List of I/O Formats

load mesh parameters

Here are listed all the file formats that can be loaded usingthe functions pmeshlab.MeshSet.load_new_mesh() and pmeshlab.MeshSet.load_current_mesh(), with all the possible parameters that can be accepted by these functions.

3ds

Load 3DS format.

Parameters:

file_name : str = 'file_name.3DS'

File Name: The name of the file to load

load_in_a_single_layer : bool = False

Load in a single layer: 3DS files may contain more than one mesh. If this parameter is set to false, all the meshes contained in the file will be merged in a single mesh.

apts

Load apts format.

Parameters:

file_name : str = 'file_name.apts'

File Name: The name of the file to load

asc

Load ASC format.

Parameters:

file_name : str = 'file_name.ASC'

File Name: The name of the file to load

rowtoskip : int = 0

Header Row to be skipped: The number of lines that must be skipped at the beginning of the file.

triangulate : bool = True

Grid triangulation: if true it assumes that the points are arranged in a complete xy grid and it tries to perform a naive height field triangulation of the input data. Length of the lines is detected automatically by searching x jumps. If the input point cloud data is not arranged as a xy regular height field, no triangles are created.

bre

Load BRE format.

Parameters:

file_name : str = 'file_name.BRE'

File Name: The name of the file to load

pointsonly : bool = False

only import points: Just import points, without triangulation

unify_vertices : bool = True

Unify Duplicated Vertices in BRE files: The BRE format is not an vertex-indexed format. Each triangle is composed by independent vertices, so, usually, duplicated vertices should be unified

ctm

Load CTM format.

Parameters:

file_name : str = 'file_name.CTM'

File Name: The name of the file to load

dae

Load DAE format.

Parameters:

file_name : str = 'file_name.DAE'

File Name: The name of the file to load

es

Load ES format.

Parameters:

file_name : str = 'file_name.ES'

File Name: The name of the file to load

seed : int = 1

Seed for random mesh generation: write a seed for the random generation of the mesh

maxrec : int = 0

set the maximum recursion: the mesh is built recursively according to the productions of the grammar, so a limit is needed. If set to 0 meshlab will generate the mesh according to the maximum recursion set in the file

sphereres : int = 1

set maximum resolution of sphere primitives, it must be included between 1 and 4: increasing the resolution of the spheres will improve the quality of the mesh

maxobj : int = 0

set the maximum number of object to be rendered: you can set a limit to the maximum number of primitives rendered. If set to 0 meshlab will generate the mesh according to the input file

fbx

Load FBX format.

Parameters:

file_name : str = 'file_name.FBX'

File Name: The name of the file to load

obj

Load OBJ format.

Parameters:

file_name : str = 'file_name.OBJ'

File Name: The name of the file to load

off

Load OFF format.

Parameters:

file_name : str = 'file_name.OFF'

File Name: The name of the file to load

pdb

Load PDB format.

Parameters:

file_name : str = 'file_name.PDB'

File Name: The name of the file to load

usecolors : bool = True

Use Atoms colors: Atoms are colored according to atomic type

justpoints : bool = False

SURFACE: Atoms as Points: Atoms are created as points, no surface is built. Overrides all subsequential surface parameters

justspheres : bool = True

SURFACE: Atoms as Spheres: Atoms are created as intersecting spheres, no interpolation surface is built. Overrides all subsequential surface parameters

interpspheres : bool = False

SURFACE: Atoms as Jointed Spheres: Atoms are created as spheres, joining surface is built. Overrides all subsequential surface parameters

metaballs : bool = False

SURFACE: Atoms as Metaballs: Atoms are created as blobby interpolation surface, refer to BLINN Metaballs article. Overrides all subsequential surface parameters

voxelsize : float = 0.25

Surface Resolution: is used by Jointed Spheres and Metaball

blobby : float = 2

Blobbyness factor: is used by Metaball

ply

Load PLY format.

Parameters:

file_name : str = 'file_name.PLY'

File Name: The name of the file to load

pts

Load pts format.

