Тип QML MapPolygon

Тип MapPolygon отображает многоугольник на карте. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• border
  • border.width : int
  • border.color : цвет
• color : цвет
• path : список<координата>

Методы

• void addCoordinate(координата)
• void removeCoordinate(координата)

Подробное описание

Тип MapPolygon отображает многоугольник на карте, заданный упорядоченным списком координат. Для наилучшего отображения и результатов многоугольники должны быть простыми (не самопересекающимися).

Координаты в пути не могут быть изменены напрямую после добавления в многоугольник. Вместо этого скопируйте path в переменную, измените копию и присвойте копию обратно path.

var path = mapPolygon.path;
path[0].latitude = 5;
mapPolygon.path = path;

Координаты также могут быть добавлены и удалены в любое время с помощью методов addCoordinate и removeCoordinate.

Для рисования прямоугольников с «прямыми» сторонами (одинаковая широта по одной стороне, одинаковая широта по другой) тип MapRectangle предоставляет более простой API с двумя точками.

По умолчанию многоугольник отображается как граница черного цвета шириной 1 пиксель без заливки. Чтобы изменить его вид, используйте свойства color, border.color и border.width.

Примечание: Поскольку MapPolygon — это географические элементы, перетаскивание MapPolygon (с помощью MouseArea) приводит к перерасчету его вершин в географическом пространстве координат. Стороны сохраняют ту же географическую длину (разницу широты и долготы между вершинами), но остаются прямыми. Видимое растяжение элемента происходит при перетаскивании на другую широту.

Производительность

MapPolygons имеют стоимость отрисовки O(n) по отношению к количеству вершин. Это означает, что стоимость отображения Polygon на карте с каждой кадровой частотой растет прямо пропорционально количеству точек в Polygon. Существует дополнительная стоимость триангуляции (приблизительно O(n log n)), которая в настоящее время оплачивается с каждым кадром, но в будущем может оплачиваться только при добавлении или удалении точек.

Как и другие объекты карты, MapPolygon обычно отображается без плавного вида. Установка свойства opacity заставит объект смешиваться, что значительно снизит производительность в зависимости от используемого оборудования.

Пример использования

В приведенном ниже фрагменте показано использование MapPolygon для отображения треугольника с тремя вершинами вблизи Брисбена, Австралия. Треугольник заливается зелёным цветом с черной границей шириной 1 пиксель.

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 }
        ]
    }
}

Документация по свойствам

border.width : int

Это свойство является частью группы свойств border. Группа свойств border содержит ширину и цвет, используемые для рисования границы многоугольника.

Ширина в пикселях и не зависит от масштаба карты.

Значения по умолчанию соответствуют черной границе шириной 1 пиксель. Для отсутствия линии используйте ширину 0 или прозрачный цвет.

color : цвет

Это свойство содержит цвет, используемый для заливки многоугольника.

Значение по умолчанию — прозрачный.

path : список<координата>

Это свойство содержит упорядоченный список координат, определяющих многоугольник. Наличие менее 3 разных координат в пути приводит к неопределённому поведению.

См. также addCoordinate и removeCoordinate.

Документация по методам

void addCoordinate(координата)

Добавляет координату в путь.

См. также removeCoordinate и path.

void removeCoordinate(координата)

Удаляет координату из пути. Если существуют несколько экземпляров одной и той же координаты, удаляется последняя добавленная.

Если координата отсутствует в пути, метод ничего не делает.

См. также addCoordinate и path.