EPointCloud::LoadPLY
Loads an EPointCloud stored in the PLY file format.
Namespace: Euresys::Open_eVision::Easy3D
[C++]
void LoadPLY(
const std::string& path
)
void LoadPLY(
const std::string& path,
const EFloatRange& undefinedZValues
)
Parameters
path
The full path of the input file.
undefinedZValues
Optional parameter, discard the points with Z value in the given range.
Remarks
The PLY file format is documented here: http://paulbourke.net/dataformats/ply/.
When loading PLY files:
- in ascii files, all numbers are assumed to be written in base 10
- file is assumed to contain at least the floating point fields x, y and z. They mustn't be the first but have to be consecutive. If one of these points is nan, inf or too big to be represented on a float, the line is ignored. These points can be double but are stored internally as float.
- the other columns are loaded as user-custom attributes unless they match the specifications of our particular attributes
- the 3(4) columns representing a color must be of type uchar and end with _red, _green, _blue (, _alpha). They must be consecutive and in the red, green, blue (alpha) order.
- columns representing an E3DPoint must have as suffixes "_x", "_y", "_z", be consecutive and of float type. They are stored as float in both cases. Otherwise they are loaded as 3 float columns.
- we do not have internal int16 or int8 types so those are converted to int32 types.
The particular attributes we define and the conditions to be parsed as one are:
- E3DAttribute_Color: names must be red, green, blue (alpha), encoding must correspond to a color.
- E3DAttribute_Normal: names must be (nx, ny and nz) or (normal_x, normal_y and normal_z), encoding must correspond to a point.
- E3DAttribute_Intensity: name must be intensity, intensity must be a numeric type.
- E3DAttribute_Texture: name must be texture (with corresponding suffixes if type is color or point).
- E3DAttribute_Index: name must be index and type uint32 or int32.
- E3DAttribute_Confidence: name must be confidence and type should be float or double (but is converted internally to float).
- E3DAttribute_Distance: name must be distance and type should be float or double (but is converted internally to float).
Use EPointCloud::SavePLY to save to PLY file.
EPointCloud.LoadPLY
Loads an EPointCloud stored in the PLY file format.
Namespace: Euresys.Open_eVision.Easy3D
[C#]
void LoadPLY(
string path
)
void LoadPLY(
string path,
Euresys.Open_eVision.EFloatRange undefinedZValues
)
Parameters
path
The full path of the input file.
undefinedZValues
Optional parameter, discard the points with Z value in the given range.
Remarks
The PLY file format is documented here: http://paulbourke.net/dataformats/ply/.
When loading PLY files:
- in ascii files, all numbers are assumed to be written in base 10
- file is assumed to contain at least the floating point fields x, y and z. They mustn't be the first but have to be consecutive. If one of these points is nan, inf or too big to be represented on a float, the line is ignored. These points can be double but are stored internally as float.
- the other columns are loaded as user-custom attributes unless they match the specifications of our particular attributes
- the 3(4) columns representing a color must be of type uchar and end with _red, _green, _blue (, _alpha). They must be consecutive and in the red, green, blue (alpha) order.
- columns representing an E3DPoint must have as suffixes "_x", "_y", "_z", be consecutive and of float type. They are stored as float in both cases. Otherwise they are loaded as 3 float columns.
- we do not have internal int16 or int8 types so those are converted to int32 types.
The particular attributes we define and the conditions to be parsed as one are:
- E3DAttribute_Color: names must be red, green, blue (alpha), encoding must correspond to a color.
- E3DAttribute_Normal: names must be (nx, ny and nz) or (normal_x, normal_y and normal_z), encoding must correspond to a point.
- E3DAttribute_Intensity: name must be intensity, intensity must be a numeric type.
- E3DAttribute_Texture: name must be texture (with corresponding suffixes if type is color or point).
- E3DAttribute_Index: name must be index and type uint32 or int32.
- E3DAttribute_Confidence: name must be confidence and type should be float or double (but is converted internally to float).
- E3DAttribute_Distance: name must be distance and type should be float or double (but is converted internally to float).
Use EPointCloud::SavePLY to save to PLY file.