oomer/poomer-bella-sine
1
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
poomer-bella-sine/README.md
Harvey Fong abb3243e6f 2026 cleanup pass
2026-01-07 04:56:49 +00:00

2.9 KiB
Raw Blame History

poomer-bella-sine

Learning prototype cross-platform command line for Bella scene creation with sine wave.

Demonstrates

  • Auto camera framing of sine wave
  • Bella scene file writing
  • Using Diffuse Logic's logging
  • Using render event callbacks with EngineObserver override
  • Use of arguments
  • Adding quickmaterials to the scene
  • Shows how to wire node output ie belVoxelMat1["color"] |= belColor1.output("outColor");
  • Using both procedural Bella box and a mesh box modelled from Blender
  • Hiding boilerplate code like cube mesh and basic Bella scene population in .h files

Usage

poomer-bella-sine #generates a 100 voxel sine plot, output .bsa
poomer-bella-sine -n:1000 # plot 1000 voxels on sine curve
poomer-bella-sine -or:16 # render 16 frames of camera orbit
poomer-bella-sine -sa:60 # sets amplitude
poomer-bella-sine -sf:0.55 # sets sine frequency
poomer-bella-sine -cv:0.65 # sets color variation
poomer-bella-sine -em # sets one material per voxel plot with gradient
poomer-bella-sine -r # render current image
poomer-bella-sine -s:2 # set xfrom scale on voxels to double
poomer-bella-sine -sv # set xfrom scale on voxels using modulus
poomer-bella-sine -m:50 # set modulus event to occur every 50 voxels

[todo] add checks for illegal argument values

Build

workdir/
├── build_engine_sdk/
├── oom/
└── poomer-bella-sine/

Ubuntu Linux x64

sudo apt install -y build-essential 
mkdir workdir && cd workdir

# Install Bella SDK
wget https://downloads.bellarender.com/bella_engine_sdk-25.3.0-linux.tar.gz
tar -xvf  bella_engine_sdk-25.3.0.tar.gz

# Build poomer-bella-sine
git clone https://git.indoodle.com/oomer/oom.git
git clone https://git.indoodle.com/oomer/poomer-bella-sine.git
cd poomer-bella-sine
make all -j$(nproc)
bin/Linux/release/poomer-bella-sine -r
file ./untitled.png

MacOS x64

# Install xcode
xcode-select --install

mkdir workdir && cd workdir

# Install Bella SDK
curl -O https://downloads.bellarender.com/bella_engine_sdk-25.3.0-macos.zip
unzip bella_engine_sdk-25.3.0-macos.zip

# Build poomer-bella-sine
git clone https://git.indoodle.com/oomer/oom.git
git clone https://git.indoodle.com/oomer/poomer-bella-sine.git
cd poomer-bella-sine
make all -j4
bin/Darwin/release/poomer-bella-sine -r
open ./untitled.png

Windows x64

  • Download Visual Studio Community Edition
  • Run VisualStudioSetup.exe
  • Workload = [x] Desktop development with C++
  • Individual components = [x] Git For Windows

x64 Native Tools for VS

mkdir workdir && cd workdir

# Install Bella SDK
curl -O https://downloads.bellarender.com/bella_engine_sdk-25.3.0-win32.zip
tar -xf bella_engine_sdk-25.3.0-win32.zip

# Build poomer-bella-sine
git clone https://git.indoodle.com/oomer/oom.git
git clone https://git.indoodle.com/oomer/poomer-bella-sine.git
cd poomer-bella-sine
msbuild poomer-bella-sine.vcxproj /p:Configuration=release 
x64\release\poomer-bella-sine.exe -r
start ./untitled.png