The renderer is the main object to interact with. It belongs to the User Interface single threaded apartment. Use the AgEsri3dRendererFactory Object object to access the renderer for a specific 3D scene.

Each 3D scene has a different renderer.

Once you get to the IAgEsri3dRenderer interface, you can:

• Configure various options on the renderer (Config property).
• Open/close map documents (OpenMapDocument, CloseMapDocument methods).
• Access the opened map document for manipulation using ArcObjects (MapDocument property).
• Manage the GIS selection (ClearSelection, SelectFeature methods).
• Manage the display (Refresh, Pause, Resume, ZoomToLayer, FlashFeature methods).
• Identify GIS features by using a specialized helper function on top of the regular Arc engine Identify capability (Identify method).
• Promote GIS features to STK objects (Promote method).
• Optimize cross thread communication (DrawPause, DrawResume methods).
• Make changes to the map document on the fly (StartMapEditing, StopMapEditing methods).

The AgEsri3dRenderer object also provides the following events:

• Map document operations:
  • OnMapDocumentOpened
    This event is triggered after a map document has been successfully opened.
  • OnMapDocumentClosed
    This event is triggered just before closing a map document. You need to release all the ArcObjects and STKesriDisplay resources that you are holding at that point.
  • OnMapDocumentOpenFailed
    This event is triggered after a map document failed to open.
  • OnMapDocumentEdited
    This event is triggered after a map document has been edited (i.e. when the StopMapEditing method is called).

• Rendering:
  • OnDrawBegin
    This event is raised when starting to render all the feature layers in the map document.
  • OnDrawProgress
    This event is raised when starting to render a specific feature layer in the map document.
  • OnDrawEnd
    This event is raised when rendering all the feature layers in the map document is done.