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

TurboJPEG 1.2.1

TurboJPEG 1.4

@@ -169,10 +169,10 @@ Functions Compress an RGB or grayscale image into a JPEG image.
DLLEXPORT unsigned long DLLCALL tjBufSize (int width, int height, int jpegSubsamp) The maximum size of the buffer (in bytes) required to hold a JPEG image with the given parameters.
-DLLEXPORT unsigned long DLLCALL tjBufSizeYUV (int width, int height, int subsamp) - The size of the buffer (in bytes) required to hold a YUV planar image with the given parameters.
-DLLEXPORT int DLLCALL tjEncodeYUV2 (tjhandle handle, unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char *dstBuf, int subsamp, int flags) - Encode an RGB or grayscale image into a YUV planar image.
+DLLEXPORT unsigned long DLLCALL tjBufSizeYUV2 (int width, int pad, int height, int subsamp) + The size of the buffer (in bytes) required to hold a YUV planar image with the given parameters.
+DLLEXPORT int DLLCALL tjEncodeYUV3 (tjhandle handle, unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char *dstBuf, int pad, int subsamp, int flags) + Encode an RGB or grayscale image into a YUV planar image.
DLLEXPORT tjhandle DLLCALL tjInitDecompress (void) Create a TurboJPEG decompressor instance.
DLLEXPORT int DLLCALL tjDecompressHeader2 (tjhandle handle, unsigned char *jpegBuf, unsigned long jpegSize, int *width, int *height, int *jpegSubsamp) @@ -181,8 +181,8 @@ Functions Returns a list of fractional scaling factors that the JPEG decompressor in this implementation of TurboJPEG supports.
DLLEXPORT int DLLCALL tjDecompress2 (tjhandle handle, unsigned char *jpegBuf, unsigned long jpegSize, unsigned char *dstBuf, int width, int pitch, int height, int pixelFormat, int flags) Decompress a JPEG image to an RGB or grayscale image.
-DLLEXPORT int DLLCALL tjDecompressToYUV (tjhandle handle, unsigned char *jpegBuf, unsigned long jpegSize, unsigned char *dstBuf, int flags) - Decompress a JPEG image to a YUV planar image.
+DLLEXPORT int DLLCALL tjDecompressToYUV2 (tjhandle handle, unsigned char *jpegBuf, unsigned long jpegSize, unsigned char *dstBuf, int width, int pad, int height, int flags) + Decompress a JPEG image to a YUV planar image.
DLLEXPORT tjhandle DLLCALL tjInitTransform (void) Create a new TurboJPEG transformer instance.
DLLEXPORT int DLLCALL tjTransform (tjhandle handle, unsigned char *jpegBuf, unsigned long jpegSize, int n, unsigned char **dstBufs, unsigned long *dstSizes, tjtransform *transforms, int flags) @@ -781,16 +781,22 @@ Variables - +

- + + + + + + + @@ -816,6 +822,7 @@ Variables

Parameters:

DLLEXPORT unsigned long DLLCALL tjBufSizeYUV	DLLEXPORT unsigned long DLLCALL tjBufSizeYUV2	(	int	width,
		int	pad,

width	width of the image (in pixels)
pad	the width of each line in each plane of the image is padded to the nearest multiple of this number of bytes (must be a power of 2.)
height	height of the image (in pixels)
subsamp	level of chrominance subsampling in the image (see Chrominance subsampling options.)

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

- +

- + @@ -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');

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

TurboJPEG 1.2.1

TurboJPEG 1.4

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

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

TurboJPEG 1.2.1

TurboJPEG 1.4

@@ -165,7 +165,7 @@ Data Fields -

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

TurboJPEG 1.2.1

TurboJPEG 1.4

@@ -127,7 +127,7 @@ Data Fields -

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

TurboJPEG 1.2.1

TurboJPEG 1.4

@@ -191,7 +191,7 @@ Data Fields -