OS Manuals

/usr/bin/exrmetrics

High dynamic-range image file format library

From openexr 3.5.3-r0 (os), captured 2026-11-05 by running exrmetrics --help (exit 0). permalink

Usage: exrmetrics [options] infile [infile2...] [-o outfile]
Read an OpenEXR image from infile, write an identical copy to outfile reporting time taken to read/write and file sizes.

Options:

  -o file                     file to write to. If no file specified, uses a memory buffer
                              note: file may be overwritten multiple times during tests

  -p n                        part number to copy, or "all" for all parts
                              default is "all"

  -m                          set to multi-threaded (system selected thread count)
  -t n                        Use a pool of n worker threads for processing files.
                              Default is single threaded (no thread pool)

  -l level                    set compression level for DWA, ZIP, ZSTD and LJ2K

  -z,--compression list       list of compression methods to test
                              (none/rle/zips/zip/piz/pxr24/b44/b44a/dwaa/dwab/htj2k256/htj2k32/lj2k/zstd,orig,all
                              default orig: retains original method)

  --convert                   shorthand options for writing a new file with no metrics:
                              -p all --time none --pixelmode orig --no-size --passes 1
                              change pixel data type/compression by specifying --pixelmode/-z after --convert

  --bench                     shorthand options for robust performance benchmarking:
                              -p all --compression all --time write,reread --passes 10 --type half,float --no-size --csv

  -16 rgba|all                [DEPRECATED] force 16 bit half float: either just RGBA, or all channels
                              Use --pixelmode half or --pixelmode mixed instead

  --pixelmode list            list of pixel data types to use (float,half,mixed,orig)
                              mixed uses half for RGBA, float for others. Default is 'orig'

  --time list                 comma separated list of operations to report timing for.
                              operations can be any of read,write,reread (use --time none for no timing)

  --no-size                   don't output size data

  --part-disk-size            Output the on-disk size of the data portion of each part in a multipart EXR file
                              (including chunk headers). File output (-o) is not supported when using this option

  --json                      print output as JSON dictionary (Default mode)

  --csv                       print output in csv mode. If passes>1, show median timing
                              default is JSON mode

  --passes num                write and re-read file num times (default 1)

  -h, --help                  print this message

  -v                          output progress messages

  --version                   print version information
[
]
Options (19)
OptionDescriptionSource
-o filefile to write to.help
-p npart number to copy, or "all" for all parts default is "all"help
-mset to multi-threaded (system selected thread count)help
-t nUse a pool of n worker threads for processing files.help
-l levelset compression level for DWA, ZIP, ZSTD and LJ2Khelp
-z, --compression listlist of compression methods to test (none/rle/zips/zip/piz/pxr24/b44/b44a/dwaa/dwab/htj2k256/htj2k32/lj2k/zstd,orig,all default orig: retains original method)help
--convertshorthand options for writing a new file with no metrics:help
--benchshorthand options for robust performance benchmarking:help
-16 rgba|all[DEPRECATED] force 16 bit half float: either just RGBA, or all channels Use --pixelmode half or --pixelmode mixed insteadhelp
--pixelmode listlist of pixel data types to use (float,half,mixed,orig) mixed uses half for RGBA, float for others.help
--time listcomma separated list of operations to report timing for.help
--no-sizedon't output size datahelp
--part-disk-sizeOutput the on-disk size of the data portion of each part in a multipart EXR file (including chunk headers).help
--jsonprint output as JSON dictionary (Default mode)help
--csvprint output in csv mode.help
--passes numwrite and re-read file num times (default 1)help
-h, --helpprint this messagehelp
-voutput progress messageshelp
--versionprint version informationhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.