Skip to content

ProtoTracer Helper Tools

ProtoTracer Helper Tools

Section titled “ProtoTracer Helper Tools”

The ProtoTracer-Helpers repository provides Python scripts that convert various file formats into ProtoTracer-compatible C++ header files.

Available Tools

Section titled “Available Tools”

Camera Creator

Section titled “Camera Creator”

Generates C++ arrays of Vector2D pixel coordinates from CSV files.

Terminal window
python Camera-Creator.py input.csv output.h

Input: CSV file with pixel coordinates
Output: C++ header with Vector2D array

FBX Converter

Section titled “FBX Converter”

Converts Autodesk FBX files to ProtoTracer 3D format with blendshape support.

Terminal window
python FBX-Converter.py model.fbx ProtoTracerModel.h

Input: .fbx file (Autodesk FBX format)
Output: C++ header with 3D geometry and blendshapes

OBJ Converter

Section titled “OBJ Converter”

Converts Wavefront OBJ files to ProtoTracer 3D format with material support.

Terminal window
python OBJ-Converter.py model.obj ProtoTracerModel.h

Input: .obj file (Wavefront OBJ format)
Output: C++ header with 3D geometry and materials

GIF Converter

Section titled “GIF Converter”

Converts animated GIFs to ProtoTracer animated material format.

Terminal window
python GIF-Converter.py animation.gif AnimatedMaterial.h

Input: .gif file (animated GIF)
Output: C++ header with animated frame data

Use this for:

  • Animated textures
  • Looping background effects
  • Simple sprite animations

Image Converter

Section titled “Image Converter”

Converts static images to ProtoTracer material format.

Terminal window
python Image-Converter.py texture.png StaticMaterial.h

Input: Image file (.png, .jpg, .bmp, etc.)
Output: C++ header with static material data

Installation & Usage

Section titled “Installation & Usage”

  1. Clone the repository:

    Terminal window
    git clone https://github.com/coelacant1/ProtoTracer-Helpers.git

  2. Install Python 3 if not already installed

  3. Navigate to the tool folder you need:

    Terminal window
    cd ProtoTracer-Helpers/FBX-Converter

  4. Run the converter:

    Terminal window
    python FBX-Converter.py your-model.fbx Output.h

  5. Include the generated header in your ProtoTracer project

Workflow Example

Section titled “Workflow Example”

Creating a Custom Protogen Face

Section titled “Creating a Custom Protogen Face”
  1. Model your face in Blender with blendshapes for expressions
  2. Export as FBX with blendshapes enabled
  3. Convert to header file:
    Terminal window
    python FBX-Converter.py MyProtogenFace.fbx MyProtogenFace.h
  4. Include in ProtoTracer and reference in your project code

License

Section titled “License”

ProtoTracer Helpers is licensed under AGPL-3.0. Modifications must be shared publicly if distributed.

View Repository