Parameters:

file_name : str = 'file_name.pts'

File Name: The name of the file to load

ptx

Load PTX format.

Parameters:

file_name : str = 'file_name.PTX'

File Name: The name of the file to load

meshindex : int = 0

Index of Range Map to be Imported: PTX files may contain more than one range map. 0 is the first range map. If the number if higher than the actual mesh number, the import will fail

pointsonly : bool = True

Keep only points: Import points a point cloud only, with radius and normals, no triangulation involved, isolated points and points with normals with steep angles are removed.

usecolor : bool = True

import color: Read color from PTX, if color is not present, uses reflectance instead

flipfaces : bool = False

LEICA: flip normal direction: LEICA PTX exporter goes counterclockwise, FARO PTX exporter goes clockwise

pointcull : bool = True

delete unsampled points: Deletes unsampled points in the grid that are normally located in [0,0,0]

anglecull : bool = True

Cull faces by angle: short

angle : float = 85

Angle limit for face culling: short

qobj

Load QOBJ format.

Parameters:

file_name : str = 'file_name.QOBJ'

File Name: The name of the file to load

stl

Load STL format.

Parameters:

file_name : str = 'file_name.STL'

File Name: The name of the file to load

unify_vertices : bool = True

Unify Duplicated Vertices in STL files: The STL format is not an vertex-indexed format. Each triangle is composed by independent vertices, so, usually, duplicated vertices should be unified

tri

Load TRI format.

Parameters:

file_name : str = 'file_name.TRI'

File Name: The name of the file to load

txt

Load TXT format.

Parameters:

file_name : str = 'file_name.TXT'

File Name: The name of the file to load

rowtoskip : int = 0

Header Row to be skipped: The number of lines that must be skipped at the beginning of the file. Generally, these files have one or more 'header' lines, before the point list

strformat : str = 'X Y Z' (or int = 0)

Possible enum values:

0. 'X Y Z'
1. 'X Y Z Reflectance'
2. 'X Y Z Reflectance R G B'
3. 'X Y Z Reflectance Nx Ny Nz'
4. 'X Y Z Reflectance R G B Nx Ny Nz'
5. 'X Y Z Reflectance Nx Ny Nz R G B'
6. 'X Y Z R G B'
7. 'X Y Z R G B Reflectance'
8. 'X Y Z R G B Reflectance Nx Ny Nz'
9. 'X Y Z R G B Nx Ny Nz Reflectance'
10. 'X Y Z Nx Ny Nz'
11. 'X Y Z Nx Ny Nz R G B Reflectance'
12. 'X Y Z Nx Ny Nz Reflectance R G B'

Point format: Which values are specified for each point, and in which order.

separator : str = ';' (or int = 0)

Possible enum values:

0. ';'
1. ','
2. 'SPACE'

Separator: The separator between individual values in the point(s) description.

rgbmode : str = '[0-255]' (or int = 0)

Possible enum values:

0. '[0-255]'
1. '[0.0-1.0]'

Color format: Colors may be specified in the [0-255] or [0.0-1.0] interval.

onerror : str = 'skip' (or int = 0)

Possible enum values:

0. 'skip'
1. 'stop'

On Parsing Error: When a line is not properly parsed, it is possible to 'skip' it and continue with the following lines, or 'stop' importing at that point

vmi

Load VMI format.

Parameters:

file_name : str = 'file_name.VMI'

File Name: The name of the file to load

wrl

Load WRL format.

Parameters:

file_name : str = 'file_name.WRL'

File Name: The name of the file to load

x3d

Load X3D format.

Parameters:

file_name : str = 'file_name.X3D'

File Name: The name of the file to load

x3dv

Load X3DV format.

Parameters:

file_name : str = 'file_name.X3DV'

File Name: The name of the file to load

xyz

Load xyz format.

Parameters:

file_name : str = 'file_name.xyz'

File Name: The name of the file to load

save mesh parameters

Here are listed all the file formats that can be saved usingthe function pmeshlab.MeshSet.save_current_mesh(), with all the possible parameters that can be accepted by these functions.

