Adds the point file to the surface.

Namespace: Autodesk.Civil.DatabaseServices
Assembly: AeccDbMgd (in AeccDbMgd.dll) Version: 13.4.2516.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

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

See Also