AddPointFile Method (String, PointFileFormat, Boolean, Boolean, Boolean)

Adds the point file to the surface.

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

Syntax

C#

public SurfaceOperationAddPointFile AddPointFile(
	string pointFilename,
	PointFileFormat pointFileFormat,
	bool useAdjustedElevation,
	bool shouldTransformPointCoordinate,
	bool shouldExpandCoordinateData
)

Visual Basic

Public Function AddPointFile ( _
	pointFilename As String, _
	pointFileFormat As PointFileFormat, _
	useAdjustedElevation As Boolean, _
	shouldTransformPointCoordinate As Boolean, _
	shouldExpandCoordinateData As Boolean _
) As SurfaceOperationAddPointFile

Visual C++

public:
SurfaceOperationAddPointFile^ AddPointFile(
	String^ pointFilename, 
	PointFileFormat^ pointFileFormat, 
	bool useAdjustedElevation, 
	bool shouldTransformPointCoordinate, 
	bool shouldExpandCoordinateData
)

Parameters

pointFilename: Type: System.String
The full path of the point file.

pointFileFormat: Type: Autodesk.Civil.DatabaseServices.PointFileFormat
The file format for the point file. You can get a collection of supported point file formats by using PointFileFormatCollection.GetPointFileFormats().

useAdjustedElevation: Type: System.Boolean
Specifies whether to adjust the point elevation values.

shouldTransformPointCoordinate: Type: System.Boolean
Specifies whether to transform the points in the file.

shouldExpandCoordinateData: Type: System.Boolean
Specifies whether to calculate the coordinate data properties of the points, such as degrees, minutes, seconds, and hemisphere for latitude and longitude.

Remarks

The shouldExpandCoordinateData and useAdjustedElevation value are ignored if they are not supported in the point file format.

Examples

CopyC#

 1// Setup: create an empty TIN surface:
 2// 
 3ObjectId surfaceId = TinSurface.Create(_acaddoc.Database, "Example Surface");
 4TinSurface surface = surfaceId.GetObject(OpenMode.ForWrite) as TinSurface;
 5
 6// These point files are included as examples for Civil 3D tutorials:
 7string pointFilePath = @"C:\Program Files\Autodesk\AutoCAD Civil 3D 2013\Help\Civil Tutorials\";
 8string pointFileName = pointFilePath + "Existing Ground Points - PENZD.txt";
 9string pointFileFormatName = "PENZD (space delimited)";
10PointFileFormat pointFileFormat = PointFileFormatCollection.GetPointFileFormats(_acaddoc.Database)[pointFileFormatName];
11
12surface.PointFilesDefinition.AddPointFile(pointFileName, pointFileFormat);
13
14// You can also specify various options for adjusting elevation and transforming
15// coordinates:
16// 
17surfaceId = TinSurface.Create(_acaddoc.Database, "Example Surface 2");
18surface = surfaceId.GetObject(OpenMode.ForWrite) as TinSurface;
19pointFileName = pointFilePath + "LIDAR_ENZ (comma delimited).csv";
20pointFileFormatName = "ENZ (comma delimited)";
21pointFileFormat = PointFileFormatCollection.GetPointFileFormats(_acaddoc.Database)[pointFileFormatName];
22bool useAdjustedElevation = true;
23bool shouldTransformPointCoordinate = false;
24bool shouldExpandCoordinateData = false;
25surface.PointFilesDefinition.AddPointFile(pointFileName, pointFileFormat, 
26    useAdjustedElevation, shouldTransformPointCoordinate, shouldExpandCoordinateData);

CopyVB.NET

 1' Setup: create an empty TIN surface:
 2'
 3Dim surfaceId As ObjectId = TinSurface.Create(_acaddoc.Database, "Example Surface")
 4Dim surface As TinSurface = TryCast(surfaceId.GetObject(OpenMode.ForWrite), TinSurface)
 5
 6' These point files are included as examples for Civil 3D tutorials:
 7Dim pointFilePath As String = "C:\Program Files\Autodesk\AutoCAD Civil 3D 2013\Help\Civil Tutorials\"
 8Dim pointFileName As String = pointFilePath & "Existing Ground Points - PENZD.txt"
 9Dim pointFileFormatName As String = "PENZD (space delimited)"
10Dim pointFileFormat As PointFileFormat = PointFileFormatCollection.GetPointFileFormats(_acaddoc.Database)(pointFileFormatName)
11
12surface.PointFilesDefinition.AddPointFile(pointFileName, pointFileFormat)
13
14' You can also specify various options for adjusting elevation and transforming
15' coordinates:
16'
17surfaceId = TinSurface.Create(_acaddoc.Database, "Example Surface 2")
18surface = TryCast(surfaceId.GetObject(OpenMode.ForWrite), TinSurface)
19pointFileName = pointFilePath & "LIDAR_ENZ (comma delimited).csv"
20pointFileFormatName = "ENZ (comma delimited)"
21pointFileFormat = PointFileFormatCollection.GetPointFileFormats(_acaddoc.Database)(pointFileFormatName)
22Dim useAdjustedElevation As Boolean = True
23Dim shouldTransformPointCoordinate As Boolean = False
24Dim shouldExpandCoordinateData As Boolean = False

Exceptions

Exception	Condition
System.ArgumentException	Thrown when: The point file content doesn't match the specified point file format.