ArcObjects Library Reference (GlobeCore)  

IGlobeAdvancedOptions2 Interface

Provides access to the globe data processing and management options.

Product Availability

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

Description

This interface corresponds to the Advanced button on the Cache tab of the Options dialog from the Tools menu in ArcGlobe.  It is used to get and set the tile memory use for various globe data types. With this advanced option, users can now fine tune memory usage on each specific data type.  This gives users a higher level of flexibility.

This interface allows you to control memory allocation per data type. GetTileMemory gives you the current and maximum allowable tile memory for each data type. There are seven data types, that can be queried for memory usage as defined in esriGlobeTileMemoryType enumeration. Use SetTileMemory to allocate maximum tile memory usage (in MegaBytes) of a of a particular data type.  As a rule of thumb, more memory should be allocated to the predominant data type in the current globe session.

The SetTileMemory method becomes handy if you encounter a thrashing effect when working with data that would require large amounts of memory. A thrashing effect results from a very high system memory paging, that causes the application to spend more time in memory paging than excuting. To alleviate such problems, try lowering tile memory limit of data types that are not used while increasing the tile memory limit of the most dominant data type in your current globe session. Note that the total allocated tile memory limit of all data types should not exceed the available physical memory on a machine. In addition, it is also advised for systems that use AGP graphics cards, the total texture memory allocated should not be greater than the AGP aperture size, which normally ranges from 64 to 512 MB.

Use GetVirtualViewportSize to get the maximum internal view port size that is used to limit the level of detail (LOD) calculation. The virtual view port size corresponds to the maximum size of a viewer, where Levels of Detail will be calculated. The default value is a maximum size of 1024X768, representing the most common full screen resolution. Use SetVirtualViewportSize to set this internal viewport size to a desired value. Note that setting this value higher than the default may increase resolution at a cost of performance.

Members

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

Inherited Interfaces

Interfaces Description
IGlobeAdvancedOptions Provides access to the globe data processing and management options.

CoClasses that implement IGlobeAdvancedOptions2

CoClasses and Classes Description
GlobeAdvancedOptions The globe advanced options object.