3D Core API

Detailed Description

This Class Category contains the main MapLink 3D API classes.

Classes
class	TSL3DCamera
class	TSL3DClientCustomDataLayer
class	TSL3DCustomDataLayer
class	TSL3DDataLayer
class	TSL3DDrawingSurface
class	TSL3DLightSource
class	TSL3DLODConfiguration
class	TSL3DMapQuery
class	TSL3DOpenGLLightSource
class	TSL3DRenderingInterface
class	TSL3DSelector
class	TSL3DStandardDataLayer
class	TSL3DTerrainDataLayer
class	TSL3DWinGLSurface
class	TSL3DX11GLSurface
class	TSLPickResult3DEntity

Typedefs
typedef void(*	TSL3DRenderingCallback) (void *arg, int pendingTextures)
enum	TSL3DCameraReturn { TSL3DCamera_OK = 0 , TSL3DCamera_Failed , TSL3DCamera_AngleOfViewInvalid , TSL3DCamera_LatitudeInvalid }
enum	TSL3DCameraMoveAction { TSL3DCameraMoveActionNone = 0 , TSL3DCameraMoveActionKeepLookAtPosition = 1 , TSL3DCameraMoveActionMaintainGroundOrientation = 2 }
enum	TSL3DLightingOptionEnum { TSL3DLightingOptionEnable = 1 }
enum	TSL3DOptionEnum { TSL3DOptionFlatEarthMode = 1 , TSL3DOptionStereoMode = 2 , TSL3DOptionWireframeMode = 4 , TSL3DOptionWaitForImagery = 8 }
enum	TSL3DRenderingModeEnum { TSL3DRenderingModeNormal , TSL3DRenderingModePick }

Typedef Documentation

TSL3DRenderingCallback

typedef void(* TSL3DRenderingCallback) (void *arg, int pendingTextures)

Multi-thread callback for rendering control.

The 3D Drawing Surface renders 2D draped information in a background thread. This callback is triggered when the background thread has new information ready to be draped.

The function called should trigger a redraw of drawing surface. However since the callback will be called from the background thread, it must not call the draw method directly unless the application has locked out any redraw calls in the main thread. Typically a message is posted to the view which is picked up by the main thread message handler.

Parameters

arg	User supplied callback argument.
pendingTextures	The number of textures still awaiting generation from the previous draw request. The callback will be invoked as each pending texture is completed. Once this count reaches 0 all the correct resolution imagery for the current view is available.

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Enumeration Type Documentation

TSL3DCameraMoveAction

enum TSL3DCameraMoveAction

Enumerated type defining how the camera orientation may be modified when the camera moves

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Enumerator
TSL3DCameraMoveActionNone	Keep current geocentric orientation.
TSL3DCameraMoveActionKeepLookAtPosition	Adjust orientation according to last parameters passed to lookAt.
TSL3DCameraMoveActionMaintainGroundOrientation	Adjust orientation to be the same relative to the ground.

TSL3DCameraReturn

enum TSL3DCameraReturn

Return type for 3D Camera functions

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Enumerator
TSL3DCamera_OK	Success.
TSL3DCamera_Failed	Failure.
TSL3DCamera_AngleOfViewInvalid	The angle of view is either < 0.0 or > 180.0 degrees.
TSL3DCamera_LatitudeInvalid	The latitude is either < -90.0 or > 90.0 degrees.

TSL3DLightingOptionEnum

enum TSL3DLightingOptionEnum

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Enumerator
TSL3DLightingOptionEnable

TSL3DOptionEnum

enum TSL3DOptionEnum

Enumerated type defining the options for a TSL3DDrawingSurface.

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Enumerator
TSL3DOptionFlatEarthMode	Sets the drawing surface mode to 2D (also known as 'flat-earth'). By default this mode maps latitude/longitude with no scaling. To enable Dynamic Arc flat earth set the option on the TLSDrawing SurfaceBase::setOption(TSLOptionDynamicArcSupportEnabled, true) and then set this option. Once Dynamic Arc option is set switching between Ellipsoid and Flat Earth will give Dynamic Arc Flat Earth. Disabling the Dynamic Flat Earth will also require a reset. Default value is False.
TSL3DOptionStereoMode	When set, renders the drawing surface in stereo. This will only have an effect if the appropriate hardware is being used (i.e. graphics cards supporting stereo display. Default value is False.
TSL3DOptionWireframeMode	When set, renders the earth as a wireframe model.
TSL3DOptionWaitForImagery	correct resolution of imagery has been loaded and rendered for the camera location.

TSL3DRenderingModeEnum

enum TSL3DRenderingModeEnum

Enumerated type defining the current mode a TSLRenderingInterface is configured in.

Deprecated

Deprecated as of MapLink 11.1. Advised to use MapLink Earth SDK instead.

Enumerator
TSL3DRenderingModeNormal	The TSLRenderingInterface is performing a regular rendering operation such as redrawing the drawing surface window.
TSL3DRenderingModePick	The TSLRenderingInterface is configured in a special mode to determine which items in a drawing surface are being picked by the user. Custom datalayers must perform one of the following to support picking depending on the type of custom datalayer: For datalayers that render using operations in the rendering interface, TSLRenderingInterface::setPickData() and TSLRenderingInterface::clearPick Data() must be used to identify the primitives that can be picked. For datalayers that render using OpenGL directory, the OpenGL glPushName() and glPopName() functions need to be used to identify the primitives that can be picked.