Тип QML MapCircle

Тип MapCircle отображает географическую окружность на карте. Подробнее...

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

Свойства

• border
  • border.width : int
  • border.color : цвет
• center : координата
• цвет : цвет
• прозрачность : real
• радиус : real

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

Тип MapCircle отображает географическую окружность на карте, которая состоит из всех точек, находящихся в заданном расстоянии от одной центральной точки. В зависимости от проекции карты, географическая окружность на экране не всегда будет идеальной окружностью: например, в проекции Меркатора окружности становятся овальными по мере приближения к полюсам. Чтобы отобразить идеальную окружность на экране вокруг точки, используйте MapQuickItem, содержащий соответствующий тип Qt Quick.

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

Внутри MapCircle реализован как многоугольник из множества сторон. Для вычисления радиус точек он использует сферическую модель Земли, аналогично методу atDistanceAndAzimuth типа coordinate. Эти два фактора могут иногда влиять на точность формы окружности, в зависимости от положения и проекции карты.

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

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

Производительность MapCircle практически эквивалентна производительности MapPolygon с таким же количеством вершин. Существует небольшое дополнительное время, связанное с предварительным вычислением вершин.

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

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

Следующий фрагмент кода показывает карту, содержащую MapCircle, расположенную в центре по координатам (-27, 153) с радиусом 5 км. Окружность заполнена зеленым цветом с черной рамкой шириной 3 пикселя.

Map {
    MapCircle {
        center {
            latitude: -27.5
            longitude: 153.0
        }
        radius: 5000.0
        color: 'green'
        border.width: 3
    }
}

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

border.width : int

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

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

center : координата

Это свойство содержит центральную точку, относительно которой определяется окружность.

См. также радиус.

цвет : цвет

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

прозрачность : real

Это свойство содержит непрозрачность элемента. Непрозрачность задается числом от 0 (полностью прозрачный) до 1 (полностью непрозрачный). Значение по умолчанию равно 1.

Элемент с 0 непрозрачностью все равно будет получать события мыши. Чтобы отключить события мыши, установите свойство visible элемента в false.

радиус : real

Это свойство содержит радиус окружности в метрах на местности.

См. также center.