GridSurface.ExtractBorder Method

Extracts the surface border information from the terrain surface.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.8.0.280

Syntax

C#

public ObjectIdCollection ExtractBorder(
	SurfaceExtractionSettingsType settingsType
)

VB

Public Function ExtractBorder ( 
	settingsType As SurfaceExtractionSettingsType
) As ObjectIdCollection

C++

public:
virtual ObjectIdCollection^ ExtractBorder(
	SurfaceExtractionSettingsType settingsType
) sealed

Parameters

settingsType  SurfaceExtractionSettingsType

Specify SurfaceExtractionSettingsType.Plan to extract the border information using the plan visual style settings, or SurfaceExtractionSettingsType.Model to use the model settings.

Return Value

ObjectIdCollection
An ObjectIdCollection of the extracted entities. The extracted entities can be Polyline, Polyline3d, or Face. If the surface has no border information, this method returns an empty ObjectIdCollection.

Implements

ITerrainSurfaceExtractBorder(SurfaceExtractionSettingsType)

Example

C#

 1// Setup: creates a new, random surface
 2// 
 3TinSurface surface = CreateRandomSurface("Example Surface");
 4ObjectIdCollection borders;
 5borders = surface.ExtractBorder(SurfaceExtractionSettingsType.Plan);
 6write("# of surface borders: " + borders.Count + "\n");
 7foreach (ObjectId borderId in borders)
 8{
 9    // Borders are Polyline3d objects:
10    Polyline3d border = borderId.GetObject(OpenMode.ForRead) as Polyline3d;
11    write("Surface border vertices:\n");
12    foreach (ObjectId vertexId in border)
13    {
14        PolylineVertex3d vertex3d = vertexId.GetObject(OpenMode.ForRead) as PolylineVertex3d;
15        write(String.Format("  - Border vertex at: {0}\n",
16            vertex3d.Position.ToString()));
17    }
18}

VB

1!ERROR: See log file!

See Also

Reference