ArcGIS Developer Help

IGlobeAdvancedOptions Interface

Provides access to the globe data processing and management options. Note: the IGlobeAdvancedOptions interface has been superseded by IGlobeAdvancedOptions2. Please consider using the more recent version.

Product Availability

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

Description

Use IGlobeAdvancedOptions interface to get\set Arcglobe�s advanced visualization and data management options. Using this interface you can get\set the following properties: CachePath � where cache data will reside on the local machine, DefaultUse16ElevBits and DefaultUse16ColorBits � default values for elevation and image color Compression, ClipNear and ClipFarFactor � Near and Far Clipping planes that aid in performance optimization by clipping areas that do not fall within the applications view, LevelOfDetail � the level of detail of image and elevation layers that gets applied during display, ManualLOD � a boolean that indicates if manual LOD control is on and TargetFrameRate � the target frame rate when using automatic control of LOD. Use VectorTileSize property to limit the amount of features (expressed as the maximum number of vertices) in a tile. Currently the maximum amount is 65,536 vertices (2¹⁶) which is set as the default value. Lowering this value will in effect result in 'trimming' or dropping-off of features that exceed the limit set within a tile. This property applies to features treated as vectors only.

IGlobeAdvancedOptions interface also has methods GetUseCache and SetUseCache, to get\set whether disk cache will be used and the size to allocate for disk cache, a property to get if lossy compression is supported � IsLossyCompressionSupported , and a method to get the default lossy compression option for a data type and its quality from 1 to 100 � GetDefaultCompression.
The RestoreClipPlaneDefaults and RestoreLODDefaults methods set the default Clipping planes and level of Detail settings to their default values respectively. Most of these advanced options will not be used until WriteToRegistry is used to commit the changes to registry.

Members

	Name	Description
	CachePath	The path to the globe data cache in disk.
	ClipFarFactor	The Far Plane Clipping Factor.
	ClipNear	The value for where the near clipping plane is.
	DefaultUse16ColorBits	Indicates whether to perform radiometric compression to 16 color bits.
	DefaultUse16ElevBits	Indicates whether to perform elevation range compression to 16 bits.
	GetDefaultCompression	Gets default lossy compression option for a data type, and its quality from 1 to 100.
	GetUseCache	Gets disk cache option and cache size.
	IsLossyCompressionSupported	Indicates if lossy data compression is supported.
	LevelOfDetail	The level of detail value.
	ManualLOD	Indicates if the level of detail is under manual control.
	RestoreClipPlaneDefaults	Restore the Default Clipping Plane Settings.
	RestoreLODDefaults	Restore the Default LOD Settings.
	SetDefaultCompression	Sets default lossy compression option for a data type, and its quality from 1 to 100.
	SetUseCache	Sets disk cache option and cache size.
	TargetFrameRate	The target frame rate -- for automatic control of level of detail.
	TileMemorySize	The memory used for tile data.
	UpdateCacheMonthlyPrompt	Indicates whether to update the cache monthly.
	VectorTileSize	The maximum size of a vector tile (< 2 power 16).
	WriteToRegistry	Write the options in the system's registry.

Classes that implement IGlobeAdvancedOptions

Classes	Description

[C#]

The following code illustrates how to manipulate the advanced options available from this interface:

public void AdvancedOpts()
{
//pGlobe is a variable of type IGlobe
IGlobeDisplay pGlbDisplay = pGlobe.GlobeDisplay;

IGlobeAdvancedOptions pGlobeAdv = pGlbDisplay.AdvancedOptions;

//Get the current cache location
string currentCacheLocation;
currentCacheLocation = pGlobeAdv.CachePath;

bool pbLossyComp;
short pQuality;

//Pass the data type (esriGlobeDataType) as the first argument
pGlobeAdv.GetDefaultCompression(esriGlobeDataType.esriGlobeDataTexture,out pbLossyComp,out pQuality);
}