Тип MapPolygon QML

Тип 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 : список<координата>

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

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

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

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

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

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

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

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

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

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