Best practices for using dynamic display

• Using the dynamic display to enable the dynamic map
• Drawing in dynamic mode
• Drawing options
• Drawing marker symbols using the dynamic display API
• Direct OpenGL API
• Dynamic layers
• Drawing a dynamic layer
• Draw cycle sequence (including DynamicMapEvents)
• Drawing objects API
• Working with dynamic symbols
• Dynamic glyph factory
• General guidelines for drawing dynamic layers
• Draw rates
• In conclusion

 

//Cast the dynamic map from the focus map.
IDynamicMap dynamicMap = (IDynamicMap)hookHelper.getFocusMap();
//Make sure to switch into dynamic mode.
if (!dynamicMap.isDynamicMapEnabled())
    dynamicMap.setDynamicMapEnabled(true);

• Implementation of IDynamicLayer using IDynamicLayer.DrawDynamicLayer
• Listen to dynamic display events:  
• IDynamicMapEvents.BeforeDynamicDraw
• IDynamicMapEvents.AfterDynamicDraw

• Using dynamic display application programming interface (API)
• Direct OpenGL API

IDynamicSymbolProperties dynamicSymbolProps = ...;
IDynamicGlyph markerGlyph = ...;
//Set the marker symbol.
dynamicSymbolProps.setDynamicGlyphByRef(esriDynamicSymbolType.esriDSymbolMarker,
    markerGlyph);
IDynamicDisplay dynamicDisplay = ...;
//Draw a marker symbol.
dynamicDisplay.drawMarker(point);

IDynamicSymbolProperties dynamicSymbolProps = ...;
IDynamicGlyph markerGlyph = ...;
//Draw the item as a compound marker. This means that you do not have to draw the items and its
//accompanying labels separately, thus allowing you to write less code and better set
//the marker symbol.
dynamicSymbolProps.setDynamicGlyphByRef(esriDynamicSymbolType.esriDSymbolMarker,
    markerGlyph);
IDynamicCompoundMarker dynamicCompoundMarker = ...;
//Drawing a compound marker symbol using six strings.
dynamicCompoundMarker.drawCompoundMarker6(point, "TOP", "BOTTOM", "LEFT1", "LEFT2", 
    "RIGHT1", "RIGHT2");

// Tell JOGL that we are going to use our own OpenGL Context
GLContext context = GLDrawableFactory.getFactory().createExternalGLContext();
context.makeCurrent();
GL gl = context.getGL();

gl.glDisable(GL.GL_TEXTURE_2D);
gl.glPushMatrix();
gl.glLoadIdentity();

// Draw a simple point.
gl.glBegin(GL.GL_POINTS);
gl.glColor3f(1.0f, 1.0f, 0.0f); //Yellow
gl.glVertex2f((float)x, (float)y);
gl.glEnd();

gl.glPopMatrix();
gl.glEnable(GL.GL_TEXTURE_2D);

	DrawDynamicLayer	Draws the layer to the specified display for the given draw phase.
	DynamicLayerDirty	Indicates if the dynamic layer has changed since last drawn for the specified draw phase.
	DynamicRecompileRate	Indicates if the dynamic layer has changed since last drawn for the specified draw phase.

• Checks if recompile is needed by checking the DynamicLayerDirty with the immediate phase. If any dynamic layer has set the dirty flag for the immediate phase, all dynamic layers DrawDynamicLayer method will be called with the immediate draw phase.
• Draws the immediate phase and calls the DrawDynamicLayer method with the immediate phase.
• Checks if recompile is needed by checking the DynamicLayerDirty (with the compiled phase) and the DynamicRecompileRate property.
• If needed, recompile the dynamic layer by calling the DrawDynamicLayer method with the compiled phase.
• Draw the compiled phase, by drawing the display list.

public void drawDynamicLayer(int phase, IDisplay display, IDynamicDisplay
    dynamicDisplay){
    //Make sure the current draw phase is immediate. In this example, there is no use of the
    //compiled draw phase. Use the esriDDPCompiled draw phase to draw semi-static items (items
    //whose update rate is lower than the display update rate).
    if (phase != esriDynamicDrawPhase.esriDDPImmediate)
        return ;
    //Actual drawing to take place here. 
    //Set the dirty flag to true to let the dynamic display that the layer needs to be redrawn.
    this.setDynamicLayerDirty(phase, true);
}

• DynamicLayerDirty property is set to true
• DynamicRecompileRate time from the previous recompile time has elapsed

• Compiled phase—When the layer needs to be recompiled
• Immediate phase—When the layer needs to be redrawn

1. BeforeDynamicDraw(esriDMDPLayers) event is being fired
2. Layers are drawn; these are the layers that do not support IDynamicLayers (static layers)
3. AfterDynamicDraw(esriDMDPLayers) event is being fired
4. BeforeDynamicDraw(esriDMDPDynamicLayers) event is being fired
5. Dynamic layers are drawn
6. Immediate phase (esriDDPImmediate)
7. Compiled phase (esriDDPCompiled)
8. AfterDynamicDraw(esriDMDPDynamicLayers) event is being fired

