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

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 : bool = True

Unify Duplicated Vertices: The STL 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

meshlabiostlunifyvertices : 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

save_polygonal : bool = True

Save Polygonal: Save Polygonal

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