ryan/mozjpeg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Undocument TJ*PARAM_RESTARTBLOCKS for lossless

Browse Source 
TJ*PARAM_RESTARTBLOCKS technically works with lossless compression, but
it is not useful, since the value must be equal to the number of samples
in a row.  (In other words, it is no different than
TJ*PARAM_RESTARTINROWS, except that it requires the user to do more
math.)
This commit is contained in:
DRC
2024-08-28 18:36:37 -04:00
parent d62079717c
commit 5cf7960678
8 changed files with 15 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
doc/html/group___turbo_j_p_e_g.html
View File

@@ -972,19 +972,19 @@ scalingFactor)</code>. </p>
<p>A point transform value of <code>0</code> is necessary in order to generate a fully lossless JPEG image. (A non-zero point transform value right-shifts the input samples by the specified number of bits, which is effectively a form of lossy color quantization.)</p>
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a249f35f0770792b19f995e603bb17c6f" title="Lossless JPEG.">TJPARAM_LOSSLESS</a>, <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a781db82741934e8cd008d308597c59d8" title="JPEG data precision (bits per sample) [decompression only, read-only].">TJPARAM_PRECISION</a> </dd></dl>
</td></tr>
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" name="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec"></a>TJPARAM_RESTARTBLOCKS&#160;</td><td class="fielddoc"><p>JPEG restart marker interval in MCU blocks (lossy) or samples (lossless) [compression only]. </p>
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" name="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec"></a>TJPARAM_RESTARTBLOCKS&#160;</td><td class="fielddoc"><p>JPEG restart marker interval in MCU blocks [lossy compression only]. </p>
<p>The nature of entropy coding is such that a corrupt JPEG image cannot be decompressed beyond the point of corruption unless it contains restart markers. A restart marker stops and restarts the entropy coding algorithm so that, if a JPEG image is corrupted, decompression can resume at the next marker. Thus, adding more restart markers improves the fault tolerance of the JPEG image, but adding too many restart markers can adversely affect the compression ratio and performance.</p>
<p><b>Value</b></p><ul>
<li>the number of MCU blocks or samples between each restart marker <em>[default: <code>0</code> (no restart markers)]</em></li>
<li>the number of MCU blocks between each restart marker <em>[default: <code>0</code> (no restart markers)]</em></li>
</ul>
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c" title="JPEG restart marker interval in MCU rows (lossy) or sample rows (lossless) [compression only].">TJPARAM_RESTARTROWS</a> to 0. </p>
</td></tr>
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c" name="ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c"></a>TJPARAM_RESTARTROWS&#160;</td><td class="fielddoc"><p>JPEG restart marker interval in MCU rows (lossy) or sample rows (lossless) [compression only]. </p>
<p>See <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCU blocks (lossy) or samples (lossless) [compression only].">TJPARAM_RESTARTBLOCKS</a> for a description of restart markers.</p>
<p>See <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCU blocks [lossy compression only].">TJPARAM_RESTARTBLOCKS</a> for a description of restart markers.</p>
<p><b>Value</b></p><ul>
<li>the number of MCU rows or sample rows between each restart marker <em>[default: <code>0</code> (no restart markers)]</em></li>
</ul>
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCU blocks (lossy) or samples (lossless) [compression only].">TJPARAM_RESTARTBLOCKS</a> to 0. </p>
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCU blocks [lossy compression only].">TJPARAM_RESTARTBLOCKS</a> to 0. </p>
</td></tr>
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a4de5c9d7cab5be806143a43c3b0e0877" name="ggaa0f6be63ba78278299c9f5c12031fe82a4de5c9d7cab5be806143a43c3b0e0877"></a>TJPARAM_XDENSITY&#160;</td><td class="fielddoc"><p>JPEG horizontal pixel density. </p>
<p><b>Value</b></p><ul>

3
java/doc/index-all.html
View File

