Skip to content
Automatically exported from code.google.com/p/plunger
Python
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
plunger
tests
.cvsignore
.gitignore
AUTHORS
COPYING
ChangeLog
INSTALL
MANIFEST.in
NEWS
README
TODO
setup.py

README

                     **************************************
                     *               PLUNGER              *
                     *        A 3D mesh converter         *
                     **************************************

About
-----
Plunger is a Collada to client 3D format converter for the WorldForge project.
It is designed in a way that should allow adding new 3D formats in a simple
way.

It is still under development, but it will eventually support MD3, Sear's own
static mesh format, Cal3D and Ogre's mesh.xml format.

Currently, Plunger is in a alpha stage, so it might still delete all your data
and eat all the food in your fridge. Still, feedback and patches are greatly
appreciated.

Design goals
------------
    *  Plugin architecture to allow adding new formats.
    * Functionality separated from the user interface.

Supported formats
-----------------
    * Collada (50% done)
    * SearObject (100% done)
    * Ogre mesh.xml (100% done)
    * Cal3D XML (todo)
    * MD3 (50% done)

Usage
-----
Usage: plunger [options] <input name> <output name>
Possible options are:
--help              -h          Display this help text.
--debug             -d          Print debugging output.
--in=<format>       -i <format> Input file is in <format>  [default: collada]
--out=<format>      -o <format> Convert to <format>        [default: info]
--display-formats   -D          List supported input/output formats
--version           -V          Display plunger version

If infile or outfile is -, stdin/stout is used.

Installation
------------
See INSTALL for installation instructions.

Examples
--------

Display all supported formats

$ plunger --display-formats
Supported import formats: sear, collada, ogrexml
Supported export formats: info, collada, ogrexml, sear, md3
$

Convert a collada file to MD3

$ plunger -o md3 example.dae example.md3
$

Show information about a Sear object file on stdout

$ plunger -i sear example.sobj -
Lots of information
$

Pipe a collada file to OgreXMLConverter

$ cat example.dae | plunger -o ogrexml - - | OgreXMLConverter
$

You can’t perform that action at this time.