Repository files navigation

Ptex is a texture mapping system developed by Walt Disney Animation Studiosfor production-quality rendering:

• No UV assignment is required! Ptex applies a separate texture to each faceof a subdivision or polygon mesh.

• The Ptex file format can efficiently store hundreds of thousands of textureimages in a single file.

• The Ptex API provides cached file I/O and high-quality filtering -everything that is needed to easily add Ptex support to a production-qualityrenderer or texture authoring application.

Building with make (Linux):

make prefix=$PWD/installmake testmake installmake doc

The Makefile uses cmake under the hood.

This will build, install to a localinstall directory, andrun regression tests.

Documentation is only built if the following dependencies are installed:

• Doxygen
• Graphviz

install/bin:    ptxinfoinstall/include:    PtexHalf.h  PtexInt.h  Ptexture.h  PtexUtils.hinstall/lib:    libPtex.a  libPtex.so

Note: docs will be generated in thesrc/doc/ptex directoryand installed asinstall/share/doc/ptex.

• Ptex library
• Command-line utilities
• Test suite
• Documentation
• The Ptex website is developed in thegh-pages branch.

Unit tests are in thesrc/tests/ directory.

All tests are run by default when building the defaultall target.Usemake test to run the tests directly.

Theflags variable can be used to forward flags toctest.For example, to run just thehalf tests:

    make test flags='-R half'

Ptex's build scripts will use a hardcoded version number that may or may notmatch the tagged version number when Ptex is built from a tarball instead offrom a git worktree.

This version be overriden by placing a file calledversion at the root ofthe source tree containing the desired version number.

For example, the following command will generate a version file that will beused by the build in lieu of git tags and thePTEX_VER cmake variable:

echo v2.3.2 >version

Before creating new minor version releases, run:

    ./src/tests/check_version --update vX.Y

check_version.sh updates the defaultPTEX_VER version inCMakeLists.txtwith the specified minor version number.

Running./src/tests/check_version.sh without any arguments will warn whenthe git tags do not match the default version.

Thegh-pages branch contains theptex.us website. When new release arecreated add an entry tobuildsite.py and run the script to update the site.