TinVolumeSurface.Create(String, ObjectId, ObjectId) Method

Creates a new instance of a TinVolumeSurface and adds it to the database where the surface specified by baseSurfaceId is located.

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

Syntax

C#

public static ObjectId Create(
	string surfaceName,
	ObjectId baseSurfaceId,
	ObjectId comparisonSurfaceId
)

VB

Public Shared Function Create ( 
	surfaceName As String,
	baseSurfaceId As ObjectId,
	comparisonSurfaceId As ObjectId
) As ObjectId

C++

public:
static ObjectId Create(
	String^ surfaceName, 
	ObjectId baseSurfaceId, 
	ObjectId comparisonSurfaceId
)

Parameters

surfaceName  String

The name of the new TinVolumeSurface.

baseSurfaceId  ObjectId

The ObjectId of the base surface for the TinVolumeSurface.

comparisonSurfaceId  ObjectId

The ObjectId of the comparison (top) surface for the TinVolumeSurface.

Return Value

ObjectId

Exceptions

Remarks

This method uses the default style for the surface so you don't need to provide a style ObjectId.

Example

 1/// <summary>
 2/// Creates a TIN volume surface from two existing TIN surfaces
 3/// </summary>
 4[CommandMethod("CreateTinVolumeSurface")]
 5public void CreateTinVolumeSurface()
 6{
 7    using (Transaction ts = Application.DocumentManager.MdiActiveDocument.Database.TransactionManager.StartTransaction())
 8    {
 9        string surfaceName = "ExampleVolumeSurface";
10        // Prompt user to select surfaces to use
11        // promptForTinSurface uses Editor.GetEntity() to select a TIN surface
12        ObjectId baseId = promptForTinSurface("Select the base surface");
13        ObjectId comparisonId = promptForTinSurface("Select the comparison surface");
14
15        try
16        {
17            // Create the surface
18            ObjectId surfaceId = TinVolumeSurface.Create(surfaceName, baseId, comparisonId);
19            TinVolumeSurface surface = surfaceId.GetObject(OpenMode.ForWrite) as TinVolumeSurface;
20        }
21
22        catch (System.Exception e)
23        {
24            editor.WriteMessage("Surface create failed: {0}", e.Message);
25        }
26
27        // commit the create action
28        ts.Commit();
29    }
30}

See Also

Reference