Class TJ
- java.lang.Object
- 
- org.libjpegturbo.turbojpeg.TJ
 
- 
 public final class TJ extends java.lang.ObjectTurboJPEG utility class (cannot be instantiated)
- 
- 
Field SummaryFields Modifier and Type Field Description static intCS_CMYKCMYK colorspace.static intCS_GRAYGrayscale colorspace.static intCS_RGBRGB colorspace.static intCS_YCbCrYCbCr colorspace.static intCS_YCCKYCCK colorspace.static intERR_FATALThe error was fatal and non-recoverable.static intERR_WARNINGThe error was non-fatal and recoverable, but the destination image may still be corrupt.static intFLAG_ACCURATEDCTDeprecated.UsePARAM_FASTDCTinstead.static intFLAG_BOTTOMUPDeprecated.UsePARAM_BOTTOMUPinstead.static intFLAG_FASTDCTDeprecated.UsePARAM_FASTDCTinstead.static intFLAG_FASTUPSAMPLEDeprecated.UsePARAM_FASTUPSAMPLEinstead.static intFLAG_LIMITSCANSDeprecated.UsePARAM_SCANLIMITinstead.static intFLAG_PROGRESSIVEDeprecated.UsePARAM_PROGRESSIVEinstead.static intFLAG_STOPONWARNINGDeprecated.UsePARAM_STOPONWARNINGinstead.static intNUMCSThe number of JPEG colorspacesstatic intNUMERRThe number of error codesstatic intNUMPFThe number of pixel formatsstatic intNUMSAMPThe number of chrominance subsampling optionsstatic intPARAM_ARITHMETICArithmetic entropy codingstatic intPARAM_BOTTOMUPRow order in packed-pixel source/destination imagesstatic intPARAM_COLORSPACEJPEG colorspacestatic intPARAM_DENSITYUNITSJPEG pixel density unitsstatic intPARAM_FASTDCTDCT/IDCT algorithm [lossy compression and decompression]static intPARAM_FASTUPSAMPLEChrominance upsampling algorithm [lossy decompression only]static intPARAM_JPEGHEIGHTJPEG height (in pixels) [decompression only, read-only]static intPARAM_JPEGWIDTHJPEG width (in pixels) [decompression only, read-only]static intPARAM_LOSSLESSLossless JPEGstatic intPARAM_LOSSLESSPSVLossless JPEG predictor selection value (PSV)static intPARAM_LOSSLESSPTLossless JPEG point transform (Pt)static intPARAM_OPTIMIZEOptimized baseline entropy coding [lossy compression only]static intPARAM_PRECISIONJPEG data precision (bits per sample) [decompression only, read-only]static intPARAM_PROGRESSIVEProgressive entropy codingstatic intPARAM_QUALITYPerceptual quality of lossy JPEG images [compression only]static intPARAM_RESTARTBLOCKSJPEG restart marker interval in MCU blocks (lossy) or samples (lossless) [compression only]static intPARAM_RESTARTROWSJPEG restart marker interval in MCU rows (lossy) or sample rows (lossless) [compression only]static intPARAM_SCANLIMITProgressive JPEG scan limit for lossy JPEG images [decompression, lossless transformation]static intPARAM_STOPONWARNINGError handling behaviorstatic intPARAM_SUBSAMPChrominance subsampling levelstatic intPARAM_XDENSITYJPEG horizontal pixel densitystatic intPARAM_YDENSITYJPEG vertical pixel densitystatic intPF_ABGRABGR pixel format.static intPF_ARGBARGB pixel format.static intPF_BGRBGR pixel format.static intPF_BGRABGRA pixel format.static intPF_BGRXBGRX pixel format.static intPF_CMYKCMYK pixel format.static intPF_GRAYGrayscale pixel format.static intPF_RGBRGB pixel format.static intPF_RGBARGBA pixel format.static intPF_RGBXRGBX pixel format.static intPF_XBGRXBGR pixel format.static intPF_XRGBXRGB pixel format.static intSAMP_4114:1:1 chrominance subsampling.static intSAMP_4204:2:0 chrominance subsampling.static intSAMP_4224:2:2 chrominance subsampling.static intSAMP_4404:4:0 chrominance subsampling.static intSAMP_4414:4:1 chrominance subsampling.static intSAMP_4444:4:4 chrominance subsampling (no chrominance subsampling).static intSAMP_GRAYGrayscale.static intSAMP_UNKNOWNUnknown subsampling.static java.awt.RectangleUNCROPPEDAjava.awt.Rectangleinstance that specifies no croppingstatic TJScalingFactorUNSCALEDATJScalingFactorinstance that specifies a scaling factor of 1/1 (no scaling)
 - 
