|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ITerrainDataSource
Provides access to members of Terrain Data Source.
ITerrainDataSource is used to set and get terrain specific properties associated with a feature class that participates in a terrain.
Method Summary | |
---|---|
int |
getFeatureClassID()
The unique database identifier for the feature class. |
int |
getGroupID()
The identifier of the terrain's thematic group to which this feature class belongs. |
String |
getHeightField()
The database column providing heights for the features. |
int |
getSurfaceFeatureType()
Indicates how the features are used to define the terrain surface. |
String |
getTagValueField()
The database column providing tag values for TIN elements derived from the terrain. |
boolean |
isApplyToOverviewTerrain()
Indicates if the 'breakline' data source should be added to the overview Terrain. |
boolean |
isEmbedded()
Indicates whether or not the data source is contained by the terrain. |
void |
queryResolutionBounds(double[] pLowerBound,
double[] pUpperBound)
Returns the lower and upper resolution bounds in which the line/area data source participates in the triangulation. |
void |
setApplyToOverviewTerrain(boolean pbApply)
Indicates if the 'breakline' data source should be added to the overview Terrain. |
void |
setFeatureClassID(int pClassID)
The unique database identifier for the feature class. |
void |
setGroupID(int pGroupID)
The identifier of the terrain's thematic group to which this feature class belongs. |
void |
setHeightField(String pFieldName)
The database column providing heights for the features. |
void |
setResolutionBounds(double lowerBound,
double upperBound)
Sets the lower and upper resolution bounds in which the line/area data source participates in the triangulation. |
void |
setSurfaceFeatureType(int pType)
Indicates how the features are used to define the terrain surface. |
void |
setTagValueField(String pFieldName)
The database column providing tag values for TIN elements derived from the terrain. |
Method Detail |
---|
void setFeatureClassID(int pClassID) throws IOException, AutomationException
pClassID
- The pClassID (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getFeatureClassID() throws IOException, AutomationException
The database ID of the feature class representing the data source. See IFeatureClass.FeatureClassID.
The ID for an embedded feature class may change after a call to ITerrainEdit.Build.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setGroupID(int pGroupID) throws IOException, AutomationException
pGroupID
- The pGroupID (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getGroupID() throws IOException, AutomationException
Groups are feature classes representing the same phenomena at different levels of detail. For example, you can have very detailed breaklines for ‘edge of road’ and more generalized breaklines that are ‘center of road’. Each is to be used at different scales. Assigning them the same group id will tell terrain they are thematically alike but must be enforced only in non-overlapping scale ranges.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setHeightField(String pFieldName) throws IOException, AutomationException
pFieldName
- The pFieldName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getHeightField() throws IOException, AutomationException
The HeightField is the name of the database column providing heights for the features. It can be the shape field name if the z values are to come from the feature geometry. It can be a numeric field in the case where z values are to come from an attribute. This parameter can also be left unset, or set to an empty string, if the features are to be incorporated into the terrain without z values (e.g. z-less clip polygon boundary).
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setTagValueField(String pFieldName) throws IOException, AutomationException
pFieldName
- The pFieldName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getTagValueField() throws IOException, AutomationException
The TagValueField is the name of the database column providing tags for derived terrain TIN elements. Tag values are integers (signed longs), with user defined meaning, that can be assigned to nodes, edges, or triangles. They are used as a simple form of attribution.
This parameter can remain unset, or set to an empty string, if tags are not to be assigned from this data source.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setSurfaceFeatureType(int pType) throws IOException, AutomationException
pType
- A com.esri.arcgis.geodatabase.esriTinSurfaceType constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getSurfaceFeatureType() throws IOException, AutomationException
The SurfaceFeatureType, or SFType for short, indicates how the features are used to define the terrain surface. There are five major types defined via the esriTinSurfaceType enumeration:
Mass: points, polyline vertices, or polygon vertices are inserted as simple nodes.
Line: line segments are enforced in triangulation as triangle edges.
Replace: everything on the perimeter and inside the polygon are assigned the same height.
Erase: all triangles inside the polygon are masked as NoData. Rendering and interpolation will not occur in these areas.
Clip: all triangles outside the polygon are masked as NoData. Rendering and interpolation will not occur in these areas.
ValueFill: all triangles inside the polygon are assigned a tag value as a simple form of attribution.
All types but mass, have 'soft' and 'hard' qualifiers. This distinction between hard and soft is a property that is assigned to line and polygon boundary edges enforced in the triangulation. The property influences the behavior of the natual neighbors interpolator: the surface is smooth across soft break edges but has a disinct break in slope across hard edges. See also Natural Neighbors interpolant.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setApplyToOverviewTerrain(boolean pbApply) throws IOException, AutomationException
pbApply
- The pbApply (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isApplyToOverviewTerrain() throws IOException, AutomationException
ApplyToOverviewTerrain is a boolean that indicates whether this data source contributes to the overview representation. It's a choice for line and polygon based data. It must be set to TRUE for mass point data or an error will be returned.
The terrain overview is the coarsest representation of terrain. It's like a vector based thumbnail.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isEmbedded() throws IOException, AutomationException
Indicates whether the feature class is embedded in the terrain. If set to TRUE the feature class is contained by the terrain, rather than referenced by it like regular feature classes, and is not visible from ArcCatalog. Operations on it must be performed through terrain related functions.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setResolutionBounds(double lowerBound, double upperBound) throws IOException, AutomationException
The resolution bounds are used by feature classes added as breakline and polygon surface feature types. The bounds represent the pyramid levels in which the features are enforced. The lower bound is inclusive, the upper exclusive. For example, a data source with a lower bound of 0.0 and an upper bound of 5.1 will be enforced by the terrain for pyramid layers whose resolution is >= 0.0 and < 5.1.
lowerBound
- The lowerBound (in)upperBound
- The upperBound (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void queryResolutionBounds(double[] pLowerBound, double[] pUpperBound) throws IOException, AutomationException
The resolution bounds are used by feature classes added as breakline and polygon surface feature types. The bounds represent the pyramid levels in which the features are enforced. The lower bound is inclusive, the upper exclusive. For example, a data source with a lower bound of 0.0 and an upper bound of 5.1 will be enforced by the terrain for pyramid layers whose resolution is >= 0.0 and < 5.1.
pLowerBound
- The pLowerBound (out: use single element array)pUpperBound
- The pUpperBound (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |