GridSurfaceExtractMinorContours(SurfaceExtractionSettingsType, ContourSmoothingType, Int32) Method

Extracts the surface minor contour information from the terrain surface.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.8.0.292
Syntax
Copy
public ObjectIdCollection ExtractMinorContours(
	SurfaceExtractionSettingsType settingsType,
	ContourSmoothingType smoothType,
	int smoothFactor
)

Parameters

settingsType  SurfaceExtractionSettingsType
Specify SurfaceExtractionSettingsType.Plan to extract the contour information using the plan visual style settings, or SurfaceExtractionSettingsType.Model to use the model settings.
smoothType  ContourSmoothingType
Currently, smoothType can be AddVertices only.
smoothFactor  Int32
smoothFactor should be in the range [0, 10]. A value of 10 generates the smoothest contours.

Return Value

ObjectIdCollection
An ObjectIdCollection of the extracted entities. The extracted entities are Polyline objects. If the surface has no contour information, this method returns an empty ObjectIdCollection.

Implements

ITerrainSurfaceExtractMinorContours(SurfaceExtractionSettingsType, ContourSmoothingType, Int32)
Exceptions
ExceptionCondition
ArgumentException Thrown when smoothFactor is not between the range [0, 10].
Example
Copy
 1// Setup: creates a new, random surface.                    
 2// 
 3TinSurface surface = CreateRandomSurface("Example Surface");
 4
 5// Surface must have a style that shows minor contours.
 6// 
 7surface.StyleId = _civildoc.Styles.SurfaceStyles["Contours and Triangles"];
 8
 9// Extract minor contours and print information about them:
10// 
11ObjectIdCollection minorContours;
12minorContours = surface.ExtractMinorContours(SurfaceExtractionSettingsType.Plan);
13write("# of extracted contours: " + minorContours.Count + "\n");
14int totalVertices = 0;
15for (int i = 0; i < minorContours.Count; i++)
16{
17    ObjectId contourId = minorContours[i];
18    // Contours are lightweight Polyline objects:
19    // 
20    Polyline contour = contourId.GetObject(OpenMode.ForRead) as Polyline;
21    write(String.Format("Contour #{0} length:{1}, # of vertices:{2}\n",
22        i, contour.Length, contour.NumberOfVertices));
23    totalVertices += contour.NumberOfVertices;
24}
25
26// Extract major contours with smoothing:
27// 
28minorContours = surface.ExtractMinorContours(SurfaceExtractionSettingsType.Plan,
29    ContourSmoothingType.AddVertices, 10);
30int totalVerticesSmoothed = 0;
31foreach (ObjectId contourId in minorContours)
32{
33    Polyline contour = contourId.GetObject(OpenMode.ForRead) as Polyline;
34    totalVerticesSmoothed += contour.NumberOfVertices;
35}
36
37// Compare smoothing by adding vertices:
38write(String.Format("Effects of smoothing:\n  total vertices no smoothing: {0}\n  total vertices with smoothing: {1}\n",
39    totalVertices, totalVerticesSmoothed));
See Also