No vtf: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
(no_vtf v5.1.1)
 
(29 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{stub}}{{DISPLAYTITLE:no_vtf}}
{{stub}}{{DISPLAYTITLE:no_vtf}}
'''no_vtf''' is an open source alternative to [[VTF2TGA]]. Unlike its first-party counterpart, it also supports converting [[VTF]]s to [[PNG]], [[Wikipedia:TIFF|TIFF]], and [[Wikipedia:OpenEXR|EXR]], and can also decompress [[VTF#HDR compression|compressed HDR]] skybox textures.
{{SoftwareBox
{{tip|Compressed HDR textures are automatically detected by the presence of the string "hdr" near the end of the filename.}}


== Help text ==
<!-- Basic info -->
{{License|type=lgpl|version=3}} Help from no_vtf run without an input file:
| title = no_vtf
{{codeblock|<!--
--><nowiki>Usage: no_vtf [OPTIONS] PATH...


  Convert Valve Texture Format files into standard image files.
<!-- Details -->
| developer = {{u|B5327157}}
| initial_release = Apr 8, 2022
| stable_release = Jun 14, 2025 (v5.1.1)
| written_in = python
| type = Texture converter
| distribution = Free and open-source
| website = [https://git.sr.ht/~b5327157/no_vtf/ Homepage]<br>[https://pypi.org/project/no-vtf/ PyPI]


  PATH can be either file, or directory (in which case it is recursively
<!-- Operating system(s)-->
  searched for .vtf files, symbolic links are not followed). Multiple paths
| linux = 1
  may be provided.
| windows = 1
| macos = 1


  As the output path, it is possible to specify either file or directory.
<!-- Target engine(s)-->
| source = 1


  Specifying the output file is useful mostly for single-file conversions,
}}
  with filters to ensure only a single image will be written.
{{SoftwareBox


  If the output directory is not specified, images are output into the source
<!-- Basic info -->
  directories. Otherwise, directory tree for any found files will be
| title = no_vtf-desktop
  reconstructed in the chosen directory.


  Output LDR/HDR format is selected by its common file name extension. Special
<!-- Details -->
  formats: "raw" to write the high resolution image data as-is; "skip" to skip
| initial_release = Oct 6, 2023
  the write step entirely.
| stable_release = Dec 13, 2024 (v0.1.4)
| type = Desktop integration
| distribution = Free and open-source
| website = [https://git.sr.ht/~b5327157/no_vtf-desktop Homepage]<br>[https://pypi.org/project/no-vtf-desktop/ PyPI]


  For supported formats, compression is controlled when saving the image.
<!-- Operating system(s)-->
  Lossless compression is enabled by default. Lossy compression is not used.
| linux = 1


  The BGRA8888 format can store both LDR and compressed HDR images. The
}}
  specific type is either auto-detected by looking at the input file name
{{no_vtf|3}} is an open source alternative to {{vtf2tga|4}}. Unlike its first-party counterpart, it also supports converting [[VTF]]s to [[PNG]], [[Wikipedia:TIFF|TIFF]], and [[Wikipedia:OpenEXR|EXR]], and can also decompress [[VTF#HDR compression|compressed HDR]] skybox textures.
  (roughly, if it contains "hdr" near the end), or can be set manually.
{{tip|Compressed HDR textures are automatically detected by the presence of the string "hdr" near the end of the filename.}}


  It is possible to filter images to convert by min/max resolution (width &
== Help text ==
  height), and by frames/faces/slices. The former supports exact or closest
{{License|type=lgpl|version=3}} Help from no_vtf run without an input file:
  match. The latter supports selection by single index or via Python slicing:
{{codeblock|
  https://python-reference.readthedocs.io/en/latest/docs/brackets/slicing.html
Usage: '''{{font color|{{no vtf|col}}|no_vtf}} {{font color|lightgray|[OPTIONS] [--] PATH...}}'''<br>
 
&nbsp;&nbsp;Convert Valve Texture Format files into standard image files.<br>
  Face index mapping: right (0), left, back, front, up, down, sphere map (6).
&nbsp;&nbsp;PATH can be either a file or a directory (in which case it is recursively
 
&nbsp;&nbsp;searched for .vtf files; symbolic links are not followed). Multiple paths
  After applying filters, only the highest-resolution mipmap is converted by
&nbsp;&nbsp;may be provided.<br>
  default. Alternatively, all mipmaps of the high-resolution image can be
&nbsp;&nbsp;As the output path, it is possible to specify either a file or a directory.<br>
  converted.
&nbsp;&nbsp;Specifying the output file is useful mostly for single-file conversions,
 
&nbsp;&nbsp;with filters to ensure the output file will be written only once.<br>
  Animated textures have frames converted into individual images by default.
&nbsp;&nbsp;If the output directory is not specified, images are output into the source
  They can also be converted into an animated image file. When the latter is
&nbsp;&nbsp;directories (in-place conversion). Otherwise, the directory tree for any
  chosen, APNG is used as the default LDR image format instead of TIFF.
&nbsp;&nbsp;found files will be reconstructed in the chosen directory.<br>
 
&nbsp;&nbsp;Output LDR/HDR format is selected by its common file name extension. It is
  The RGB/L and A channels are packed into one file by default. When output
&nbsp;&nbsp;recommended selecting one of the specifically supported image formats (PNG,
  separately, resulting file names will be suffixed with "_rgb", "_l" or "_a".
&nbsp;&nbsp;APNG, TGA, TIFF, EXR). Other image formats have not been validated to work,
 
&nbsp;&nbsp;but can still be selected. A secondary format specifically used to output
  By default, image files are only written if they do not exist already.
&nbsp;&nbsp;animated image files can be selected after &apos;&#124;&apos; (see default LDR format as an
  Alternatively, they can be overwritten, or writing can be disabled entirely.
&nbsp;&nbsp;example). The &quot;skip&quot; format can be used to skip the R/W step entirely.<br>
 
&nbsp;&nbsp;For the specifically supported image formats, compression is configurable
  Images can be also read back to verify they have been written properly.
&nbsp;&nbsp;when saving the image. Lossless compression is enabled by default. Lossy
  Readback will error if data to be written do not match what is in the file.
&nbsp;&nbsp;compression is not used.<br>
 
&nbsp;&nbsp;The BGRA8888 format can store both LDR and compressed HDR images. The
  Worker is spawned for each logical core to run the conversion in parallel.
&nbsp;&nbsp;specific type is either auto-detected by looking at the input file name
  Number of workers can be overridden. If set to 1, conversion is sequential.
&nbsp;&nbsp;(roughly, if it contains &quot;hdr&quot; near the end), or can be set manually.<br>
 
&nbsp;&nbsp;It is possible to filter images to convert by min/max resolution (width &amp;
  Exit status: Zero if all went successfully, non-zero if there was an error.
&nbsp;&nbsp;height), and by frames/faces/slices. The former supports exact or closest
  Upon a recoverable error, conversion will proceed with the next file.
&nbsp;&nbsp;match. The latter supports selection by single index or via Python slicing:
 
&nbsp;&nbsp;https://python-reference.readthedocs.io/en/latest/docs/brackets/slicing.html
Options:
&nbsp;&nbsp;It is also possible to specify multiple indices/slices separated by commas.<br>
  -o, --output-dir DIRECTORY     Output directory
&nbsp;&nbsp;Face index mapping: right (0), left, back, front, up, down, sphere map (6).<br>
  --output-file FILE              Output file
&nbsp;&nbsp;After applying filters, only the highest-resolution mipmap is converted by
  -l, --ldr-format TEXT          LDR output format [default: tiff|apng]
&nbsp;&nbsp;default. Alternatively, all mipmaps of the high-resolution image can be
  -h, --hdr-format TEXT          HDR output format  [default: exr]
&nbsp;&nbsp;converted.<br>
  -d, --dynamic-range [ldr|hdr]  Override LDR/HDR auto-detection
&nbsp;&nbsp;Animated textures are converted into an animated multi-frame image file by
  -m, --mipmaps                  Extract all mipmaps
&nbsp;&nbsp;default. Alternatively, they can also be converted into single-frame images
  --min-resolution INTEGER       Minimum mipmap resolution  [x>=1]
&nbsp;&nbsp;when animation is disabled.<br>
  --max-resolution INTEGER       Maximum mipmap resolution  [x>=1]
&nbsp;&nbsp;The RGB/L and A channels are packed into one file by default. When output
  --closest-resolution           Fallback to closest resolution if no exact
&nbsp;&nbsp;separately, resulting file names will be suffixed with &quot;_rgb&quot;, &quot;_l&quot;, or
                                  match
&nbsp;&nbsp;&quot;_a&quot;.<br>
  --frames INDEX|[START]:[STOP][:STEP]
&nbsp;&nbsp;By default, image files are only written if they do not exist already.
                                  Frames to extract
&nbsp;&nbsp;Alternatively, they can be overwritten, or writing can be disabled entirely.<br>
  --faces INDEX|[START]:[STOP][:STEP]
&nbsp;&nbsp;Images can also be read back to verify they have been written properly.
                                  Faces to extract
&nbsp;&nbsp;Readback will error if would-be-written data does not match what is in the
  --slices INDEX|[START]:[STOP][:STEP]
&nbsp;&nbsp;file.<br>
                                  Slices to extract
&nbsp;&nbsp;Workers are spawned for each logical core to run the conversion in parallel.
  -a, --animate                  Output animated image file instead of
&nbsp;&nbsp;The number of workers can be overridden. If set to 1, conversion is
                                  writing each frame individually
&nbsp;&nbsp;sequential. Sequential conversion enables more verbose errors to be printed.<br>
  -F, --fps INTEGER              Frame rate used for animated image files
&nbsp;&nbsp;Exit status: Zero if all went successfully, non-zero if there was an error.
                                  [default: 5]
&nbsp;&nbsp;Upon a recoverable error, conversion will proceed with the next file.<br>
  -s, --separate-channels         Output the RGB/L and A channels separately
<u>Options</u>:
  -O, --overbright-factor FLOAT  Multiplicative factor used for decoding
&nbsp;&nbsp;{{font color|#D78700|'''Conversion mode: '''}}
                                  compressed HDR textures  [default: 16.0]
&nbsp;&nbsp;&nbsp;&nbsp;--animate / --no-animate     Output animated image file (default) /
  --compress / --no-compress     Control lossless compression
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;output each frame individually
  --always-write / --no-write     Write images
&nbsp;&nbsp;&nbsp;&nbsp;--raw                        Extract image data as-is (without decoding)<br>
  --readback / --no-readback     Readback images
{{font color|#D78700|''' Extraction: '''}}
  --num-workers INTEGER           Number of workers for parallel conversion
&nbsp;&nbsp;&nbsp;&nbsp;-m, --mipmaps                Extract all mipmaps
                                  [x>=1]
&nbsp;&nbsp;&nbsp;&nbsp;--low-res-img                Extract the low-resolution image
  --no-progress                   Do not show the progress bar
&nbsp;&nbsp;&nbsp;&nbsp;--min-resolution INTEGER     Minimum mipmap resolution  {{font color|gray|&#91;x&gt;&#61;1&#93;}}
  --version                      Show the version and exit.
&nbsp;&nbsp;&nbsp;&nbsp;--max-resolution INTEGER     Maximum mipmap resolution  {{font color|gray|&#91;x&gt;&#61;1&#93;}}
  --credits                      Show the credits and exit.
&nbsp;&nbsp;&nbsp;&nbsp;--closest-resolution         Fallback to the closest resolution if no
  --help                          Show this message and exit.
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;exact match
</nowiki>}}
&nbsp;&nbsp;&nbsp;&nbsp;--frames INDEX&#124;&#91;START&#93;:&#91;STOP&#93;&#91;:STEP&#93;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Frames to extract
&nbsp;&nbsp;&nbsp;&nbsp;--faces INDEX&#124;&#91;START&#93;:&#91;STOP&#93;&#91;:STEP&#93;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Faces to extract
&nbsp;&nbsp;&nbsp;&nbsp;--slices INDEX&#124;&#91;START&#93;:&#91;STOP&#93;&#91;:STEP&#93;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Slices to extract<br>
{{font color|#D78700|'''  Image decoding (not used with --raw): '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--dynamic-range &#91;ldr&#124;hdr&#93;    Override LDR/HDR auto-detection
&nbsp;&nbsp;&nbsp;&nbsp;--overbright-factor FLOAT    Multiplicative factor used for decoding
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;compressed HDR textures  &#91;default: 16.0&#93;<br>
{{font color|#D78700|'''  Image postprocessing (not used with --raw): '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--hdr-to-ldr                  Convert HDR from linear sRGB to sRGB and
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;output as clipped LDR
&nbsp;&nbsp;&nbsp;&nbsp;--separate-channels           Output the RGB/L and A channels separately<br>
{{font color|#D78700|'''  Image output (not used with --raw): '''}}
&nbsp;&nbsp;&nbsp;&nbsp;-f, --ldr-format SINGLE&#91;&#124;MULTI&#93;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LDR output format  &#91;default: tiff&#124;apng&#93;
&nbsp;&nbsp;&nbsp;&nbsp;-F, --hdr-format SINGLE&#91;&#124;MULTI&#93;
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;HDR output format  &#91;default: exr&#93;
&nbsp;&nbsp;&nbsp;&nbsp;--fps INTEGER                Frame rate used for animated image files
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#91;default: 5&#93;
&nbsp;&nbsp;&nbsp;&nbsp;--compress / --no-compress   Control lossless compression<br>
{{font color|#D78700|'''  Read/write control: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--always-write / --no-write   Write images
&nbsp;&nbsp;&nbsp;&nbsp;--readback / --no-readback   Readback images<br>
{{font color|#D78700|'''  Output destination: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;-o, --output-dir PATH        Output directory
&nbsp;&nbsp;&nbsp;&nbsp;-O, --output-file PATH        Output file<br>
{{font color|#D78700|'''  Miscellaneous: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--num-workers INTEGER         Number of workers for parallel conversion
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;{{font color|gray|&#91;x&gt;&#61;1&#93;}}
&nbsp;&nbsp;&nbsp;&nbsp;--no-progress                 Do not show the progress bar<br>
{{font color|#D78700|'''  Info: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--shell-completion &#91;SHELL&#93;    Setup shell completion.
&nbsp;&nbsp;&nbsp;&nbsp;-h, --help                    Show this message and exit.
&nbsp;&nbsp;&nbsp;&nbsp;--version                    Show the version and exit.
&nbsp;&nbsp;&nbsp;&nbsp;--credits                    Show the credits and exit.
&#8203;
}}


== See Also ==
== See also ==
* [[VTF2TGA]]
* {{vtf2tga|4}}
* [[VTFEdit]]
* {{vtfedit|4}}
* {{vtfeditrld|4}}


== External Links ==
== External links ==
* [https://sr.ht/~b5327157/no_vtf/ Download]
* [https://git.sr.ht/~b5327157/no_vtf/#application-bundle Download]


{{sdktools|cat=0|0}}
{{sdktools|cat=0|0}}
[[Category:Material System]][[Category:Third Party Tools]]
[[Category:Material System]][[Category:Third Party Tools]]

Latest revision as of 13:58, 14 June 2025

Stub

This article or section is a stub. You can help by expanding it.

no_vtf
Developer(s)
Initial release
Apr 8, 2022
Stable release
Jun 14, 2025 (v5.1.1)
Written in
Python
Operating system
Windows MacOS Linux
Type
Texture converter
Target engine(s)
Source
Distribution
Free and open-source
Website
no_vtf-desktop
Initial release
Oct 6, 2023
Stable release
Dec 13, 2024 (v0.1.4)
Operating system
Linux
Type
Desktop integration
Distribution
Free and open-source
Website

no_vtf is an open source alternative to VTF2TGA VTF2TGA. Unlike its first-party counterpart, it also supports converting VTFs to PNG, TIFF, and EXR, and can also decompress compressed HDR skybox textures.

Tip.pngTip:Compressed HDR textures are automatically detected by the presence of the string "hdr" near the end of the filename.

Help text

Help from no_vtf run without an input file:

Usage: no_vtf [OPTIONS] [--] PATH...

  Convert Valve Texture Format files into standard image files.
  PATH can be either a file or a directory (in which case it is recursively   searched for .vtf files; symbolic links are not followed). Multiple paths   may be provided.
  As the output path, it is possible to specify either a file or a directory.
  Specifying the output file is useful mostly for single-file conversions,   with filters to ensure the output file will be written only once.
  If the output directory is not specified, images are output into the source   directories (in-place conversion). Otherwise, the directory tree for any   found files will be reconstructed in the chosen directory.
  Output LDR/HDR format is selected by its common file name extension. It is   recommended selecting one of the specifically supported image formats (PNG,   APNG, TGA, TIFF, EXR). Other image formats have not been validated to work,   but can still be selected. A secondary format specifically used to output   animated image files can be selected after '|' (see default LDR format as an   example). The "skip" format can be used to skip the R/W step entirely.
  For the specifically supported image formats, compression is configurable   when saving the image. Lossless compression is enabled by default. Lossy   compression is not used.
  The BGRA8888 format can store both LDR and compressed HDR images. The   specific type is either auto-detected by looking at the input file name   (roughly, if it contains "hdr" near the end), or can be set manually.
  It is possible to filter images to convert by min/max resolution (width &   height), and by frames/faces/slices. The former supports exact or closest   match. The latter supports selection by single index or via Python slicing:   https://python-reference.readthedocs.io/en/latest/docs/brackets/slicing.html   It is also possible to specify multiple indices/slices separated by commas.
  Face index mapping: right (0), left, back, front, up, down, sphere map (6).
  After applying filters, only the highest-resolution mipmap is converted by   default. Alternatively, all mipmaps of the high-resolution image can be   converted.
  Animated textures are converted into an animated multi-frame image file by   default. Alternatively, they can also be converted into single-frame images   when animation is disabled.
  The RGB/L and A channels are packed into one file by default. When output   separately, resulting file names will be suffixed with "_rgb", "_l", or   "_a".
  By default, image files are only written if they do not exist already.   Alternatively, they can be overwritten, or writing can be disabled entirely.
  Images can also be read back to verify they have been written properly.   Readback will error if would-be-written data does not match what is in the   file.
  Workers are spawned for each logical core to run the conversion in parallel.   The number of workers can be overridden. If set to 1, conversion is   sequential. Sequential conversion enables more verbose errors to be printed.
  Exit status: Zero if all went successfully, non-zero if there was an error.   Upon a recoverable error, conversion will proceed with the next file.
Options:   Conversion mode:     --animate / --no-animate Output animated image file (default) /                                   output each frame individually     --raw Extract image data as-is (without decoding)
Extraction:     -m, --mipmaps Extract all mipmaps     --low-res-img Extract the low-resolution image     --min-resolution INTEGER Minimum mipmap resolution [x>=1]     --max-resolution INTEGER Maximum mipmap resolution [x>=1]     --closest-resolution Fallback to the closest resolution if no                                   exact match     --frames INDEX|[START]:[STOP][:STEP]                                   Frames to extract     --faces INDEX|[START]:[STOP][:STEP]                                   Faces to extract     --slices INDEX|[START]:[STOP][:STEP]                                   Slices to extract
Image decoding (not used with --raw):     --dynamic-range [ldr|hdr] Override LDR/HDR auto-detection     --overbright-factor FLOAT Multiplicative factor used for decoding                                   compressed HDR textures [default: 16.0]
Image postprocessing (not used with --raw):     --hdr-to-ldr Convert HDR from linear sRGB to sRGB and                                   output as clipped LDR     --separate-channels Output the RGB/L and A channels separately
Image output (not used with --raw):     -f, --ldr-format SINGLE[|MULTI]                                   LDR output format [default: tiff|apng]     -F, --hdr-format SINGLE[|MULTI]                                   HDR output format [default: exr]     --fps INTEGER Frame rate used for animated image files                                   [default: 5]     --compress / --no-compress Control lossless compression
Read/write control:     --always-write / --no-write Write images     --readback / --no-readback Readback images
Output destination:     -o, --output-dir PATH Output directory     -O, --output-file PATH Output file
Miscellaneous:     --num-workers INTEGER Number of workers for parallel conversion                                   [x>=1]     --no-progress Do not show the progress bar
Info:     --shell-completion [SHELL] Setup shell completion.     -h, --help Show this message and exit.     --version Show the version and exit.     --credits Show the credits and exit.

See also

External links