diff --git a/Texassemble.md b/Texassemble.md index b37ffac..26477d2 100644 --- a/Texassemble.md +++ b/Texassemble.md @@ -16,25 +16,22 @@ The optional command-line switches are described in the following table. # Optional Switches Description **-r**: Input file names can contain wildcard characters (``?`` or ``*``). If this switch is used, subdirectories are also searched. -**-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. - +**-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. +**-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. +**-o _Output-filename_**: The default name is a .DDS file based on the first input image file. + **-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. @@ -46,7 +43,8 @@ The optional command-line switches are described in the following table. This loads the three image files 'lena.jpg', 'fishingboat.jpg', and 'peppers.tiff', resizes them to 256 x 256, and then writes out a volume (3D) texture to 'volume.dds' sized 256 x 256 x 3 with each input image as a depth slice. The result uses a DXGI format derived from the 'lena.jpg' input image, or one could be provided via the '-f' command-line switch. _The result does not have mipmaps but 'volume.dds' could be use as input for **texconv** to finish the processing such as generating mipmaps or block-compression._ - texassemble -cube -w 256 -h 256 -o cubemap.dds lobbyxposjpg lobbyxneg.jpg lobbyypos.jpg lobbyyneg.jpg lobbyzpos.jpg lobbyzneg.jpg + texassemble -cube -w 256 -h 256 -o cubemap.dds lobbyxposjpg lobbyxneg.jpg + lobbyypos.jpg lobbyyneg.jpg lobbyzpos.jpg lobbyzneg.jpg This loads the six image JPEG files, resizes them to 256 x 256, and then writes out a cubemap texture to 'cubemap.dds' sized 256 x 256 with six faces, with each input image as a distinct face (ordered positive-x, negative-x, positive-y, negative-y, positive-z, and negative-z). The result uses a DXGI format derived from 'lobbyxpos.jpg', or one could be provided via the '-f' command-line switch. _The result does not have mipmaps but 'cubemap.dds' could be use as input for **texconv** to finish the processing such as generating mipmaps or block-compression._