1
0
mirror of https://github.com/microsoft/DirectXTex synced 2024-11-22 04:20:07 +00:00

Updated Texassemble (markdown)

Chuck Walbourn 2021-01-09 16:56:23 -08:00
parent 63f13ec7f5
commit c233549a4a

@ -17,6 +17,7 @@ texassemble <command>
[-nologo] [-nologo]
[-fl feature-level] [-fl feature-level]
[-bgcolor] [-bgcolor]
[-swizzle rgbamask]
<file-name(s)> <file-name(s)>
``` ```
@ -40,9 +41,7 @@ The file-name parameter indicates the file(s) to use to create the assembled ima
**array-strip**: Creates a horizontal strip image from an input 1D/2D array ``dds`` file. **array-strip**: Creates a horizontal strip image from an input 1D/2D array ``dds`` file.
**merge**: Creates a texture using two input images: RGB coming from the first image, A (via the Blue channel) from the second image. **merge**: Creates a texture using two input images. You can control which channels are used with the ``-swizzle`` option below.
> The ``merge`` command matches the legacy DirectX Texture Tool behavior when doing "Open Alpha onto Surface..."
**gif**: Converts an animated ``gif`` into a texture array with properly composed frames. **gif**: Converts an animated ``gif`` into a texture array with properly composed frames.
@ -84,6 +83,10 @@ The file-name parameter indicates the file(s) to use to create the assembled ima
**-bgcolor**: When doing the ``gif`` command, by default it always uses a transparent background color which is consistent with most browsers. You can choose to use the background color metadata in the file with this switch instead, but the results are not likely to match most viewers. **-bgcolor**: When doing the ``gif`` command, by default it always uses a transparent background color which is consistent with most browsers. You can choose to use the background color metadata in the file with this switch instead, but the results are not likely to match most viewers.
**-swizzle _rgbamask_**: When doing the ``merge`` command, by default it uses the Blue channel from the second image as the Alpha channel for the output; pulling Red, Green, and Blue from the original image which is same as the mask ``rgbB``. This option lets you provide alternative channel patterns using [HLSL-style](https://docs.microsoft.com/en-us/windows/win32/direct3dhlsl/dx9-graphics-reference-asm-ps-registers-modifiers-source-register-swizzling) swizzle masks. Lowercase letters indicate channels pulled from the first image (``rgbaxyzw``), and uppercase letters indicate the second image (``RGBAXYZW``). The mask is 1 to 4 characters in length.
> The ``merge`` command default swizzle mask matches the legacy DirectX Texture Tool behavior when doing "Open Alpha onto Surface..."
# Examples # Examples
``` ```