CreateLocationStep

Creates a presentation step that moves the camera to a different location. A route can be generated manually by calling this method several times to create a list of locations, with each location being a separate step. TerraExplorer Pro generates the route by computing a line that passes through each location. A route can also be created by flying through the terrain and recording the exact route you traveled, using the StartRecord and StopRecord methods.

 

JavaScript

 

CreateLocationStep(

       AdvancedType,

       WaitTime,

       Description,

       Position)

 

C#

 

IPresentationStep66 CreateLocationStep(

       PresentationStepContinue AdvancedType,

       int WaitTime,

       string Description,

       object Position)

 

C++

 

HRESULT CreateLocationStep(

       PresentationStepContinue AdvancedType,

       long WaitTime,

       BSTR Description,

       VARIANT Position,

       IPresentationStep66** Step)

 

Parameters

AdvancedType

An enum that determines how the presentation advances to the next step. The following are its possible values:

·          PSC_MOUSECLICK = 0
On mouse click.

·          PSC_WAIT = 1
Automatically after the preset wait time.

WaitTime

After performing the step, the number of seconds to wait before the presentation should advance to the next step.

Description

A string describing the step that displays in the Presentation Editor. If an empty string is passed into this parameter, TerraExplorer assigns it a unique name.

Position

The position of the location, defined by its coordinates in the 3D World.

Return Value

Step

An IPresentationStep66 representing the location step that was created.

Exceptions

See:  HRESULT Return Values for a list of possible values returned by the HRESULT.