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


IGlobeLayerProperties2.IsInvisibleWhenNavigating Property (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (GlobeCore)  

IGlobeLayerProperties2.IsInvisibleWhenNavigating Property

Indicates if the layer is visible while interactive navigation.

[Visual Basic .NET]
Public Property IsInvisibleWhenNavigating As Boolean
[C#]
public bool IsInvisibleWhenNavigating {get; set;}
[C++]
HRESULT get_IsInvisibleWhenNavigating(
  VARIANT_BOOL* bInvisibleWhenNavigating
);
[C++]
HRESULT put_IsInvisibleWhenNavigating(
  VARIANT_BOOL bInvisibleWhenNavigating
);
[C++]

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

Product Availability

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

Description

Some layers in the ArcGlobe document may be very expensive to render, reducing the responsiveness of interactive navigation through the 3D view.  When this option is set to True, the layer will not display while navigating, thereby freeing up resources to improve the interactive navigation experience.  When navigation halts, the layer will be displayed again.

 

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 layer drawing to be suspended appropriately.  When the Fly Tool halts, the ‘while navigating’ state is set to false and layer will draw.  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 may not be preferred when outputting animation files, as the animation framework will set the ‘while navigating’ status to true and the resulting video will not include display of this layer.

See Also

IGlobeLayerProperties2 Interface