$ git clone https://github.com/johsteffens/beth
$ git clone https://github.com/johsteffens/actinon
$ cd actinon
$ make
# Run a quick rendering:
$ bin/actinon src_acn/primitives.acn
# Display result using gThumb:
$ gthumb src_acn/primitives.acn.pnm
Actinon is a lightweight ray-tracing renderer and interpreter of a dedicated scripting language. It can render 3D scenes, employing techniques like distributed tracing, path tracing, anti-aliasing and others. It can handle transparency, reflection, refraction, media-transition, diffuse-light, indirect-light and more. Various realistic surfaces are achieved by mixing fresnel-reflection, chromatic-reflection, (Oren-Nayar) diffuse-reflection and by simulating surface roughness. The rendering-engine is multi-threaded.
For scene-design a special language has been developed. It supports the composition of complex objects from simpler objects. Geometric operations on objects like translation, scaling and rotations can be applied easily and intuitively. Vectors and matrices have dedicated types with associated operators supporting arithmetic in a 3D vector space. The language also allows computing image sequences (e.g. for videos).
Actinon is based on project beth.
Actinon is a console-application. It takes a text-source file as argument and executes its content, which normally comprises of the scene design, virtual camera specifications, render specifications and instructions how to render one or more images.
It will render the image in multiple passes, gradually improving quality. After each pass, the image file is updated such that progress can be monitored with an external image-viewing tool.
- Pick a source file from folder src_acn. Maybe wine_glass.acn.
- Run in a terminal:
actinon wine_glass.acn - After 1 ... 2 minutes, it will produce the image file
wine_glass.acn.pnm. The file gets updated at intervals, gradually improving image-quality. After around 20 ... 60 min (depending on CPU speed), rendering should be completed. Interrupt any time with Ctl-C, which will save an intermediate result and terminate. You can resume from an incomplete image later. - You may want to convert the image to a more common format with netpbm or similar tool (e.g.
pnmtopng). - A nice tool to view the image is gThumb.
- Learn a bit about the Actinon Language: For the time being, you might want to glean some insight by examining wine_glass.acn, which is inline-commented for that purpose.
- Experiment with provided scenes or design your own scene.
- Tip: While drafting and testing your scene, switch off path tracing
path_samples = 0and setdirect_samplesto a low value. E.g.direct_samples = 10. This will yield results in seconds.
The source code in this repository, including actinon source code, is licensed under the Apache 2.0 License. Images in this repository, depicting results of the raytracer, are licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. Images or videos you created with actinon from your own script sources are yours.
One objective is demonstrating the capabilities of project 'beth', which is a foundation-library to develop advanced applications in 'C'.
I've always been fascinated by computer graphics. Particularly combining physics, mathematics and creativity to achieve realism. In the mid 1990s I experimented with algorithms using Lambertian light distribution on rays casted in a virtual 3D scene. Back then I was not even aware that the technique was well-known under the label "ray-tracing". Today, modern workstations are powerful enough to allow deep recursions into the rendering equation, making experimenting in this field even more rewarding.
Actinon is the name of the Radon-219 isotope, which is a radioactive gas. As project-name, it was inspired by a train of thought: ray-tracing -> radiation -> radon -> actinon.