ImageConverter
The ImageConverter class is the main interface for converting RAW images to ACES format.
It provides a high-level API that handles the entire conversion pipeline.
Overview
The ImageConverter class encapsulates the complete RAW-to-ACES conversion workflow:
Configure white balance and color matrix methods
Load the RAW image
Apply color transformations
Apply exposure scaling and cropping
Save the ACES container output
Basic Usage
Pass the path to a supported RAW file as the first argument to this program.
It writes <input_stem>_aces.exr beside the input file.
#include <rawtoaces/image_converter.h>
#include <iostream>
int main(int argc, char **argv)
{
if (argc != 2)
{
std::cerr << "Usage: convert <INPUT_PATH>\n";
return 1;
}
const std::string input_path = argv[1];
rta::util::ImageConverter converter;
converter.settings.WB_method = rta::util::ImageConverter::Settings::WBMethod::Metadata;
converter.settings.matrix_method = rta::util::ImageConverter::Settings::MatrixMethod::Auto;
if (!converter.process_image(input_path))
{
std::cerr << converter.last_error_message << '\n';
return 1;
}
return 0;
}
Output Scaling
Pixel values are multiplied by settings.headroom * settings.scale.
headroom is a linear factor (default 6.0). Doubling headroom is
equivalent to adding one exposure stop. An adjustment of s stops
corresponds to multiplying the factor by std::pow(2.0, s).
OpenImageIO buffers
ImageConverter can also run the same pipeline on OpenImageIO buffers.
configure reads metadata and prepares decoding hints. load_image fills
an OIIO::ImageBuf. process_buffer applies lens correction, the colour
matrix, scale, and crop; those steps are also available individually.
save_image writes the ACES container.
These C++ methods are part of rawtoaces_util. The matching Python methods
require OpenImageIO 3.2 or later; see OpenImageIO 3.2. Signatures
are in the
C++ Reference. The API overview
says when the buffer layer is the right choice.