Тип QML MapPolygon

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

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

Свойства

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

Методы

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

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

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

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

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

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

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

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

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

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

MapPolygon имеет стоимость отрисовки O(n) относительно количества вершин. Это означает, что стоимость за кадр для многоугольника на карте увеличивается прямо пропорционально количеству точек в многоугольнике. Есть дополнительная стоимость триангуляции (приблизительно 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 : список<координата>

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

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

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

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

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

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

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

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

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

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