See the following illustration:

map.addIDynamicMapEventsListener(new IDynamicMapEventsAdapter(){
    public void afterDynamicDraw(IDynamicMapEventsAfterDynamicDrawEvent event)throws
        IOException, AutomationException{
        //Make sure we only draw after the dynamic layers have been drawn
        if (event.getDynamicMapDrawPhase() !=
            esriDynamicMapDrawPhase.esriDMDPDynamicLayers)return ; 
        //Do the drawings in here.
    }
}

    ;

• IDynamicLayer.DrawDynamicLayer
• IDynamicMapEvents.BeforeDynamicDraw
• IDynamicMapEvents.AfterDynamicDraw

• Use the IDynamicDisplay interface to draw objects in map coordintates. Use the IDynamicCompoundMarkerSymbol interface as an additional option for drawing character marker symbols with surrounding attribute text.
• Use the IDynamicScreenDisplay interface to draw objects in screen coordinates. This origin uses the DisplayTransformation.DeviceFrame. In this case, it uses the upper-left of the screen.
• Use the IDynamicGlyphFactory interface to create and delete dynamic glyphs. To get the interface to IDynamicGlyphFactory, use IDynamicDisplay. 
• Use the IDynamicSymbolProperties interface to control the dynamic symbols properties (dynamic marker, line, text, and fill). 
• Use the IDynamicGlyph interface to access properties of dynamic glyphs. A dynamic glyph is a handle to a resource. 
• Use the IDynamicMap interface to set the IDynamicMap.UseSubPixelRendering property. 

• Symbol is a state of drawing:
• Controls the symbol through IDynamicSymbolProperties
• Needs to be synthesized through DynamicGlyph:
• DynamicGlyph provides resource for symbol
• DynamicSymbol types:
• esriDSymbolMarker
• esriDSymbolLine
• esriDSymbolText
• esriDSymbolFill
• DynamicGlyph types:
• esriDGlyphMarker
• esriDGlyphLine
• esriDGlyphText

• Get IDynamicGlyphFactory from the DynamicDisplay
• Create marker
• Load from bitmap (BMP)
• PictureMarker.CreateFromFile
• Create line
• Create text

	DynamicGlyph	Indicates the dynamic glyph for the specified dynamic symbol.
	GetColor	Indicates the color for the specified dynamic symbol.
	GetScale	Scales the dynamic symbol.
	Heading	Indicates the heading for the specified dynamic symbol. Only valid if dynamic symbol rotation alignment is a heading and for text and marker.
	RotationAlignment	Indicates the rotation alignment for the specified dynamic symbol. Only valid for text and marker.
	SetColor	Indicates the color for the specified dynamic symbol.
	SetScale	Scales the dynamic symbol.
	Smooth	Indicates whether the specified dynamic symbol will be smooth. Only valid for text, line, and marker.
	TextHorizontalAlignment	Indicates the horizontal alignment for the text dynamic symbol.
	TextVerticalAlignment	Indicates the vertical alignment for the text dynamic symbol.

• Image of a typographical sign
• Image used in the visual representation of characters; how a character looks. A font is a set of glyphs
• A single unit of display in a font (Microsoft). It can be defined by the following:
• An outline (in OpenType)
• A bitmap
• A set of graphic commands
• DynamicGlyph:
• Glyph using in the dynamic display environment
• A handle of the resource for rendering dynamic symbols

	CreateDynamicGlyph	Creates a dynamic glyph from a symbol.
	CreateDynamicGlyphFromFile	Creates a dynamic glyph from a file.
	DeleteDynamicGlyph	Deletes a dynamic glyph from a symbol.
	DynamicGlyph	Retrieves a dynamic glyph from a glyph group.
	Init	Initializes the dynamic glyph factory.
	LoadDynamicGlyphsGroup	Loads an external dynamic glyph group from a file.
	UnloadDynamicGlyphsGroup	Unloads an external dynamic glyph group from a file.

private boolean doOnce = true;
private IDynamicGlyphFactory dynamicGlyphFactory = null;
private IDynamicSymbolProperties dynamicSymbolProps = null;
IDynamicCompoundMarker dynamicCompoundMarker = null;
public void drawDynamicLayer(int phase, IDisplay display, IDynamicDisplay
    dynamicDisplay){
    ... if (doOnce){
        //Cast the dynamic display into dynamic glyph factory.
        dynamicGlyphFactory = dynamicDisplay.getDynamicGlyphFactory();
        //Cast the dynamic display into dynamic symbol properties.
        dynamicSymbolProps = (IDynamicSymbolProperties)dynamicDisplay;
        //Cast the compound marker symbol.
        dynamicCompoundMarker = (IDynamicCompoundMarker)dynamicDisplay;
        //Do other initializations in here.
        doOnce = false;
    }
    ...
}

• DynamicMapStarted and DynamicMapFinished—Fired on start and end of each dynamic map heart bit
• BeforeDynamicDraw and AfterDynamicDraw—Fired on before and after the dynamic display drawing

See Also: