OpenMap Tutorial 4 — Слои

В качестве краткого напоминания openmap.layers ссылается на загружаемые слои, а openmap.startUpLayers ссылается на те, которые должны быть загружены при запуске. Вы заметите, что basic слой был добавлен.

Результат можно визуализировать на рисунке 2. Из BasicLayer BasicLayer мы узнаем, что он расширяет OMGraphicHandlerLayer , который содержит хорошую функциональность, но предоставляет только методы, необходимые для начала добавления объектов ( OMGraphic s) на карту. Это слой, в котором объекты никогда не меняются, а объекты карты, используемые этим слоем, никогда не меняются. Они всегда управляются и рисуются, даже если они находятся за пределами видимой карты. Когда проекция изменяется, OMGraphic получают сообщение о том, что такое новая проекция, чтобы они могли изменить OMGraphic положение, и затем они перерисовываются. Если вы хотите больше узнать о взаимодействии с вашими OMGraphic после того, как вы OMGraphic их эффективно отображать, перейдите на OMGraphic InteractionLayer .

Слои реализуют интерфейс ProjectionListener для прослушивания ProjectionEvent . Когда проекция изменяется, им может понадобиться повторно извлечь, восстановить их графику, а затем перерисовать себя в новом виде. Мы расскажем больше о проектировании в следующем уроке.

BasicLayer переопределяет два метода из OMGraphicHandlerLayer :

• prepare() : этот метод вызывается при добавлении слоя на карту или при изменении проекции карты. Нам нужно убедиться, что OMGraphicList возвращаемый этим методом, является тем, что мы хотим нарисовать на карте. OMGraphic должны быть сгенерированы с текущей проекцией. Мы проверяем нулевой OMGraphicList в слое, чтобы увидеть, нужно ли нам создавать OMGraphic s. Этот слой не меняет свои OMGraphic для разных проекций, если ваш слой делает это, вам нужно очистить OMGraphicList и добавить OMGraphics вы хотите для текущей проекции.
• init() : вызывается из метода prepare() если слой обнаруживает, что его OMGraphicList равен null .

getList() возвращает все, что было возвращено из этого метода при последнем вызове prepare() . В этом примере мы всегда возвращаем объект OMGraphicList , поэтому, если он null , prepare() не был вызван. В этом случае вызывается init() .

Перед возвратом списка объектов карты, вызов для установки проекции слоя имеет решающее значение! OMGraphic нужно сказать, где рисовать себя, и они OMGraphic это, когда им передается текущая Projection в вызове generate(Projection) . Если OMGraphic изменилось, его нужно будет восстановить перед тем, как он будет отрендерен, иначе он не будет отрисовываться сам. У вас может возникнуть проблема генерации, когда OMGraphic появляются с изменениями проекции (масштабирование и панорамирование), но не в любое другое время после каких-либо изменений в OMGraphic . Если вы хотите быть более эффективным, вы можете заменить этот вызов списка в качестве предложения else для проверки (list == null) выше, и вызывать generate(Projection) для всех OMGraphics в методе init() ниже, так как вы создать их. Это предотвратит OMGraphicList.generate(Projection) создания дополнительного цикла через все OMGraphic прежде чем они будут возвращены.

Метод init() вызывается, когда prepare() возвращает null . Он создает объекты ( OMGraphic ), которые будут добавлены к слою.

В качестве краткого руководства типичное ГИС-приложение состоит из карты ( MapBean в OpenMap), которая состоит из слоев (объектов Layer ), которые состоят из объектов ( OMGraphic ). На следующем рисунке показана иерархия классов OMGraphic s.

Это фактически говорит вашему слою, что его функции должны реагировать на жесты мыши (например, наведение мыши). MouseEvent может управляться некоторыми компонентами OpenMap, направляя их на слои и на OMGraphic . MouseMode описывает, как MouseEvent и MouseMotionEvent интерпретируются и используются. MouseDelegator — это настоящий MouseListener и MouseMotionListener в MapBean . MouseDelegator управляет списком MouseMode и знает, какой из них является «активным» в любой момент времени. MouseDelegator также запрашивает у активных слоев свои MapMouseListener и добавляет те, которые заинтересованы в событиях из активного MouseMode качестве слушателей этого режима.

Когда MouseEvent запускается из MapBean, он проходит через MouseDelegator в активный MouseMode , где MouseMode начинает предоставлять MouseEvent своим MapMouseListener . Каждому слушателю предоставляется возможность использовать событие. MapMouseListener может воздействовать на событие и не использовать его, чтобы его можно было продолжать передавать другим слушателям.

