(ChangeLog update forthcoming)
- Prefix all function names with "tj3" and remove version suffixes from
function names. (Future API overhauls will increment the prefix to
"tj4", etc., thus retaining backward API/ABI compatibility without
versioning each individual function.)
- Replace stateless boolean flags (including TJ*FLAG_ARITHMETIC and
TJ*FLAG_LOSSLESS, which were never released) with stateful integer
parameters, the value of which persists between function calls.
* Use parameters for the JPEG quality and subsampling as well, in
order to eliminate the awkwardness of specifying function arguments
that weren't relevant for lossless compression.
* tj3DecompressHeader() now stores all relevant information about the
JPEG image, including the width, height, subsampling type, entropy
coding type, etc. in parameters rather than returning that
information in its arguments.
* TJ*FLAG_LIMITSCANS has been reimplemented as an integer parameter
(TJ*PARAM_SCANLIMIT) that allows the number of scans to be
specified.
- Use the const keyword for all pointer arguments to unmodified
buffers, as well as for both dimensions of 2D pointers. Addresses
#395.
- Use size_t rather than unsigned long to represent buffer sizes, since
unsigned long is a 32-bit type on Windows. Addresses #24.
- Return 0 from all buffer size functions if an error occurs, rather
than awkwardly trying to return -1 in an unsigned data type.
- Implement 12-bit and 16-bit data precision using dedicated
compression, decompression, and image I/O functions/methods.
* Suffix the names of all data-precision-specific functions with 8,
12, or 16.
* Because the YUV functions are intended to be used for video, they
are currently only implemented with 8-bit data precision, but they
can be expanded to 12-bit data precision in the future, if
necessary.
* Extend TJUnitTest and TJBench to test 12-bit and 16-bit data
precision, using a new -precision option.
* Add appropriate regression tests for all of the above to the 'test'
target.
* Extend tjbenchtest to test 12-bit and 16-bit data precision, and
add separate 'tjtest12' and 'tjtest16' targets.
* BufferedImage I/O in the Java API is currently limited to 8-bit
data precision, since the BufferedImage class does not
straightforwardly support higher data precisions.
* Extend the PPM reader to convert 12-bit and 16-bit PBMPLUS files
to grayscale or CMYK pixels, as it already does for 8-bit files.
- Properly accommodate lossless JPEG using dedicated parameters
(TJ*PARAM_LOSSLESS, TJ*PARAM_LOSSLESSPSV, and TJ*PARAM_LOSSLESSPT),
rather than using a flag and awkwardly repurposing the JPEG quality.
Update TJBench to properly reflect whether a JPEG image is lossless.
- Re-organize the TJBench usage screen.
- Update the Java docs using Java 11, to improve the formatting and
eliminate HTML frames.
- Use the accurate integer DCT algorithm by default for both
compression and decompression, since the "fast" algorithm is a legacy
feature, it does not pass the ISO compliance tests, and it is not
actually faster on modern x86 CPUs.
* Remove the -accuratedct option from TJBench and TJExample.
- Re-implement the 'tjtest' target using a CMake script that enables
the appropriate tests, depending on the data precision and whether or
not the Java API is part of the build.
- Consolidate the C and Java versions of tjbenchtest into one script.
- Consolidate the C and Java versions of tjexampletest into one script.
- Combine all initialization functions into a single function
(tj3Init()) that accepts an integer parameter specifying the
subsystems to initialize.
- Enable decompression scaling explicitly, using a new function/method
(tj3SetScalingFactor()/TJDecompressor.setScalingFactor()), rather
than implicitly using awkward "desired width"/"desired height"
parameters.
- Introduce a new macro/constant (TJUNSCALED/TJ.UNSCALED) that maps to
a scaling factor of 1/1.
- Implement partial image decompression, using a new function/method
(tj3SetCroppingRegion()/TJDecompressor.setCroppingRegion()) and
TJBench option (-crop). Extend tjbenchtest to test the new feature.
Addresses #1.
- Allow the JPEG colorspace to be specified explicitly when
compressing, using a new parameter (TJ*PARAM_COLORSPACE). This
allows JPEG images with the RGB and CMYK colorspaces to be created.
- Remove the error/difference image feature from TJBench. Identical
images to the ones that TJBench created can be generated using
ImageMagick with
'magick composite <original_image> <output_image> -compose difference <diff_image>'
- Handle JPEG images with unknown subsampling types. TJ*PARAM_SUBSAMP
is set to TJ*SAMP_UNKNOWN (== -1) for such images, but they can still
be decompressed fully into packed-pixel images or losslessly
transformed (with the exception of lossless cropping.) They cannot
be partially decompressed or decompressed into planar YUV images.
Note also that TJBench, due to its lack of support for imperfect
transforms, requires that the subsampling type be known when
rotating, flipping, or transversely transposing an image. Addresses
#436
- The Java version of TJBench now has identical functionality to the C
version. This was accomplished by (somewhat hackishly) calling the
TurboJPEG C image I/O functions through JNI and copying the pixels
between the C heap and the Java heap.
- Add parameters (TJ*PARAM_RESTARTROWS and TJ*PARAM_RESTARTBLOCKS) and
a TJBench option (-restart) to allow the restart marker interval to
be specified when compressing. Eliminate the undocumented TJ_RESTART
environment variable.
- Add a parameter (TJ*PARAM_OPTIMIZE), a transform option
(TJ*OPT_OPTIMIZE), and a TJBench option (-optimize) to allow
optimized baseline Huffman coding to be specified when compressing.
Eliminate the undocumented TJ_OPTIMIZE environment variable.
- Add parameters (TJ*PARAM_XDENSITY, TJ*PARAM_DENSITY, and
TJ*DENSITYUNITS) to allow the pixel density to be specified when
compressing or saving a Windows BMP image and to be queried when
decompressing or loading a Windows BMP image. Addresses #77.
- Refactor the fuzz targets to use the new API.
* Extend decompression coverage to 12-bit and 16-bit data precision.
* Replace the awkward cjpeg12 and cjpeg16 targets with proper
TurboJPEG-based compress12, compress12-lossless, and
compress16-lossless targets
- Fix innocuous UBSan warnings uncovered by the new fuzzers.
- Implement previous versions of the TurboJPEG API by wrapping the new
functions (tested by running the 2.1.x versions of TJBench, via
tjbenchtest, and TJUnitTest against the new implementation.)
* Remove all JNI functions for deprecated Java methods and implement
the deprecated methods using pure Java wrappers. It should be
understood that backward API compatibility in Java applies only to
the Java classes and that one cannot mix and match a JAR file from
one version of libjpeg-turbo with a JNI library from another
version.
- tj3Destroy() now silently accepts a NULL handle.
- tj3Alloc() and tj3Free() now return/accept void pointers, as malloc()
and free() do.
- The image I/O functions now accept a TurboJPEG instance handle, which
is used to transmit/receive parameters and to receive error
information.
Closes #517
1706 lines
84 KiB
HTML
1706 lines
84 KiB
HTML
<!DOCTYPE HTML>
|
|
<!-- NewPage -->
|
|
<html lang="en">
|
|
<head>
|
|
<!-- Generated by javadoc -->
|
|
<title>TJDecompressor</title>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
|
|
<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
|
|
<link rel="stylesheet" type="text/css" href="../../../jquery/jquery-ui.min.css" title="Style">
|
|
<link rel="stylesheet" type="text/css" href="../../../jquery-ui.overrides.css" title="Style">
|
|
<script type="text/javascript" src="../../../script.js"></script>
|
|
<script type="text/javascript" src="../../../jquery/jszip/dist/jszip.min.js"></script>
|
|
<script type="text/javascript" src="../../../jquery/jszip-utils/dist/jszip-utils.min.js"></script>
|
|
<!--[if IE]>
|
|
<script type="text/javascript" src="../../../jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
|
|
<![endif]-->
|
|
<script type="text/javascript" src="../../../jquery/jquery-3.6.0.min.js"></script>
|
|
<script type="text/javascript" src="../../../jquery/jquery-ui.min.js"></script>
|
|
</head>
|
|
<body>
|
|
<script type="text/javascript"><!--
|
|
try {
|
|
if (location.href.indexOf('is-external=true') == -1) {
|
|
parent.document.title="TJDecompressor";
|
|
}
|
|
}
|
|
catch(err) {
|
|
}
|
|
//-->
|
|
var data = {"i0":10,"i1":42,"i2":42,"i3":42,"i4":42,"i5":42,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":42,"i18":42,"i19":10,"i20":42,"i21":10,"i22":10,"i23":42,"i24":10,"i25":10,"i26":10,"i27":42,"i28":42,"i29":42,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10};
|
|
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
|
|
var altColor = "altColor";
|
|
var rowColor = "rowColor";
|
|
var tableTab = "tableTab";
|
|
var activeTableTab = "activeTableTab";
|
|
var pathtoroot = "../../../";
|
|
var useModuleDirectories = true;
|
|
loadScripts(document, 'script');</script>
|
|
<noscript>
|
|
<div>JavaScript is disabled on your browser.</div>
|
|
</noscript>
|
|
<header role="banner">
|
|
<nav role="navigation">
|
|
<div class="fixedNav">
|
|
<!-- ========= START OF TOP NAVBAR ======= -->
|
|
<div class="topNav"><a id="navbar.top">
|
|
<!-- -->
|
|
</a>
|
|
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
|
|
<a id="navbar.top.firstrow">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="navList" title="Navigation">
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="navBarCell1Rev">Class</li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-all.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="subNav">
|
|
<ul class="navList" id="allclasses_navbar_top">
|
|
<li><a href="../../../allclasses.html">All Classes</a></li>
|
|
</ul>
|
|
<ul class="navListSearch">
|
|
<li><label for="search">SEARCH:</label>
|
|
<input type="text" id="search" value="search" disabled="disabled">
|
|
<input type="reset" id="reset" value="reset" disabled="disabled">
|
|
</li>
|
|
</ul>
|
|
<div>
|
|
<script type="text/javascript"><!--
|
|
allClassesLink = document.getElementById("allclasses_navbar_top");
|
|
if(window==top) {
|
|
allClassesLink.style.display = "block";
|
|
}
|
|
else {
|
|
allClassesLink.style.display = "none";
|
|
}
|
|
//-->
|
|
</script>
|
|
<noscript>
|
|
<div>JavaScript is disabled on your browser.</div>
|
|
</noscript>
|
|
</div>
|
|
<div>
|
|
<ul class="subNavList">
|
|
<li>Summary: </li>
|
|
<li>Nested | </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor.summary">Constr</a> | </li>
|
|
<li><a href="#method.summary">Method</a></li>
|
|
</ul>
|
|
<ul class="subNavList">
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor.detail">Constr</a> | </li>
|
|
<li><a href="#method.detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<a id="skip.navbar.top">
|
|
<!-- -->
|
|
</a></div>
|
|
<!-- ========= END OF TOP NAVBAR ========= -->
|
|
</div>
|
|
<div class="navPadding"> </div>
|
|
<script type="text/javascript"><!--
|
|
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
|
|
//-->
|
|
</script>
|
|
</nav>
|
|
</header>
|
|
<!-- ======== START OF CLASS DATA ======== -->
|
|
<main role="main">
|
|
<div class="header">
|
|
<div class="subTitle"><span class="packageLabelInType">Package</span> <a href="package-summary.html">org.libjpegturbo.turbojpeg</a></div>
|
|
<h2 title="Class TJDecompressor" class="title">Class TJDecompressor</h2>
|
|
</div>
|
|
<div class="contentContainer">
|
|
<ul class="inheritance">
|
|
<li>java.lang.Object</li>
|
|
<li>
|
|
<ul class="inheritance">
|
|
<li>org.libjpegturbo.turbojpeg.TJDecompressor</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<div class="description">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<dl>
|
|
<dt>All Implemented Interfaces:</dt>
|
|
<dd><code>java.io.Closeable</code>, <code>java.lang.AutoCloseable</code></dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>Direct Known Subclasses:</dt>
|
|
<dd><code><a href="TJTransformer.html" title="class in org.libjpegturbo.turbojpeg">TJTransformer</a></code></dd>
|
|
</dl>
|
|
<hr>
|
|
<pre>public class <span class="typeNameLabel">TJDecompressor</span>
|
|
extends java.lang.Object
|
|
implements java.io.Closeable</pre>
|
|
<div class="block">TurboJPEG decompressor</div>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="summary">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
|
|
<section>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a id="constructor.summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Constructor Summary</h3>
|
|
<table class="memberSummary">
|
|
<caption><span>Constructors</span><span class="tabEnd"> </span></caption>
|
|
<tr>
|
|
<th class="colFirst" scope="col">Constructor</th>
|
|
<th class="colLast" scope="col">Description</th>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E()">TJDecompressor</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Create a TurboJPEG decompresssor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E(byte%5B%5D)">TJDecompressor</a></span>​(byte[] jpegImage)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Create a TurboJPEG decompressor instance and associate the JPEG source
|
|
image or "abbreviated table specification" (AKA "tables-only") datastream
|
|
stored in <code>jpegImage</code> with the newly created instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="altColor">
|
|
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E(byte%5B%5D,int)">TJDecompressor</a></span>​(byte[] jpegImage,
|
|
int imageSize)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Create a TurboJPEG decompressor instance and associate the JPEG source
|
|
image or "abbreviated table specification" (AKA "tables-only") datastream
|
|
of length <code>imageSize</code> bytes stored in <code>jpegImage</code>
|
|
with the newly created instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr class="rowColor">
|
|
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E(org.libjpegturbo.turbojpeg.YUVImage)">TJDecompressor</a></span>​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> yuvImage)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Create a TurboJPEG decompressor instance and associate the
|
|
8-bit-per-sample planar YUV source image stored in <code>yuvImage</code>
|
|
with the newly created instance.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
<!-- ========== METHOD SUMMARY =========== -->
|
|
<section>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a id="method.summary">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Method Summary</h3>
|
|
<table class="memberSummary">
|
|
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd"> </span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd"> </span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd"> </span></span><span id="t6" class="tableTab"><span><a href="javascript:show(32);">Deprecated Methods</a></span><span class="tabEnd"> </span></span></caption>
|
|
<tr>
|
|
<th class="colFirst" scope="col">Modifier and Type</th>
|
|
<th class="colSecond" scope="col">Method</th>
|
|
<th class="colLast" scope="col">Description</th>
|
|
</tr>
|
|
<tr id="i0" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#close()">close</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Free the native structures associated with this decompressor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i1" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress(byte%5B%5D,int,int,int,int,int,int,int)">decompress</a></span>​(byte[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int desiredWidth,
|
|
int pitch,
|
|
int desiredHeight,
|
|
int pixelFormat,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>,
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and
|
|
<a href="#decompress8(byte%5B%5D,int,int,int,int)"><code>decompress8(byte[], int, int, int, int)</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i2" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress(int%5B%5D,int,int,int,int,int,int,int)">decompress</a></span>​(int[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int desiredWidth,
|
|
int stride,
|
|
int desiredHeight,
|
|
int pixelFormat,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompress8(int%5B%5D,int,int,int,int)"><code>decompress8(int[], int, int, int, int)</code></a>
|
|
instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i3" class="rowColor">
|
|
<td class="colFirst"><code>java.awt.image.BufferedImage</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress(int,int,int,int)">decompress</a></span>​(int desiredWidth,
|
|
int desiredHeight,
|
|
int bufferedImageType,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompress8(int)"><code>decompress8(int)</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i4" class="altColor">
|
|
<td class="colFirst"><code>byte[]</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress(int,int,int,int,int)">decompress</a></span>​(int desiredWidth,
|
|
int pitch,
|
|
int desiredHeight,
|
|
int pixelFormat,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>,
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and
|
|
<a href="#decompress8(int,int)"><code>decompress8(int, int)</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i5" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress(java.awt.image.BufferedImage,int)">decompress</a></span>​(java.awt.image.BufferedImage dstImage,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompress8(java.awt.image.BufferedImage)"><code>decompress8(BufferedImage)</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i6" class="altColor">
|
|
<td class="colFirst"><code>short[]</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress12(int,int)">decompress12</a></span>​(int pitch,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 12-bit-per-sample JPEG source image associated with this
|
|
decompressor instance and return a buffer containing a 12-bit-per-sample
|
|
packed-pixel decompressed image.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i7" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress12(short%5B%5D,int,int,int,int)">decompress12</a></span>​(short[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int pitch,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 12-bit-per-sample JPEG source image associated with this
|
|
decompressor instance and output a 12-bit-per-sample packed-pixel
|
|
grayscale, RGB, or CMYK image to the given destination buffer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i8" class="altColor">
|
|
<td class="colFirst"><code>short[]</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress16(int,int)">decompress16</a></span>​(int pitch,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 16-bit-per-sample JPEG source image associated with this
|
|
decompressor instance and return a buffer containing a 16-bit-per-sample
|
|
packed-pixel decompressed image.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i9" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress16(short%5B%5D,int,int,int,int)">decompress16</a></span>​(short[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int pitch,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 16-bit-per-sample lossless JPEG source image associated
|
|
with this decompressor instance and output a 16-bit-per-sample
|
|
packed-pixel grayscale, RGB, or CMYK image to the given destination
|
|
buffer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i10" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress8(byte%5B%5D,int,int,int,int)">decompress8</a></span>​(byte[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int pitch,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and output an
|
|
8-bit-per-sample packed-pixel grayscale, RGB, or CMYK image to the given
|
|
destination buffer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i11" class="rowColor">
|
|
<td class="colFirst"><code>java.awt.image.BufferedImage</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress8(int)">decompress8</a></span>​(int bufferedImageType)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and return a
|
|
<code>BufferedImage</code> instance containing the 8-bit-per-sample
|
|
packed-pixel decompressed/decoded image.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i12" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress8(int%5B%5D,int,int,int,int)">decompress8</a></span>​(int[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int stride,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and output an
|
|
8-bit-per-sample packed-pixel grayscale, RGB, or CMYK image to the given
|
|
destination buffer.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i13" class="rowColor">
|
|
<td class="colFirst"><code>byte[]</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress8(int,int)">decompress8</a></span>​(int pitch,
|
|
int pixelFormat)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and return a
|
|
buffer containing an 8-bit-per-sample packed-pixel decompressed image.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i14" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompress8(java.awt.image.BufferedImage)">decompress8</a></span>​(java.awt.image.BufferedImage dstImage)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and output an
|
|
8-bit-per-sample packed-pixel decompressed/decoded image to the given
|
|
<code>BufferedImage</code> instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i15" class="rowColor">
|
|
<td class="colFirst"><code><a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a></code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompressToYUV(int)">decompressToYUV</a></span>​(int align)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image associated with this
|
|
decompressor instance into an 8-bit-per-sample unified planar YUV image
|
|
and return a <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing the decompressed image.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i16" class="altColor">
|
|
<td class="colFirst"><code><a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a></code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompressToYUV(int%5B%5D)">decompressToYUV</a></span>​(int[] strides)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image associated with this
|
|
decompressor instance into a set of 8-bit-per-sample Y, U (Cb), and V (Cr)
|
|
image planes and return a <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing the
|
|
decompressed image planes.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i17" class="rowColor">
|
|
<td class="colFirst"><code><a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a></code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompressToYUV(int,int%5B%5D,int,int)">decompressToYUV</a></span>​(int desiredWidth,
|
|
int[] strides,
|
|
int desiredHeight,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompressToYUV(int%5B%5D)"><code>decompressToYUV(int[])</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i18" class="altColor">
|
|
<td class="colFirst"><code><a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a></code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompressToYUV(int,int,int,int)">decompressToYUV</a></span>​(int desiredWidth,
|
|
int align,
|
|
int desiredHeight,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompressToYUV(int)"><code>decompressToYUV(int)</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i19" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompressToYUV(org.libjpegturbo.turbojpeg.YUVImage)">decompressToYUV</a></span>​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> dstImage)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image associated with this
|
|
decompressor instance into an 8-bit-per-sample planar YUV image and store
|
|
it in the given <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i20" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#decompressToYUV(org.libjpegturbo.turbojpeg.YUVImage,int)">decompressToYUV</a></span>​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> dstImage,
|
|
int flags)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompressToYUV(org.libjpegturbo.turbojpeg.YUVImage)"><code>decompressToYUV(YUVImage)</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i21" class="rowColor">
|
|
<td class="colFirst"><code>protected void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#finalize()">finalize</a></span>()</code></th>
|
|
<td class="colLast"> </td>
|
|
</tr>
|
|
<tr id="i22" class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#get(int)">get</a></span>​(int param)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Get the value of a decompression parameter.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i23" class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getColorspace()">getColorspace</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <code><a href="#get(int)"><code>get</code></a>(<a href="TJ.html#PARAM_COLORSPACE"><code>TJ.PARAM_COLORSPACE</code></a>)</code>
|
|
instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i24" class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getHeight()">getHeight</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Returns the height of the source image (JPEG or YUV) associated with this
|
|
decompressor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i25" class="rowColor">
|
|
<td class="colFirst"><code>byte[]</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getJPEGBuf()">getJPEGBuf</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Returns the JPEG buffer associated with this decompressor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i26" class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getJPEGSize()">getJPEGSize</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Returns the size of the JPEG image (in bytes) associated with this
|
|
decompressor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i27" class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getScaledHeight(int,int)">getScaledHeight</a></span>​(int desiredWidth,
|
|
int desiredHeight)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a> and
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i28" class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getScaledWidth(int,int)">getScaledWidth</a></span>​(int desiredWidth,
|
|
int desiredHeight)</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a> and
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a> instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i29" class="rowColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getSubsamp()">getSubsamp</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <code><a href="#get(int)"><code>get</code></a>(<a href="TJ.html#PARAM_SUBSAMP"><code>TJ.PARAM_SUBSAMP</code></a>)</code>
|
|
instead.</div>
|
|
</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i30" class="altColor">
|
|
<td class="colFirst"><code>int</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getWidth()">getWidth</a></span>()</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Returns the width of the source image (JPEG or YUV) associated with this
|
|
decompressor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i31" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#set(int,int)">set</a></span>​(int param,
|
|
int value)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Set the value of a decompression parameter.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i32" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setCroppingRegion(java.awt.Rectangle)">setCroppingRegion</a></span>​(java.awt.Rectangle croppingRegion)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Set the cropping region for partially decompressing a lossy JPEG image
|
|
into a packed-pixel image.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i33" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)">setScalingFactor</a></span>​(<a href="TJScalingFactor.html" title="class in org.libjpegturbo.turbojpeg">TJScalingFactor</a> scalingFactor)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Set the scaling factor for subsequent lossy decompression operations.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i34" class="altColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setSourceImage(byte%5B%5D,int)">setSourceImage</a></span>​(byte[] jpegImage,
|
|
int imageSize)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Associate the JPEG image or "abbreviated table specification" (AKA
|
|
"tables-only") datastream of length <code>imageSize</code> bytes stored in
|
|
<code>jpegImage</code> with this decompressor instance.</div>
|
|
</td>
|
|
</tr>
|
|
<tr id="i35" class="rowColor">
|
|
<td class="colFirst"><code>void</code></td>
|
|
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setSourceImage(org.libjpegturbo.turbojpeg.YUVImage)">setSourceImage</a></span>​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> srcImage)</code></th>
|
|
<td class="colLast">
|
|
<div class="block">Associate the specified planar YUV source image with this decompressor
|
|
instance.</div>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a id="methods.inherited.from.class.java.lang.Object">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Methods inherited from class java.lang.Object</h3>
|
|
<code>clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div class="details">
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
|
<section>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a id="constructor.detail">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Constructor Detail</h3>
|
|
<a id="<init>()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>TJDecompressor</h4>
|
|
<pre>public TJDecompressor()
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Create a TurboJPEG decompresssor instance.</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="<init>(byte[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>TJDecompressor</h4>
|
|
<pre>public TJDecompressor​(byte[] jpegImage)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Create a TurboJPEG decompressor instance and associate the JPEG source
|
|
image or "abbreviated table specification" (AKA "tables-only") datastream
|
|
stored in <code>jpegImage</code> with the newly created instance. Refer
|
|
to <a href="#setSourceImage(byte%5B%5D,int)"><code>setSourceImage(byte[], int)</code></a> for more details.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>jpegImage</code> - buffer containing a JPEG source image or tables-only
|
|
datastream. (The size of the JPEG image or datastream is assumed to be
|
|
the length of the array.) This buffer is not modified.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="<init>(byte[],int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>TJDecompressor</h4>
|
|
<pre>public TJDecompressor​(byte[] jpegImage,
|
|
int imageSize)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Create a TurboJPEG decompressor instance and associate the JPEG source
|
|
image or "abbreviated table specification" (AKA "tables-only") datastream
|
|
of length <code>imageSize</code> bytes stored in <code>jpegImage</code>
|
|
with the newly created instance. Refer to
|
|
<a href="#setSourceImage(byte%5B%5D,int)"><code>setSourceImage(byte[], int)</code></a> for more details.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>jpegImage</code> - buffer containing a JPEG source image or tables-only
|
|
datastream. This buffer is not modified.</dd>
|
|
<dd><code>imageSize</code> - size of the JPEG source image or tables-only datastream
|
|
(in bytes)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="<init>(org.libjpegturbo.turbojpeg.YUVImage)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockListLast">
|
|
<li class="blockList">
|
|
<h4>TJDecompressor</h4>
|
|
<pre>public TJDecompressor​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> yuvImage)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Create a TurboJPEG decompressor instance and associate the
|
|
8-bit-per-sample planar YUV source image stored in <code>yuvImage</code>
|
|
with the newly created instance. Refer to
|
|
<a href="#setSourceImage(org.libjpegturbo.turbojpeg.YUVImage)"><code>setSourceImage(YUVImage)</code></a> for more details.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>yuvImage</code> - <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing a planar YUV source
|
|
image to be decoded. This image is not modified.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
<!-- ============ METHOD DETAIL ========== -->
|
|
<section>
|
|
<ul class="blockList">
|
|
<li class="blockList"><a id="method.detail">
|
|
<!-- -->
|
|
</a>
|
|
<h3>Method Detail</h3>
|
|
<a id="setSourceImage(byte[],int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>setSourceImage</h4>
|
|
<pre class="methodSignature">public void setSourceImage​(byte[] jpegImage,
|
|
int imageSize)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Associate the JPEG image or "abbreviated table specification" (AKA
|
|
"tables-only") datastream of length <code>imageSize</code> bytes stored in
|
|
<code>jpegImage</code> with this decompressor instance. If
|
|
<code>jpegImage</code> contains a JPEG image, then this image will be used
|
|
as the source image for subsequent decompression operations. Passing a
|
|
tables-only datastream to this method primes the decompressor with
|
|
quantization and Huffman tables that can be used when decompressing
|
|
subsequent "abbreviated image" datastreams. This is useful, for instance,
|
|
when decompressing video streams in which all frames share the same
|
|
quantization and Huffman tables. If a JPEG image is passed to this
|
|
method, then the <a href="TJ.html#PARAM_STOPONWARNING"><code>parameters</code></a> that describe
|
|
the JPEG image will be set when the method returns.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>jpegImage</code> - buffer containing a JPEG source image or tables-only
|
|
datastream. This buffer is not modified.</dd>
|
|
<dd><code>imageSize</code> - size of the JPEG source image or tables-only datastream
|
|
(in bytes)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="setSourceImage(org.libjpegturbo.turbojpeg.YUVImage)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>setSourceImage</h4>
|
|
<pre class="methodSignature">public void setSourceImage​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> srcImage)</pre>
|
|
<div class="block">Associate the specified planar YUV source image with this decompressor
|
|
instance. Subsequent decompression operations will decode this image into
|
|
a packed-pixel RGB or grayscale destination image. This method sets
|
|
<a href="TJ.html#PARAM_SUBSAMP"><code>TJ.PARAM_SUBSAMP</code></a> to the chrominance subsampling level of the
|
|
source image.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>srcImage</code> - <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing a planar YUV source
|
|
image to be decoded. This image is not modified.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="getWidth()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getWidth</h4>
|
|
<pre class="methodSignature">public int getWidth()</pre>
|
|
<div class="block">Returns the width of the source image (JPEG or YUV) associated with this
|
|
decompressor instance.</div>
|
|
<dl>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>the width of the source image (JPEG or YUV) associated with this
|
|
decompressor instance.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="getHeight()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getHeight</h4>
|
|
<pre class="methodSignature">public int getHeight()</pre>
|
|
<div class="block">Returns the height of the source image (JPEG or YUV) associated with this
|
|
decompressor instance.</div>
|
|
<dl>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>the height of the source image (JPEG or YUV) associated with this
|
|
decompressor instance.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="set(int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>set</h4>
|
|
<pre class="methodSignature">public void set​(int param,
|
|
int value)</pre>
|
|
<div class="block">Set the value of a decompression parameter.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>param</code> - one of <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_*</code></a></dd>
|
|
<dd><code>value</code> - value of the decompression parameter (refer to
|
|
<a href="TJ.html#PARAM_STOPONWARNING"><code>parameter documentation</code></a>)</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="get(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>get</h4>
|
|
<pre class="methodSignature">public int get​(int param)</pre>
|
|
<div class="block">Get the value of a decompression parameter.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>param</code> - one of <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_*</code></a></dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>the value of the specified decompression parameter, or -1 if the
|
|
value is unknown.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>setScalingFactor</h4>
|
|
<pre class="methodSignature">public void setScalingFactor​(<a href="TJScalingFactor.html" title="class in org.libjpegturbo.turbojpeg">TJScalingFactor</a> scalingFactor)</pre>
|
|
<div class="block">Set the scaling factor for subsequent lossy decompression operations.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>scalingFactor</code> - <a href="TJScalingFactor.html" title="class in org.libjpegturbo.turbojpeg"><code>TJScalingFactor</code></a> instance that specifies a
|
|
fractional scaling factor that the decompressor supports (see
|
|
<a href="TJ.html#getScalingFactors()"><code>TJ.getScalingFactors()</code></a>), or <a href="TJ.html#UNSCALED"><code>TJ.UNSCALED</code></a> for no scaling.
|
|
Decompression scaling is a function of the IDCT algorithm, so scaling
|
|
factors are generally limited to multiples of 1/8. If the entire JPEG
|
|
image will be decompressed, then the width and height of the scaled
|
|
destination image can be determined by calling
|
|
<code>scalingFactor.</code><a href="TJScalingFactor.html#getScaled(int)"><code>getScaled()</code></a>
|
|
with the JPEG image width and height (see <a href="#getWidth()"><code>getWidth()</code></a> and
|
|
<a href="#getHeight()"><code>getHeight()</code></a>.) When decompressing into a planar YUV image, an
|
|
intermediate buffer copy will be performed if the width or height of the
|
|
scaled destination image is not an even multiple of the MCU block size
|
|
(see <a href="TJ.html#getMCUWidth(int)"><code>TJ.getMCUWidth()</code></a> and <a href="TJ.html#getMCUHeight(int)"><code>TJ.getMCUHeight()</code></a>.) Note that decompression scaling is not available
|
|
(and the specified scaling factor is ignored) when decompressing lossless
|
|
JPEG images (see <a href="TJ.html#PARAM_LOSSLESS"><code>TJ.PARAM_LOSSLESS</code></a>), since the IDCT algorithm is
|
|
not used with those images. Note also that <a href="TJ.html#PARAM_FASTDCT"><code>TJ.PARAM_FASTDCT</code></a> is
|
|
ignored when decompression scaling is enabled.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="setCroppingRegion(java.awt.Rectangle)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>setCroppingRegion</h4>
|
|
<pre class="methodSignature">public void setCroppingRegion​(java.awt.Rectangle croppingRegion)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Set the cropping region for partially decompressing a lossy JPEG image
|
|
into a packed-pixel image.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>croppingRegion</code> - <code>java.awt.Rectangle</code> instance that
|
|
specifies a subregion of the JPEG image to decompress, or
|
|
<a href="TJ.html#UNCROPPED"><code>TJ.UNCROPPED</code></a> for no cropping. The left boundary of the cropping
|
|
region must be evenly divisible by the scaled MCU block width, which can
|
|
be determined by calling <a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a> with the specified scaling factor (see
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>) and the MCU block width
|
|
(see <a href="TJ.html#getMCUWidth(int)"><code>TJ.getMCUWidth()</code></a>) for the level of chrominance
|
|
subsampling in the JPEG image (see <a href="TJ.html#PARAM_SUBSAMP"><code>TJ.PARAM_SUBSAMP</code></a>.) The
|
|
cropping region should be specified relative to the scaled image
|
|
dimensions. Unless <code>croppingRegion</code> is <a href="TJ.html#UNCROPPED"><code>TJ.UNCROPPED</code></a>,
|
|
the JPEG header must be read (see <a href="#setSourceImage(byte%5B%5D,int)"><code>setSourceImage(byte[], int)</code></a>
|
|
prior to calling this method.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="getSubsamp()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getSubsamp</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public int getSubsamp()</pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <code><a href="#get(int)"><code>get</code></a>(<a href="TJ.html#PARAM_SUBSAMP"><code>TJ.PARAM_SUBSAMP</code></a>)</code>
|
|
instead.</div>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
<a id="getColorspace()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getColorspace</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public int getColorspace()</pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <code><a href="#get(int)"><code>get</code></a>(<a href="TJ.html#PARAM_COLORSPACE"><code>TJ.PARAM_COLORSPACE</code></a>)</code>
|
|
instead.</div>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
<a id="getJPEGBuf()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getJPEGBuf</h4>
|
|
<pre class="methodSignature">public byte[] getJPEGBuf()</pre>
|
|
<div class="block">Returns the JPEG buffer associated with this decompressor instance.</div>
|
|
<dl>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>the JPEG buffer associated with this decompressor instance.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="getJPEGSize()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getJPEGSize</h4>
|
|
<pre class="methodSignature">public int getJPEGSize()</pre>
|
|
<div class="block">Returns the size of the JPEG image (in bytes) associated with this
|
|
decompressor instance.</div>
|
|
<dl>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>the size of the JPEG image (in bytes) associated with this
|
|
decompressor instance.</dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="getScaledWidth(int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getScaledWidth</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public int getScaledWidth​(int desiredWidth,
|
|
int desiredHeight)</pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a> and
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a> instead.</div>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
<a id="getScaledHeight(int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>getScaledHeight</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public int getScaledHeight​(int desiredWidth,
|
|
int desiredHeight)</pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a> and
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a> instead.</div>
|
|
</div>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress8(byte[],int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress8</h4>
|
|
<pre class="methodSignature">public void decompress8​(byte[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int pitch,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and output an
|
|
8-bit-per-sample packed-pixel grayscale, RGB, or CMYK image to the given
|
|
destination buffer.
|
|
<p>
|
|
NOTE: The destination image is fully recoverable if this method throws a
|
|
non-fatal <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg"><code>TJException</code></a> (unless <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_STOPONWARNING</code></a> is
|
|
set.)</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>dstBuf</code> - buffer that will receive the packed-pixel
|
|
decompressed/decoded image. This buffer should normally be
|
|
<code>pitch * destinationHeight</code> bytes in size. However, the buffer
|
|
may also be larger, in which case the <code>x</code>, <code>y</code>, and
|
|
<code>pitch</code> parameters can be used to specify the region into which
|
|
the source image should be decompressed/decoded. NOTE: If the source
|
|
image is a lossy JPEG image, then <code>destinationHeight</code> is either
|
|
the scaled JPEG height (see <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>,
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, and
|
|
<a href="#getHeight()"><code>getHeight()</code></a>) or the height of the cropping region (see
|
|
<a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If the source image is a
|
|
YUV image or a lossless JPEG image, then <code>destinationHeight</code> is
|
|
the height of the source image.</dd>
|
|
<dd><code>x</code> - x offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed/decoded</dd>
|
|
<dd><code>y</code> - y offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed/decoded</dd>
|
|
<dd><code>pitch</code> - bytes per row in the destination image. Normally this should
|
|
be set to <code>destinationWidth *
|
|
<a href="TJ.html#getPixelSize(int)"><code>TJ.getPixelSize</code></a>(pixelFormat)</code>, if the
|
|
destination image will be unpadded. (Setting this parameter to 0 is the
|
|
equivalent of setting it to <code>destinationWidth *
|
|
<a href="TJ.html#getPixelSize(int)"><code>TJ.getPixelSize</code></a>(pixelFormat)</code>.) However,
|
|
you can also use this parameter to specify the row alignment/padding of
|
|
the destination image, to skip rows, or to decompress/decode into a
|
|
specific region of a larger image. NOTE: if the source image is a lossy
|
|
JPEG image, then <code>destinationWidth</code> is either the scaled JPEG
|
|
width (see <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>,
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, and
|
|
<a href="#getWidth()"><code>getWidth()</code></a>) or the width of the cropping region (see
|
|
<a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If the source image is a
|
|
YUV image or a lossless JPEG image, then <code>destinationWidth</code> is
|
|
the width of the source image.</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed/decoded image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress(byte[],int,int,int,int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public void decompress​(byte[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int desiredWidth,
|
|
int pitch,
|
|
int desiredHeight,
|
|
int pixelFormat,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>,
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and
|
|
<a href="#decompress8(byte%5B%5D,int,int,int,int)"><code>decompress8(byte[], int, int, int, int)</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress8(int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress8</h4>
|
|
<pre class="methodSignature">public byte[] decompress8​(int pitch,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and return a
|
|
buffer containing an 8-bit-per-sample packed-pixel decompressed image.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>pitch</code> - see
|
|
<a href="#decompress8(byte%5B%5D,int,int,int,int)"><code>decompress8(byte[], int, int, int, int)</code></a> for description</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>a buffer containing an 8-bit-per-sample packed-pixel decompressed
|
|
image.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress(int,int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public byte[] decompress​(int desiredWidth,
|
|
int pitch,
|
|
int desiredHeight,
|
|
int pixelFormat,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>,
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and
|
|
<a href="#decompress8(int,int)"><code>decompress8(int, int)</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress12(short[],int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress12</h4>
|
|
<pre class="methodSignature">public void decompress12​(short[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int pitch,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 12-bit-per-sample JPEG source image associated with this
|
|
decompressor instance and output a 12-bit-per-sample packed-pixel
|
|
grayscale, RGB, or CMYK image to the given destination buffer.
|
|
<p>
|
|
NOTE: The destination image is fully recoverable if this method throws a
|
|
non-fatal <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg"><code>TJException</code></a> (unless <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_STOPONWARNING</code></a> is
|
|
set.)</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>dstBuf</code> - buffer that will receive the packed-pixel
|
|
decompressed image. This buffer should normally be
|
|
<code>pitch * destinationHeight</code> samples in size. However, the
|
|
buffer may also be larger, in which case the <code>x</code>,
|
|
<code>y</code>, and <code>pitch</code> parameters can be used to specify
|
|
the region into which the source image should be decompressed. NOTE: If
|
|
the source image is a lossy JPEG image, then
|
|
<code>destinationHeight</code> is either the scaled JPEG height (see
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>,
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, and
|
|
<a href="#getHeight()"><code>getHeight()</code></a>) or the height of the cropping region (see
|
|
<a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If the source image is a
|
|
lossless JPEG image, then <code>destinationHeight</code> is the height of
|
|
the source image.</dd>
|
|
<dd><code>x</code> - x offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed</dd>
|
|
<dd><code>y</code> - y offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed</dd>
|
|
<dd><code>pitch</code> - samples per row in the destination image. Normally this
|
|
should be set to <code>destinationWidth *
|
|
<a href="TJ.html#getPixelSize(int)"><code>TJ.getPixelSize</code></a>(pixelFormat)</code>, if the
|
|
destination image will be unpadded. (Setting this parameter to 0 is the
|
|
equivalent of setting it to <code>destinationWidth *
|
|
<a href="TJ.html#getPixelSize(int)"><code>TJ.getPixelSize</code></a>(pixelFormat)</code>.) However,
|
|
you can also use this parameter to specify the row alignment/padding of
|
|
the destination image, to skip rows, or to decompress into a specific
|
|
region of a larger image. NOTE: if the source image is a lossy JPEG
|
|
image, then <code>destinationWidth</code> is either the scaled JPEG width
|
|
(see <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>,
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, and
|
|
<a href="#getWidth()"><code>getWidth()</code></a>) or the width of the cropping region (see
|
|
<a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If the source image is a
|
|
YUV image or a lossless JPEG image, then <code>destinationWidth</code> is
|
|
the width of the source image.</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress12(int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress12</h4>
|
|
<pre class="methodSignature">public short[] decompress12​(int pitch,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 12-bit-per-sample JPEG source image associated with this
|
|
decompressor instance and return a buffer containing a 12-bit-per-sample
|
|
packed-pixel decompressed image.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>pitch</code> - see
|
|
<a href="#decompress12(short%5B%5D,int,int,int,int)"><code>decompress12(short[], int, int, int, int)</code></a> for description</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>a buffer containing an 8-bit-per-sample packed-pixel decompressed
|
|
image.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress16(short[],int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress16</h4>
|
|
<pre class="methodSignature">public void decompress16​(short[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int pitch,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 16-bit-per-sample lossless JPEG source image associated
|
|
with this decompressor instance and output a 16-bit-per-sample
|
|
packed-pixel grayscale, RGB, or CMYK image to the given destination
|
|
buffer.
|
|
<p>
|
|
NOTE: The destination image is fully recoverable if this method throws a
|
|
non-fatal <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg"><code>TJException</code></a> (unless <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_STOPONWARNING</code></a> is
|
|
set.)</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>dstBuf</code> - buffer that will receive the packed-pixel
|
|
decompressed image. This buffer should normally be
|
|
<code>pitch * jpegHeight</code> samples in size. However, the buffer may
|
|
also be larger, in which case the <code>x</code>,
|
|
<code>y</code>, and <code>pitch</code> parameters can be used to specify
|
|
the region into which the source image should be decompressed.</dd>
|
|
<dd><code>x</code> - x offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed</dd>
|
|
<dd><code>y</code> - y offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed</dd>
|
|
<dd><code>pitch</code> - samples per row in the destination image. Normally this
|
|
should be set to <code>jpegWidth *
|
|
<a href="TJ.html#getPixelSize(int)"><code>TJ.getPixelSize</code></a>(pixelFormat)</code>, if the
|
|
destination image will be unpadded. (Setting this parameter to 0 is the
|
|
equivalent of setting it to <code>jpegWidth *
|
|
<a href="TJ.html#getPixelSize(int)"><code>TJ.getPixelSize</code></a>(pixelFormat)</code>.) However,
|
|
you can also use this parameter to specify the row alignment/padding of
|
|
the destination image, to skip rows, or to decompress into a specific
|
|
region of a larger image.</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress16(int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress16</h4>
|
|
<pre class="methodSignature">public short[] decompress16​(int pitch,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 16-bit-per-sample JPEG source image associated with this
|
|
decompressor instance and return a buffer containing a 16-bit-per-sample
|
|
packed-pixel decompressed image.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>pitch</code> - see
|
|
<a href="#decompress16(short%5B%5D,int,int,int,int)"><code>decompress16(short[], int, int, int, int)</code></a> for description</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>a buffer containing an 8-bit-per-sample packed-pixel decompressed
|
|
image.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompressToYUV(org.libjpegturbo.turbojpeg.YUVImage)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompressToYUV</h4>
|
|
<pre class="methodSignature">public void decompressToYUV​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> dstImage)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image associated with this
|
|
decompressor instance into an 8-bit-per-sample planar YUV image and store
|
|
it in the given <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance. This method performs JPEG
|
|
decompression but leaves out the color conversion step, so a planar YUV
|
|
image is generated instead of a packed-pixel image. This method cannot be
|
|
used to decompress JPEG source images with the CMYK or YCCK colorspace.
|
|
<p>
|
|
NOTE: The planar YUV destination image is fully recoverable if this method
|
|
throws a non-fatal <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg"><code>TJException</code></a> (unless
|
|
<a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_STOPONWARNING</code></a> is set.)</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>dstImage</code> - <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance that will receive the planar YUV
|
|
decompressed image. The level of subsampling specified in this
|
|
<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance must match that of the JPEG image, and the width
|
|
and height specified in the <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance must match the
|
|
scaled JPEG width and height (see <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, <a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, <a href="#getWidth()"><code>getWidth()</code></a>, and <a href="#getHeight()"><code>getHeight()</code></a>.)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompressToYUV(org.libjpegturbo.turbojpeg.YUVImage,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompressToYUV</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public void decompressToYUV​(<a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> dstImage,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompressToYUV(org.libjpegturbo.turbojpeg.YUVImage)"><code>decompressToYUV(YUVImage)</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompressToYUV(int[])">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompressToYUV</h4>
|
|
<pre class="methodSignature">public <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> decompressToYUV​(int[] strides)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image associated with this
|
|
decompressor instance into a set of 8-bit-per-sample Y, U (Cb), and V (Cr)
|
|
image planes and return a <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing the
|
|
decompressed image planes. This method performs JPEG decompression but
|
|
leaves out the color conversion step, so a planar YUV image is generated
|
|
instead of a packed-pixel image. This method cannot be used to decompress
|
|
JPEG source images with the CMYK or YCCK colorspace.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>strides</code> - an array of integers, each specifying the number of bytes
|
|
per row in the corresponding plane of the YUV image. Setting the stride
|
|
for any plane to 0 is the same as setting it to the scaled plane width
|
|
(see <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a>.) If <code>strides</code> is null, then the strides
|
|
for all planes will be set to their respective scaled plane widths. You
|
|
can adjust the strides in order to add an arbitrary amount of row padding
|
|
to each plane.</dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>a <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing the decompressed image
|
|
planes</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompressToYUV(int,int[],int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompressToYUV</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> decompressToYUV​(int desiredWidth,
|
|
int[] strides,
|
|
int desiredHeight,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompressToYUV(int%5B%5D)"><code>decompressToYUV(int[])</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompressToYUV(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompressToYUV</h4>
|
|
<pre class="methodSignature">public <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> decompressToYUV​(int align)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image associated with this
|
|
decompressor instance into an 8-bit-per-sample unified planar YUV image
|
|
and return a <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing the decompressed image.
|
|
This method performs JPEG decompression but leaves out the color
|
|
conversion step, so a planar YUV image is generated instead of a
|
|
packed-pixel image. This method cannot be used to decompress JPEG source
|
|
images with the CMYK or YCCK colorspace.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>align</code> - row alignment (in bytes) of the YUV image (must be a power of
|
|
2.) Setting this parameter to n will cause each row in each plane of the
|
|
YUV image to be padded to the nearest multiple of n bytes (1 = unpadded.)</dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>a <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg"><code>YUVImage</code></a> instance containing the unified planar YUV
|
|
decompressed image</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompressToYUV(int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompressToYUV</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public <a href="YUVImage.html" title="class in org.libjpegturbo.turbojpeg">YUVImage</a> decompressToYUV​(int desiredWidth,
|
|
int align,
|
|
int desiredHeight,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompressToYUV(int)"><code>decompressToYUV(int)</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress8(int[],int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress8</h4>
|
|
<pre class="methodSignature">public void decompress8​(int[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int stride,
|
|
int pixelFormat)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and output an
|
|
8-bit-per-sample packed-pixel grayscale, RGB, or CMYK image to the given
|
|
destination buffer.
|
|
<p>
|
|
NOTE: The destination image is fully recoverable if this method throws a
|
|
non-fatal <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg"><code>TJException</code></a> (unless <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_STOPONWARNING</code></a>
|
|
is set.)</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>dstBuf</code> - buffer that will receive the packed-pixel
|
|
decompressed/decoded image. This buffer should normally be
|
|
<code>stride * destinationHeight</code> pixels in size. However, the
|
|
buffer may also be larger, in which case the <code>x</code>,
|
|
<code>y</code>, and <code>pitch</code> parameters can be used to specify
|
|
the region into which the source image should be decompressed/decoded.
|
|
NOTE: If the source image is a lossy JPEG image, then
|
|
<code>destinationHeight</code> is either the scaled JPEG height (see
|
|
<a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>,
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, and
|
|
<a href="#getHeight()"><code>getHeight()</code></a>) or the height of the cropping region (see
|
|
<a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If the source image is a
|
|
YUV image or a lossless JPEG image, then <code>destinationHeight</code> is
|
|
the height of the source image.</dd>
|
|
<dd><code>x</code> - x offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed/decoded</dd>
|
|
<dd><code>y</code> - y offset (in pixels) of the region in the destination image into
|
|
which the source image should be decompressed/decoded</dd>
|
|
<dd><code>stride</code> - pixels per row in the destination image. Normally this
|
|
should be set to <code>destinationWidth</code>. (Setting this parameter
|
|
to 0 is the equivalent of setting it to <code>destinationWidth</code>.)
|
|
However, you can also use this parameter to skip rows or to
|
|
decompress/decode into a specific region of a larger image. NOTE: if the
|
|
source image is a lossy JPEG image, then <code>destinationWidth</code> is
|
|
either the scaled JPEG width (see <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, <a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>, and <a href="#getWidth()"><code>getWidth()</code></a>) or the width of the
|
|
cropping region (see <a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If
|
|
the source image is a YUV image or a lossless JPEG image, then
|
|
<code>destinationWidth</code> is the width of the source image.</dd>
|
|
<dd><code>pixelFormat</code> - pixel format of the decompressed/decoded image (one of
|
|
<a href="TJ.html#PF_RGB"><code>TJ.PF_*</code></a>)</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress(int[],int,int,int,int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public void decompress​(int[] dstBuf,
|
|
int x,
|
|
int y,
|
|
int desiredWidth,
|
|
int stride,
|
|
int desiredHeight,
|
|
int pixelFormat,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompress8(int%5B%5D,int,int,int,int)"><code>decompress8(int[], int, int, int, int)</code></a>
|
|
instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress8(java.awt.image.BufferedImage)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress8</h4>
|
|
<pre class="methodSignature">public void decompress8​(java.awt.image.BufferedImage dstImage)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and output an
|
|
8-bit-per-sample packed-pixel decompressed/decoded image to the given
|
|
<code>BufferedImage</code> instance.
|
|
<p>
|
|
NOTE: The destination image is fully recoverable if this method throws a
|
|
non-fatal <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg"><code>TJException</code></a> (unless <a href="TJ.html#PARAM_STOPONWARNING"><code>TJ.PARAM_STOPONWARNING</code></a>
|
|
is set.)</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>dstImage</code> - a <code>BufferedImage</code> instance that will receive
|
|
the packed-pixel decompressed/decoded image. If the source image is a
|
|
lossy JPEG image, then the width and height of the
|
|
<code>BufferedImage</code> instance must match the scaled JPEG width and
|
|
height (see <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>,
|
|
<a href="TJScalingFactor.html#getScaled(int)"><code>TJScalingFactor.getScaled()</code></a>,
|
|
<a href="#getWidth()"><code>getWidth()</code></a>, and <a href="#getHeight()"><code>getHeight()</code></a>) or the width and height of the
|
|
cropping region (see <a href="#setCroppingRegion(java.awt.Rectangle)"><code>setCroppingRegion()</code></a>.) If
|
|
the source image is a YUV image or a lossless JPEG image, then the width
|
|
and height of the <code>BufferedImage</code> instance must match the width
|
|
and height of the source image.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress(java.awt.image.BufferedImage,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public void decompress​(java.awt.image.BufferedImage dstImage,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompress8(java.awt.image.BufferedImage)"><code>decompress8(BufferedImage)</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress8(int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress8</h4>
|
|
<pre class="methodSignature">public java.awt.image.BufferedImage decompress8​(int bufferedImageType)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Decompress the 8-bit-per-sample JPEG source image or decode the planar YUV
|
|
source image associated with this decompressor instance and return a
|
|
<code>BufferedImage</code> instance containing the 8-bit-per-sample
|
|
packed-pixel decompressed/decoded image.</div>
|
|
<dl>
|
|
<dt><span class="paramLabel">Parameters:</span></dt>
|
|
<dd><code>bufferedImageType</code> - the image type of the <code>BufferedImage</code>
|
|
instance that will be created (for instance,
|
|
<code>BufferedImage.TYPE_INT_RGB</code>)</dd>
|
|
<dt><span class="returnLabel">Returns:</span></dt>
|
|
<dd>a <code>BufferedImage</code> instance containing the
|
|
8-bit-per-sample packed-pixel decompressed/decoded image.</dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="decompress(int,int,int,int)">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>decompress</h4>
|
|
<pre class="methodSignature">@Deprecated
|
|
public java.awt.image.BufferedImage decompress​(int desiredWidth,
|
|
int desiredHeight,
|
|
int bufferedImageType,
|
|
int flags)
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="deprecationBlock"><span class="deprecatedLabel">Deprecated.</span>
|
|
<div class="deprecationComment">Use <a href="#set(int,int)"><code>set()</code></a>, <a href="#setScalingFactor(org.libjpegturbo.turbojpeg.TJScalingFactor)"><code>setScalingFactor()</code></a>, and <a href="#decompress8(int)"><code>decompress8(int)</code></a> instead.</div>
|
|
</div>
|
|
<dl>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="close()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockList">
|
|
<li class="blockList">
|
|
<h4>close</h4>
|
|
<pre class="methodSignature">public void close()
|
|
throws <a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></pre>
|
|
<div class="block">Free the native structures associated with this decompressor instance.</div>
|
|
<dl>
|
|
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
|
|
<dd><code>close</code> in interface <code>java.lang.AutoCloseable</code></dd>
|
|
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
|
|
<dd><code>close</code> in interface <code>java.io.Closeable</code></dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code><a href="TJException.html" title="class in org.libjpegturbo.turbojpeg">TJException</a></code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
<a id="finalize()">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="blockListLast">
|
|
<li class="blockList">
|
|
<h4>finalize</h4>
|
|
<pre class="methodSignature">protected void finalize()
|
|
throws java.lang.Throwable</pre>
|
|
<dl>
|
|
<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
|
|
<dd><code>finalize</code> in class <code>java.lang.Object</code></dd>
|
|
<dt><span class="throwsLabel">Throws:</span></dt>
|
|
<dd><code>java.lang.Throwable</code></dd>
|
|
</dl>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</section>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
</main>
|
|
<!-- ========= END OF CLASS DATA ========= -->
|
|
<footer role="contentinfo">
|
|
<nav role="navigation">
|
|
<!-- ======= START OF BOTTOM NAVBAR ====== -->
|
|
<div class="bottomNav"><a id="navbar.bottom">
|
|
<!-- -->
|
|
</a>
|
|
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
|
|
<a id="navbar.bottom.firstrow">
|
|
<!-- -->
|
|
</a>
|
|
<ul class="navList" title="Navigation">
|
|
<li><a href="package-summary.html">Package</a></li>
|
|
<li class="navBarCell1Rev">Class</li>
|
|
<li><a href="package-tree.html">Tree</a></li>
|
|
<li><a href="../../../deprecated-list.html">Deprecated</a></li>
|
|
<li><a href="../../../index-all.html">Index</a></li>
|
|
<li><a href="../../../help-doc.html">Help</a></li>
|
|
</ul>
|
|
</div>
|
|
<div class="subNav">
|
|
<ul class="navList" id="allclasses_navbar_bottom">
|
|
<li><a href="../../../allclasses.html">All Classes</a></li>
|
|
</ul>
|
|
<div>
|
|
<script type="text/javascript"><!--
|
|
allClassesLink = document.getElementById("allclasses_navbar_bottom");
|
|
if(window==top) {
|
|
allClassesLink.style.display = "block";
|
|
}
|
|
else {
|
|
allClassesLink.style.display = "none";
|
|
}
|
|
//-->
|
|
</script>
|
|
<noscript>
|
|
<div>JavaScript is disabled on your browser.</div>
|
|
</noscript>
|
|
</div>
|
|
<div>
|
|
<ul class="subNavList">
|
|
<li>Summary: </li>
|
|
<li>Nested | </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor.summary">Constr</a> | </li>
|
|
<li><a href="#method.summary">Method</a></li>
|
|
</ul>
|
|
<ul class="subNavList">
|
|
<li>Detail: </li>
|
|
<li>Field | </li>
|
|
<li><a href="#constructor.detail">Constr</a> | </li>
|
|
<li><a href="#method.detail">Method</a></li>
|
|
</ul>
|
|
</div>
|
|
<a id="skip.navbar.bottom">
|
|
<!-- -->
|
|
</a></div>
|
|
<!-- ======== END OF BOTTOM NAVBAR ======= -->
|
|
</nav>
|
|
</footer>
|
|
</body>
|
|
</html>
|