- + @@ -1109,6 +1116,24 @@ If you choose option 1, *jpegSize should be set to the size of your + + + + + + + + + + + + + + + + + + @@ -1125,13 +1150,16 @@ If you choose option 1, *jpegSize should be set to the size of your

Decompress a JPEG image to a YUV planar image.

This function performs JPEG decompression but leaves out the color conversion step, so a planar YUV image is generated instead of an RGB image. The padding of the planes in this image is the same as in the images generated by tjEncodeYUV2(). Note that, if the width or height of the image is not an even multiple of the MCU block size (see tjMCUWidth and tjMCUHeight), then an intermediate buffer copy will be performed within TurboJPEG.

This function performs JPEG decompression but leaves out the color conversion step, so a planar YUV image is generated instead of an RGB image. The structure of the planes in this image is the same as in the images generated by tjEncodeYUV3(). Note that, if the width or height of the JPEG image is not an even multiple of the MCU block size (see tjMCUWidth and tjMCUHeight), then an intermediate buffer copy will be performed within TurboJPEG.

Parameters:

DLLEXPORT int DLLCALL tjDecompressToYUV	DLLEXPORT int DLLCALL tjDecompressToYUV2	(	tjhandle	handle,	unsigned char *	dstBuf,
		int	width,
		int	pad,
		int	height,

- + + + +

handle	a handle to a TurboJPEG decompressor or transformer instance
jpegBuf	pointer to a buffer containing the JPEG image to decompress
jpegSize	size of the JPEG image (in bytes)
dstBuf	pointer to an image buffer that will receive the YUV image. Use tjBufSizeYUV() to determine the appropriate size for this buffer based on the image width, height, and level of subsampling.
dstBuf	pointer to an image buffer that will receive the YUV image. Use tjBufSizeYUV2() to determine the appropriate size for this buffer based on the image width, height, padding, and level of subsampling.
width	desired width (in pixels) of the YUV image. If this is different than the width of the JPEG image being decompressed, then TurboJPEG will use scaling in the JPEG decompressor to generate the largest possible image that will fit within the desired width. If `width` is set to 0, then only the height will be considered when determining the scaled image size.
pad	the width of each line in each plane of the YUV image will be padded to the nearest multiple of this number of bytes (must be a power of 2.) To generate images suitable for X Video, `pad` should be set to 4.
height	desired height (in pixels) of the YUV image. If this is different than the height of the JPEG image being decompressed, then TurboJPEG will use scaling in the JPEG decompressor to generate the largest possible image that will fit within the desired height. If `height` is set to 0, then only the width will be considered when determining the scaled image size.
flags	the bitwise OR of one or more of the flags.

@@ -1166,12 +1194,12 @@ If you choose option 1, *jpegSize should be set to the size of your

- + @@ -1212,6 +1240,12 @@ If you choose option 1, *jpegSize should be set to the size of your + + + + + + @@ -1234,7 +1268,7 @@ If you choose option 1, *jpegSize should be set to the size of your

Encode an RGB or grayscale image into a YUV planar image.

This function uses the accelerated color conversion routines in TurboJPEG's underlying codec to produce a planar YUV image that is suitable for X Video. Specifically, if the chrominance components are subsampled along the horizontal dimension, then the width of the luminance plane is padded to 2 in the output image (same goes for the height of the luminance plane, if the chrominance components are subsampled along the vertical dimension.) Also, each line of each plane in the output image is padded to 4 bytes. Although this will work with any subsampling option, it is really only useful in combination with TJ_420, which produces an image compatible with the I420 (AKA "YUV420P") format.

This function uses the accelerated color conversion routines in TurboJPEG's underlying codec but does not execute any of the other steps in the JPEG compression process. The Y, U, and V image planes are stored sequentially into the destination buffer, and the size of each plane is determined by the width and height of the source image, as well as the specified padding and level of chrominance subsampling. If the chrominance components are subsampled along the horizontal dimension, then the width of the luminance plane is padded to the nearest multiple of 2 in the output image (same goes for the height of the luminance plane, if the chrominance components are subsampled along the vertical dimension.)

Parameters:

DLLEXPORT int DLLCALL tjEncodeYUV2	DLLEXPORT int DLLCALL tjEncodeYUV3	(	tjhandle	handle,	unsigned char *	dstBuf,
		int	pad,

@@ -1243,8 +1277,9 @@ If you choose option 1, *jpegSize should be set to the size of your - - + + +

handle	a handle to a TurboJPEG compressor or transformer instance
pitch	bytes per line of the source image. Normally, this should be `width * tjPixelSize[pixelFormat]` if the image is unpadded, or `TJPAD(width * tjPixelSize[pixelFormat])` if each line of the image is padded to the nearest 32-bit boundary, as is the case for Windows bitmaps. You can also be clever and use this parameter to skip lines, etc. Setting this parameter to 0 is the equivalent of setting it to `width * tjPixelSize[pixelFormat]`.
height	height (in pixels) of the source image
pixelFormat	pixel format of the source image (see Pixel formats.)
dstBuf	pointer to an image buffer that will receive the YUV image. Use tjBufSizeYUV() to determine the appropriate size for this buffer based on the image width, height, and level of chrominance subsampling.
subsamp	the level of chrominance subsampling to be used when generating the YUV image (see Chrominance subsampling options.)
dstBuf	pointer to an image buffer that will receive the YUV image. Use tjBufSizeYUV2() to determine the appropriate size for this buffer based on the image width, height, padding, and level of chrominance subsampling.
pad	the width of each line in each plane of the YUV image will be padded to the nearest multiple of this number of bytes (must be a power of 2.) To generate images suitable for X Video, `pad` should be set to 4.
subsamp	the level of chrominance subsampling to be used when generating the YUV image (see Chrominance subsampling options.) To generate images suitable for X Video, `subsamp` should be set to TJSAMP_420. This produces an image compatible with the I420 (AKA "YUV420P") format.
flags	the bitwise OR of one or more of the flags.

@@ -1594,7 +1629,7 @@ If you choose option 1, dstSizes[i] should be set to the size of yo

Generated on Fri Apr 26 2013 03:39:31 for TurboJPEG by + diff --git a/doc/html/index.html b/doc/html/index.html index 7c43e58..49e0d4b 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -19,7 +19,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search'); -

TurboJPEG 1.2.1

TurboJPEG 1.4

@@ -69,7 +69,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');