Globe Component v2



Methods


globeMC.setSunPosition(posObj)

In standalone mode posObj should have theta and phi properties measured in degrees. In plug-in mode the position should be defined in a way that is recognized by the celestial sphere component (e.g. it has ra and dec properties).


globeMC.setViewerDirection(dirObj)

This sets the orientation of the globe in standalone mode. dirObj should have theta and phi properties measured in degrees.


globeMC.getViewerDirection()

Returns an object with theta and phi properties (for standalone mode only).


globeMC.setShadingStyle(color, alpha)

Use this function to set the fill style of the night-time shading used on the globe. The defaults are 0x000000 and 40.


globeMC.setAxisStyle(thickness, color, alpha)

Use this function to set the line style of the earth's rotational axis. The defaults are 1, 0x000000, and 100.


globeMC.setWaterLinkageName(linkageName), globeMC.setLandLinkageName(linkageName)

These functions are used to set which movieclips are used for the land and water parts of the globe. Each movieclip should contain a filled disc 100 pixels in diameter centered on the movieclip's origin. The default movieclips are located in the Resources folder of the component.



Properties


globeMC.size

In standalone mode the size (the diameter of the globe) is measured in pixels. In the plug-in mode the size is the fractional size with respect to the celestial sphere the globe resides in. The defaults are 200 and 0.2, respectively.


globeMC.rotation

Use this angle (measured in degrees) to rotate the globe about its instantaneous axis. The default is 0.


globeMC.precession

This angle (measured in degrees) shifts the axis of the earth's rotation as happens over the 26,000 year precession cycle. The default is 0.


globeMC.showAxis

This property sets the visibility of the earth's rotational axis. The default is true.


globeMC.axisLength

In standalone mode this length is expressed as a multiple of the globe's size. In the plug-in mode this length is a multiple of the celestial sphere's size. In both modes the default is 1.4.


globeMC.showShading

This property determines whether night-time shading is shown on the globe. The default is false.


globeMC.isDraggable

This property determines whether the user can drag the globe around in standalone mode, thus changing the viewer direction. If the user drags the sphere around the viewerDirectionChangeHandler function of the parent of the globe component will be called (assuming it is defined). This property has no effect in the plug-in mode.



initObject Properties

The defaults above can be changed by using the properties inspector (for a standalone dragged on the stage in the authoring environment) or by passing an initObject with any of the following properties:

initSize
initRotation
initPrecession
initViewerTheta
initViewerPhi
initIsDraggable
viewerDirectionChangeHandler
initShowAxis
initAxisLength
initAxisThickness
initAxisColor
initAxisAlpha
initShowShading
initSunPosition (an object that can be passed to setSunPosition)
initSunTheta
initSunPhi
initShadingColor
initShadingAlpha
initWaterLinkageName
initLandLinkageName
isStandalone (usually you should let the component determine which mode it is in)