3ds

Save 3DS format.

Parameters:

file_name : str = 'file_name.3DS'

File Name: The name of the file to save

save_face_color : bool = True

Save Face Color: Save Face Color

save_face_normal : bool = True

Save Face Normal: Save Face Normal

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

save_wedge_normal : bool = True

Save Wedge Normal: Save Wedge Normal

ctm

Save CTM format.

Parameters:

file_name : str = 'file_name.CTM'

File Name: The name of the file to save

lossless : bool = False

LossLess compression: If true it does not apply any lossy compression technique.

relativeprecisionparam : float = 0.0001

Relative Coord Precision: When using a lossy compression this number control the introduced error and hence the compression factor.It is a number relative to the average edge length. (e.g. the default means that the error should be roughly 1/10000 of the average edge length)

save_vertex_quality : bool = True

Save Vertex Quality: Save Vertex Quality

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

dae

Save DAE format.

Parameters:

file_name : str = 'file_name.DAE'

File Name: The name of the file to save

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_vertex_coord : bool = True

Save Vertex Coord: Save Vertex Coord

save_vertex_normal : bool = True

Save Vertex Normal: Save Vertex Normal

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

save_wedge_normal : bool = True

Save Wedge Normal: Save Wedge Normal

dxf

Save DXF format.

Parameters:

file_name : str = 'file_name.DXF'

File Name: The name of the file to save

idtf

Save IDTF format.

Parameters:

file_name : str = 'file_name.IDTF'

File Name: The name of the file to save

position_val : numpy.ndarray[numpy.float64[3]] = [0, 0, -1.73205]

Camera Position: The position in which the camera is set. The default value is derived by the 3d mesh's bounding box.

target_val : numpy.ndarray[numpy.float64[3]] = [0, 0, 0]

Camera target point: The point towards the camera is seeing. The default value is derived by the 3d mesh's bounding box.

fov_val : float = 60

Camera's FOV Angle 0..180: Camera's FOV Angle. The values' range is between 0-180 degree. The default value is 60.

compression_val : int = 500

U3D quality 0..1000: U3D mesh's compression ratio. The values' range is between 0-1000 degree. The default value is 500.

save_vertex_color : bool = False

Save Vertex Color: Save Vertex Color

save_vertex_normal : bool = False

Save Vertex Normal: Save Vertex Normal

save_face_color : bool = False

Save Face Color: Save Face Color

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

save_wedge_normal : bool = True

Save Wedge Normal: Save Wedge Normal

json

Save JSON format.

Parameters:

file_name : str = 'file_name.JSON'

File Name: The name of the file to save

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_vertex_coord : bool = True

Save Vertex Coord: Save Vertex Coord

save_vertex_normal : bool = True

Save Vertex Normal: Save Vertex Normal

obj

Save OBJ format.

Parameters:

file_name : str = 'file_name.OBJ'

File Name: The name of the file to save

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_vertex_coord : bool = True

Save Vertex Coord: Save Vertex Coord

save_vertex_normal : bool = True

Save Vertex Normal: Save Vertex Normal

save_face_color : bool = True

Save Face Color: Save Face Color

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

save_wedge_normal : bool = True

Save Wedge Normal: Save Wedge Normal

save_polygonal : bool = True

Save Polygonal: Save Polygonal

off

Save OFF format.

Parameters:

file_name : str = 'file_name.OFF'

File Name: The name of the file to save

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_vertex_coord : bool = True

Save Vertex Coord: Save Vertex Coord

save_face_color : bool = True

Save Face Color: Save Face Color

save_polygonal : bool = True

Save Polygonal: Save Polygonal

ply

Save PLY format.

Parameters:

file_name : str = 'file_name.PLY'

File Name: The name of the file to save

binary : bool = True

Binary encoding: Save the mesh using a binary encoding. If false the mesh is saved in a plain, readable ascii format.

save_vertex_quality : bool = True

Save Vertex Quality: Save Vertex Quality