@@ -791,8 +791,7 @@ $('.navPadding').css('padding-top', $('.fixedNav').css("height"));
</dd>
<dt><span class="memberNameLink"><a href="org/libjpegturbo/turbojpeg/TJ.html#PARAM_RESTARTBLOCKS">PARAM_RESTARTBLOCKS</a></span> - Static variable in class org.libjpegturbo.turbojpeg.<a href="org/libjpegturbo/turbojpeg/TJ.html" title="class in org.libjpegturbo.turbojpeg">TJ</a></dt>
<dd>
<div class="block">JPEG restart marker interval in MCU blocks (lossy) or samples (lossless)
[compression only]</div>
<div class="block">JPEG restart marker interval in MCU blocks [lossy compression only]</div>
</dd>
<dt><span class="memberNameLink"><a href="org/libjpegturbo/turbojpeg/TJ.html#PARAM_RESTARTROWS">PARAM_RESTARTROWS</a></span> - Static variable in class org.libjpegturbo.turbojpeg.<a href="org/libjpegturbo/turbojpeg/TJ.html" title="class in org.libjpegturbo.turbojpeg">TJ</a></dt>
<dd>

BIN
java/doc/member-search-index.zip
View File

Binary file not shown.

10
java/doc/org/libjpegturbo/turbojpeg/TJ.html
View File

@@ -417,8 +417,7 @@ extends java.lang.Object</pre>
<td class="colFirst"><code>static int</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#PARAM_RESTARTBLOCKS">PARAM_RESTARTBLOCKS</a></span></code></th>
<td class="colLast">
<div class="block">JPEG restart marker interval in MCU blocks (lossy) or samples (lossless)
[compression only]</div>
<div class="block">JPEG restart marker interval in MCU blocks [lossy compression only]</div>
</td>
</tr>
<tr class="altColor">
@@ -1804,8 +1803,7 @@ extends java.lang.Object</pre>
<li class="blockList">
<h4>PARAM_RESTARTBLOCKS</h4>
<pre>public static final&nbsp;int PARAM_RESTARTBLOCKS</pre>
<div class="block">JPEG restart marker interval in MCU blocks (lossy) or samples (lossless)
[compression only]
<div class="block">JPEG restart marker interval in MCU blocks [lossy compression only]
<p>The nature of entropy coding is such that a corrupt JPEG image cannot
be decompressed beyond the point of corruption unless it contains restart
@@ -1817,8 +1815,8 @@ extends java.lang.Object</pre>
<p><b>Value</b>
<ul>
<li> the number of MCU blocks or samples between each restart marker
<i>[default: <code>0</code> (no restart markers)]</i>
<li> the number of MCU blocks between each restart marker <i>[default:
<code>0</code> (no restart markers)]</i>
</ul>
<p> Setting this parameter to a non-zero value sets

BIN
java/doc/package-search-index.zip
View File

Binary file not shown.

BIN
java/doc/type-search-index.zip
View File

Binary file not shown.

7
java/org/libjpegturbo/turbojpeg/TJ.java
View File

@@ -765,8 +765,7 @@ public final class TJ {
*/
public static final int PARAM_LOSSLESSPT = 17;
/**
* JPEG restart marker interval in MCU blocks (lossy) or samples (lossless)
* [compression only]
* JPEG restart marker interval in MCU blocks [lossy compression only]
*
* <p>The nature of entropy coding is such that a corrupt JPEG image cannot
* be decompressed beyond the point of corruption unless it contains restart
@@ -778,8 +777,8 @@ public final class TJ {
*
* <p><b>Value</b>
* <ul>
* <li> the number of MCU blocks or samples between each restart marker
* <i>[default: <code>0</code> (no restart markers)]</i>
* <li> the number of MCU blocks between each restart marker <i>[default:
* <code>0</code> (no restart markers)]</i>
* </ul>
*
* <p> Setting this parameter to a non-zero value sets

7
turbojpeg.h
View File

@@ -752,8 +752,7 @@ enum TJPARAM {
*/
TJPARAM_LOSSLESSPT,
/**
* JPEG restart marker interval in MCU blocks (lossy) or samples (lossless)
* [compression only]
* JPEG restart marker interval in MCU blocks [lossy compression only]
*
* The nature of entropy coding is such that a corrupt JPEG image cannot
* be decompressed beyond the point of corruption unless it contains restart
@@ -764,8 +763,8 @@ enum TJPARAM {
* adversely affect the compression ratio and performance.
*
* **Value**
* - the number of MCU blocks or samples between each restart marker
* *[default: `0` (no restart markers)]*
* - the number of MCU blocks between each restart marker *[default: `0` (no
* restart markers)]*
*
* Setting this parameter to a non-zero value sets #TJPARAM_RESTARTROWS to 0.
*/