Back to Adaptive Vision Library website

You are here: Start » Function Reference » Interoperability » LoadPoint3DGrid

LoadPoint3DGrid


Loads entities from a file of one of available types as an array of points in 3D.

Syntax

C++
C#
 
void avl::LoadPoint3DGrid
(
	const atl::File& inFile,
	avl::Point3DFileFormat::Type inFileFormat,
	avl::Point3DGrid& outPoint3DGrid
)

Parameters

Name Type Default Description
inFile const File&
inFileFormat Point3DFileFormat::Type
outPoint3DGrid Point3DGrid&

Description

The operation loads an grid of points from a file in one of the standard 3D file formats. Currently the filter supports the following formats:
  • STL (*.stl),
  • PLY (*.ply).
PLY (Polygon File Format) also known as the Stanford Triangle Format is a format for storing graphical objects described as a collection of polygons. Both ASCII and binary (big-endian and little-endian) versions are supported. Please note that only vertex coordinates can be loaded. Other elements and properties are omitted.
STL (STereoLithography) is a file format commonly used in the stereolithography CAD software. Only binary STL is supported.

Errors

Error type Description
DomainError Unknown file format in LoadPoint3DGrid.
IoError Wrong PLY file format. Invalid vertex property type.
IoError Wrong PLY file format. Invalid file signature.
IoError Wrong PLY file format. End of header not found.
IoError Wrong PLY file format. Unrecognized data encoding.
IoError Wrong PLY file format. Invalid vertex property definition.
IoError Wrong PLY file format. Invalid format definition.
IoError Wrong PLY file format. Invalid element definition.
IoError Loading Point3DGrid failed. Too many vertex properties.
IoError Wrong PLY file format. No vertices found.
IoError Wrong PLY file format. Invalid vertex data.
IoError Opening PLY file failed.
IoError Wrong PLY file format. Invalid vertex definition.