settings

The settings objects give you access to a range of visual display settings: shadow color, saturation, contrast, brightness, sharpness, and a color lookup-table (LUT). The following members are available:

§  blueShadow

§  brightness

§  contrast

§  cursor

§  gamma

§  lut

§  quality

§  saturation

§  sharpness

 

Members

blueShadow

static blueShadow : Boolean

Gets and sets a Boolean value that determines whether the shadow color is blue. If set to FALSE, the shadow color is black.

brightness

static brightness : Number

Gets and sets the brightness value. This number must be between -1 and 1. The default value is 0.

contrast

static contrast : Number

Gets and sets the contrast value. This number must be between -1 and 1. The default value is 0.

cursor

static cursor : Cursor

Gets and sets the Cursor object (i.e., the cursor icon to use) for any of the contexts listed below. Set the context and the path to the icon.:

§  Free – In free navigation mode.

§  Left – When pressing the left mouse button.

§  Middle – When pressing the middle mouse button.

§  MsgPointer – When hovering over a message link.

§  Pointer – When using a tool, e.g., analysis tool.

§  Always – Fixed, single cursor style for all contexts. This value overrides any other value set.

 

Example

TerraExplorer.settings.cursor  =  new TerraExplorer.Cursor({ free : "./img/favorites.png"});

 

To reset the cursor object to its default, use the following command:

TerraExplorer.settings.cursor = new TerraExplorer.Cursor();

gamma

static gamma : Number

Gets and sets the gamma value. This number must be between 0 and 2, where 1 is normal and 2 is overexposed.

lut

static lut :String

Gets and sets the URL of a colors lookup-table (LUT) imagery file that maps the 3D Window's colors to other colors.

quality

static quality : QualityMode

Gets and sets the QualityMode setting that controls rendering quality and the level of detail of the display in the 3D Window. It can be set to any of the following. The Auto option automatically provides optimal balance between performance and quality.

§  High = 1.0

§  Medium = 0.8

§  Low = 0.6

§  Auto = -1

Example

TerraExplorer.settings.quality = TerraExplorer.QualityMode.HIGH; 

saturation

static saturation : Number

Gets and sets the saturation value. This number must be between 0 and 2. The default value is 1.3.

sharpness

static sharpness : Number

Gets and sets the sharpness value. This number must be between 0 and 2. The default value is 1.3.