Method SummaryAll Methods Static Methods Concrete Methods Modifier and Type Method Description static intbufSize(int width, int height, int jpegSubsamp)Returns the maximum size of the buffer (in bytes) required to hold a JPEG image with the given width, height, and level of chrominance subsampling.static intbufSizeYUV(int width, int align, int height, int subsamp)Returns the size of the buffer (in bytes) required to hold a unified planar YUV image with the given width, height, and level of chrominance subsampling.static intgetAlphaOffset(int pixelFormat)For the given pixel format, returns the number of samples that the alpha component is offset from the start of the pixel.static intgetBlueOffset(int pixelFormat)For the given pixel format, returns the number of samples that the blue component is offset from the start of the pixel.static intgetGreenOffset(int pixelFormat)For the given pixel format, returns the number of samples that the green component is offset from the start of the pixel.static intgetMCUHeight(int subsamp)Returns the MCU block height for the given level of chrominance subsampling.static intgetMCUWidth(int subsamp)Returns the MCU block width for the given level of chrominance subsampling.static intgetPixelSize(int pixelFormat)Returns the pixel size (in samples) for the given pixel format.static intgetRedOffset(int pixelFormat)For the given pixel format, returns the number of samples that the red component is offset from the start of the pixel.static TJScalingFactor[]getScalingFactors()Returns a list of fractional scaling factors that the JPEG decompressor supports.static intplaneHeight(int componentID, int height, int subsamp)Returns the plane height of a YUV image plane with the given parameters.static intplaneSizeYUV(int componentID, int width, int stride, int height, int subsamp)Returns the size of the buffer (in bytes) required to hold a YUV image plane with the given parameters.static intplaneWidth(int componentID, int width, int subsamp)Returns the plane width of a YUV image plane with the given parameters.
 
- 
- 
- 
Field Detail- 
NUMSAMPpublic static final int NUMSAMP The number of chrominance subsampling options- See Also:
- Constant Field Values
 
 - 
SAMP_444public static final int SAMP_444 4:4:4 chrominance subsampling (no chrominance subsampling). The JPEG or YUV image will contain one chrominance component for every pixel in the source image.- See Also:
- Constant Field Values
 
 - 
SAMP_422public static final int SAMP_422 4:2:2 chrominance subsampling. The JPEG or YUV image will contain one chrominance component for every 2x1 block of pixels in the source image.- See Also:
- Constant Field Values
 
 - 
SAMP_420public static final int SAMP_420 4:2:0 chrominance subsampling. The JPEG or YUV image will contain one chrominance component for every 2x2 block of pixels in the source image.- See Also:
- Constant Field Values
 
 - 
SAMP_GRAYpublic static final int SAMP_GRAY Grayscale. The JPEG or YUV image will contain no chrominance components.- See Also:
- Constant Field Values
 
 - 
SAMP_440public static final int SAMP_440 4:4:0 chrominance subsampling. The JPEG or YUV image will contain one chrominance component for every 1x2 block of pixels in the source image. Note that 4:4:0 subsampling is not fully accelerated in libjpeg-turbo.- See Also:
- Constant Field Values
 
 - 
SAMP_411public static final int SAMP_411 4:1:1 chrominance subsampling. The JPEG or YUV image will contain one chrominance component for every 4x1 block of pixels in the source image. JPEG images compressed with 4:1:1 subsampling will be almost exactly the same size as those compressed with 4:2:0 subsampling, and in the aggregate, both subsampling methods produce approximately the same perceptual quality. However, 4:1:1 is better able to reproduce sharp horizontal features. Note that 4:1:1 subsampling is not fully accelerated in libjpeg-turbo.- See Also:
- Constant Field Values
 
 - 
SAMP_441public static final int SAMP_441 4:4:1 chrominance subsampling. The JPEG or YUV image will contain one chrominance component for every 1x4 block of pixels in the source image. JPEG images compressed with 4:4:1 subsampling will be almost exactly the same size as those compressed with 4:2:0 subsampling, and in the aggregate, both subsampling methods produce approximately the same perceptual quality. However, 4:4:1 is better able to reproduce sharp vertical features. Note that 4:4:1 subsampling is not fully accelerated in libjpeg-turbo.- See Also:
- Constant Field Values
 
 - 
SAMP_UNKNOWNpublic static final int SAMP_UNKNOWN Unknown subsampling. The JPEG image uses an unusual type of chrominance subsampling. Such images can be decompressed into packed-pixel images, but they cannot be- decompressed into planar YUV images,
-  losslessly transformed if TJTransform.OPT_CROPis specified, or
- partially decompressed using a cropping region.
 - See Also:
