oces_viewer

A reader library module oces::reader and a couple of programs for reading Open Compound Eye Standard (OCES) files.

• oces2cray Opens an OCES file and outputs the ommatidia data in libcompound-ray eye file format to stdout
• oces_viewer Opens an OCES file and visualizes the eye and head.

Getting the code

Clone this repo from github with submodules.

git clone git@github.com:sebsjames/oces_viewer
cd oces_viewer
git submodule init
git submodule update

The submodules are: sebsjames/mathplot, sebsjames/maths, args and tinygltf.

Build tools

To compile oces_viewer, you need:

• clang-20 or higher.
• cmake version 3.28.5 or higher. Either apt install cmake on Ubuntu 25+ or download and build cmake from the cmake.org download page (it's an easy, reliable compile).
• ninja (apt install ninja-build)

Build

Do a cmake build

cd oces_viewer
mkdir build
pushd build
CC=clang-20 CXX=clang++-20 cmake .. -GNinja
make
popd

Run the program

To see command line options:

./build/oces_viewer -h

To view the velox-head data:

./build/oces_viewer -f data/velox-head.gltf -r 0.0002 -c -0.00056,0.00005,-0.00005 -x1,0,0 -o0.2 -s -y