AuroraMiddleware/DirectXTex
1
0
Fork 0
mirror of https://github.com/microsoft/DirectXTex synced 2024-11-21 20:10:05 +00:00
Code Issues Releases Wiki Activity

Updated Texassemble (markdown)

Chuck Walbourn 2015-06-16 11:28:40 -07:00
parent 7af409a660
commit 566ebafce8
1 changed files with 37 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
Texassemble.md

@ -1,6 +1,42 @@
This DirectXTex sample is a command-line texture utility for creating DDS files containing cubemaps, volume maps, or texture arrays from individual images.
This utility does not support mipmap generation or texture compression, but the resulting .DDS file can be further processed by the [[Texconv]] utility. Any texture compressed input file is decompressed on load.
_This utility does not support mipmap generation or texture compression, but the resulting .DDS file can be further processed by the [[Texconv]] utility. Any texture compressed input file is decompressed on load._
# Syntax
``Texassemble.exe`` uses the following command syntax:
texassemble [-cube | - volume | -array | -cubearray]
[-w width] [-h height] [-f format] [-if filter] [-sepalpha]
[-o <outputfile>] [-dx10] [-nologo] <files>
The file-name parameter indicates the file(s) to use to create the image.
The optional command-line switches are described in the following table.
# Optional Switches Description
* **-cube**: Creates a cubemap. Must have six images to form each of the six faces.
* **-volume**: Creates a volume map. Must have at least two images and the number of images determines the 'depth'.
* **-array**: Creates a 1D or 2D texture array. Must have at least two images. Note that loading the resulting DDS file requires feature level 10.0 or better hardware.
* **-cubearray**: Creates a cubemap array. Must have a multiple of six images. Note that loading the resulting DDS file requires feature level 10.1 or better hardware.
* **-w _number_**: Width of the output texture in pixels.
* **-h _number_**: Height of the output texture in pixels. If no size is given, the size is taken from the first input image.
* **-f _format_**: Output format. Specify the DXGI format without the ``DXGI_FORMAT_`` prefix (i.e. ``-f R10G10B10A2_UNORM``). If no format is given, the format of the first image file is used.
* **-if _filter_**: Image filter used for resizing the images. Use one of the following: ``POINT``, ``LINEAR``, ``CUBIC``, ``FANT``, ``BOX``, ``TRIANGLE``, ``POINT_DITHER``, ``LINEAR_DITHER``, ``CUBIC_DITHER``, ``FANT_DITHER``, ``BOX_DITHER``, ``TRIANGLE_DITHER``, ``POINT_DITHER_DIFFUSION``, ``LINEAR_DITHER_DIFFUSION``, ``CUBIC_DITHER_DIFFUSION``, ``FANT_DITHER_DIFFUSION``, ``BOX_DITHER_DIFFUSION``, or ``TRIANGLE_DITHER_DIFFUSION``. Filters with ``DITHER`` in their name indicate that the 4x4 ordered dither algorithm, while ``DITHER_DIFFUSION`` is error diffusion dithering.
* **-o _Output-filename_**: The default name is a .DDS file based on the first input image file.
* **-sepalpha**: Separates alpha channel for resize.
* **-dx10**: Forces DDS file output to always use the "DX10" header extension, and allows the writing of alpha mode metadata information. The resulting file may not be compatible with the legacy D3DX10 or D3DX11 libraries.
* **-nologo**: Suppress copyright message.
# Examples