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++]
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

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:

• inShape: sets the 3D point location for creating the new geometry.
• outShape: returns the result of the operation.
• enforcedZ: apply this Z value to the 3D point location, overwriting any existing Z value in the 'inShape' parameter. The default value is AVNaN, representing 'not a number' as defined in the shapefile definition.
• unitFactor: multiply the current Z for the 3D point location by this value (runs after enforcedZ, above). This is useful for converting between units (eg: feet to meters). 
• zScale: flatten or stretch the symbol shape along the z-axis by this value (runs after UnitFactor above).

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

See Also