public final class MapRendererFactory extends java.lang.Object
MapRendererFactory manages a list of map renderer classes and associated meta data (display name, description).
Plugins can implement and supply their own map renderers.
Sample code in a pluginpublic class MyMapRenderer extends AbstractMapRenderer { // .... } // to be called when the plugin is created MapRendererFactory factory = MapRendererFactory.getInstance(); factory.register(MyMapRenderer.class, "My map renderer", "This is is a fast map renderer"); factory.activate(MyMapRenderer.class);
Modifier and Type | Class and Description |
---|---|
static class |
MapRendererFactory.Descriptor |
static class |
MapRendererFactory.MapRendererFactoryException |
Modifier and Type | Field and Description |
---|---|
private java.lang.Class<? extends AbstractMapRenderer> |
activeRenderer |
private java.util.List<MapRendererFactory.Descriptor> |
descriptors |
private static MapRendererFactory |
instance |
static java.lang.String |
PREF_KEY_RENDERER_CLASS_NAME
preference key for the renderer class name.
|
Modifier | Constructor and Description |
---|---|
private |
MapRendererFactory() |
Modifier and Type | Method and Description |
---|---|
void |
activate(java.lang.Class<? extends AbstractMapRenderer> renderer)
Activates a map renderer class.
|
void |
activateDefault()
Activates the default map renderer.
|
private void |
activateMapRenderer(java.lang.String rendererClassName) |
AbstractMapRenderer |
createActiveRenderer(java.awt.Graphics2D g,
NavigatableComponent viewport,
boolean isInactiveMode)
Creates an instance of the currently active renderer.
|
static MapRendererFactory |
getInstance()
Replies the unique instance
|
java.util.List<MapRendererFactory.Descriptor> |
getMapRendererDescriptors()
Replies the (unmodifiable) list of map renderer descriptors.
|
boolean |
isRegistered(java.lang.Class<? extends AbstractMapRenderer> renderer)
Replies true, if
Renderer is already a registered map renderer
class. |
boolean |
isWireframeMapRendererActive()
Replies true, if currently the wireframe map renderer is active.
|
private static java.lang.Class<?> |
loadRendererClass(java.lang.String className) |
void |
register(java.lang.Class<? extends AbstractMapRenderer> renderer,
java.lang.String displayName,
java.lang.String description)
Registers a map renderer class.
|
private void |
registerDefaultRenderers() |
void |
unregister(java.lang.Class<? extends AbstractMapRenderer> renderer)
Unregisters a map renderer class.
|
public static final java.lang.String PREF_KEY_RENDERER_CLASS_NAME
StyledMapRenderer
private static MapRendererFactory instance
private final java.util.List<MapRendererFactory.Descriptor> descriptors
private java.lang.Class<? extends AbstractMapRenderer> activeRenderer
private MapRendererFactory()
public static MapRendererFactory getInstance()
private static java.lang.Class<?> loadRendererClass(java.lang.String className)
private void activateMapRenderer(java.lang.String rendererClassName)
private void registerDefaultRenderers()
public boolean isRegistered(java.lang.Class<? extends AbstractMapRenderer> renderer)
Replies true, if Renderer
is already a registered map renderer
class.
renderer
- the map renderer class. Must not be null.Renderer
is already a registered map renderer
classjava.lang.IllegalArgumentException
- if renderer
is nullpublic void register(java.lang.Class<? extends AbstractMapRenderer> renderer, java.lang.String displayName, java.lang.String description)
Registers a map renderer class.
renderer
- the map renderer class. Must not be null.displayName
- the display name to be displayed in UIs (i.e. in the preference dialog)description
- the descriptionjava.lang.IllegalArgumentException
- if renderer
is nulljava.lang.IllegalStateException
- if renderer
is already registeredpublic void unregister(java.lang.Class<? extends AbstractMapRenderer> renderer)
Unregisters a map renderer class.
If the respective class is also the active renderer, the renderer is reset to the default renderer.
renderer
- the map renderer class. Must not be null.public void activate(java.lang.Class<? extends AbstractMapRenderer> renderer)
Activates a map renderer class.
The renderer class must already be registered.
renderer
- the map renderer class. Must not be null.java.lang.IllegalArgumentException
- if renderer
is nulljava.lang.IllegalStateException
- if renderer
isn't registered yetpublic void activateDefault()
Activates the default map renderer.
java.lang.IllegalStateException
- if the default renderer StyledMapRenderer
isn't registeredpublic AbstractMapRenderer createActiveRenderer(java.awt.Graphics2D g, NavigatableComponent viewport, boolean isInactiveMode) throws MapRendererFactory.MapRendererFactoryException
Creates an instance of the currently active renderer.
MapRendererFactory.MapRendererFactoryException
- if creating an instance failsAbstractMapRenderer.AbstractMapRenderer(Graphics2D, NavigatableComponent, boolean)
public java.util.List<MapRendererFactory.Descriptor> getMapRendererDescriptors()
Replies the (unmodifiable) list of map renderer descriptors.
public boolean isWireframeMapRendererActive()
Replies true, if currently the wireframe map renderer is active. Otherwise, false.
There is a specific method for WireframeMapRenderer
for legacy support.
Until 03/2011 there were only two possible map renderers in JOSM: the wireframe
renderer and the styled renderer. For the time being there are still UI elements
(menu entries, etc.) which toggle between these two renderers only.