wf2fmem

Wavefront .obj (3D model) to FPGA memory init file converter for use with Verilog $readmemh(). Written in Python 3.

Turns triangular and quad faces into 8-bit line coordinates suitable for simple 3D drawing with an FPGA.

Example projects using this tool:

Licensed under the MIT License. See the LICENSE file for details.

Usage

wf2fmem.py model_file size offset

model_file - source model file name
size - maximum size in pixels for output (16-255)
offset - offset from screen edge in pixels for output. size+offset must be 255 or less.

Example:

wf2fmem.py test/icosphere.obj 220 8

Converts the icosphere model file with a maximum pixel dimensions of 220 and an offset of 8 pixels from the edge of the screen.

For advice on working with Verilog .mem files, see Initialize Memory in Verilog.

The output consist of a 48-bit hex string per model line, for example 41D39782D3AC.

You can turn this into 8-bit coordinates like this:

{x0,y0,z0,x1,y1,z1} <= data;

The output will contain duplicates, as most lines are part of more than one face.

You can fix this with the UN*X sort and uniq commands. For example:

wf2fmem.py test/icosphere.obj 220 8 | sort | uniq > test/icosphere.mem