This document is archived and information here might be outdated.  Recommended version.


IMarker3DPlacement.ApplyToPoint Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (3DAnalyst)  

IMarker3DPlacement.ApplyToPoint Method

Applies symbol construction to original shape.

[Visual Basic .NET]
Public Sub ApplyToPoint ( _
    ByVal inShape As IPoint, _
    ByRef outShape As IGeometry, _
    [ByVal enforcedZ As Double], _
    [ByVal unitFactor As Double], _
    [ByVal zScale As Double] _
)
[C#]
public void ApplyToPoint (
    IPoint inShape,
    ref IGeometry outShape,
    ref double enforcedZ,
    ref double unitFactor,
    ref double zScale
);
[C#]

Optional Values

enforcedZ   Supply -1.1E+38 as a default value.
unitFactor   Supply 0 as a default value.
zScale   Supply 1 as a default value.
[C++]
HRESULT ApplyToPoint(
  IPoint* inShape,
  IGeometry** outShape,
  double enforcedZ,
  double unitFactor,
  double zScale
);
[C++]

Parameters inShape [in]
inShape is a parameter of type IPoint outShape [out]
outShape is a parameter of type IGeometry enforcedZ [in, optional, defaultvalue(-1.1E+38)] enforcedZ is a parameter of type double unitFactor [in, optional, defaultvalue(0)] unitFactor is a parameter of type double zScale [in, optional, defaultvalue(1)] zScale is a parameter of type double

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires 3D Analyst Extension.

Description

The ApplyToPoint method is used to apply the 3D Marker symbol to a 3D point, thereby creating a georeferenced geometry for use elsewhere. Essentially, it allows you to generate a geometry using the marker symbol as a template. This can be useful, for example, when creating new features to be stored in the geodatabase. The geometry created is usually a multipatch, though it depends upon the 3D symbol being used.

This interface has been traditionally used for converting symbolized 2D feature classes into 3D multipatch feature classes. From 9.2, the Layer 3D to feature class geoprocessing tool can be used as an alternative.

Remarks

The parameters of ApplyToPoint are:

This call will fail if the symbol is protected by IMarker3DSymbol.IsRestricted property.

See Also

IMarker3DPlacement Interface