commandline.html 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  2. "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  3. <html xmlns="http://www.w3.org/1999/xhtml">
  4. <head>
  5. <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
  6. <title>Command Line Options &#8212; Compressonator Compressonator - latest build documentation</title>
  7. <link rel="stylesheet" href="../_static/alabaster.css" type="text/css" />
  8. <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
  9. <link rel="stylesheet" href="../_static/theme_overrides.css" type="text/css" />
  10. <script type="text/javascript">
  11. var DOCUMENTATION_OPTIONS = {
  12. URL_ROOT: '../',
  13. VERSION: 'Compressonator - latest build',
  14. COLLAPSE_INDEX: false,
  15. FILE_SUFFIX: '.html',
  16. HAS_SOURCE: true,
  17. SOURCELINK_SUFFIX: '.txt'
  18. };
  19. </script>
  20. <script type="text/javascript" src="../_static/jquery.js"></script>
  21. <script type="text/javascript" src="../_static/underscore.js"></script>
  22. <script type="text/javascript" src="../_static/doctools.js"></script>
  23. <link rel="index" title="Index" href="../genindex.html" />
  24. <link rel="search" title="Search" href="../search.html" />
  25. <link rel="next" title="GUI Tool" href="../gui_tool/index.html" />
  26. <link rel="prev" title="Command Line Tool" href="index.html" />
  27. <link rel="stylesheet" href="../_static/custom.css" type="text/css" />
  28. <meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />
  29. </head>
  30. <body>
  31. <div class="document">
  32. <div class="documentwrapper">
  33. <div class="bodywrapper">
  34. <div class="body" role="main">
  35. <div class="section" id="command-line-options">
  36. <h1>Command Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this headline">¶</a></h1>
  37. <p>Usage CompressonatorCLI.exe [options] SourceFile DestFile</p>
  38. <table border="1" class="docutils">
  39. <colgroup>
  40. <col width="34%" />
  41. <col width="66%" />
  42. </colgroup>
  43. <thead valign="bottom">
  44. <tr class="row-odd"><th class="head">Mip Map Options:</th>
  45. <th class="head">&#160;</th>
  46. </tr>
  47. </thead>
  48. <tbody valign="top">
  49. <tr class="row-even"><td>-GenGPUMipMap</td>
  50. <td>When encoding with GPU this flag will enable
  51. mip map level generation using GPU HW</td>
  52. </tr>
  53. <tr class="row-odd"><td>-mipsize &lt;size&gt;</td>
  54. <td>The size in pixels used to determine
  55. how many mip levels to generate</td>
  56. </tr>
  57. <tr class="row-even"><td>-miplevels &lt;Level&gt;</td>
  58. <td>Sets Mips Level for output,
  59. (mipSize overides this option): default is 1</td>
  60. </tr>
  61. <tr class="row-odd"><td>-nomipmap</td>
  62. <td>Turns off Mipmap generation</td>
  63. </tr>
  64. <tr class="row-even"><td>-UseSRGBFrames</td>
  65. <td>When encoding with GPU, GL_FRAMEBUFFER_SRGB
  66. will be enabled else use GL_FRAMEBUFFER</td>
  67. </tr>
  68. </tbody>
  69. </table>
  70. <table border="1" class="docutils">
  71. <colgroup>
  72. <col width="26%" />
  73. <col width="74%" />
  74. </colgroup>
  75. <thead valign="bottom">
  76. <tr class="row-odd"><th class="head">Compression Options</th>
  77. <th class="head">&#160;</th>
  78. </tr>
  79. </thead>
  80. <tbody valign="top">
  81. <tr class="row-even"><td>-fd &lt;format&gt;</td>
  82. <td>Specifies the destination texture format to use</td>
  83. </tr>
  84. <tr class="row-odd"><td>-DecodeWith</td>
  85. <td>GPU based decompression using OpenGL,DirectX or Vulkan
  86. Default is OpenGL, UseGPUDecompress is implied when
  87. this option is set</td>
  88. </tr>
  89. <tr class="row-even"><td>-decomp &lt;filename&gt;</td>
  90. <td>If the destination file is compressed optionally
  91. decompress it
  92. to the specified file. Note the destination must
  93. be compatible
  94. with the sources format,decompress formats are typically
  95. set to ARGB_8888 or ARGB_32F</td>
  96. </tr>
  97. <tr class="row-odd"><td>-doswizzle</td>
  98. <td>Swizzle the source images Red and Blue channels</td>
  99. </tr>
  100. <tr class="row-even"><td>-EncodeWith</td>
  101. <td>Compression with CPU, HPC, OCL, DXC, GPU.
  102. Default is CPU.
  103. GPU will use GL Compress Extensions
  104. OCL &amp; DXC is only available on Windows Version</td>
  105. </tr>
  106. <tr class="row-odd"><td>-UseGPUDecompress</td>
  107. <td>By default decompression is done using CPU,
  108. when set OpenGL will be used by default, this can be
  109. changed to DirectX or Vulkan using DecodeWith setting</td>
  110. </tr>
  111. </tbody>
  112. </table>
  113. <table border="1" class="docutils">
  114. <colgroup>
  115. <col width="28%" />
  116. <col width="72%" />
  117. </colgroup>
  118. <thead valign="bottom">
  119. <tr class="row-odd"><th class="head">Channel Formats</th>
  120. <th class="head">&#160;</th>
  121. </tr>
  122. </thead>
  123. <tbody valign="top">
  124. <tr class="row-even"><td>ARGB_8888</td>
  125. <td>ARGB format with 8-bit fixed channels</td>
  126. </tr>
  127. <tr class="row-odd"><td>ARGB_16F</td>
  128. <td>ARGB format with 16-bit floating-point channels</td>
  129. </tr>
  130. <tr class="row-even"><td>ARGB_32F</td>
  131. <td>ARGB format with 32-bit floating-point channels</td>
  132. </tr>
  133. </tbody>
  134. </table>
  135. <table border="1" class="docutils">
  136. <colgroup>
  137. <col width="28%" />
  138. <col width="72%" />
  139. </colgroup>
  140. <thead valign="bottom">
  141. <tr class="row-odd"><th class="head">Compression Formats</th>
  142. <th class="head">&#160;</th>
  143. </tr>
  144. </thead>
  145. <tbody valign="top">
  146. <tr class="row-even"><td>ASTC</td>
  147. <td>Adaptive Scalable Texture Compression</td>
  148. </tr>
  149. <tr class="row-odd"><td>ATC_RGB</td>
  150. <td>Compressed RGB format</td>
  151. </tr>
  152. <tr class="row-even"><td>ATC_RGBA_Explicit</td>
  153. <td>ARGB format with explicit alpha</td>
  154. </tr>
  155. <tr class="row-odd"><td>ATC_RGBA_Interpolated</td>
  156. <td>ARGB format with interpolated alpha</td>
  157. </tr>
  158. <tr class="row-even"><td>ATI1N</td>
  159. <td>Single component compression format using the same
  160. technique as DXT5 alpha. Four bits per pixel</td>
  161. </tr>
  162. <tr class="row-odd"><td>ATI2N</td>
  163. <td>Two component compression format using the same
  164. technique as DXT5 alpha. Designed for compression object
  165. space normal maps. Eight bits per pixel</td>
  166. </tr>
  167. <tr class="row-even"><td>ATI2N_XY</td>
  168. <td>Two component compression format using the same technique
  169. as DXT5 alpha. The same as ATI2N but with the channels
  170. swizzled.Eight bits per pixel</td>
  171. </tr>
  172. <tr class="row-odd"><td>ATI2N_DXT5</td>
  173. <td>An ATI2N like format using DXT5. Intended for use on GPUs
  174. that do not natively support ATI2N. Eight bits per pixel</td>
  175. </tr>
  176. <tr class="row-even"><td>BC1</td>
  177. <td>Four component opaque (or 1-bit alpha) compressed texture
  178. format. Four bit per pixel</td>
  179. </tr>
  180. <tr class="row-odd"><td>BC2</td>
  181. <td>Four component compressed texture format with explicit
  182. alpha. Eight bits per pixel</td>
  183. </tr>
  184. <tr class="row-even"><td>BC3</td>
  185. <td>Four component compressed texture format with interpolated
  186. alpha. Eight bits per pixel</td>
  187. </tr>
  188. <tr class="row-odd"><td>BC4</td>
  189. <td>Single component (red channel)compressed texture format</td>
  190. </tr>
  191. <tr class="row-even"><td>BC4_S</td>
  192. <td>Signed Channel compression using BC4 format</td>
  193. </tr>
  194. <tr class="row-odd"><td>BC5</td>
  195. <td>Two component (reg and green channels) compressed format</td>
  196. </tr>
  197. <tr class="row-even"><td>BC5_S</td>
  198. <td>Signed Channel compression using BC5 format</td>
  199. </tr>
  200. <tr class="row-odd"><td>BC6H</td>
  201. <td>High-Dynamic Range compression format</td>
  202. </tr>
  203. <tr class="row-even"><td>BC7</td>
  204. <td>High-quality compression of RGB and RGBA data</td>
  205. </tr>
  206. <tr class="row-odd"><td>DXT1</td>
  207. <td>An opaque (or 1-bit alpha) DXTC compressed texture format.
  208. Four bits per pixel</td>
  209. </tr>
  210. <tr class="row-even"><td>DXT3</td>
  211. <td>DXTC compressed texture format with explicit alpha.
  212. Eight bits per pixel</td>
  213. </tr>
  214. <tr class="row-odd"><td>DXT5</td>
  215. <td>DXTC compressed texture format with interpolated alpha.
  216. Eight bits per pixel</td>
  217. </tr>
  218. <tr class="row-even"><td>DXT5_xGBR</td>
  219. <td>DXT5 with the red component swizzled into the alpha channel
  220. Eight bits per pixel</td>
  221. </tr>
  222. <tr class="row-odd"><td>DXT5_RxBG</td>
  223. <td>Swizzled DXT5 format with the green component swizzled
  224. into the alpha channel. Eight bits per pixel</td>
  225. </tr>
  226. <tr class="row-even"><td>DXT5_RBxG</td>
  227. <td>Swizzled DXT5 format with the green component swizzled
  228. into the alpha channel &amp; the blue component swizzled into
  229. the green channel. Eight bits per pixel</td>
  230. </tr>
  231. <tr class="row-odd"><td>DXT5_xRBG</td>
  232. <td>Swizzled DXT5 format with the green component swizzled
  233. into the alpha channel &amp; the red component swizzled into
  234. the green channel. Eight bits per pixel</td>
  235. </tr>
  236. <tr class="row-even"><td>DXT5_RGxB</td>
  237. <td>Swizzled DXT5 format with the blue component swizzled
  238. into the alpha channel. Eight bits per pixel</td>
  239. </tr>
  240. <tr class="row-odd"><td>DXT5_xGxR</td>
  241. <td>Two-component swizzled DXT5 format with the red component
  242. swizzled into the alpha channel &amp; the green component in
  243. the green channel. Eight bits per pixel</td>
  244. </tr>
  245. <tr class="row-even"><td>ETC_RGB</td>
  246. <td>Ericsson Texture Compression - Compressed RGB format.</td>
  247. </tr>
  248. <tr class="row-odd"><td>ETC2_RGB</td>
  249. <td>Ericsson Texture Compression 2 - RGB format</td>
  250. </tr>
  251. <tr class="row-even"><td>ETC2_RGBA</td>
  252. <td>RGB with 8 bit alpha</td>
  253. </tr>
  254. <tr class="row-odd"><td>ETC2_RGBA1</td>
  255. <td>RGB with 1 bit alpha</td>
  256. </tr>
  257. </tbody>
  258. </table>
  259. <table border="1" class="docutils">
  260. <colgroup>
  261. <col width="33%" />
  262. <col width="67%" />
  263. </colgroup>
  264. <thead valign="bottom">
  265. <tr class="row-odd"><th class="head">Codec Options</th>
  266. <th class="head">Reference developer SDK documentation for range of values</th>
  267. </tr>
  268. </thead>
  269. <tbody valign="top">
  270. <tr class="row-even"><td>-AlphaRestrict &lt;value&gt;</td>
  271. <td>This setting is a quality tuning setting for BC7
  272. which may be necessary for some textures</td>
  273. </tr>
  274. <tr class="row-odd"><td>-AlphaThreshold &lt;value&gt;</td>
  275. <td>The alpha threshold to use when compressing
  276. to DXT1 &amp; BC1 with DXT1UseAlpha
  277. Texels with an alpha value less than the threshold
  278. are treated as transparent
  279. value is in the range of 0 to 255, default is 128</td>
  280. </tr>
  281. <tr class="row-even"><td>-Analysis &lt;image1&gt; &lt;image2&gt;</td>
  282. <td>Generate analysis metric like SSIM, PSNR values
  283. between 2 images with same size. Analysis_Result.xml file
  284. will be generated.</td>
  285. </tr>
  286. <tr class="row-odd"><td>-BlockRate &lt;value&gt;</td>
  287. <td>ASTC 2D only - sets block size or bit rate
  288. value can be a bit per pixel rate from 0.0 to 9.9
  289. or can be a combination of x and y axes with paired
  290. values of 4,5,6,8,10 or 12 from 4x4 to 12x12</td>
  291. </tr>
  292. <tr class="row-even"><td>-ColourRestrict &lt;value&gt;</td>
  293. <td>This setting is a quality tuning setting for BC7
  294. which may be necessary for convenience in some
  295. applications</td>
  296. </tr>
  297. <tr class="row-odd"><td>-CompressionSpeed &lt;value&gt;</td>
  298. <td>The trade-off between compression speed &amp; quality
  299. This setting is not used in BC6H and BC7</td>
  300. </tr>
  301. <tr class="row-even"><td>-diff_image &lt;image1&gt; &lt;image2&gt;</td>
  302. <td>Generate difference between 2 images with same size
  303. A .bmp file will be generated. Please use compressonator
  304. GUI to increase the contrast to view the diff pixels.</td>
  305. </tr>
  306. <tr class="row-odd"><td>-DXT1UseAlpha &lt;value&gt;</td>
  307. <td>Encode single-bit alpha data.
  308. Only valid when compressing to DXT1 &amp; BC1</td>
  309. </tr>
  310. <tr class="row-even"><td>-imageprops &lt;image&gt;</td>
  311. <td>Print image properties of image files specifies.</td>
  312. </tr>
  313. <tr class="row-odd"><td>-log</td>
  314. <td>Logs process information to a process_results.txt file
  315. containing file info, performance data,SSIM,PSNR and MSE.</td>
  316. </tr>
  317. <tr class="row-even"><td>-logcsv</td>
  318. <td>Logs process information to a process_results.csv file
  319. containing file info, performance data,SSIM,PSNR and MSE.</td>
  320. </tr>
  321. <tr class="row-odd"><td>-log &lt;filename&gt;</td>
  322. <td>Logs process information to a user defined text file</td>
  323. </tr>
  324. <tr class="row-even"><td>-logcsv &lt;filename&gt;</td>
  325. <td>Logs process information to a user defined csv file</td>
  326. </tr>
  327. <tr class="row-odd"><td>-ModeMask &lt;value&gt;</td>
  328. <td>Mode to set BC7 to encode blocks using any of 8
  329. different block modes in order to obtain the
  330. highest quality</td>
  331. </tr>
  332. <tr class="row-even"><td>-NumThreads &lt;value&gt;</td>
  333. <td>Number of threads to initialize for ASTC,BC6H,BC7
  334. encoding (Max up to 128). Default set to 0 (Auto)</td>
  335. </tr>
  336. <tr class="row-odd"><td>-Performance &lt;value&gt;</td>
  337. <td>Sets performance of encoding for BC7</td>
  338. </tr>
  339. <tr class="row-even"><td>-Quality &lt;value&gt;</td>
  340. <td>Sets quality of encoding for BC7</td>
  341. </tr>
  342. <tr class="row-odd"><td>-RefineSteps &lt;value&gt;</td>
  343. <td>Adds extra steps in encoding for BC1
  344. to improve quality over performance.
  345. Step values are 1 and 2.</td>
  346. </tr>
  347. <tr class="row-even"><td>-Signed &lt;value&gt;</td>
  348. <td>Used for BC6H only, Default BC6H format disables
  349. use of a sign bit in the 16-bit floating point
  350. channels, with a value set to 1 BC6H format will
  351. use a sign bit</td>
  352. </tr>
  353. <tr class="row-odd"><td>-UseChannelWeighting &lt;value&gt;</td>
  354. <td>Use channel weightings</td>
  355. </tr>
  356. <tr class="row-even"><td>-WeightR &lt;value&gt;</td>
  357. <td>The weighting of the Red or X Channel</td>
  358. </tr>
  359. <tr class="row-odd"><td>-WeightG &lt;value&gt;</td>
  360. <td>The weighting of the Green or Y Channel</td>
  361. </tr>
  362. <tr class="row-even"><td>-WeightB &lt;value&gt;</td>
  363. <td>The weighting of the Blue or Z Channel</td>
  364. </tr>
  365. <tr class="row-odd"><td>-ff &lt;ext&gt;,&lt;ext&gt;,…,&lt;ext&gt;</td>
  366. <td>File filters used for processing a list of image files
  367. with specified extensions in a given directory folder
  368. supported &lt;ext&gt; are any of the following combinations:
  369. DDS,KTX,TGA,EXR,PNG,BMP,HDR,JPG,TIFF,PPM</td>
  370. </tr>
  371. </tbody>
  372. </table>
  373. <table border="1" class="docutils">
  374. <colgroup>
  375. <col width="33%" />
  376. <col width="67%" />
  377. </colgroup>
  378. <thead valign="bottom">
  379. <tr class="row-odd"><th class="head">Output Options</th>
  380. <th class="head">&#160;</th>
  381. </tr>
  382. </thead>
  383. <tbody valign="top">
  384. <tr class="row-even"><td>-noprogress</td>
  385. <td>Disables showing of compression progress messages</td>
  386. </tr>
  387. <tr class="row-odd"><td>-performance</td>
  388. <td>Shows various performance stats</td>
  389. </tr>
  390. <tr class="row-even"><td>-silent</td>
  391. <td>Disable print messages</td>
  392. </tr>
  393. </tbody>
  394. </table>
  395. <div class="section" id="example-compression">
  396. <h2>Example Compression<a class="headerlink" href="#example-compression" title="Permalink to this headline">¶</a></h2>
  397. <p><cite>CompressonatorCLI.exe -fd BC7 -EncodeWith HPC image.bmp result.dds</cite> <br />
  398. <cite>CompressonatorCLI.exe -fd ASTC image.bmp result.astc</cite> <br />
  399. <cite>CompressonatorCLI.exe -fd ASTC -BlockRate 0.8 image.bmp result.astc</cite> <br />
  400. <cite>CompressonatorCLI.exe -fd ASTC -BlockRate 12x12 image.bmp result.astc</cite> <br />
  401. <cite>CompressonatorCLI.exe -fd BC7 image.bmp result.dds</cite> <br />
  402. <cite>CompressonatorCLI.exe -fd BC7 -NumTheads 16 image.bmp result.dds</cite> <br />
  403. <cite>CompressonatorCLI.exe -fd BC6H image.exr result.dds</cite> <br /></p>
  404. </div>
  405. <div class="section" id="example-compression-using-gpu">
  406. <h2>Example Compression using GPU<a class="headerlink" href="#example-compression-using-gpu" title="Permalink to this headline">¶</a></h2>
  407. <p><cite>CompressonatorCLI.exe -fd BC1 -EncodeWith GPU image.bmp result.dds</cite> <br />
  408. <cite>CompressonatorCLI.exe -fd BC1 -EncodeWith OCL image.bmp result.dds</cite> <br />
  409. <cite>CompressonatorCLI.exe -fd BC1 -EncodeWith DXC image.bmp result.dds</cite> <br /></p>
  410. </div>
  411. <div class="section" id="example-decompression-from-compressed-image-using-cpu">
  412. <h2>Example Decompression from compressed image using CPU<a class="headerlink" href="#example-decompression-from-compressed-image-using-cpu" title="Permalink to this headline">¶</a></h2>
  413. <p><cite>CompressonatorCLI.exe result.dds image.bmp</cite></p>
  414. </div>
  415. <div class="section" id="compression-followed-by-decompression">
  416. <h2>Compression Followed by Decompression<a class="headerlink" href="#compression-followed-by-decompression" title="Permalink to this headline">¶</a></h2>
  417. <p>(Useful for qualitative analysis)</p>
  418. <p><cite>CompressonatorCLI.exe -fd BC7 image.bmp result.bmp</cite></p>
  419. </div>
  420. <div class="section" id="gpu-based-decompression">
  421. <h2>GPU Based Decompression<a class="headerlink" href="#gpu-based-decompression" title="Permalink to this headline">¶</a></h2>
  422. <p><cite>compressonatorCLI.exe -DecodeWith OpenGL result.dds image.bmp</cite></p>
  423. </div>
  424. <div class="section" id="mesh-compression">
  425. <h2>Mesh Compression<a class="headerlink" href="#mesh-compression" title="Permalink to this headline">¶</a></h2>
  426. <p>(support glTF and obj file only)</p>
  427. <p>The following mesh compression uses default quantization bits with Google Draco library settings
  428. (These default settings are currently not programmable):</p>
  429. <ul class="simple">
  430. <li>Compression level = 7.</li>
  431. <li>Quantization bits for position = 14.</li>
  432. <li>Quantization bits value for texture coordinates = 12.</li>
  433. <li>quantization bits value for normal = 10.</li>
  434. </ul>
  435. <p><cite>compressonatorcli.exe -draco source.gltf dest.gltf</cite></p>
  436. <p><cite>compressonatorcli.exe -draco source.obj dest.drc</cite></p>
  437. </div>
  438. <div class="section" id="mesh-decompression">
  439. <h2>Mesh Decompression<a class="headerlink" href="#mesh-decompression" title="Permalink to this headline">¶</a></h2>
  440. <p>(support glTF and obj file only)</p>
  441. <p><cite>compressonatorcli.exe source.gltf dest.gltf</cite></p>
  442. <p><cite>compressonatorcli.exe source.drc dest.obj</cite></p>
  443. </div>
  444. <div class="section" id="mesh-optimization">
  445. <h2>Mesh Optimization<a class="headerlink" href="#mesh-optimization" title="Permalink to this headline">¶</a></h2>
  446. <p>(support glTF and obj file only)</p>
  447. <p>The following uses default settings that optimizes vertices with cache size = 16, overdraw with ACMR Threshold = 1.05 and vertices fetch. <br /></p>
  448. <p><cite>compressonatorcli.exe -meshopt source.gltf dest.gltf</cite></p>
  449. <p><cite>compressonatorcli.exe -meshopt source.obj dest.obj</cite></p>
  450. <p>Specifies settings:</p>
  451. <p><cite>compressonatorcli.exe -meshopt -optVCacheSize 32 -optOverdrawACMRThres 1.03 -optVFetch 0 source.gltf dest.gltf</cite></p>
  452. <p>CLI mesh optimization include settings:</p>
  453. <table border="1" class="docutils">
  454. <colgroup>
  455. <col width="26%" />
  456. <col width="74%" />
  457. </colgroup>
  458. <tbody valign="top">
  459. <tr class="row-odd"><td>-optVCacheSize &lt;value&gt;</td>
  460. <td>optimize vertices with hardware cache size in the value specified
  461. Default is enabled with cache size = 16</td>
  462. </tr>
  463. <tr class="row-even"><td>-optVCacheFIFOSize &lt;value&gt;</td>
  464. <td>optimize vertices with hardware FIFO cache size in the value specified
  465. Default is disabled</td>
  466. </tr>
  467. <tr class="row-odd"><td>-optOverdrawACMRThres &lt;value&gt;</td>
  468. <td>optimize overdraw with ACMR (average cache miss ratio) threshold value
  469. specified (value range 1-3) default is enabled with ACMR
  470. value = 1.05 (i.e. 5% worse)</td>
  471. </tr>
  472. <tr class="row-even"><td>-optVFetch &lt;boolean value&gt;</td>
  473. <td>optimize vertices fetch . boolean value 0 - disabled, 1-enabled. -default is enabled.</td>
  474. </tr>
  475. <tr class="row-odd"><td>-simplifyMeshLOD &lt;value&gt;</td>
  476. <td>simplify mesh using LOD (Level of Details) value specified.
  477. (value range 1- no limit as it allows users to simplify the mesh until the level
  478. they desired. Higher level means less triangles drawn, less details.)</td>
  479. </tr>
  480. </tbody>
  481. </table>
  482. </div>
  483. <div class="section" id="test-analysis-logging-features-and-file-filters">
  484. <h2>Test Analysis Logging Features and File Filters<a class="headerlink" href="#test-analysis-logging-features-and-file-filters" title="Permalink to this headline">¶</a></h2>
  485. <p>(Windows OS only)</p>
  486. <p>CLI will generate an output “process_results.txt” when -log is added to the compression command line options, users can change the default log file using the command -logfile, the log captures details of the source and destination files along with statistical data on performance and quality.</p>
  487. <p>Example:</p>
  488. <p><img alt="image127" src="../_images/image127.png" /></p>
  489. <p>Generates a “process_results.txt” file with content:</p>
  490. <p><img alt="image128" src="../_images/image128.png" /></p>
  491. <p>Multiple processes will append results to this file with a dash line separator. The option is valid only for compressing images and not for 3D models or image transcoding.</p>
  492. <p>In addition to the -log and -logfile two command-line options are avilable to output analysis data into comma-separated file format. use -logcsv or -logcsvfile to generate a .csv file suitable to use in any application that supports viewing these files in a table as shown in this sample:</p>
  493. <p><img alt="image432" src="../_images/image2020-3-17_13-39-6.png" /></p>
  494. <p>The CLI also support processing image files from a folder, without the need to specify a file name. Using a file filter, specific files types can also be selected for compression as needed.</p>
  495. <p>Examples:</p>
  496. <p><img alt="image129" src="../_images/image129.png" /></p>
  497. <p>Processes all image file with BC7 Compression into results folder</p>
  498. <p><img alt="image130" src="../_images/image130.png" /></p>
  499. <p>Processes only images with extension bmp, png and exr. Notice that BC7 compression is been applied to HDR images, this is an automatic Adaptive Channel Format feature (ACF) that transcodes the image half float channels to byte prior to processing.</p>
  500. </div>
  501. <div class="section" id="csv-file-update-to-support-automation">
  502. <h2>CSV File Update to Support Automation<a class="headerlink" href="#csv-file-update-to-support-automation" title="Permalink to this headline">¶</a></h2>
  503. <p>An error code field is added to log the state of a processed image when using the command-line application option “-logcsv”.</p>
  504. <p><img alt="image433" src="../_images/csvfilesupport.png" /></p>
  505. <p>The error code will be 0 for processed images, else a value is set to indicate any errors encountered while the image was processed.</p>
  506. <p>For a list of the most recent codes look for AnalysisErrorCodeType in the sdk file cmp_compressonatorlib/common.h</p>
  507. </div>
  508. </div>
  509. </div>
  510. </div>
  511. </div>
  512. <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
  513. <div class="sphinxsidebarwrapper">
  514. <p class="logo"><a href="../index.html">
  515. <img class="logo" src="../_static/acompress-128.png" alt="Logo"/>
  516. </a></p>
  517. <h1 class="logo"><a href="../index.html">Compressonator</a></h1>
  518. <h3>Navigation</h3>
  519. <p class="caption"><span class="caption-text">Content</span></p>
  520. <ul class="current">
  521. <li class="toctree-l1"><a class="reference internal" href="../developer_sdk/index.html">Developer SDK</a></li>
  522. <li class="toctree-l1 current"><a class="reference internal" href="index.html">Command Line Tool</a></li>
  523. <li class="toctree-l1"><a class="reference internal" href="../gui_tool/index.html">GUI Tool</a></li>
  524. <li class="toctree-l1"><a class="reference internal" href="../build_from_source/build_instructions.html">Build from GitHub Sources</a></li>
  525. <li class="toctree-l1"><a class="reference internal" href="../analysis/index.html">Analysis</a></li>
  526. <li class="toctree-l1"><a class="reference internal" href="../revisions.html">Revision History</a></li>
  527. <li class="toctree-l1"><a class="reference internal" href="../support/contact.html">Contact and Support</a></li>
  528. <li class="toctree-l1"><a class="reference internal" href="../support/license.html">License</a></li>
  529. <li class="toctree-l1"><a class="reference internal" href="../bibliography.html">Bibliography</a></li>
  530. </ul>
  531. <div class="relations">
  532. <h3>Related Topics</h3>
  533. <ul>
  534. <li><a href="../index.html">Documentation overview</a><ul>
  535. <li><a href="index.html">Command Line Tool</a><ul>
  536. <li>Previous: <a href="index.html" title="previous chapter">Command Line Tool</a></li>
  537. <li>Next: <a href="../gui_tool/index.html" title="next chapter">GUI Tool</a></li>
  538. </ul></li>
  539. </ul></li>
  540. </ul>
  541. </div>
  542. <div id="searchbox" style="display: none" role="search">
  543. <h3>Quick search</h3>
  544. <form class="search" action="../search.html" method="get">
  545. <div><input type="text" name="q" /></div>
  546. <div><input type="submit" value="Go" /></div>
  547. <input type="hidden" name="check_keywords" value="yes" />
  548. <input type="hidden" name="area" value="default" />
  549. </form>
  550. </div>
  551. <script type="text/javascript">$('#searchbox').show(0);</script>
  552. </div>
  553. </div>
  554. <div class="clearer"></div>
  555. </div>
  556. <div class="footer">
  557. &copy;2017 to 2021, AMD Developer Tools.
  558. |
  559. Powered by <a href="http://sphinx-doc.org/">Sphinx 1.6.5</a>
  560. &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
  561. </div>
  562. </body>
  563. </html>