save_vertex_flag : bool = False

Save Vertex Flag: Save Vertex Flag

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_vertex_coord : bool = True

Save Vertex Coord: Save Vertex Coord

save_vertex_normal : bool = False

Save Vertex Normal: Save Vertex Normal

save_vertex_radius : bool = True

Save Vertex Radius: Save Vertex Radius

save_face_quality : bool = True

Save Face Quality: Save Face Quality

save_face_flag : bool = False

Save Face Flag: Save Face Flag

save_face_color : bool = True

Save Face Color: Save Face Color

save_wedge_color : bool = True

Save Wedge Color: Save Wedge Color

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

save_wedge_normal : bool = True

Save Wedge Normal: Save Wedge Normal

stl

Save STL format.

Parameters:

file_name : str = 'file_name.STL'

File Name: The name of the file to save

binary : bool = True

Binary encoding: Save the mesh using a binary encoding. If false the mesh is saved in a plain, readable ascii format.

colormode : bool = True

Materialise Color Encoding: Save the color using a binary encoding according to the Materialise's Magic style (e.g. RGB coding instead of BGR coding).

save_face_color : bool = True

Save Face Color: Save Face Color

u3d

Save U3D format.

Parameters:

file_name : str = 'file_name.U3D'

File Name: The name of the file to save

position_val : numpy.ndarray[numpy.float64[3]] = [0, 0, -1.73205]

Camera Position: The position in which the camera is set. The default value is derived by the 3d mesh's bounding box.

target_val : numpy.ndarray[numpy.float64[3]] = [0, 0, 0]

Camera target point: The point towards the camera is seeing. The default value is derived by the 3d mesh's bounding box.

fov_val : float = 60

Camera's FOV Angle 0..180: Camera's FOV Angle. The values' range is between 0-180 degree. The default value is 60.

compression_val : int = 500

U3D quality 0..1000: U3D mesh's compression ratio. The values' range is between 0-1000 degree. The default value is 500.

save_vertex_color : bool = False

Save Vertex Color: Save Vertex Color

save_face_color : bool = False

Save Face Color: Save Face Color

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

wrl

Save WRL format.

Parameters:

file_name : str = 'file_name.WRL'

File Name: The name of the file to save

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_wedge_color : bool = True

Save Wedge Color: Save Wedge Color

save_wedge_texcoord : bool = True

Save Wedge TexCoord: Save Wedge TexCoord

x3d

Save X3D format.

Parameters:

file_name : str = 'file_name.X3D'

File Name: The name of the file to save

save_vertex_color : bool = True

Save Vertex Color: Save Vertex Color

save_vertex_coord : bool = True

Save Vertex Coord: Save Vertex Coord

save_vertex_normal : bool = True

Save Vertex Normal: Save Vertex Normal

save_face_color : bool = False

Save Face Color: Save Face Color

save_face_normal : bool = False

Save Face Normal: Save Face Normal

save_wedge_color : bool = False

Save Wedge Color: Save Wedge Color

save_wedge_texcoord : bool = False

Save Wedge TexCoord: Save Wedge TexCoord

save_wedge_normal : bool = False

Save Wedge Normal: Save Wedge Normal

xyz

Save xyz format.

Parameters:

file_name : str = 'file_name.xyz'

File Name: The name of the file to save

save_vertex_normal : bool = True

Save Vertex Normal: Save Vertex Normal

load raster parameters

Here are listed all the raster file formats that can be loaded usingthe functions pmeshlab.MeshSet.load_new_raster().

JPEG

Load JPEG format.

Parameters:

file_name : str = 'file_name.JPEG'

File Name: The name of the file to load

JPG

Load JPG format.

Parameters:

file_name : str = 'file_name.JPG'

File Name: The name of the file to load

PNG

Load PNG format.

Parameters:

file_name : str = 'file_name.PNG'

File Name: The name of the file to load

XPM

Load XPM format.

Parameters:

file_name : str = 'file_name.XPM'

File Name: The name of the file to load