Updated Texassemble (markdown)

Texassemble.md

@@ -5,21 +5,32 @@ _This utility does not support mipmap generation or texture compression, but the
 # Syntax
 ``Texassemble.exe`` uses the following command syntax:
 
-    texassemble [-r] [-cube | - volume | -array | -cubearray]
-    [-w width] [-h height] [-f format] [-if filter] [-sepalpha]
-    [-o <outputfile>] [-dx10]  [-nologo]
+    texassemble [command]
+    [-r] [-w width] [-h height] [-f format]
+    [-if filter] [-srgb | -srgbi | -srgbo]
+    [-sepalpha] [-wrap | -mirror] [-alpha]
+    [-o <outputfile>] [-y] [-dx10]  [-nologo]
     <file-name(s)>
 
 The file-name parameter indicates the file(s) to use to create the assembled image using ``dds``, ``tga``, ``hdr``, or a WIC-supported format (``bmp``, ``jpg``, ``png``, ``jxr``, etc.).
 
+# Commands
+
+**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.
+
+**h-cross**, **v-cross**: Creates a vertical/horizontal cross image from an input cubemap dds file
+
+**h-strip**, **v-strip**: Creates a vertical/horizontal strip image from an input cubemap dds file
+
 # 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.   
-**-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. 
 
@@ -27,10 +38,18 @@ The file-name parameter indicates the file(s) to use to create the assembled ima
 
 **-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. 
 
+**-srgb**, **-srgbi**, or **-srgbo**: Use sRGB if both the input and output data are in the sRGB color format (ie. gamma ~2.2). Use sRGBi if only the input is in sRGB; use sRGBo if only the output is in sRGB.
+
 **-sepalpha**: Separates alpha channel for resize. 
 
+**-wrap**, **-mirror**: Sets the texture addressing mode for filtering to wrap or mirror, otherwise defaults to clamp. 
+
+**-wrap**, **-mirror**: Sets the texture addressing mode for filtering to wrap or mirror, otherwise defaults to clamp. 
+
 **-o _Output-filename_**: The default name is a ``.DDS`` file based on the first input image file. 
 
+**-y**: overwrite existing output file if any. By default, the tool will abort if the output file already exists.
+
 **-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. 
@@ -38,15 +57,15 @@ The file-name parameter indicates the file(s) to use to create the assembled ima
 
 # Examples
 
-    texassemble -volume -w 256 -h 256 -o volume.dds lena.jpg fishingboat.jpg peppers.tiff
+    texassemble volume -w 256 -h 256 -o volume.dds lena.jpg fishingboat.jpg peppers.tiff
 
 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
+    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._
 
-    texassemble -array -o array.dds lena.jpg peppers.tiff
+    texassemble array -o array.dds lena.jpg peppers.tiff
 
 This loads the two image files 'lena.jpg' and 'peppers.tiff'. It resizes 'peppers.tiff' to the same size as 'lena.jpg', and then writes out an array 2D texture to 'array.dds' using the two input images. The result uses a DXGI format derived from 'lena.jpg', or one could be provided via the '-f' command-line switch. _The result does not have mipmaps but 'array.dds' could be use as input for **texconv** to finish the processing such as generating mipmaps or block-compression._ Note that loading 'array.dds' requires feature level 10.0 or better hardware.