This document is archived and information here might be outdated.  Recommended version.


IGlobeDisplay3.IsFetchingSuspendedWhenNavigating Property (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GlobeCore)  

IGlobeDisplay3.IsFetchingSuspendedWhenNavigating Property

Indicates if tile fetching is disabled while navigating.

[Visual Basic .NET]
Public Property IsFetchingSuspendedWhenNavigating As Boolean
[C#]
public bool IsFetchingSuspendedWhenNavigating {get; set;}
[C++]
HRESULT get_IsFetchingSuspendedWhenNavigating(
  VARIANT_BOOL* bSuspended
);
[C++]
HRESULT put_IsFetchingSuspendedWhenNavigating(
  VARIANT_BOOL bSuspended
);
[C++]

Parameters bSuspended [out, retval] bSuspended is a parameter of type VARIANT_BOOL bSuspended [in] bSuspended is a parameter of type VARIANT_BOOL

Product Availability

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

Description

ArcGlobe uses two threads – one for display and one for fetching tiles.  When this option is set to True, the tile fetching thread is completely suspended while navigating, thereby freeing up hardware resources for the display thread.  When navigation halts, the tile fetching thread is re-enabled and ArcGlobe will use the appropriate level-of-detail for displaying the current view.

 

Tile fetching is occurring when retrieving existing tiles from the disk cache, or when generating new tiles as the user visits a new geographic region.  Note that any tiles that are already in physical memory (RAM) will continue to display when this option is enabled, but no additional tiles will be read from disk or generated for display.

 

The view is said to be navigating when the Globe Camera is moving continuously.  For example, using the Fly Tool will set the ‘while navigating’ state to true and cause tile fetching to be suspended appropriately.  When the Fly Tool halts, the ‘while navigating’ state is set to false and tile fetching will resume.  An example of a navigation technique which does not set the ‘while navigating’ state to true is the mouse-wheel zoom in.  This functionality uses discrete steps to zoom in and is therefore not a continuous navigation event.

 

This option is not recommended when outputting animation video files, as the animation framework will set the ‘while navigating’ status to true and the resulting video will only use tiles that are in memory when generating the video.  This will most likely be a lower resolution display than required.

 

To disable tile fetching on a per-layer basis, see the IsFetchingSuspendedWhenNavigating property for IGlobeLayerProperties2.

See Also

IGlobeDisplay3 Interface