revisions.html 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573
  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>Revision History &#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="Contact and Support" href="support/contact.html" />
  26. <link rel="prev" title="Analysis" href="analysis/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="revision-history">
  36. <h1>Revision History<a class="headerlink" href="#revision-history" title="Permalink to this headline">¶</a></h1>
  37. <p>For the latest documentation, please refer to: <a class="reference external" href="http://compressonator.readthedocs.io/en/latest/">http://compressonator.readthedocs.io/en/latest/</a></p>
  38. <div class="section" id="v4-2">
  39. <h2>V4.2<a class="headerlink" href="#v4-2" title="Permalink to this headline">¶</a></h2>
  40. <p>July 2021</p>
  41. <p><strong>Features</strong></p>
  42. <ul>
  43. <li><p class="first">BC1 Quality Improvements</p>
  44. <blockquote>
  45. <div><ul class="simple">
  46. <li>Added new refine steps to improve quality of images with mixed low and high-frequency content.</li>
  47. <li>Boosted encoding performance by 2x with improved quality for smooth texture-mapped surfaces.</li>
  48. </ul>
  49. </div></blockquote>
  50. </li>
  51. <li><p class="first">BC7 HLSL Improvements</p>
  52. <blockquote>
  53. <div><ul class="simple">
  54. <li>Bug fixes and improved overall quality of the shader.</li>
  55. </ul>
  56. </div></blockquote>
  57. </li>
  58. <li><p class="first">GUI Update</p>
  59. <blockquote>
  60. <div><ul class="simple">
  61. <li>Added “Refine Steps” settings for BC1 image processing</li>
  62. <li>Removed “Use Alpha” and “No Alpha” setting for BC1, Just set a threshold above 0 to enable BC1 punch through ranges</li>
  63. </ul>
  64. </div></blockquote>
  65. </li>
  66. <li><p class="first">SDK Updates</p>
  67. <blockquote>
  68. <div><ul class="simple">
  69. <li>Removed framework.h file, replaced with compressonator.h</li>
  70. <li>Added new kernel setting options for BCn codecs in CMP_Framework</li>
  71. <li>New single header shader files added for CPU-GPU common API’s and type definitions</li>
  72. <li>Added FidelityFX types to common_defs.h to support programming FidelityFX shaders with CMP type definitions</li>
  73. <li>Improved CompressonatorLib BC1 performance and quality</li>
  74. </ul>
  75. </div></blockquote>
  76. </li>
  77. <li><p class="first">CMake Build Updates</p>
  78. <blockquote>
  79. <div><ul class="simple">
  80. <li>Added options to select build of external libs, SDK libs and applications</li>
  81. <li>Build updated for CLI on Mac OS</li>
  82. <li>OpenCV 4 supported</li>
  83. <li>Improved compiler standard revision detection and extensions</li>
  84. <li>Visual Studio 2019 support</li>
  85. <li>Qt 5.15 support</li>
  86. </ul>
  87. </div></blockquote>
  88. </li>
  89. </ul>
  90. <p><strong>Known issues and limitations</strong></p>
  91. <ul class="simple">
  92. <li>BC1 set to high-quality settings or with refinement steps take longer time to process than prior versions, adjust quality-settings lower if better performance is required</li>
  93. <li>Fixed quality issues for BC7 HLSL for images with alpha content, the processing time is longer than the previous release</li>
  94. <li>Global Setting of Refine Steps is only valid for BC1, it will not work for any other format settings.</li>
  95. </ul>
  96. </div>
  97. <div class="section" id="v4-1">
  98. <h2>V4.1<a class="headerlink" href="#v4-1" title="Permalink to this headline">¶</a></h2>
  99. <p>November 2020</p>
  100. <p><strong>Features</strong></p>
  101. <ul>
  102. <li><p class="first">SNORM Support</p>
  103. <blockquote>
  104. <div><p><a class="reference external" href="gui_tool/user_guide/texturecompression.html#compressing-signed-channel-images">Signed channel support for BC4 and BC5</a></p>
  105. </div></blockquote>
  106. </li>
  107. <li><p class="first">GPU Encoding</p>
  108. <blockquote>
  109. <div><p><a class="reference external" href="gui_tool/user_guide/applicationoptions.html?#encode-with">GPU Based Compression</a></p>
  110. </div></blockquote>
  111. </li>
  112. <li><p class="first">Mip Map Generation</p>
  113. <blockquote>
  114. <div><p><a class="reference external" href="gui_tool/user_guide/userguide.html#mip-map-filter-support-using-either-gpu-or-cpu">MIP Map Filter Support Using either GPU or CPU</a></p>
  115. <p><a class="reference external" href="gui_tool/user_guide/userguide.html#gpu-based-compression-and-mip-map-generation">GPU Based MIP Map generation</a></p>
  116. </div></blockquote>
  117. </li>
  118. <li><p class="first">Image View</p>
  119. <blockquote>
  120. <div><p><a class="reference external" href="gui_tool/user_guide/imageview.html#psnr-display-feature-for-gui-image-views">PSNR Display Feature for GUI Image Views</a></p>
  121. </div></blockquote>
  122. </li>
  123. <li><p class="first">Test Analysis</p>
  124. <blockquote>
  125. <div><p><a class="reference external" href="command_line_tool/commandline.html#csv-file-update-to-support-automation">CSV File Update to Support Automation</a></p>
  126. </div></blockquote>
  127. </li>
  128. <li><p class="first"><a class="reference external" href="gui_tool/user_guide/imageview.html?#adding-additional-image-formats">KTX2 File Support</a></p>
  129. <blockquote>
  130. <div><p>A KTX version 2 plugin has been added to the SDK, that supports saving and loading multichannel images, BCn, ETCn, and ASTC codecs.</p>
  131. </div></blockquote>
  132. </li>
  133. </ul>
  134. <p><strong>Known issues and limitations</strong></p>
  135. <ul class="simple">
  136. <li>When using GPU encoding, all source image width and height must be divisible by 4.</li>
  137. <li>GPU HW based encoding feature is only available on the Windows platform. Encoding is set only for BCn codecs and quality is limited when compared to CPU encoding.</li>
  138. <li>BC6H is not supported with GPU HW based encoding.</li>
  139. <li>KTX2 file formats for ATIn and DXT5 swizzled formats are not supported.</li>
  140. <li>ATI1n, ATI2n processed images save as BC4 and BC5 formats.</li>
  141. <li>Transcoding to ARGB_16F, ARGB_32F, and ARGB_8888 image formats is supported, all other channel formats have various data issues and have been removed until a fix is available.</li>
  142. <li>Viewing glTF and OBJ models using Vulkan(TM) rendering shows blank views.</li>
  143. <li>PSNR and Image diff analysis for mismatched channel source and destination types (F16, F32, HalfFloat, and 8bit) needs improvement.</li>
  144. <li>BC6H for OpenCL is not available in this release.</li>
  145. <li>If user-requested MIP Map level generation for GPU texture sizes in the GUI and CLI applications are invalid, they will automatically be adjusted to the lowest settable limits.</li>
  146. <li>Limited CubeMap support.</li>
  147. </ul>
  148. </div>
  149. <div class="section" id="v4-0">
  150. <h2>V4.0<a class="headerlink" href="#v4-0" title="Permalink to this headline">¶</a></h2>
  151. <p>May 2020</p>
  152. <p><strong>Features</strong></p>
  153. <ul>
  154. <li><p class="first"><a class="reference external" href="developer_sdk/cmp_core/index.html#cmp-core">CMP_Core GPU encoding support</a></p>
  155. <blockquote>
  156. <div><p>Supports GPU based encoding with OpenCL and DX11</p>
  157. </div></blockquote>
  158. </li>
  159. <li><p class="first"><a class="reference external" href="analysis/index.html#analysis-views">Analysis Views</a></p>
  160. <blockquote>
  161. <div><p>(Beta Feature) Displays performance data for GPU and CPU based BC1 to BC7 encoders</p>
  162. </div></blockquote>
  163. </li>
  164. <li><p class="first"><a class="reference external" href="command_line_tool/commandline.html#test-analysis-logging-features-and-file-filters">CLI Analysis Log File</a></p>
  165. <blockquote>
  166. <div><p>The “process_results.txt” logging includes GPU performance analysis data. csv file format is also available.</p>
  167. </div></blockquote>
  168. </li>
  169. <li><p class="first"><a class="reference external" href="developer_sdk/cmp_core/index.html#quality-settings">Using Codec Quality Settings</a></p>
  170. <blockquote>
  171. <div><p>Quality settings are available for BC1, BC2 and BC3 encoders.</p>
  172. </div></blockquote>
  173. </li>
  174. <li><p class="first"><a class="reference external" href="gui_tool/user_guide/ProjectExplorer.html#setting-global-quality-settings">Setting Global Quality Settings</a></p>
  175. <blockquote>
  176. <div><p>Users can override all individual destination compression settings, using a globally set value before processing.</p>
  177. </div></blockquote>
  178. </li>
  179. <li><p class="first"><a class="reference external" href="gui_tool/user_guide/TextureCompression.html#using-the-make-compatible-feature">Make Compatible Feature</a></p>
  180. <blockquote>
  181. <div><p>Compressonator SDK performs auto conversions of FP16 to byte and byte to FP16 formats when encoding textures with GPU or CPU encoders, a pre-conversion of the source data is performed, into a temporary buffer which is then sent for processing, once the processing is completed the buffer is removed.</p>
  182. </div></blockquote>
  183. </li>
  184. </ul>
  185. <p><strong>Known issues and limitations</strong></p>
  186. <ul class="simple">
  187. <li>GPU based encoding feature is only available on the Windows platform.</li>
  188. <li>When using GPU Encoding, all source image width and height must be divisible by 4.</li>
  189. <li>BC1, BC2 and BC3 DXC Performance is slow for quality setting &gt; 0.6</li>
  190. <li>CMP_Core for BC1,BC2,BC3,BC4,BC5 is fully functional on both OpenCL and DX11.</li>
  191. <li>CMP_Core BC7 has limited support on OpenCL, in a few cases encoding images causes GPU and CLI application to become unresponsive.</li>
  192. <li>CMP_Core BC6 for OpenCL is not completed.</li>
  193. <li>BC6 &amp; BC7 on DX11 uses DirectX Tex shaders, CMP_Core version will be available soon.</li>
  194. <li>GPU shaders for OpenCL and DX11 are compiled at runtime when encoding a texture for the first time, all subsequent runs use compiled shaders.</li>
  195. <li>KPerf(ms) and MTx/s are not measured for Compressonator SDK CPU encoding, only measured for CMP_Core SDK HPC-CPU and GPU encoding.</li>
  196. <li>KPerf(ms) and MTx/s measurements do not match across DXC and OCL pipelines.</li>
  197. <li>If user-requested MIP Map level generation for GPU texture sizes in the GUI and CLI applications are invalid, they will automatically be adjusted to the lowest settable limits.</li>
  198. <li>See v3.2 list for additional issues and limitations.</li>
  199. </ul>
  200. </div>
  201. <div class="section" id="v3-2">
  202. <h2>V3.2<a class="headerlink" href="#v3-2" title="Permalink to this headline">¶</a></h2>
  203. <p>December 2019</p>
  204. <p><strong>Features</strong></p>
  205. <ul>
  206. <li><p class="first"><a class="reference external" href="developer_sdk/index.html">New Libraries</a></p>
  207. <blockquote>
  208. <div><p>Several new libraries are now provided with the SDK.</p>
  209. <p><a class="reference external" href="developer_sdk/cmp_core/index.html">Compressonator Core</a>
  210. Provides block level API access to updated performance and quality driven BCn codecs.</p>
  211. <p><a class="reference external" href="developer_sdk/cmp_framework/index.html">Compressonator Framework</a>
  212. Includes Compressonator core with interfaces for multi-threading, mipmap generation, file access of images and HPC pipeline interfaces. (SPMD &amp; GPU support is not enabled in this release)</p>
  213. <p><a class="reference external" href="developer_sdk/cmp_compressonator/index.html">Compressonator SDK</a>
  214. Has been updated to support Cube Maps, MIP Map generation. External link requirement for Open EXR has been removed.</p>
  215. </div></blockquote>
  216. </li>
  217. <li><p class="first"><a class="reference external" href="gui_tool/user_guide/UserGuide.html#cube-maps">Cube Map Support</a></p>
  218. <blockquote>
  219. <div><p>This release previews cube map support for images that are limited to RGBA_8888 format and RGBA_F16. Support for other formats will be provided in the next major update.</p>
  220. </div></blockquote>
  221. </li>
  222. <li><p class="first"><a class="reference external" href="analysis/index.html#analysis-views">Analysis Views</a></p>
  223. <blockquote>
  224. <div><p>A analysis table view and results output are provided for users to view test analysis results for Performance, PSNR and SSIM analysis during and after processing of image textures.</p>
  225. </div></blockquote>
  226. </li>
  227. </ul>
  228. <p><strong>Known issues and limitations</strong></p>
  229. <ul class="simple">
  230. <li>HPC BC7 codec on Linux platforms shows block artifacts.</li>
  231. <li>HDR Cube maps (Format ARGB_16F) files have issues in the GUI view, only the first frame and MIP Level is displayed.</li>
  232. <li>Cube map only supports a limited set of texture types (RGBA_8888 and RGBA_F16), additional format will be added in future release.</li>
  233. <li>Cube maps with .KTX as destination format is not supported.</li>
  234. <li>When transcoding signed floats with BC6H HPC on unsigned RGBA_8888 data the images will appear distorted.</li>
  235. <li>CreateCodecBuffer (nCodecBufferType) case needs to create new codec buffers for CBT_RGBA8888, CBT_BGRA8888 and CBT_ARGB8888. The fix has been patched in this release.</li>
  236. <li>In GUI, ATI2N decode with CPU is swizzled. Decode views with GPU_OpenGL, GPU_DirectX and GPU_Vulkan are correct.</li>
  237. <li>MSE calculations are based on RGB channels only, alpha channel is not included. New MSE calculations based on MipSet data format for RGBA channels will be used in next release.</li>
  238. </ul>
  239. <p><strong>Notes</strong></p>
  240. <ul class="simple">
  241. <li>BC5 codec uses ATI2N_XY (Red &amp; Green) channel format if you prefer Green &amp; Red for BC5 please use ATI2N format for encoding.</li>
  242. <li>In GUI, BC4 decode views using CPU is gray scaled based on Red channel. Next release will only use Red channel views to match GPU views.</li>
  243. </ul>
  244. </div>
  245. <div class="section" id="v3-1">
  246. <h2>V3.1<a class="headerlink" href="#v3-1" title="Permalink to this headline">¶</a></h2>
  247. <p>November 2018</p>
  248. <p><strong>Features</strong></p>
  249. <ul>
  250. <li><p class="first"><strong>Fresh New Installers:</strong></p>
  251. <blockquote>
  252. <div><p>When installing to Windows with V3.1 release, you will notice that there are several separate new installers: SDK, GUI and CLI, which when all used result in the following file structure under \Program Files\Compressonator 3.1</p>
  253. <blockquote>
  254. <div><p><img alt="image126" src="_images/image126.png" /></p>
  255. </div></blockquote>
  256. <p>The bin and license folders are created when the user installed GUI or CLI. When the SDK is installed, an examples folder is created which contains sample application source code demonstrating the use of the Compressonator SDK. These samples use the header files from the include folder and require linking with the prebuilt sample Compressonator library provided in the lib folder. Users can also build the Compressonator library using the source code from GPUOpen.
  257. Each of these installs will not remove prior v3.0 or older installations. The user should uninstall manually using the control panel “add remove programs”.</p>
  258. </div></blockquote>
  259. </li>
  260. <li><p class="first"><strong>Texture Compression</strong></p>
  261. <blockquote>
  262. <div><p><strong>BC6H:</strong> The quality of images varies slightly when processed with a CPU based encoder and decompressed by GPU compared to decompression by CPU, especially when generating MIP map levels with progressively lower resolution images. Our latest release compensates for these differences to reduce the errors that causes blocking artifacts and luminance changes.</p>
  263. <p><a class="reference external" href="gui_tool/user_guide/TextureCompression.html#etc2">ETC2_RGBA</a> and <a class="reference external" href="gui_tool/user_guide/TextureCompression.html#etc2">ETC2_RGBA1</a> is added to Compressonator SDK, that controls the degree of transparency of images for ETC2 blocks.</p>
  264. </div></blockquote>
  265. </li>
  266. <li><p class="first"><strong>CLI Options</strong></p>
  267. <blockquote>
  268. <div><p><a class="reference external" href="command_line_tool/commandline.html#test-analysis-logging-features-and-file-filters">Process Source and Destination Folders:</a></p>
  269. <p>The new CLI adds support for 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>
  270. <p><a class="reference external" href="command_line_tool/commandline.html#test-analysis-logging-features-and-file-filters">CLI Analysis Log File:</a></p>
  271. <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>
  272. </div></blockquote>
  273. </li>
  274. <li><p class="first"><strong>3D Model</strong></p>
  275. <blockquote>
  276. <div><p><strong>Model Mesh Compression:</strong> Additional support for gltf 2.0 compression extensions (KHR_draco_mesh_compression) is added to <a class="reference external" href="command_line_tool/commandline.html#mesh-compression">CLI</a> and <a class="reference external" href="gui_tool/user_guide/3DModelCompression.html#d-mesh-optimization-and-or-mesh-compression">GUI</a></p>
  277. <p><strong>Selectable 3D Model Viewers:</strong> Support for the Vulkan Viewer code introduced in 3.0 can now be set in GUI application settings, this is an alpha version and not expected to work for all glTF models, feature for this viewer compared to DX12 has been limited.</p>
  278. <p><strong>3D Model Image Diff Viewer, Auto and Manual View:</strong> This feature allows the user to select a manual override of the automated difference view of two rendered models. The Auto View switches render frames at a predetermined rate after two render cycles of each model view, the Manual View allows the users to manually switch view using the keyboards space bar.</p>
  279. </div></blockquote>
  280. </li>
  281. <li><p class="first"><strong>Image Viewer</strong>.</p>
  282. <blockquote>
  283. <div><p><strong>Save View as:</strong> Users can capture viewed images to file using context menu “Save View as” to either DDS, BMP or EXR files</p>
  284. <p><strong>Save Block as:</strong> Users can now save any block to file using “Save Source Block … as”&nbsp;where … is the current cursor location translated to a block position.</p>
  285. <p><strong>Copy to Windows Clipboard:</strong> Users can capture images to Windows Clipboard, using keyboard keys Ctrl C (captures displayed image), Alt C (captures original source image).</p>
  286. </div></blockquote>
  287. </li>
  288. </ul>
  289. <p><strong>Known issues and limitations</strong></p>
  290. <blockquote>
  291. <div><ul class="simple">
  292. <li>After uninstalling the SDK or CLI, Windows short cuts for the tools folder references are not removed. When selecting them in the start menu Windows will prompt for removal.</li>
  293. <li>Vulkan Model Viewer, the code is a preview alpha version, it may cause GUI instability with various models!</li>
  294. </ul>
  295. </div></blockquote>
  296. </div>
  297. <div class="section" id="v3-0">
  298. <h2>V3.0<a class="headerlink" href="#v3-0" title="Permalink to this headline">¶</a></h2>
  299. <p>April 2018</p>
  300. <p>V3.0 release will expand Compressonator assets processing from 2D to 3D.
  301. Please refer to Getting Started document (Section “Getting Started on 3D
  302. Mesh Processing”) if you wish to have a quick start on V3.0.</p>
  303. <p><strong>Features</strong></p>
  304. <p><a class="reference external" href="#_Optimizing_Mesh">3D Mesh Optimization</a></p>
  305. <ul class="simple">
  306. <li>Optimize mesh (.obj model and .bin file from .glTF model) using
  307. vertex cache optimization, overdraw reduction and mesh simplification
  308. using level of details.</li>
  309. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#Analyzing_Mesh">Analyzing Mesh</a> : Provide ACMR (Average Cache
  310. Miss Ratio) and ATVR (Average Transformed Vertices Ratio) statistic
  311. from mesh optimization to analyze mesh optimization only.</li>
  312. </ul>
  313. <p><a class="reference external" href="gui_tool/user_guide/UserGuide.html#Optimizing_Mesh">3D Mesh Compression</a></p>
  314. <ul>
  315. <li><p class="first">Compress mesh (support only .obj model) using Draco library.</p>
  316. <blockquote>
  317. <div><p><a class="reference external" href="#_Image_View_switch">Image View switch between Original and
  318. Processed</a></p>
  319. </div></blockquote>
  320. </li>
  321. <li><p class="first">Original Image View and Processed Image View (Compressed Image View
  322. or Pixels Difference Image View) can be switched with simple key
  323. stokes (O or P)</p>
  324. </li>
  325. </ul>
  326. <p><strong>Known issues and limitations</strong></p>
  327. <ul class="simple">
  328. <li>“Mesh optimization only support glTF and obj file format while mesh
  329. compression only support obj file format.</li>
  330. <li>Embedded gltf is not supported for now. Only gltf with external .bin
  331. mesh file is supported.</li>
  332. <li>.obj file texture load (with an external mtl file) and view is not
  333. supported.</li>
  334. <li>“AutoOpt” in the mesh optimization setting may not produce the best
  335. result, it is just a default setting which includes vertex cache
  336. optimization with cache size of 16, overdraw optimization with ACMR
  337. threshold 1.05 and vertex fetch optimization. The mesh optimization
  338. setting is model-dependent and depend on actual hardware. If result
  339. is not optimized, users are advised to use “UserOpt” setting and
  340. refer to <a class="reference external" href="gui_tool/user_guide/UserGuide.html#Mesh_Optimizer_Settings">Mesh Optimizer Settings for “UserOpt”
  341. selection</a> to set each value manually
  342. or check/uncheck certain optimization.</li>
  343. <li>Mesh Optimization with all selected Mesh Optimizer Settings will need
  344. to work with <a class="reference external" href="gui_tool/user_guide/UserGuide.html#Analyzing_Mesh">mesh analyzing</a> with the values
  345. set to match the hardware to get the optimum result.</li>
  346. <li>KTX 3 color channels multiple mip level may result in GUI crash and
  347. will be fix in next release.</li>
  348. </ul>
  349. </div>
  350. <div class="section" id="v2-7">
  351. <h2>V2.7<a class="headerlink" href="#v2-7" title="Permalink to this headline">¶</a></h2>
  352. <p>October 2017</p>
  353. <p><strong>Features</strong></p>
  354. <ul class="simple">
  355. <li><a class="reference external" href="#_Cross_platform_support">Linux and Mac support-</a> build with
  356. cmake and shell script</li>
  357. <li>Preview of 3D model viewer and asset compression<ul>
  358. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#glTF_Viewer_and">Compress texture images within the glTF
  359. file</a>.</li>
  360. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#glTF_Viewer_and">View 3D Models with DX12 using glTF v2.0</a>
  361. file format <a class="reference external" href="https://www.khronos.org/gltf">https://www.khronos.org/gltf</a></li>
  362. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#glTF_3D_Model">Compare compressed model</a> textures with
  363. original</li>
  364. </ul>
  365. </li>
  366. </ul>
  367. <p><strong>Known issues and limitations</strong></p>
  368. <ul class="simple">
  369. <li>“Drag and drop” does not work due to User Interface Privilege
  370. Isolation technology which forbid dragging from non-admin to admin,
  371. please relaunch the app without admin again if drag and drop does not
  372. work.</li>
  373. <li>glTF viewer is pre-mature and requires DX12 feature level 12, support
  374. only Win10 RS2 or later, also Window SDK 10.0.15063.0 is recommended
  375. for best functionality of the viewer.</li>
  376. <li>Decompress view with Vulkan only support up to driver version 1.5.0.
  377. Stay tune for update to support the latest driver.</li>
  378. <li>Some glTF view might appear zoom in or out. Please use the mouse
  379. wheel to zoom in/out for better view.</li>
  380. </ul>
  381. <p><img alt="image118" src="_images/image1181.png" /></p>
  382. </div>
  383. <div class="section" id="v2-5">
  384. <h2>V2.5<a class="headerlink" href="#v2-5" title="Permalink to this headline">¶</a></h2>
  385. <p>October 2017</p>
  386. <p><strong>Features</strong></p>
  387. <ul class="simple">
  388. <li>GUI updates includes</li>
  389. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#GUI_HDR_Properties">Added support for HDR image view</a>, a HDR
  390. properties window has been added to allow user adjust Exposure,
  391. Defog, Knee Low and Knee-High values.</li>
  392. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#GUI_Channel_weighting">Added support for channel weight
  393. setting</a> in destination setting window
  394. for compression codecs.</li>
  395. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#GUI_Alpha_setting">Added support for alpha setting</a> in
  396. destination setting window for BC1.</li>
  397. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#Selectable_GPU_or">Added option to select image view with GPU or
  398. CPU</a> (decompress with GPU or CPU).</li>
  399. <li>GUI “Process” icon behavior has been changed for the convenience of
  400. the users:<ul>
  401. <li>“Process” icon has been enabled all the time even when users do
  402. not add any compression setting to the original images.</li>
  403. <li>Allow user to drag and drop multiple images and click “Process”
  404. right away, in which GUI will set the compression setting chosen
  405. by the users to all original images.</li>
  406. </ul>
  407. </li>
  408. <li>Codecs updates includes</li>
  409. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#ASTC">ASTC</a></li>
  410. <li><a class="reference external" href="gui_tool/user_guide/UserGuide.html#ETC2">ETC2</a></li>
  411. <li>Improved BC6H Compression quality</li>
  412. </ul>
  413. </div>
  414. <div class="section" id="v2-4">
  415. <h2>V2.4<a class="headerlink" href="#v2-4" title="Permalink to this headline">¶</a></h2>
  416. <p>December 2016</p>
  417. <p><strong>Features</strong></p>
  418. <ul class="simple">
  419. <li>Improved performance of ASTC compression</li>
  420. <li>Performance adjusted according to quality settings</li>
  421. <li>Fast multi-threaded implementation Example: Boat.png sample image
  422. with Quality = 0.05 and BitRate = 8.0 over 40% faster for single
  423. threaded compression compare with v2.3 35x faster for multi threaded
  424. (8 threads on a 8 Core CPU) compression</li>
  425. <li>Support MipMap generation in KTX files</li>
  426. <li>Added TGA image plugin</li>
  427. <li>Added Vulkan GPU based decompression and viewing of compressed image</li>
  428. <li>64-bit support added to Command Line and GUI applications</li>
  429. </ul>
  430. <p><strong>Known issues and limitations</strong></p>
  431. <ul class="simple">
  432. <li>MipMap views is not supported in GPU based decompression</li>
  433. </ul>
  434. <p><strong>Bug Fixes and Changes</strong></p>
  435. <ul class="simple">
  436. <li>GUI application no longer requires GPUOpen CodeXL components<ul>
  437. <li>Replaced Progress Bar</li>
  438. <li>Replaced About Box</li>
  439. <li>Replaced Welcome Page</li>
  440. <li>Removed Crash Reports</li>
  441. </ul>
  442. </li>
  443. <li>To build GUI and CLI applications from source, it is required to
  444. install Qt v5.7 first (Qt v5.5 in common folder is no longer
  445. required)</li>
  446. <li>The path setting for 32 and 64 bit Qt files is set in a shared
  447. VisualStudio project file Compressonator_RootDev.proj</li>
  448. <li>Fixed the problem of corrupted BlockRate values in GUI when loading
  449. project files and processing</li>
  450. <li>Fixed the corrupted image block problem when “BlockRate” width is not
  451. equal to height during ASTC CPU based decompression</li>
  452. <li>Added check on valid ASTC user input block size (WxH) parameter</li>
  453. <li>Fixed ATC_RGB channel swizzle</li>
  454. <li>Fixed missing decompressed image output to TGA file (replaced Qt
  455. plugins with Compressonator’s own TGA plugin)</li>
  456. </ul>
  457. </div>
  458. <div class="section" id="v2-3">
  459. <h2>V2.3<a class="headerlink" href="#v2-3" title="Permalink to this headline">¶</a></h2>
  460. <p>July 2016</p>
  461. <p><strong>Features</strong></p>
  462. <p><a class="reference external" href="gui_tool/user_guide/TextureCompression.html#etc2">ETC2 codec for RGB textures</a></p>
  463. <ul class="simple">
  464. <li>Compatible with OpenGL’s GL_COMPRESSED_RGB8_ETC2 API</li>
  465. </ul>
  466. <p><a class="reference external" href="gui_tool/user_guide/TextureCompression.html#astc">ASTC</a> compression &amp; decompression of various block sizes
  467. from 4x4 to 12x12</p>
  468. <ul class="simple">
  469. <li>Supported through OpenGL APIs</li>
  470. <li>Requires GPU HW supports ASTC format</li>
  471. </ul>
  472. <p><a class="reference external" href="gui_tool/user_guide/UserGuide.html#selectable-gpu-or-cpu-based-compressed-image-views">Selectable GPU or CPU based compressed image
  473. views</a></p>
  474. <ul class="simple">
  475. <li>GPU rendering based on OpenGL or DirectX</li>
  476. </ul>
  477. <p><a class="reference external" href="gui_tool/user_guide/UserGuide.html#gui-channel-weighting">Channel weighting</a></p>
  478. <ul class="simple">
  479. <li>Enabled in Compression setting</li>
  480. </ul>
  481. <p><a class="reference external" href="gui_tool/user_guide/UserGuide.html#GUI-Alpha-setting">Alpha setting enabled for BC1 (DXT1)</a></p>
  482. </div>
  483. </div>
  484. </div>
  485. </div>
  486. </div>
  487. <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
  488. <div class="sphinxsidebarwrapper">
  489. <p class="logo"><a href="index.html">
  490. <img class="logo" src="_static/acompress-128.png" alt="Logo"/>
  491. </a></p>
  492. <h1 class="logo"><a href="index.html">Compressonator</a></h1>
  493. <h3>Navigation</h3>
  494. <p class="caption"><span class="caption-text">Content</span></p>
  495. <ul class="current">
  496. <li class="toctree-l1"><a class="reference internal" href="developer_sdk/index.html">Developer SDK</a></li>
  497. <li class="toctree-l1"><a class="reference internal" href="command_line_tool/index.html">Command Line Tool</a></li>
  498. <li class="toctree-l1"><a class="reference internal" href="gui_tool/index.html">GUI Tool</a></li>
  499. <li class="toctree-l1"><a class="reference internal" href="build_from_source/build_instructions.html">Build from GitHub Sources</a></li>
  500. <li class="toctree-l1"><a class="reference internal" href="analysis/index.html">Analysis</a></li>
  501. <li class="toctree-l1 current"><a class="current reference internal" href="#">Revision History</a></li>
  502. <li class="toctree-l1"><a class="reference internal" href="support/contact.html">Contact and Support</a></li>
  503. <li class="toctree-l1"><a class="reference internal" href="support/license.html">License</a></li>
  504. <li class="toctree-l1"><a class="reference internal" href="bibliography.html">Bibliography</a></li>
  505. </ul>
  506. <div class="relations">
  507. <h3>Related Topics</h3>
  508. <ul>
  509. <li><a href="index.html">Documentation overview</a><ul>
  510. <li>Previous: <a href="analysis/index.html" title="previous chapter">Analysis</a></li>
  511. <li>Next: <a href="support/contact.html" title="next chapter">Contact and Support</a></li>
  512. </ul></li>
  513. </ul>
  514. </div>
  515. <div id="searchbox" style="display: none" role="search">
  516. <h3>Quick search</h3>
  517. <form class="search" action="search.html" method="get">
  518. <div><input type="text" name="q" /></div>
  519. <div><input type="submit" value="Go" /></div>
  520. <input type="hidden" name="check_keywords" value="yes" />
  521. <input type="hidden" name="area" value="default" />
  522. </form>
  523. </div>
  524. <script type="text/javascript">$('#searchbox').show(0);</script>
  525. </div>
  526. </div>
  527. <div class="clearer"></div>
  528. </div>
  529. <div class="footer">
  530. &copy;2017 to 2021, AMD Developer Tools.
  531. |
  532. Powered by <a href="http://sphinx-doc.org/">Sphinx 1.6.5</a>
  533. &amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>
  534. </div>
  535. </body>
  536. </html>