- Constant Field Values
 
 - 
NUMPFpublic static final int NUMPF The number of pixel formats- See Also:
- Constant Field Values
 
 - 
PF_RGBpublic static final int PF_RGB RGB pixel format. The red, green, and blue components in the image are stored in 3-sample pixels in the order R, G, B from lowest to highest memory address within each pixel.- See Also:
- Constant Field Values
 
 - 
PF_BGRpublic static final int PF_BGR BGR pixel format. The red, green, and blue components in the image are stored in 3-sample pixels in the order B, G, R from lowest to highest memory address within each pixel.- See Also:
- Constant Field Values
 
 - 
PF_RGBXpublic static final int PF_RGBX RGBX pixel format. The red, green, and blue components in the image are stored in 4-sample pixels in the order R, G, B from lowest to highest memory address within each pixel. The X component is ignored when compressing and undefined when decompressing.- See Also:
- Constant Field Values
 
 - 
PF_BGRXpublic static final int PF_BGRX BGRX pixel format. The red, green, and blue components in the image are stored in 4-sample pixels in the order B, G, R from lowest to highest memory address within each pixel. The X component is ignored when compressing and undefined when decompressing.- See Also:
- Constant Field Values
 
 - 
PF_XBGRpublic static final int PF_XBGR XBGR pixel format. The red, green, and blue components in the image are stored in 4-sample pixels in the order R, G, B from highest to lowest memory address within each pixel. The X component is ignored when compressing and undefined when decompressing.- See Also:
- Constant Field Values
 
 - 
PF_XRGBpublic static final int PF_XRGB XRGB pixel format. The red, green, and blue components in the image are stored in 4-sample pixels in the order B, G, R from highest to lowest memory address within each pixel. The X component is ignored when compressing and undefined when decompressing.- See Also:
- Constant Field Values
 
 - 
PF_GRAYpublic static final int PF_GRAY Grayscale pixel format. Each 1-sample pixel represents a luminance (brightness) level from 0 to the maximum sample value (255 for 8-bit samples, 4095 for 12-bit samples, and 65535 for 16-bit samples.)- See Also:
- Constant Field Values
 
 - 
PF_RGBApublic static final int PF_RGBA RGBA pixel format. This is the same asPF_RGBX, except that when decompressing, the X component is guaranteed to be equal to the maximum sample value, which can be interpreted as an opaque alpha channel.- See Also:
- Constant Field Values
 
 - 
PF_BGRApublic static final int PF_BGRA BGRA pixel format. This is the same asPF_BGRX, except that when decompressing, the X component is guaranteed to be equal to the maximum sample value, which can be interpreted as an opaque alpha channel.- See Also:
- Constant Field Values
 
 - 
PF_ABGRpublic static final int PF_ABGR ABGR pixel format. This is the same asPF_XBGR, except that when decompressing, the X component is guaranteed to be equal to the maximum sample value, which can be interpreted as an opaque alpha channel.- See Also:
- Constant Field Values
 
 - 
PF_ARGBpublic static final int PF_ARGB ARGB pixel format. This is the same asPF_XRGB, except that when decompressing, the X component is guaranteed to be equal to the maximum sample value, which can be interpreted as an opaque alpha channel.- See Also:
- Constant Field Values
 
 - 
PF_CMYKpublic static final int PF_CMYK CMYK pixel format. Unlike RGB, which is an additive color model used primarily for display, CMYK (Cyan/Magenta/Yellow/Key) is a subtractive color model used primarily for printing. In the CMYK color model, the value of each color component typically corresponds to an amount of cyan, magenta, yellow, or black ink that is applied to a white background. In order to convert between CMYK and RGB, it is necessary to use a color management system (CMS.) A CMS will attempt to map colors within the printer's gamut to perceptually similar colors in the display's gamut and vice versa, but the mapping is typically not 1:1 or reversible, nor can it be defined with a simple formula. Thus, such a conversion is out of scope for a codec library. However, the TurboJPEG API allows for compressing packed-pixel CMYK images into YCCK JPEG images (seeCS_YCCK) and decompressing YCCK JPEG images into packed-pixel CMYK images.- See Also:
- Constant Field Values
 
 - 
NUMCSpublic static final int NUMCS The number of JPEG colorspaces- See Also:
- Constant Field Values
 
 - 
CS_RGBpublic static final int CS_RGB RGB colorspace. When compressing the JPEG image, the R, G, and B components in the source image are reordered into image planes, but no colorspace conversion or subsampling is performed. RGB JPEG images can be compressed from and decompressed to packed-pixel images with any of the extended RGB or grayscale pixel formats, but they cannot be compressed from or decompressed to planar YUV images.- See Also:
- Constant Field Values
 
 - 
