AddPointFile Method (String, PointFileFormat)

Adds points from a 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
)

Visual Basic

Public Function AddPointFile ( _
	pointFilename As String, _
	pointFileFormat As PointFileFormat _
) As SurfaceOperationAddPointFile

Visual C++

public:
SurfaceOperationAddPointFile^ AddPointFile(
	String^ pointFilename, 
	PointFileFormat^ pointFileFormat
)

Parameters

pointFilename
Type: System.String
The full path and name 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().

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