Convert a single image

Convert one RAW file to an ACES EXR with rta::util::ImageConverter::process_image() or rawtoaces.ImageConverter.process_image().

The examples set soft crop, so the full sensor is written and the crop is stored as the display window. That matches the command-line default. The C++ and Python APIs would otherwise write only the crop rectangle. White balance stays on file metadata, the matrix method stays auto, headroom stays 6, and scale stays 1. Pixel values are multiplied by headroom * scale.

The output is <stem>_aces.exr beside the input. For photo.dng that is photo_aces.exr in the same directory. overwrite stays false, so an existing output makes the call fail and the file is left unchanged. create_dirs is not involved.

A failed command exits non-zero and prints the reason. C++ and Python return false and set status and last_error_message. DNG is the format that carries the calibration used by the metadata white balance.

rawtoaces --crop-mode soft photo.dng

See also white balance and matrix, batch conversion, errors, and the API overview.