CS_YCbCrpublic static final int CS_YCbCr YCbCr colorspace. YCbCr is not an absolute colorspace but rather a mathematical transformation of RGB designed solely for storage and transmission. YCbCr images must be converted to RGB before they can actually be displayed. In the YCbCr colorspace, the Y (luminance) component represents the black & white portion of the original image, and the Cb and Cr (chrominance) components represent the color portion of the original image. Originally, the analog equivalent of this transformation allowed the same signal to drive both black & white and color televisions, but JPEG images use YCbCr primarily because it allows the color data to be optionally subsampled for the purposes of reducing network or disk usage. YCbCr is the most common JPEG colorspace, and YCbCr JPEG images can be compressed from and decompressed to packed-pixel images with any of the extended RGB or grayscale pixel formats. YCbCr JPEG images can also be compressed from and decompressed to planar YUV images.- See Also:
- Constant Field Values
 
 - 
CS_GRAYpublic static final int CS_GRAY Grayscale colorspace. The JPEG image retains only the luminance data (Y component), and any color data from the source image is discarded. Grayscale JPEG images can be compressed from and decompressed to packed-pixel images with any of the extended RGB or grayscale pixel formats, or they can be compressed from and decompressed to planar YUV images.- See Also:
- Constant Field Values
 
 - 
CS_CMYKpublic static final int CS_CMYK CMYK colorspace. When compressing the JPEG image, the C, M, Y, and K components in the source image are reordered into image planes, but no colorspace conversion or subsampling is performed. CMYK JPEG images can only be compressed from and decompressed to packed-pixel images with the CMYK pixel format.- See Also:
- Constant Field Values
 
 - 
CS_YCCKpublic static final int CS_YCCK YCCK colorspace. YCCK (AKA "YCbCrK") is not an absolute colorspace but rather a mathematical transformation of CMYK designed solely for storage and transmission. It is to CMYK as YCbCr is to RGB. CMYK pixels can be reversibly transformed into YCCK, and as with YCbCr, the chrominance components in the YCCK pixels can be subsampled without incurring major perceptual loss. YCCK JPEG images can only be compressed from and decompressed to packed-pixel images with the CMYK pixel format.- See Also:
- Constant Field Values
 
 - 
PARAM_STOPONWARNINGpublic static final int PARAM_STOPONWARNING Error handling behaviorValue -  0[default] Allow the current compression/decompression/transform operation to complete unless a fatal error is encountered.
-  1Immediately discontinue the current compression/decompression/transform operation if a warning (non-fatal error) occurs.
 - See Also:
- Constant Field Values
 
-  
 - 
PARAM_BOTTOMUPpublic static final int PARAM_BOTTOMUP Row order in packed-pixel source/destination imagesValue -  0[default] top-down (X11) order
-  1bottom-up (Windows, OpenGL) order
 - See Also:
- Constant Field Values
 
-  
 - 
PARAM_QUALITYpublic static final int PARAM_QUALITY Perceptual quality of lossy JPEG images [compression only]Value -  1-100(1= worst quality but best compression,100= best quality but worst compression) [no default; must be explicitly specified]
 - See Also:
- Constant Field Values
 
-  
 - 
PARAM_SUBSAMPpublic static final int PARAM_SUBSAMP Chrominance subsampling levelThe JPEG or YUV image uses (decompression, decoding) or will use (lossy compression, encoding) the specified level of chrominance subsampling. When pixels are converted from RGB to YCbCr (see CS_YCbCr) or from CMYK to YCCK (seeCS_YCCK) as part of the JPEG compression process, some of the Cb and Cr (chrominance) components can be discarded or averaged together to produce a smaller image with little perceptible loss of image clarity. (The human eye is more sensitive to small changes in brightness than to small changes in color.) This is called "chrominance subsampling".Value -  One of TJ.SAMP_*[no default; must be explicitly specified for lossy compression, encoding, and decoding]
 - See Also:
- Constant Field Values
 
-  One of 
 - 
PARAM_JPEGWIDTHpublic static final int PARAM_JPEGWIDTH JPEG width (in pixels) [decompression only, read-only]- See Also:
- Constant Field Values
 
 - 
PARAM_JPEGHEIGHTpublic static final int PARAM_JPEGHEIGHT JPEG height (in pixels) [decompression only, read-only]- See Also:
- Constant Field Values
 
 - 
PARAM_PRECISIONpublic static final int PARAM_PRECISION JPEG data precision (bits per sample) [decompression only, read-only]The JPEG image uses the specified number of bits per sample. Value -  8,12, or16
 12-bit data precision implies PARAM_OPTIMIZEunlessPARAM_ARITHMETICis set.- See Also:
