Creates a graphical representation of all regions on the terrain and on 3D models and objects that are visible, within a field of view, from a given viewing point.
|
JavaScript |
|
|
CreateViewshed( ViewerPosition, FieldOfViewX, FieldOfViewY, Distance, ParentGroupID, Description) |
|
|
C# |
|
|
I3DViewshed65 Create3DViewshed( IPosition65 ViewerPosition, double FieldOfViewX, double FieldOfViewY, double Distance, [string ParentGroupID = ""], [string Description = ""]) |
|
|
C++ |
|
|
HRESULT Create3DViewshed( IPosition65* ViewerPosition, double FieldOfViewX, double FieldOfViewY, double Distance BSTR ParentGroupID, BSTR Description, I3DViewshed65** pI3DViewshed65) |
|
Parameters
ViewerPosition
An IPosition65 representing the viewing point position, defined by its coordinates in the 3D World.
FieldOfViewX
The horizontal angle limits of the viewshed. Values are in degrees from 0 to 120.
FieldOfViewY
The vertical angle limits of the viewshed. Values are in degrees from 0 to 120.
Distance
Length of the viewshed analysis from the viewer position in meters.
ParentGroupID
The Project Tree group in which the model is created. If it is set to an empty string, the object is created under the root. You can obtain the GroupID by one of the following methods:
· Create the group using IProjectTree65.CreateGroup.
· Find the group, if you know the name, using IProjectTree65.FindItem.
· Traverse the Tree using IProjectTree65 methods such as GetNextItem, until you come to the desired GroupID.
Description
The name of the viewshed object as it appears in the Project Tree. If an empty string is passed into this parameter, TerraExplorer assigns it a unique name.
Return Value
pI3DViewshed65
An I3DViewshed65 representing the newly created 3D viewshed object.
Exceptions
See: HRESULT Return Values for a list of possible values returned by the HRESULT.