com.esri.arcgis.display
Class IDynamicMapEventsBeforeDynamicDrawEvent

java.lang.Object
  extended by java.util.EventObject
      extended by com.esri.arcgis.display.IDynamicMapEventsBeforeDynamicDrawEvent
All Implemented Interfaces:
Serializable

public class IDynamicMapEventsBeforeDynamicDrawEvent
extends EventObject

Remarks

The BeforeDynamicDraw event is getting fired with two different phases (enum esriDynamicMapDrawPhase). Each phase has a different meaning and usage:

  1. esriDMDPDynamicLayers – This is getting fired on each dynamic cycle that the Dynamic Map re-renders the scene. The BeforeDynamicDraw event is fired just before the first layer is rendered, and AfterDynamicDraw event is fired just after the last layer (including any Graphic Layer) is rendered.
    In this context, there is an active OpenGL Rendering context (with a preset rendering volume, viewport, etc).
    Use this context to plug-in any custom dynamic drawings with the DynamicDisplay API as well as with the OpenGL API. This context can be useful in order to draw dynamic elements behind or on top of the Layers and Graphics, which do not need to be associated with a layer.
  2. esriDMDPLayers – When the Dynamic Map is sensing that it needs to fetch tiles in order to be able to render the scene, the BeforeDynamicDraw will get fired. When the last missing tile will be available and rendered the AfterDynamicDraw event will get fired.
    Note that it is not valid to use the DynamicDisplay API, nor the OpenGL API in this context, since the OpenGL Rendering Context is not fully setup.
    Use this context if you need to monitor when the Dynamic Map is still in a process of fetching tiles for rendering the display.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.util.EventObject
source
 
Constructor Summary
IDynamicMapEventsBeforeDynamicDrawEvent(Object source)
           
 
Method Summary
 IDisplay getDisplay()
           
 IDynamicDisplay getDynamicDisplay()
           
 int getDynamicMapDrawPhase()
           
 void init(int dynamicMapDrawPhase, IDisplay display, IDynamicDisplay dynamicDisplay)
           
 
Methods inherited from class java.util.EventObject
getSource, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

IDynamicMapEventsBeforeDynamicDrawEvent

public IDynamicMapEventsBeforeDynamicDrawEvent(Object source)
Method Detail

init

public void init(int dynamicMapDrawPhase,
                 IDisplay display,
                 IDynamicDisplay dynamicDisplay)

getDynamicMapDrawPhase

public final int getDynamicMapDrawPhase()

getDisplay

public final IDisplay getDisplay()

getDynamicDisplay

public final IDynamicDisplay getDynamicDisplay()