File output options determine the format in which rendered images are written, and how frequently they are written. Depending on the compilation options used, available file output options vary.
Output color depth of 8 or 16 bits of precision per color channel can be specified, for 24-bit or 48-bit color, respectively.
If ALE has been built with ImageMagick support, then the output file type can
be determined automatically by file extension. This is the default behavior
for ImageMagick builds. The --auto
flag explicitly specifies that
the default behavior should be used; it generates an error on builds compiled
without ImageMagick support.
All builds of ALE support PPM output. PPM can be written in plain (ASCII) or raw (binary) format. If ALE has been built without ImageMagick support, or if the file type cannot be automatically determined by file extension, then raw PPM output is used by default.
By default, ALE writes intermediate results periodically throughout the rendering process. This behavior can be disabled, however, so that output is written only after rendering is complete.
By default, ALE colors undefined values black. To assign nearest-neighbor colors
to undefined pixels, the --def-nn
option can be used.