- Constant Field Values
 
-  
 - 
PARAM_COLORSPACEpublic static final int PARAM_COLORSPACE JPEG colorspaceThe JPEG image uses (decompression) or will use (lossy compression) the specified colorspace. Value -  One of TJ.CS_*[default for lossy compression: automatically selected based on the subsampling level and pixel format]
 - See Also:
- Constant Field Values
 
-  One of 
 - 
PARAM_FASTUPSAMPLEpublic static final int PARAM_FASTUPSAMPLE Chrominance upsampling algorithm [lossy decompression only]Value -  0[default] Use smooth upsampling when decompressing a JPEG image that was compressed using chrominance subsampling. This creates a smooth transition between neighboring chrominance components in order to reduce upsampling artifacts in the decompressed image.
-  1Use the fastest chrominance upsampling algorithm available, which may combine upsampling with color conversion.
 - See Also:
- Constant Field Values
 
-  
 - 
PARAM_FASTDCTpublic static final int PARAM_FASTDCT DCT/IDCT algorithm [lossy compression and decompression]Value -  0[default] Use the most accurate DCT/IDCT algorithm available.
-  1Use the fastest DCT/IDCT algorithm available.
 This parameter is provided mainly for backward compatibility with libjpeg, which historically implemented several different DCT/IDCT algorithms because of performance limitations with 1990s CPUs. In the libjpeg-turbo implementation of the TurboJPEG API: - The "fast" and "accurate" DCT/IDCT algorithms perform similarly on modern x86/x86-64 CPUs that support AVX2 instructions.
- The "fast" algorithm is generally only about 5-15% faster than the "accurate" algorithm on other types of CPUs.
- The difference in accuracy between the "fast" and "accurate" algorithms is the most pronounced at JPEG quality levels above 90 and tends to be more pronounced with decompression than with compression.
- The "fast" algorithm degrades and is not fully accelerated for JPEG quality levels above 97, so it will be slower than the "accurate" algorithm.
 - See Also:
- Constant Field Values
 
-  
 - 
PARAM_OPTIMIZEpublic static final int PARAM_OPTIMIZE Optimized baseline entropy coding [lossy compression only]Value -  0[default] The JPEG image will use the default Huffman tables.
-  1Optimal Huffman tables will be computed for the JPEG image. For lossless transformation, this can also be specified usingTJTransform.OPT_OPTIMIZE.
 Optimized baseline entropy coding will improve compression slightly (generally 5% or less), but it will reduce compression performance considerably. - See Also:
- Constant Field Values
 
-  
 - 
PARAM_PROGRESSIVEpublic static final int PARAM_PROGRESSIVE Progressive entropy codingValue -  0[default for compression, lossless transformation] The lossy JPEG image uses (decompression) or will use (compression, lossless transformation) baseline entropy coding.
-  1The lossy JPEG image uses (decompression) or will use (compression, lossless transformation) progressive entropy coding. For lossless transformation, this can also be specified usingTJTransform.OPT_PROGRESSIVE.
 Progressive entropy coding will generally improve compression relative to baseline entropy coding, but it will reduce compression and decompression performance considerably. Can be combined with PARAM_ARITHMETIC. ImpliesPARAM_OPTIMIZEunlessPARAM_ARITHMETICis also set.- See Also:
- Constant Field Values
 
-  
 - 
PARAM_SCANLIMITpublic static final int PARAM_SCANLIMIT Progressive JPEG scan limit for lossy JPEG images [decompression, lossless transformation]Setting this parameter will cause the decompression and transform functions to return an error if the number of scans in a progressive JPEG image exceeds the specified limit. The primary purpose of this is to allow security-critical applications to guard against an exploit of the progressive JPEG format described in this report. Value -  maximum number of progressive JPEG scans that the decompression and
 transform functions will process [default: 0(no limit)]
 - See Also:
- PARAM_PROGRESSIVE, Constant Field Values
 