MapMouseListener предоставляет массив String всех MouseMode ID от MouseMode ID он заинтересован в получении событий, а также имеет свои собственные методы, в MouseMotionEvent поступают MouseEvent и MouseMotionEvent . MapMouseListener может использовать эти события в сочетании с OMGraphicList , чтобы найти out, если события произошли на каком-либо OMGraphic , и ответить, если необходимо.

Есть несколько MouseModes которыми ваш слой может взаимодействовать. Поиск modeID в исходном коде или здесь возвращает следующие 8 режимов мыши (есть два дубликата):

• DistanceMouseMode.modeID = "Distance"
• DistQuickToolMouseMode.modeID = "Distance"
• NavMouseMode.modeID = "Navigation"
• NullMouseMode.modeID = "None"
• OMDrawingToolMouseMode.modeID = "Drawing"
• OMMouseMode.modeID = "Gestures"
• PanMouseMode.modeID = "Pan"
• RangeRighsMouseMode.modeID = "RangeRings"
• SelectMouseMode.modeID = "Gestures"
• ZoomMouseMode.modeID = "Zoom"

Не забудьте добавить что-то вроде следующего к вашим функциям при их создании, для визуального отображения, когда на них point.setSelectPaint(Color.yellow); курсор мыши: point.setSelectPaint(Color.yellow);

Вы можете переопределить следующие методы:

• isSelectable() — Запрос о том, что OMGraphic можно выбрать. Вы должны вернуть true чтобы сделать его доступным для выбора.
• isHighlightable() — Запрос, что OMGraphic может быть выделен, когда мышь перемещается над ним.
• getInfoText() — отображать текст в строке состояния, когда указатель мыши находится над OMGraphic
• getToolTipTextFor() — отображать всплывающую подсказку, когда мышь находится над OMGraphic

Например

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

• List getItemsForOMGraphicMenu(OMGraphic omg)

Если вы хотите отобразить всплывающее меню при щелчке правой кнопкой мыши в любом месте слоя, переопределите следующий метод, чтобы получить список пунктов меню:

• List getItemsForMapMenu(MapMouseEvent me)

Надеюсь, это было довольно мило и не так сложно, однако вы не можете перемещать функции. Например, я хотел бы иметь возможность выбрать OMPoint и перетащить его на новую позицию. Чтобы добавить эту функциональность, нам нужно изучить некоторые слои, которые не перечислены в приведенных выше списках:

• com.bbn.openmap.layer.DemoLayer
• com.bbn.openmap.layer.DrawingToolLayer
• com.bbn.openmap.layer.editor.EditorLayer

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

Когда вы нажимаете кнопку Drawing Tool Launcher , вы можете добавлять на слой множество типов графики, что может оказаться не тем, что вам нужно. Например, вы можете захотеть, чтобы ваш слой отображал только OMPoint s, и вы не хотите, чтобы пользователь мог добавлять, например, линии или круги, используя Drawing Tool . Это может быть легко сделано, если вы измените openmap.components оставив только omdrawingtool и ompointloader (или только типы загрузчиков OM, которые вы используете в своем приложении):

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

Виновником является OMDrawingTool . Поскольку OpenMap является проектом с открытым исходным кодом, рекомендуется прочитать код вышеуказанного класса ( com.bbn.openmap.tools.drawing.OMDrawingTool ). Собственно, в методе select() вы увидите строку:

OMDrawingTool определяет несколько масок поведения:

• SHOW_GUI_BEHAVIOR_MASK
• GUI_VIA_POPUP_BEHAVIOR_MASK
• USE_POPUP_BEHAVIOR_MASK
• ALT_POPUP_BEHAVIOR_MASK
• PASSIVE_MOUSE_EVENT_BEHAVIOR_MASK
• DEACTIVATE_ASAP_BEHAVIOR_MASK
• DEFAULT_BEHAVIOR_MASK
• QUICK_CHANGE_BEHAVIOR_MASK

Вы можете попробовать их все, чтобы увидеть, как ведет себя слой. К сожалению, ни один из них не покрывает наши потребности. Если всплывающее окно (или наше всплывающее окно) не появляется, функция не может быть перетащена в другое место; если появляется всплывающее окно, это одно из OMDrawingTool . Итак, хак. Мы создадим наш собственный OMDrawingTool :

Вы можете пойти еще дальше, добавив методы set, чтобы установить список JMenuItem созданный методом getItemsForOMGraphicMenu() , но я оставляю это как упражнение для вас. Нам нужно сделать еще одну вещь:

С этим изменением вы можете удалить строку, которая устанавливает маску поведения в методе select() вашего слоя.