Skip to content
Tool for manipulating mesh data using pycollada
Python
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
meshtool
.gitignore
AUTHORS
COPYING
README.md
setup.py

README.md

Installation

Release

pip install meshtool

Development

git clone git://github.com/pycollada/meshtool.git meshtool
cd meshtool
python meshtool --help

Optional Dependencies

Some visualization filters use Panda3D. To enable the filters, install version 1.7.2 of the Panda3D SDK from here: http://www.panda3d.org/download.php?sdk&version=1.7.2

Examples

$ python meshtool --load_collada duck.dae --print_textures
./duckCM.tga

Usage and Filter List

usage: meshtool --load_filter [--operation] [--save_filter]

Tool for manipulating mesh data using pycollada.

Loading:
  --load_collada file   Loads a collada file
  --load_obj file       Loads a Wavefront OBJ file

Printing:
  --print_textures      Prints a list of the embedded images in the mesh
  --print_render_info   Prints estimated number of batches, total number of
                        triangles, and total texture memory
  --print_json          Prints a bunch of information about the mesh in a JSON
                        format
  --print_info          Prints a bunch of information about the mesh to the
                        console
  --print_instances     Prints geometry instances from the default scene
  --print_scene         Prints the default scene tree
  --print_bounds        Prints bounds information about the mesh

Simplification:
  --sander_simplify pm_file
                        Simplifies the mesh based on sandler, et al. method.
  --add_back_pm pm_file percent
                        Adds back mesh data from a progressive PDAE file

Optimizations:
  --combine_effects     Combines identical effects
  --combine_materials   Combines identical materials
  --combine_primitives  Combines primitives within a geometry if they have the
                        same sources and scene material mapping (triangle sets
                        only)
  --strip_lines         Strips any lines from the document
  --strip_empty_geometry
                        Strips any empty geometry from the document and
                        removes them from any scenes
  --strip_unused_sources
                        Strips any source arrays from geometries if they
                        aren't referenced by any primitives
  --triangulate         Replaces any polylist or polygons with triangles
  --generate_normals    Generates normals for any triangle sets that don't
                        have any
  --save_mipmaps        Saves mipmaps to disk in tar format in the same
                        location as textures but with an added .tar. The
                        archive will contain PNG or JPG images.
  --optimize_textures   Converts all textures with alpha channel to PNG and
                        ones without to JPEG
  --adjust_texcoords    Adjusts texture coordinates of triangles so that they
                        are as close to the 0-1 range as possible
  --normalize_indices   Goes through all triangle sets, changing all index
                        values to go from 1 to N, replacing sources to be size
                        N
  --make_atlases        Makes a texture atlas with the textures referenced in
                        the given file. Extremely conservative: will only make
                        an atlas from texture coordinates inside the range
                        (0,1). Atlas can be saved with --save_collada_zip.
  --split_triangle_texcoords
                        Splits triangles that span multiple texcoords into
                        multiple triangles to better help texture atlasing
  --optimize_sources    Compresses sources to unique values, updating
                        triangleset indices

Visualizations:
  --viewer              Uses panda3d to bring up a viewer
  --collada_viewer      Uses panda3d to bring up a viewer with lights and
                        camera from the collada file
  --pm_viewer pm_file   Uses panda3d to bring up a viewer of a base mesh and
                        progressive stream

Meta:
  --medium_optimizations
                        A meta filter that runs a safe, medium-level of
                        optimizations. Performs these filters in this order:
                        triangulate, generate_normals, combine_effects,
                        combine_materials, combine_primitives,
                        optimize_sources, strip_unused_sources,
                        optimize_textures
  --full_optimizations  A meta filter that runs all optimizations. Performs
                        these filters in this order: triangulate,
                        generate_normals, combine_effects, combine_materials,
                        combine_primitives, adjust_texcoords,
                        optimize_textures, split_triangle_texcoords,
                        normalize_indices, make_atlases, combine_effects,
                        combine_materials, combine_primitives,
                        optimize_sourcesstrip_unused_sources,
                        optimize_textures

Saving:
  --save_screenshot file
                        Saves a screenshot of the rendered collada file
  --save_rotate_screenshots file N W H
                        Saves N screenshots of size WxH, rotating evenly
                        spaced around the object between shots. Each
                        screenshot file will be file.n.png
  --save_collada file   Saves a collada file
  --save_collada_zip file
                        Saves a collada file and textures in a zip file.
                        Normalizes texture paths.
  --save_badgerfish file
                        Saves a collada file as JSON badgerfish
  --save_ply file       Saves a collada model in PLY format
  --save_obj file       Saves a mesh as an OBJ file
  --save_obj_zip file   Saves an OBJ file and textures in a zip file.
                        Normalizes texture paths.
  --save_bam file       Saves to Panda3D BAM file format
  --save_threejs_scene file
                        Saves a collada model in three.js scene format
Something went wrong with that request. Please try again.