-  maximum number of progressive JPEG scans that the decompression and
 transform functions will process [default: 
 - 
PARAM_ARITHMETICpublic static final int PARAM_ARITHMETIC Arithmetic entropy codingValue -  0[default for compression, lossless transformation] The lossy JPEG image uses (decompression) or will use (compression, lossless transformation) Huffman entropy coding.
-  1The lossy JPEG image uses (decompression) or will use (compression, lossless transformation) arithmetic entropy coding. For lossless transformation, this can also be specified usingTJTransform.OPT_ARITHMETIC.
 Arithmetic entropy coding will generally improve compression relative to Huffman entropy coding, but it will reduce compression and decompression performance considerably. Can be combined with PARAM_PROGRESSIVE.- See Also:
- Constant Field Values
 
-  
 - 
PARAM_LOSSLESSpublic static final int PARAM_LOSSLESS Lossless JPEGValue -  0[default for compression] The JPEG image is (decompression) or will be (compression) lossy/DCT-based.
-  1The JPEG image is (decompression) or will be (compression) lossless/predictive.
 In most cases, compressing and decompressing lossless JPEG images is considerably slower than compressing and decompressing lossy JPEG images. Also note that the following features are not available with lossless JPEG images: -  Colorspace conversion (lossless JPEG images always use
 CS_RGB,CS_GRAY, orCS_CMYK, depending on the pixel format of the source image)
-  Chrominance subsampling (lossless JPEG images always use
 SAMP_444)
- JPEG quality selection
- DCT/IDCT algorithm selection
- Progressive entropy coding
- Arithmetic entropy coding
- Compression from/decompression to planar YUV images
- Decompression scaling
- Lossless transformation
 - See Also:
- PARAM_LOSSLESSPSV,- PARAM_LOSSLESSPT, Constant Field Values
 
-  
 - 
PARAM_LOSSLESSPSVpublic static final int PARAM_LOSSLESSPSV Lossless JPEG predictor selection value (PSV)Value -  1-7[default for compression:1]
 - See Also:
- PARAM_LOSSLESS, Constant Field Values
 
-  
 - 
PARAM_LOSSLESSPTpublic static final int PARAM_LOSSLESSPT Lossless JPEG point transform (Pt)Value -  0through precision - 1, where precision is the JPEG data precision in bits [default for compression:0]
 A point transform value of 0is necessary in order to generate a fully lossless JPEG image. (A non-zero point transform value right-shifts the input samples by the specified number of bits, which is effectively a form of lossy color quantization.)- See Also:
- PARAM_LOSSLESS,- PARAM_PRECISION, Constant Field Values
 
-  
 - 
PARAM_RESTARTBLOCKSpublic static final int PARAM_RESTARTBLOCKS JPEG restart marker interval in MCU blocks (lossy) or samples (lossless) [compression only]The nature of entropy coding is such that a corrupt JPEG image cannot be decompressed beyond the point of corruption unless it contains restart markers. A restart marker stops and restarts the entropy coding algorithm so that, if a JPEG image is corrupted, decompression can resume at the next marker. Thus, adding more restart markers improves the fault tolerance of the JPEG image, but adding too many restart markers can adversely affect the compression ratio and performance. Value -  the number of MCU blocks or samples between each restart marker
 [default: 0(no restart markers)]
 Setting this parameter to a non-zero value sets PARAM_RESTARTROWSto 0.- See Also:
- Constant Field Values
 
-  the number of MCU blocks or samples between each restart marker
 [default: 
 - 
PARAM_RESTARTROWSpublic static final int PARAM_RESTARTROWS JPEG restart marker interval in MCU rows (lossy) or sample rows (lossless) [compression only]See PARAM_RESTARTBLOCKSfor a description of restart markers.Value -  the number of MCU rows or sample rows between each restart marker
 [default: 0(no restart markers)]
 Setting this parameter to a non-zero value sets PARAM_RESTARTBLOCKSto 0.- See Also:
- Constant Field Values
 
-  the number of MCU rows or sample rows between each restart marker
 [default: 
 - 
PARAM_XDENSITYpublic static final int PARAM_XDENSITY JPEG horizontal pixel densityValue -  The JPEG image has (decompression) or will have (compression) the
 specified horizontal pixel density [default for compression:
 1].
 This value is stored in or read from the JPEG header. It does not affect the contents of the JPEG image. - See Also:
- PARAM_DENSITYUNITS, Constant Field Values
 
-  The JPEG image has (decompression) or will have (compression) the
 specified horizontal pixel density [default for compression:
 
 - 
PARAM_YDENSITYpublic static final int PARAM_YDENSITY JPEG vertical pixel densityValue -  The JPEG image has (decompression) or will have (compression) the
 specified vertical pixel density [default for compression:
 1].
 This value is stored in or read from the JPEG header. It does not affect the contents of the JPEG image. - See Also:
- PARAM_DENSITYUNITS, Constant Field Values
 
-  The JPEG image has (decompression) or will have (compression) the
 specified vertical pixel density [default for compression:
 
 - 
PARAM_DENSITYUNITSpublic static final int PARAM_DENSITYUNITS JPEG pixel density unitsValue -  0[default for compression] The pixel density of the JPEG image is expressed (decompression) or will be expressed (compression) in unknown units.
-  1The pixel density of the JPEG image is expressed (decompression) or will be expressed (compression) in units of pixels/inch.
-  2The pixel density of the JPEG image is expressed (decompression) or will be expressed (compression) in units of pixels/cm.
 This value is stored in or read from the JPEG header. It does not affect the contents of the JPEG image. - See Also:
- PARAM_XDENSITY,- PARAM_YDENSITY, Constant Field Values
 
-  
 - 
FLAG_BOTTOMUP@Deprecated public static final int FLAG_BOTTOMUP Deprecated.UsePARAM_BOTTOMUPinstead.- See Also:
- Constant Field Values
 
 - 
FLAG_FASTUPSAMPLE@Deprecated public static final int FLAG_FASTUPSAMPLE Deprecated.UsePARAM_FASTUPSAMPLEinstead.- See Also:
- Constant Field Values
 
 - 
FLAG_FASTDCT@Deprecated public static final int FLAG_FASTDCT Deprecated.UsePARAM_FASTDCTinstead.- See Also:
- Constant Field Values
 
 - 
FLAG_ACCURATEDCT@Deprecated public static final int FLAG_ACCURATEDCT Deprecated.UsePARAM_FASTDCTinstead.- See Also:
- Constant Field Values
 
 - 
FLAG_STOPONWARNING@Deprecated public static final int FLAG_STOPONWARNING Deprecated.UsePARAM_STOPONWARNINGinstead.- See Also:
- Constant Field Values
 
 - 
FLAG_PROGRESSIVE@Deprecated public static final int FLAG_PROGRESSIVE Deprecated.UsePARAM_PROGRESSIVEinstead.- See Also:
- Constant Field Values
 
 - 
FLAG_LIMITSCANS@Deprecated public static final int FLAG_LIMITSCANS Deprecated.UsePARAM_SCANLIMITinstead.- See Also:
- Constant Field Values
 
 - 
NUMERRpublic static final int NUMERR The number of error codes- See Also:
- Constant Field Values
 
 - 
ERR_WARNINGpublic static final int ERR_WARNING The error was non-fatal and recoverable, but the destination image may still be corrupt.NOTE: due to the design of the TurboJPEG Java API, only certain methods (specifically, TJDecompressor.decompress*()methods with a void return type) will complete and leave the destination image in a fully recoverable state after a non-fatal error occurs.- See Also:
- Constant Field Values
 
 - 
ERR_FATALpublic static final int ERR_FATAL The error was fatal and non-recoverable.- See Also:
- Constant Field Values
 
 - 
UNSCALEDpublic static final TJScalingFactor UNSCALED ATJScalingFactorinstance that specifies a scaling factor of 1/1 (no scaling)
 - 
UNCROPPEDpublic static final java.awt.Rectangle UNCROPPED Ajava.awt.Rectangleinstance that specifies no cropping
 
- 
 - 
Method Detail- 
getMCUWidthpublic static int getMCUWidth(int subsamp) Returns the MCU block width for the given level of chrominance subsampling.- Parameters:
- subsamp- the level of chrominance subsampling (one of- SAMP_*)
- Returns:
- the MCU block width for the given level of chrominance subsampling.
 
 - 
getMCUHeightpublic static int getMCUHeight(int subsamp) Returns the MCU block height for the given level of chrominance subsampling.- Parameters:
- subsamp- the level of chrominance subsampling (one of- SAMP_*)
- Returns:
- the MCU block height for the given level of chrominance subsampling.
 
 - 
getPixelSizepublic static int getPixelSize(int pixelFormat) Returns the pixel size (in samples) for the given pixel format.- Parameters:
- pixelFormat- the pixel format (one of- PF_*)
- Returns:
- the pixel size (in samples) for the given pixel format.
 
 - 
getRedOffsetpublic static int getRedOffset(int pixelFormat) For the given pixel format, returns the number of samples that the red component is offset from the start of the pixel. For instance, if an 8-bit-per-sample pixel of formatTJ.PF_BGRXis stored inchar pixel[], then the red component will bepixel[TJ.getRedOffset(TJ.PF_BGRX)].- Parameters:
- pixelFormat- the pixel format (one of- PF_*)
- Returns:
- the red offset for the given pixel format, or -1 if the pixel format does not have a red component.
 
 - 
getGreenOffsetpublic static int getGreenOffset(int pixelFormat) For the given pixel format, returns the number of samples that the green component is offset from the start of the pixel. For instance, if an 8-bit-per-sample pixel of formatTJ.PF_BGRXis stored inchar pixel[], then the green component will bepixel[TJ.getGreenOffset(TJ.PF_BGRX)].- Parameters:
- pixelFormat- the pixel format (one of- PF_*)
- Returns:
- the green offset for the given pixel format, or -1 if the pixel format does not have a green component.
 
 - 
getBlueOffsetpublic static int getBlueOffset(int pixelFormat) For the given pixel format, returns the number of samples that the blue component is offset from the start of the pixel. For instance, if an 8-bit-per-sample pixel of formatTJ.PF_BGRXis stored inchar pixel[], then the blue component will bepixel[TJ.getBlueOffset(TJ.PF_BGRX)].- Parameters:
- pixelFormat- the pixel format (one of- PF_*)
- Returns:
- the blue offset for the given pixel format, or -1 if the pixel format does not have a blue component.
 
 - 
getAlphaOffsetpublic static int getAlphaOffset(int pixelFormat) For the given pixel format, returns the number of samples that the alpha component is offset from the start of the pixel. For instance, if an 8-bit-per-sample pixel of formatTJ.PF_BGRAis stored inchar pixel[], then the alpha component will bepixel[TJ.getAlphaOffset(TJ.PF_BGRA)].- Parameters:
- pixelFormat- the pixel format (one of- PF_*)
- Returns:
- the alpha offset for the given pixel format, or -1 if the pixel format does not have a alpha component.
 
 - 
bufSizepublic static int bufSize(int width, int height, int jpegSubsamp)Returns the maximum size of the buffer (in bytes) required to hold a JPEG image with the given width, height, and level of chrominance subsampling.- Parameters:
- width- the width (in pixels) of the JPEG image
- height- the height (in pixels) of the JPEG image
- jpegSubsamp- the level of chrominance subsampling to be used when generating the JPEG image (one of- TJ.SAMP_*.)- SAMP_UNKNOWNis treated like- SAMP_444, since a buffer large enough to hold a JPEG image with no subsampling should also be large enough to hold a JPEG image with an arbitrary level of subsampling. Note that lossless JPEG images always use- SAMP_444.
- Returns:
- the maximum size of the buffer (in bytes) required to hold a JPEG image with the given width, height, and level of chrominance subsampling.
 
 - 
bufSizeYUVpublic static int bufSizeYUV(int width, int align, int height, int subsamp)Returns the size of the buffer (in bytes) required to hold a unified planar YUV image with the given width, height, and level of chrominance subsampling.- Parameters:
- width- the width (in pixels) of the YUV image
- align- row alignment (in bytes) of the YUV image (must be a power of 2.) Setting this parameter to n specifies that each row in each plane of the YUV image will be padded to the nearest multiple of n bytes (1 = unpadded.)
- height- the height (in pixels) of the YUV image
- subsamp- the level of chrominance subsampling used in the YUV image (one of- TJ.SAMP_*)
- Returns:
- the size of the buffer (in bytes) required to hold a unified planar YUV image with the given width, height, and level of chrominance subsampling.
 
 - 
planeSizeYUVpublic static int planeSizeYUV(int componentID, int width, int stride, int height, int subsamp)Returns the size of the buffer (in bytes) required to hold a YUV image plane with the given parameters.- Parameters:
- componentID- ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
- width- width (in pixels) of the YUV image. NOTE: this is the width of the whole image, not the plane width.
- stride- bytes per row in the image plane.
- height- height (in pixels) of the YUV image. NOTE: this is the height of the whole image, not the plane height.
- subsamp- the level of chrominance subsampling used in the YUV image (one of- TJ.SAMP_*)
- Returns:
- the size of the buffer (in bytes) required to hold a YUV image plane with the given parameters.
 
 - 
planeWidthpublic static int planeWidth(int componentID, int width, int subsamp)Returns the plane width of a YUV image plane with the given parameters. Refer toYUVImagefor a description of plane width.- Parameters:
- componentID- ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
- width- width (in pixels) of the YUV image
- subsamp- the level of chrominance subsampling used in the YUV image (one of- TJ.SAMP_*)
- Returns:
- the plane width of a YUV image plane with the given parameters.
 
 - 
planeHeightpublic static int planeHeight(int componentID, int height, int subsamp)Returns the plane height of a YUV image plane with the given parameters. Refer toYUVImagefor a description of plane height.- Parameters:
- componentID- ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
- height- height (in pixels) of the YUV image
- subsamp- the level of chrominance subsampling used in the YUV image (one of- TJ.SAMP_*)
- Returns:
- the plane height of a YUV image plane with the given parameters.
 
 - 
getScalingFactorspublic static TJScalingFactor[] getScalingFactors() Returns a list of fractional scaling factors that the JPEG decompressor supports.- Returns:
- a list of fractional scaling factors that the JPEG decompressor supports.
 
 
- 
 
-