Тип QML MapCircle

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

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

Свойства

• autoFadeIn : bool
• backend : MapCircle.Backend
• border
  • border.color : цвет
  • border.width : int
• center : координата
• color : цвет
• opacity : real
• radius : 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
    }
}

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

autoFadeIn : bool

Это свойство определяет, будет ли элемент автоматически поблескивать при приближении к карте, начиная с очень низких уровней масштабирования. По умолчанию это true. Установка этого свойства в false заставляет элемент карты всегда иметь непрозрачность, указанную с помощью свойства QtQuick::Item::opacity, которое по умолчанию равно 1,0.

Это свойство было добавлено в Qt 5.14.

backend : MapCircle.Backend

Это свойство указывает, какой бэкенд используется для отрисовки элемента карты. Допустимые значения — MapCircle.Software и MapCircle.OpenGL. Значение по умолчанию — MapCircle.Software.

Примечание: Выпуск этого API с Qt 5.15 — предварительный просмотр технологии. В идеале, по мере развития OpenGL бэкендов для элементов карты, больше не будет необходимости предлагать бэкенд legacy программной проекции. Поэтому это свойство, вероятно, исчезнет в какой-то момент в будущем. Чтобы выбрать бэкенды элементов, ускоренные OpenGL, не используя это свойство, можно также установить переменную среды QTLOCATION_OPENGL_ITEMS в 1. Также обратите внимание, что все текущие OpenGL бэкенды не будут работать должным образом при включении слоёв на отдельном элементе или при запуске на OpenGL профилях выше 2.x.

Это свойство было добавлено в Qt 5.15.

border.color : color

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

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

center : coordinate

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

См. также radius.

color : color

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

opacity : real

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

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

radius : real

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

См. также center.