No vtf: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(no_vtf-desktop v0.1.2)
m (→‎Help text: Unicodifying, replaced: </b> → ''' (10), <b> → ''' (10))
Line 45: Line 45:
{{License|type=lgpl|version=3}} Help from no_vtf run without an input file:
{{License|type=lgpl|version=3}} Help from no_vtf run without an input file:
{{codeblock|
{{codeblock|
Usage: <b>{{font color|{{no vtf|col}}|no_vtf}} {{font color|lightgray|[OPTIONS] [--] PATH...}}</b><br>
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>
&nbsp;&nbsp;Convert Valve Texture Format files into standard image files.<br>
&nbsp;&nbsp;PATH can be either file, or directory (in which case it is recursively
&nbsp;&nbsp;PATH can be either file, or directory (in which case it is recursively
Line 91: Line 91:
&nbsp;&nbsp;Upon a recoverable error, conversion will proceed with the next file.<br>
&nbsp;&nbsp;Upon a recoverable error, conversion will proceed with the next file.<br>
<u>Options</u>:
<u>Options</u>:
&nbsp;&nbsp;{{font color|#D78700|<b>Conversion mode: </b>}}
&nbsp;&nbsp;{{font color|#D78700|'''Conversion mode: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--animate / --no-animate      Output animated image file (default) /
&nbsp;&nbsp;&nbsp;&nbsp;--animate / --no-animate      Output animated image file (default) /
&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
&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
&nbsp;&nbsp;&nbsp;&nbsp;--raw                        Extract image data as-is (without decoding)<br>
&nbsp;&nbsp;&nbsp;&nbsp;--raw                        Extract image data as-is (without decoding)<br>
{{font color|#D78700|<b> Extraction: </b>}}
{{font color|#D78700|''' Extraction: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;-m, --mipmaps                Extract all mipmaps
&nbsp;&nbsp;&nbsp;&nbsp;-m, --mipmaps                Extract all mipmaps
&nbsp;&nbsp;&nbsp;&nbsp;--low-res-img                Extract low resolution image
&nbsp;&nbsp;&nbsp;&nbsp;--low-res-img                Extract low resolution image
Line 108: Line 108:
&nbsp;&nbsp;&nbsp;&nbsp;--slices INDEX&#124;&#91;START&#93;:&#91;STOP&#93;&#91;:STEP&#93;
&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>
&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|<b> Image decoding (not used with --raw): </b>}}
{{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;--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;--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>
&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|<b> Image postprocessing (not used with --raw): </b>}}
{{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;--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;&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>
&nbsp;&nbsp;&nbsp;&nbsp;--separate-channels          Output the RGB/L and A channels separately<br>
{{font color|#D78700|<b> Image output (not used with --raw): </b>}}
{{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;-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;&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;
Line 124: Line 124:
&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;&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>
&nbsp;&nbsp;&nbsp;&nbsp;--compress / --no-compress    Control lossless compression<br>
{{font color|#D78700|<b> Read/write control: </b>}}
{{font color|#D78700|''' Read/write control: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--always-write / --no-write  Write images
&nbsp;&nbsp;&nbsp;&nbsp;--always-write / --no-write  Write images
&nbsp;&nbsp;&nbsp;&nbsp;--readback / --no-readback    Readback images<br>
&nbsp;&nbsp;&nbsp;&nbsp;--readback / --no-readback    Readback images<br>
{{font color|#D78700|<b> Output destination: </b>}}
{{font color|#D78700|''' Output destination: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;-o, --output-dir PATH        Output directory
&nbsp;&nbsp;&nbsp;&nbsp;-o, --output-dir PATH        Output directory
&nbsp;&nbsp;&nbsp;&nbsp;-O, --output-file PATH        Output file<br>
&nbsp;&nbsp;&nbsp;&nbsp;-O, --output-file PATH        Output file<br>
{{font color|#D78700|<b> Miscellaneous: </b>}}
{{font color|#D78700|''' Miscellaneous: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;--num-workers INTEGER        Number of workers for parallel conversion
&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;&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>
&nbsp;&nbsp;&nbsp;&nbsp;--no-progress                Do not show the progress bar<br>
{{font color|#D78700|<b> Info: </b>}}
{{font color|#D78700|''' Info: '''}}
&nbsp;&nbsp;&nbsp;&nbsp;-h, --help                    Show this message and exit.
&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;--version                    Show the version and exit.

Revision as of 11:31, 8 January 2024

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
Dec 07, 2023 (v4.2.0)
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 07, 2023 (v0.1.2)
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

GNU Lesser General Public License
The following work is licensed under the GNU General Public License 3.0
This work is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License; version 3 as published by the Free Software Foundation. This work is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See version 3 of the GNU Lesser General Public License for more details.

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 file, or 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 file or 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, 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 be still 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 write 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
  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   with animation 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 data to be written do not match what is in the file.
  Worker is spawned for each logical core to run the conversion in parallel.   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 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:     -h, --help Show this message and exit.     --version Show the version and exit.     --credits Show the credits and exit.

​

See also

External links

Mod tools
Map editors
Map compilers
Map compiler frontends
Map converters
005 Decompiler • BSPSource • MapFool • VMEX
Map tools
AutoBSPpackingTool • BSPEntSpy • Crafty • Convexer • EntEd • Entspy • JERC • Map Analyst • Map Obfuscator • Material Enumerator • Pakrat • Source Compile Analyzer • TAR • TeamSpen's Hammer Addons • Vgroup • VMF Optimizer • VMF Updater • WinBSPZip • LumpStich • VPKEdit
Model compilers
Model compiler frontends
Model converters
Model tools
3Dcoat • 3DS Max • Blender • Cinema 4D • Fragmotion • GMax • HLMV++ • kHED • Lightwave • Maya • MilkShape 3D • Modo • SourceOps • VSIF2VCD • Softimage Mod Tool • Zbrush
Displacement tools
Particle converters
Texture converters
Texture tools
Sound tools
VPK tools
Libraries
AVIKit • HLLib • VectorLib • VTFLib
Plugins
Other
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=No_vtf&oldid=373515"