AGI STK Esri Display 11 Send comments on this topic.
Promote Method (IAgEsri3dRenderer)
See Also  Example
Feature
Feature to promote (not required when promoting the selection).
Name
Name of the resulting STK objects.
PromoteType





Description

Promotes a feature to an STK object

Syntax

[Visual Basic .NET]
Public Sub Promote( _
   ByVal Feature As IFeature, _
   ByVal Name As String, _
   ByVal PromoteType As AgESTKesriPromoteType _
) 

[C#]
public void Promote(
IFeature Feature,
string Name,
AgESTKesriPromoteType PromoteType
);

[Managed C++]
public: void Promote(
IFeature ^ Feature,
String __gc ^ Name,
AgESTKesriPromoteType PromoteType
);

[Java]
public  promote(
IFeature Feature,
String Name,
AgESTKesriPromoteType PromoteType
);

[Unmanaged C++]
public: HRESULT Promote(
IFeature * Feature,
BSTR Name,
AgESTKesriPromoteType PromoteType
);

Parameters

Feature
Feature to promote (not required when promoting the selection).
Name
Name of the resulting STK objects.
PromoteType
Member Value Description
ePromoteFacilities 0 Promote point(s) to facilities.
ePromoteTargets 1 Promote point(s) to targets.
ePromoteFacilitiesConstellation 2 Promote points to facilities and puts them in a constellation.
ePromoteTargetsConstellation 3 Promote points to targets and puts them in a constellation.
ePromoteLineTargets 4 Promote line(s) to line targets.
ePromoteLineTargetsConstellation 5 Promote lines to line targets and puts them in a constellation.
ePromoteAreaTargets 6 Promote polygons(s) to area targets.
ePromoteAreaTargetsConstellation 7 Promote polygons to area targets and puts them in a constellation.
ePromoteSelection 8 Promote selection to STK Objects.
ePromoteSelectionConstellation 9 Promote selection to STK Objects and puts them in a constellation.
ePromoteAircrafts 10 Promote line(s) to aircrafts.
ePromoteAircraftsConstellation 11 Promote lines to aircrafts and puts them in a constellation.
ePromoteShips 12 Promote line(s) to ships.
ePromoteShipsConstellation 13 Promote lines to ships and puts them in a constellation.
ePromoteGroundVehicles 14 Promote line(s) to ground vehicles.
ePromoteGroundVehiclesConstellation 15 Promote lines to ground vehicles and puts them in a constellation.
ePromotePlaces 16 Promote point(s) to places.
ePromotePlacesConstellation 17 Promote points to places and puts them in a constellation.

Remarks

In order to perform analysis, promote GIS features into STK objects:

  • Point features are promoted to STK facilities or targets.
  • Polyline features are promoted to STK line targets.
  • Polygon features are promoted to STK area targets.

If a feature has multiple parts, the resulting STK objects can also be grouped into one constellation, which facilitates their manipulation as a group for analysis.

The names of the STK objects are built using the Name parameter as a basis, and then adding _ followed by a numerical counter to ensure uniqueness.

Example

[C#] Copy Code
m_Renderer.Promote(m_SelectedFeature, "GISFeature", AgESTKesriPromoteType.ePromoteFacilities);

See Also

© 2016 Analytical Graphics, Inc. All Rights Reserved.

STK Programming Interface 11.0.1