Skip to content

Latest commit

 

History

History
56 lines (42 loc) · 2.04 KB

README.md

File metadata and controls

56 lines (42 loc) · 2.04 KB
Raw

P3diTools

Tools for manipulating and compiling p3di models

Creating p3di models

Use the Blender export addon.

Blender conventions

  • Up is +Z. This is converted to +Y during compilation.
  • Forward is +Y. This is converted to +Z during compilation.
  • One pixel is 0.1m (10cm).
  • The name of the Object becomes the name of the submesh.
  • All Objects must have their rotation and scale transformations applied (Ctrl+A, Rotation & Scale) before export.
    • The origin of an Object becomes the rotation point of a submesh in a compiled model.
  • Sockets are defined by adding Empties of type Arrows (Add, Empty, Arrows).
    • The name of the Empty becomes the name of the socket.
    • The axes as drawn directly correspond to the local coordinate space of the ingame object.
  • Objects may use the scene hierarchy to define rotation-based parenting.
    • This applies to both Empties (sockets) and Objects (submeshes).

Compiling p3di models into p3d models and p3dr rigs

Download the latest release and run P3diTools compile --help

Example command:

P3diTools compile -mrs my_model.p3di

Generates the following output files in the working directory:

  • my_model.p3d
  • my_model.p3dr

Breakdown

  • The compile tool
  • The option chain -mrs
    • m option generates a model
    • r option generates a rig
    • s option snaps pixels to the grid using the default resolution of 128x and epsilon of 0.1 (Run P3diTools compile --help for all options)
  • The input file my_model.p3di

Generating a texture map

P3diTools genmap -r 128 my_model.p3di map.png
  • The genmap tool
  • The option chain -r 128
    • r 128 option option sets a texture resolution of 128x128
  • The input file my_model.p3di
  • The output file map.png

UV vertex snapping is also available for genmap. Run P3diTools genmap --help for all options.