com.esri.arcgis.analyst3d
Interface IMarker3DSymbol

All Superinterfaces:
Serializable
All Known Implementing Classes:
Marker3DSymbol

public interface IMarker3DSymbol
extends Serializable

Provides access to members that control the 3D marker symbol.

Description

The IMarker3DSymbol interface provides properties and methods to define 3D marker symbols. The CreateFromFile method enbles import of existing OpenFlight (.flt), 3ds max* (.3ds), or Virtual Reality Markup Language (VRML*) models and then symbolize point features with these models. RestrictAccessToShape restricts the access to the geometry of a 3D marker symbol. IsRestrictedAccess indicates whether the geometry of the 3D Marker Symbol is restricted. UseMaterialDraping is used to display the symbols with or without texture materials.

Product Availability

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


Method Summary
 void createFromFile(String fileName)
          Imports the symbol definition.
 int getMaterialCount()
          Number of materials present.
 IGeometry getShape()
          Marker shape geometry.
 IPicture getThumbnail()
          The symbol thumbnail for 2D representation.
 boolean isRestricted()
          Indicates if the marker restricts access to internal shape.
 boolean isUseMaterialDraping()
          Indicates if the marker uses material property for draping.
 void restrictAccessToShape()
          Restricts all further access to internal shape.
 void setShapeByRef(IGeometry shape)
          Marker shape geometry.
 void setThumbnailByRef(IPicture thumbnail)
          The symbol thumbnail for 2D representation.
 void setUseMaterialDraping(boolean useDraping)
          Indicates if the marker uses material property for draping.
 

Method Detail

setShapeByRef

void setShapeByRef(IGeometry shape)
                   throws IOException,
                          AutomationException
Marker shape geometry.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
shape - A reference to a com.esri.arcgis.geometry.IGeometry (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getShape

IGeometry getShape()
                   throws IOException,
                          AutomationException
Marker shape geometry.

Product Availability

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

Returns:
A reference to a com.esri.arcgis.geometry.IGeometry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isUseMaterialDraping

boolean isUseMaterialDraping()
                             throws IOException,
                                    AutomationException
Indicates if the marker uses material property for draping.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The useDraping
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setUseMaterialDraping

void setUseMaterialDraping(boolean useDraping)
                           throws IOException,
                                  AutomationException
Indicates if the marker uses material property for draping.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
useDraping - The useDraping (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaterialCount

int getMaterialCount()
                     throws IOException,
                            AutomationException
Number of materials present.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The cMaterials
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

createFromFile

void createFromFile(String fileName)
                    throws IOException,
                           AutomationException
Imports the symbol definition.

Description

Pass in the full path to the file. URLs are also supported as the file path string.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getThumbnail

IPicture getThumbnail()
                      throws IOException,
                             AutomationException
The symbol thumbnail for 2D representation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.support.ms.stdole.IPicture
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setThumbnailByRef

void setThumbnailByRef(IPicture thumbnail)
                       throws IOException,
                              AutomationException
The symbol thumbnail for 2D representation.

Product Availability

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

Parameters:
thumbnail - A reference to a com.esri.arcgis.support.ms.stdole.IPicture (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

restrictAccessToShape

void restrictAccessToShape()
                           throws IOException,
                                  AutomationException
Restricts all further access to internal shape.

Remarks

Once a marker 3D symbol's shape/geometry is set to be restricted, its geometry cannot be obtained via ArcObjects.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isRestricted

boolean isRestricted()
                     throws IOException,
                            AutomationException
Indicates if the marker restricts access to internal shape.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The isRestricted
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.