mirror of
https://github.com/libjpeg-turbo/libjpeg-turbo
synced 2025-03-28 21:13:18 +00:00
Merge branch 'main' into dev
This commit is contained in:
DRC
commit
a4d19a4592
@ -271,27 +271,27 @@ Functions</h2></td></tr>
|
||||
<tr class="memitem:ga69c09d39f97ec30250ad3605ace7e5df" id="r_ga69c09d39f97ec30250ad3605ace7e5df"><td class="memItemLeft" align="right" valign="top">DLLEXPORT <a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga69c09d39f97ec30250ad3605ace7e5df">tj3Init</a> (int initType)</td></tr>
|
||||
<tr class="memdesc:ga69c09d39f97ec30250ad3605ace7e5df"><td class="mdescLeft"> </td><td class="mdescRight">Create a new TurboJPEG instance. <br /></td></tr>
|
||||
<tr class="separator:ga69c09d39f97ec30250ad3605ace7e5df"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga53fbadf4560e95a65b8f5ab81703fe82" id="r_ga53fbadf4560e95a65b8f5ab81703fe82"><td class="memItemLeft" align="right" valign="top">DLLEXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga53fbadf4560e95a65b8f5ab81703fe82">tj3Destroy</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle)</td></tr>
|
||||
<tr class="memdesc:ga53fbadf4560e95a65b8f5ab81703fe82"><td class="mdescLeft"> </td><td class="mdescRight">Destroy a TurboJPEG instance. <br /></td></tr>
|
||||
<tr class="separator:ga53fbadf4560e95a65b8f5ab81703fe82"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga5a23ad0776c5333cda0d7c6d826e9d29" id="r_ga5a23ad0776c5333cda0d7c6d826e9d29"><td class="memItemLeft" align="right" valign="top">DLLEXPORT char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga5a23ad0776c5333cda0d7c6d826e9d29">tj3GetErrorStr</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle)</td></tr>
|
||||
<tr class="memdesc:ga5a23ad0776c5333cda0d7c6d826e9d29"><td class="mdescLeft"> </td><td class="mdescRight">Returns a descriptive error message explaining why the last command failed. <br /></td></tr>
|
||||
<tr class="separator:ga5a23ad0776c5333cda0d7c6d826e9d29"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gab8c8279f1415fe425ff30dbbc56013bd" id="r_gab8c8279f1415fe425ff30dbbc56013bd"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gab8c8279f1415fe425ff30dbbc56013bd">tj3GetErrorCode</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle)</td></tr>
|
||||
<tr class="memdesc:gab8c8279f1415fe425ff30dbbc56013bd"><td class="mdescLeft"> </td><td class="mdescRight">Returns a code indicating the severity of the last error. <br /></td></tr>
|
||||
<tr class="separator:gab8c8279f1415fe425ff30dbbc56013bd"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gaddf92640bfee3e8622218c713e77e7db" id="r_gaddf92640bfee3e8622218c713e77e7db"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaddf92640bfee3e8622218c713e77e7db">tj3Set</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, int param, int value)</td></tr>
|
||||
<tr class="memdesc:gaddf92640bfee3e8622218c713e77e7db"><td class="mdescLeft"> </td><td class="mdescRight">Set the value of a parameter. <br /></td></tr>
|
||||
<tr class="separator:gaddf92640bfee3e8622218c713e77e7db"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga34af9ba3183bdf0ec7c8f47bb9a4c84f" id="r_ga34af9ba3183bdf0ec7c8f47bb9a4c84f"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga34af9ba3183bdf0ec7c8f47bb9a4c84f">tj3Get</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, int param)</td></tr>
|
||||
<tr class="memdesc:ga34af9ba3183bdf0ec7c8f47bb9a4c84f"><td class="mdescLeft"> </td><td class="mdescRight">Get the value of a parameter. <br /></td></tr>
|
||||
<tr class="separator:ga34af9ba3183bdf0ec7c8f47bb9a4c84f"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga2cc418a2dab709ad7f30f5b25905f138" id="r_ga2cc418a2dab709ad7f30f5b25905f138"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga2cc418a2dab709ad7f30f5b25905f138">tj3Compress8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga2cc418a2dab709ad7f30f5b25905f138"><td class="mdescLeft"> </td><td class="mdescRight">Compress a packed-pixel RGB, grayscale, or CMYK image with 2 to 8 bits of data precision per sample into a JPEG image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:ga2cc418a2dab709ad7f30f5b25905f138"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga9a1968c384ec7abb6122830253ebf570" id="r_ga9a1968c384ec7abb6122830253ebf570"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga9a1968c384ec7abb6122830253ebf570">tj3Compress12</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const short *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga9a1968c384ec7abb6122830253ebf570"><td class="mdescLeft"> </td><td class="mdescRight">Compress a packed-pixel RGB, grayscale, or CMYK image with 9 to 12 bits of data precision per sample into a JPEG image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:ga9a1968c384ec7abb6122830253ebf570"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga77901b71d0471784f318ada31ff4e7bd" id="r_ga77901b71d0471784f318ada31ff4e7bd"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga77901b71d0471784f318ada31ff4e7bd">tj3Compress16</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned short *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga77901b71d0471784f318ada31ff4e7bd"><td class="mdescLeft"> </td><td class="mdescRight">Compress a packed-pixel RGB, grayscale, or CMYK image with 13 to 16 bits of data precision per sample into a lossless JPEG image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:ga77901b71d0471784f318ada31ff4e7bd"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga041c870d9c669eb3f385c78f4346c43f" id="r_ga041c870d9c669eb3f385c78f4346c43f"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga041c870d9c669eb3f385c78f4346c43f">tj3CompressFromYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int align, int height, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga041c870d9c669eb3f385c78f4346c43f"><td class="mdescLeft"> </td><td class="mdescRight">Compress an 8-bit-per-sample unified planar YUV image into an 8-bit-per-sample JPEG image. <br /></td></tr>
|
||||
<tr class="separator:ga041c870d9c669eb3f385c78f4346c43f"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gac9f5ace3e73805b476c95dda9f8d0cd0" id="r_gac9f5ace3e73805b476c95dda9f8d0cd0"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gac9f5ace3e73805b476c95dda9f8d0cd0">tj3CompressFromYUVPlanes8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *const *srcPlanes, int width, const int *strides, int height, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:gac9f5ace3e73805b476c95dda9f8d0cd0"><td class="mdescLeft"> </td><td class="mdescRight">Compress a set of 8-bit-per-sample Y, U (Cb), and V (Cr) image planes into an 8-bit-per-sample JPEG image. <br /></td></tr>
|
||||
<tr class="separator:gac9f5ace3e73805b476c95dda9f8d0cd0"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga1a2c96d8b47530b6e6050ba6f10b7c57" id="r_ga1a2c96d8b47530b6e6050ba6f10b7c57"><td class="memItemLeft" align="right" valign="top">DLLEXPORT void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga1a2c96d8b47530b6e6050ba6f10b7c57">tj3Alloc</a> (size_t bytes)</td></tr>
|
||||
<tr class="memdesc:ga1a2c96d8b47530b6e6050ba6f10b7c57"><td class="mdescLeft"> </td><td class="mdescRight">Allocate a byte buffer for use with TurboJPEG. <br /></td></tr>
|
||||
<tr class="separator:ga1a2c96d8b47530b6e6050ba6f10b7c57"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gaddb84fb6c81769e9faa0f5a63b296606" id="r_gaddb84fb6c81769e9faa0f5a63b296606"><td class="memItemLeft" align="right" valign="top">DLLEXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaddb84fb6c81769e9faa0f5a63b296606">tj3Free</a> (void *buffer)</td></tr>
|
||||
<tr class="memdesc:gaddb84fb6c81769e9faa0f5a63b296606"><td class="mdescLeft"> </td><td class="mdescRight">Free a byte buffer previously allocated by TurboJPEG. <br /></td></tr>
|
||||
<tr class="separator:gaddb84fb6c81769e9faa0f5a63b296606"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gac6285e58e35a35d871d7162ec5a929c4" id="r_gac6285e58e35a35d871d7162ec5a929c4"><td class="memItemLeft" align="right" valign="top">DLLEXPORT size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gac6285e58e35a35d871d7162ec5a929c4">tj3JPEGBufSize</a> (int width, int height, int jpegSubsamp)</td></tr>
|
||||
<tr class="memdesc:gac6285e58e35a35d871d7162ec5a929c4"><td class="mdescLeft"> </td><td class="mdescRight">The maximum size of the buffer (in bytes) required to hold a JPEG image with the given parameters. <br /></td></tr>
|
||||
<tr class="separator:gac6285e58e35a35d871d7162ec5a929c4"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
@ -307,12 +307,27 @@ Functions</h2></td></tr>
|
||||
<tr class="memitem:ga969767ec8180cc3edd99cf507f87299b" id="r_ga969767ec8180cc3edd99cf507f87299b"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga969767ec8180cc3edd99cf507f87299b">tj3YUVPlaneHeight</a> (int componentID, int height, int subsamp)</td></tr>
|
||||
<tr class="memdesc:ga969767ec8180cc3edd99cf507f87299b"><td class="mdescLeft"> </td><td class="mdescRight">The plane height of a YUV image plane with the given parameters. <br /></td></tr>
|
||||
<tr class="separator:ga969767ec8180cc3edd99cf507f87299b"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga2a8d50f130bde10f0a04030f8cc59936" id="r_ga2a8d50f130bde10f0a04030f8cc59936"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga2a8d50f130bde10f0a04030f8cc59936">tj3EncodeYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char *dstBuf, int align)</td></tr>
|
||||
<tr class="memdesc:ga2a8d50f130bde10f0a04030f8cc59936"><td class="mdescLeft"> </td><td class="mdescRight">Encode an 8-bit-per-sample packed-pixel RGB or grayscale image into an 8-bit-per-sample unified planar YUV image. <br /></td></tr>
|
||||
<tr class="separator:ga2a8d50f130bde10f0a04030f8cc59936"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga2cc418a2dab709ad7f30f5b25905f138" id="r_ga2cc418a2dab709ad7f30f5b25905f138"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga2cc418a2dab709ad7f30f5b25905f138">tj3Compress8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga2cc418a2dab709ad7f30f5b25905f138"><td class="mdescLeft"> </td><td class="mdescRight">Compress a packed-pixel RGB, grayscale, or CMYK image with 2 to 8 bits of data precision per sample into a JPEG image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:ga2cc418a2dab709ad7f30f5b25905f138"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga9a1968c384ec7abb6122830253ebf570" id="r_ga9a1968c384ec7abb6122830253ebf570"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga9a1968c384ec7abb6122830253ebf570">tj3Compress12</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const short *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga9a1968c384ec7abb6122830253ebf570"><td class="mdescLeft"> </td><td class="mdescRight">Compress a packed-pixel RGB, grayscale, or CMYK image with 9 to 12 bits of data precision per sample into a JPEG image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:ga9a1968c384ec7abb6122830253ebf570"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga77901b71d0471784f318ada31ff4e7bd" id="r_ga77901b71d0471784f318ada31ff4e7bd"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga77901b71d0471784f318ada31ff4e7bd">tj3Compress16</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned short *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga77901b71d0471784f318ada31ff4e7bd"><td class="mdescLeft"> </td><td class="mdescRight">Compress a packed-pixel RGB, grayscale, or CMYK image with 13 to 16 bits of data precision per sample into a lossless JPEG image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:ga77901b71d0471784f318ada31ff4e7bd"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gac9f5ace3e73805b476c95dda9f8d0cd0" id="r_gac9f5ace3e73805b476c95dda9f8d0cd0"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gac9f5ace3e73805b476c95dda9f8d0cd0">tj3CompressFromYUVPlanes8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *const *srcPlanes, int width, const int *strides, int height, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:gac9f5ace3e73805b476c95dda9f8d0cd0"><td class="mdescLeft"> </td><td class="mdescRight">Compress a set of 8-bit-per-sample Y, U (Cb), and V (Cr) image planes into an 8-bit-per-sample JPEG image. <br /></td></tr>
|
||||
<tr class="separator:gac9f5ace3e73805b476c95dda9f8d0cd0"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga041c870d9c669eb3f385c78f4346c43f" id="r_ga041c870d9c669eb3f385c78f4346c43f"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga041c870d9c669eb3f385c78f4346c43f">tj3CompressFromYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int align, int height, unsigned char **jpegBuf, size_t *jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga041c870d9c669eb3f385c78f4346c43f"><td class="mdescLeft"> </td><td class="mdescRight">Compress an 8-bit-per-sample unified planar YUV image into an 8-bit-per-sample JPEG image. <br /></td></tr>
|
||||
<tr class="separator:ga041c870d9c669eb3f385c78f4346c43f"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gae2e9df38790e9bddc249d04cb158a4cf" id="r_gae2e9df38790e9bddc249d04cb158a4cf"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gae2e9df38790e9bddc249d04cb158a4cf">tj3EncodeYUVPlanes8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char **dstPlanes, int *strides)</td></tr>
|
||||
<tr class="memdesc:gae2e9df38790e9bddc249d04cb158a4cf"><td class="mdescLeft"> </td><td class="mdescRight">Encode an 8-bit-per-sample packed-pixel RGB or grayscale image into separate 8-bit-per-sample Y, U (Cb), and V (Cr) image planes. <br /></td></tr>
|
||||
<tr class="separator:gae2e9df38790e9bddc249d04cb158a4cf"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga2a8d50f130bde10f0a04030f8cc59936" id="r_ga2a8d50f130bde10f0a04030f8cc59936"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga2a8d50f130bde10f0a04030f8cc59936">tj3EncodeYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int width, int pitch, int height, int pixelFormat, unsigned char *dstBuf, int align)</td></tr>
|
||||
<tr class="memdesc:ga2a8d50f130bde10f0a04030f8cc59936"><td class="mdescLeft"> </td><td class="mdescRight">Encode an 8-bit-per-sample packed-pixel RGB or grayscale image into an 8-bit-per-sample unified planar YUV image. <br /></td></tr>
|
||||
<tr class="separator:ga2a8d50f130bde10f0a04030f8cc59936"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga96d2c4b3432f9d88ad14758ae240b8d1" id="r_ga96d2c4b3432f9d88ad14758ae240b8d1"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga96d2c4b3432f9d88ad14758ae240b8d1">tj3DecompressHeader</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *jpegBuf, size_t jpegSize)</td></tr>
|
||||
<tr class="memdesc:ga96d2c4b3432f9d88ad14758ae240b8d1"><td class="mdescLeft"> </td><td class="mdescRight">Retrieve information about a JPEG image without decompressing it, or prime the decompressor with quantization and Huffman tables. <br /></td></tr>
|
||||
<tr class="separator:ga96d2c4b3432f9d88ad14758ae240b8d1"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
@ -334,27 +349,21 @@ Functions</h2></td></tr>
|
||||
<tr class="memitem:gaa074e63f9beb0b3ff42b833a4049df6e" id="r_gaa074e63f9beb0b3ff42b833a4049df6e"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaa074e63f9beb0b3ff42b833a4049df6e">tj3Decompress16</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *jpegBuf, size_t jpegSize, unsigned short *dstBuf, int pitch, int pixelFormat)</td></tr>
|
||||
<tr class="memdesc:gaa074e63f9beb0b3ff42b833a4049df6e"><td class="mdescLeft"> </td><td class="mdescRight">Decompress a lossless JPEG image with 13 to 16 bits of data precision per sample into a packed-pixel RGB, grayscale, or CMYK image with the same data precision. <br /></td></tr>
|
||||
<tr class="separator:gaa074e63f9beb0b3ff42b833a4049df6e"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga1e6bf6a19fec3f9fa7534348879d8320" id="r_ga1e6bf6a19fec3f9fa7534348879d8320"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga1e6bf6a19fec3f9fa7534348879d8320">tj3DecompressToYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *jpegBuf, size_t jpegSize, unsigned char *dstBuf, int align)</td></tr>
|
||||
<tr class="memdesc:ga1e6bf6a19fec3f9fa7534348879d8320"><td class="mdescLeft"> </td><td class="mdescRight">Decompress an 8-bit-per-sample JPEG image into an 8-bit-per-sample unified planar YUV image. <br /></td></tr>
|
||||
<tr class="separator:ga1e6bf6a19fec3f9fa7534348879d8320"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga934373482dbbf257f2280505b6ff4fb5" id="r_ga934373482dbbf257f2280505b6ff4fb5"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga934373482dbbf257f2280505b6ff4fb5">tj3DecompressToYUVPlanes8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *jpegBuf, size_t jpegSize, unsigned char **dstPlanes, int *strides)</td></tr>
|
||||
<tr class="memdesc:ga934373482dbbf257f2280505b6ff4fb5"><td class="mdescLeft"> </td><td class="mdescRight">Decompress an 8-bit-per-sample JPEG image into separate 8-bit-per-sample Y, U (Cb), and V (Cr) image planes. <br /></td></tr>
|
||||
<tr class="separator:ga934373482dbbf257f2280505b6ff4fb5"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gaa1eb574f38b1c1de43a6c7aafcf68d8c" id="r_gaa1eb574f38b1c1de43a6c7aafcf68d8c"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaa1eb574f38b1c1de43a6c7aafcf68d8c">tj3DecodeYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int align, unsigned char *dstBuf, int width, int pitch, int height, int pixelFormat)</td></tr>
|
||||
<tr class="memdesc:gaa1eb574f38b1c1de43a6c7aafcf68d8c"><td class="mdescLeft"> </td><td class="mdescRight">Decode an 8-bit-per-sample unified planar YUV image into an 8-bit-per-sample packed-pixel RGB or grayscale image. <br /></td></tr>
|
||||
<tr class="separator:gaa1eb574f38b1c1de43a6c7aafcf68d8c"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga1e6bf6a19fec3f9fa7534348879d8320" id="r_ga1e6bf6a19fec3f9fa7534348879d8320"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga1e6bf6a19fec3f9fa7534348879d8320">tj3DecompressToYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *jpegBuf, size_t jpegSize, unsigned char *dstBuf, int align)</td></tr>
|
||||
<tr class="memdesc:ga1e6bf6a19fec3f9fa7534348879d8320"><td class="mdescLeft"> </td><td class="mdescRight">Decompress an 8-bit-per-sample JPEG image into an 8-bit-per-sample unified planar YUV image. <br /></td></tr>
|
||||
<tr class="separator:ga1e6bf6a19fec3f9fa7534348879d8320"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gad366f1915f82c1ad4e7e37ebe073ca89" id="r_gad366f1915f82c1ad4e7e37ebe073ca89"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gad366f1915f82c1ad4e7e37ebe073ca89">tj3DecodeYUVPlanes8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *const *srcPlanes, const int *strides, unsigned char *dstBuf, int width, int pitch, int height, int pixelFormat)</td></tr>
|
||||
<tr class="memdesc:gad366f1915f82c1ad4e7e37ebe073ca89"><td class="mdescLeft"> </td><td class="mdescRight">Decode a set of 8-bit-per-sample Y, U (Cb), and V (Cr) image planes into an 8-bit-per-sample packed-pixel RGB or grayscale image. <br /></td></tr>
|
||||
<tr class="separator:gad366f1915f82c1ad4e7e37ebe073ca89"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gaa1eb574f38b1c1de43a6c7aafcf68d8c" id="r_gaa1eb574f38b1c1de43a6c7aafcf68d8c"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaa1eb574f38b1c1de43a6c7aafcf68d8c">tj3DecodeYUV8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *srcBuf, int align, unsigned char *dstBuf, int width, int pitch, int height, int pixelFormat)</td></tr>
|
||||
<tr class="memdesc:gaa1eb574f38b1c1de43a6c7aafcf68d8c"><td class="mdescLeft"> </td><td class="mdescRight">Decode an 8-bit-per-sample unified planar YUV image into an 8-bit-per-sample packed-pixel RGB or grayscale image. <br /></td></tr>
|
||||
<tr class="separator:gaa1eb574f38b1c1de43a6c7aafcf68d8c"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gaff23ba1dcabed456794b844791613920" id="r_gaff23ba1dcabed456794b844791613920"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaff23ba1dcabed456794b844791613920">tj3Transform</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const unsigned char *jpegBuf, size_t jpegSize, int n, unsigned char **dstBufs, size_t *dstSizes, const <a class="el" href="structtjtransform.html">tjtransform</a> *transforms)</td></tr>
|
||||
<tr class="memdesc:gaff23ba1dcabed456794b844791613920"><td class="mdescLeft"> </td><td class="mdescRight">Losslessly transform a JPEG image into another JPEG image. <br /></td></tr>
|
||||
<tr class="separator:gaff23ba1dcabed456794b844791613920"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga53fbadf4560e95a65b8f5ab81703fe82" id="r_ga53fbadf4560e95a65b8f5ab81703fe82"><td class="memItemLeft" align="right" valign="top">DLLEXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga53fbadf4560e95a65b8f5ab81703fe82">tj3Destroy</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle)</td></tr>
|
||||
<tr class="memdesc:ga53fbadf4560e95a65b8f5ab81703fe82"><td class="mdescLeft"> </td><td class="mdescRight">Destroy a TurboJPEG instance. <br /></td></tr>
|
||||
<tr class="separator:ga53fbadf4560e95a65b8f5ab81703fe82"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga1a2c96d8b47530b6e6050ba6f10b7c57" id="r_ga1a2c96d8b47530b6e6050ba6f10b7c57"><td class="memItemLeft" align="right" valign="top">DLLEXPORT void * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga1a2c96d8b47530b6e6050ba6f10b7c57">tj3Alloc</a> (size_t bytes)</td></tr>
|
||||
<tr class="memdesc:ga1a2c96d8b47530b6e6050ba6f10b7c57"><td class="mdescLeft"> </td><td class="mdescRight">Allocate a byte buffer for use with TurboJPEG. <br /></td></tr>
|
||||
<tr class="separator:ga1a2c96d8b47530b6e6050ba6f10b7c57"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga884023536e70985616126a073f662001" id="r_ga884023536e70985616126a073f662001"><td class="memItemLeft" align="right" valign="top">DLLEXPORT unsigned char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga884023536e70985616126a073f662001">tj3LoadImage8</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const char *filename, int *width, int align, int *height, int *pixelFormat)</td></tr>
|
||||
<tr class="memdesc:ga884023536e70985616126a073f662001"><td class="mdescLeft"> </td><td class="mdescRight">Load a packed-pixel image with 2 to 8 bits of data precision per sample from disk into memory. <br /></td></tr>
|
||||
<tr class="separator:ga884023536e70985616126a073f662001"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
@ -373,15 +382,6 @@ Functions</h2></td></tr>
|
||||
<tr class="memitem:ga0fd87851f4266aca24bf4594dd0c0e71" id="r_ga0fd87851f4266aca24bf4594dd0c0e71"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga0fd87851f4266aca24bf4594dd0c0e71">tj3SaveImage16</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle, const char *filename, const unsigned short *buffer, int width, int pitch, int height, int pixelFormat)</td></tr>
|
||||
<tr class="memdesc:ga0fd87851f4266aca24bf4594dd0c0e71"><td class="mdescLeft"> </td><td class="mdescRight">Save a packed-pixel image with 13 to 16 bits of data precision per sample from memory to disk. <br /></td></tr>
|
||||
<tr class="separator:ga0fd87851f4266aca24bf4594dd0c0e71"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gaddb84fb6c81769e9faa0f5a63b296606" id="r_gaddb84fb6c81769e9faa0f5a63b296606"><td class="memItemLeft" align="right" valign="top">DLLEXPORT void </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gaddb84fb6c81769e9faa0f5a63b296606">tj3Free</a> (void *buffer)</td></tr>
|
||||
<tr class="memdesc:gaddb84fb6c81769e9faa0f5a63b296606"><td class="mdescLeft"> </td><td class="mdescRight">Free a byte buffer previously allocated by TurboJPEG. <br /></td></tr>
|
||||
<tr class="separator:gaddb84fb6c81769e9faa0f5a63b296606"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:ga5a23ad0776c5333cda0d7c6d826e9d29" id="r_ga5a23ad0776c5333cda0d7c6d826e9d29"><td class="memItemLeft" align="right" valign="top">DLLEXPORT char * </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#ga5a23ad0776c5333cda0d7c6d826e9d29">tj3GetErrorStr</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle)</td></tr>
|
||||
<tr class="memdesc:ga5a23ad0776c5333cda0d7c6d826e9d29"><td class="mdescLeft"> </td><td class="mdescRight">Returns a descriptive error message explaining why the last command failed. <br /></td></tr>
|
||||
<tr class="separator:ga5a23ad0776c5333cda0d7c6d826e9d29"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
<tr class="memitem:gab8c8279f1415fe425ff30dbbc56013bd" id="r_gab8c8279f1415fe425ff30dbbc56013bd"><td class="memItemLeft" align="right" valign="top">DLLEXPORT int </td><td class="memItemRight" valign="bottom"><a class="el" href="group___turbo_j_p_e_g.html#gab8c8279f1415fe425ff30dbbc56013bd">tj3GetErrorCode</a> (<a class="el" href="group___turbo_j_p_e_g.html#ga758d2634ecb4949de7815cba621f5763">tjhandle</a> handle)</td></tr>
|
||||
<tr class="memdesc:gab8c8279f1415fe425ff30dbbc56013bd"><td class="mdescLeft"> </td><td class="mdescRight">Returns a code indicating the severity of the last error. <br /></td></tr>
|
||||
<tr class="separator:gab8c8279f1415fe425ff30dbbc56013bd"><td class="memSeparator" colspan="2"> </td></tr>
|
||||
</table><table class="memberdecls">
|
||||
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="var-members" name="var-members"></a>
|
||||
Variables</h2></td></tr>
|
||||
@ -973,20 +973,20 @@ scalingFactor)</code>. </p>
|
||||
<p>A point transform value of <code>0</code> is necessary in order to generate a fully lossless JPEG image. (A non-zero point transform value right-shifts the input samples by the specified number of bits, which is effectively a form of lossy color quantization.)</p>
|
||||
<dl class="section see"><dt>See also</dt><dd><a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a249f35f0770792b19f995e603bb17c6f" title="Lossless JPEG.">TJPARAM_LOSSLESS</a>, <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a781db82741934e8cd008d308597c59d8" title="Data precision (bits per sample)">TJPARAM_PRECISION</a> </dd></dl>
|
||||
</td></tr>
|
||||
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" name="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec"></a>TJPARAM_RESTARTBLOCKS </td><td class="fielddoc"><p>JPEG restart marker interval in MCUs [lossy compression only]. </p>
|
||||
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" name="ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec"></a>TJPARAM_RESTARTBLOCKS </td><td class="fielddoc"><p>JPEG restart marker interval in MCUs [lossy compression, lossless transformation]. </p>
|
||||
<p>The nature of entropy coding is such that a corrupt JPEG image cannot be decompressed beyond the point of corruption unless it contains restart markers. A restart marker stops and restarts the entropy coding algorithm so that, if a JPEG image is corrupted, decompression can resume at the next marker. Thus, adding more restart markers improves the fault tolerance of the JPEG image, but adding too many restart markers can adversely affect the compression ratio and performance.</p>
|
||||
<p>In typical JPEG images, an MCU (Minimum Coded Unit) is the minimum set of interleaved "data units" (8x8 DCT blocks if the image is lossy or samples if the image is lossless) necessary to represent at least one data unit per component. (For example, an MCU in an interleaved lossy JPEG image that uses 4:2:2 subsampling consists of two luminance blocks followed by one block for each chrominance component.) In single-component or non-interleaved JPEG images, an MCU is the same as a data unit.</p>
|
||||
<p><b>Value</b></p><ul>
|
||||
<li>the number of MCUs between each restart marker <em>[default: <code>0</code> (no restart markers)]</em></li>
|
||||
</ul>
|
||||
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c" title="JPEG restart marker interval in MCU rows [compression only].">TJPARAM_RESTARTROWS</a> to 0. </p>
|
||||
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c" title="JPEG restart marker interval in MCU rows [compression, lossless transformation].">TJPARAM_RESTARTROWS</a> to 0. </p>
|
||||
</td></tr>
|
||||
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c" name="ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c"></a>TJPARAM_RESTARTROWS </td><td class="fielddoc"><p>JPEG restart marker interval in MCU rows [compression only]. </p>
|
||||
<p>See <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCUs [lossy compression only].">TJPARAM_RESTARTBLOCKS</a> for a description of restart markers and MCUs. An MCU row is a row of MCUs spanning the entire width of the image.</p>
|
||||
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c" name="ggaa0f6be63ba78278299c9f5c12031fe82a714367585952fe5c863f0dba5bd37e5c"></a>TJPARAM_RESTARTROWS </td><td class="fielddoc"><p>JPEG restart marker interval in MCU rows [compression, lossless transformation]. </p>
|
||||
<p>See <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCUs [lossy compression, lossless transformation].">TJPARAM_RESTARTBLOCKS</a> for a description of restart markers and MCUs. An MCU row is a row of MCUs spanning the entire width of the image.</p>
|
||||
<p><b>Value</b></p><ul>
|
||||
<li>the number of MCU rows between each restart marker <em>[default: <code>0</code> (no restart markers)]</em></li>
|
||||
</ul>
|
||||
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCUs [lossy compression only].">TJPARAM_RESTARTBLOCKS</a> to 0. </p>
|
||||
<p>Setting this parameter to a non-zero value sets <a class="el" href="group___turbo_j_p_e_g.html#ggaa0f6be63ba78278299c9f5c12031fe82a343c72883b7160f23f3ef46fc548a0ec" title="JPEG restart marker interval in MCUs [lossy compression, lossless transformation].">TJPARAM_RESTARTBLOCKS</a> to 0. </p>
|
||||
</td></tr>
|
||||
<tr><td class="fieldname"><a id="ggaa0f6be63ba78278299c9f5c12031fe82a4de5c9d7cab5be806143a43c3b0e0877" name="ggaa0f6be63ba78278299c9f5c12031fe82a4de5c9d7cab5be806143a43c3b0e0877"></a>TJPARAM_XDENSITY </td><td class="fielddoc"><p>JPEG horizontal pixel density. </p>
|
||||
<p><b>Value</b></p><ul>
|
||||
|
||||
1362
src/turbojpeg.c
1362
src/turbojpeg.c
File diff suppressed because it is too large
Load Diff
674
src/turbojpeg.h
674
src/turbojpeg.h
@ -1196,6 +1196,40 @@ extern "C" {
|
||||
DLLEXPORT tjhandle tj3Init(int initType);
|
||||
|
||||
|
||||
/**
|
||||
* Destroy a TurboJPEG instance.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance. If the handle is NULL, then
|
||||
* this function has no effect.
|
||||
*/
|
||||
DLLEXPORT void tj3Destroy(tjhandle handle);
|
||||
|
||||
|
||||
/**
|
||||
* Returns a descriptive error message explaining why the last command failed.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance, or NULL if the error was
|
||||
* generated by a global function (but note that retrieving the error message
|
||||
* for a global function is thread-safe only on platforms that support
|
||||
* thread-local storage.)
|
||||
*
|
||||
* @return a descriptive error message explaining why the last command failed.
|
||||
*/
|
||||
DLLEXPORT char *tj3GetErrorStr(tjhandle handle);
|
||||
|
||||
|
||||
/**
|
||||
* Returns a code indicating the severity of the last error. See
|
||||
* @ref TJERR "Error codes".
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance
|
||||
*
|
||||
* @return a code indicating the severity of the last error. See
|
||||
* @ref TJERR "Error codes".
|
||||
*/
|
||||
DLLEXPORT int tj3GetErrorCode(tjhandle handle);
|
||||
|
||||
|
||||
/**
|
||||
* Set the value of a parameter.
|
||||
*
|
||||
@ -1223,6 +1257,145 @@ DLLEXPORT int tj3Set(tjhandle handle, int param, int value);
|
||||
DLLEXPORT int tj3Get(tjhandle handle, int param);
|
||||
|
||||
|
||||
/**
|
||||
* Allocate a byte buffer for use with TurboJPEG. You should always use this
|
||||
* function to allocate the JPEG destination buffer(s) for the compression and
|
||||
* transform functions unless you are disabling automatic buffer (re)allocation
|
||||
* (by setting #TJPARAM_NOREALLOC.)
|
||||
*
|
||||
* @param bytes the number of bytes to allocate
|
||||
*
|
||||
* @return a pointer to a newly-allocated buffer with the specified number of
|
||||
* bytes.
|
||||
*
|
||||
* @see tj3Free()
|
||||
*/
|
||||
DLLEXPORT void *tj3Alloc(size_t bytes);
|
||||
|
||||
|
||||
/**
|
||||
* Free a byte buffer previously allocated by TurboJPEG. You should always use
|
||||
* this function to free JPEG destination buffer(s) that were automatically
|
||||
* (re)allocated by the compression and transform functions or that were
|
||||
* manually allocated using #tj3Alloc().
|
||||
*
|
||||
* @param buffer address of the buffer to free. If the address is NULL, then
|
||||
* this function has no effect.
|
||||
*
|
||||
* @see tj3Alloc()
|
||||
*/
|
||||
DLLEXPORT void tj3Free(void *buffer);
|
||||
|
||||
|
||||
/**
|
||||
* The maximum size of the buffer (in bytes) required to hold a JPEG image with
|
||||
* the given parameters. The number of bytes returned by this function is
|
||||
* larger than the size of the uncompressed source image. The reason for this
|
||||
* is that the JPEG format uses 16-bit coefficients, so it is possible for a
|
||||
* very high-quality source image with very high-frequency content to expand
|
||||
* rather than compress when converted to the JPEG format. Such images
|
||||
* represent very rare corner cases, but since there is no way to predict the
|
||||
* size of a JPEG image prior to compression, the corner cases have to be
|
||||
* handled.
|
||||
*
|
||||
* @param width width (in pixels) of the image
|
||||
*
|
||||
* @param height height (in pixels) of the image
|
||||
*
|
||||
* @param jpegSubsamp the level of chrominance subsampling to be used when
|
||||
* generating the JPEG image (see @ref TJSAMP
|
||||
* "Chrominance subsampling options".) #TJSAMP_UNKNOWN is treated like
|
||||
* #TJSAMP_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 #TJSAMP_444.
|
||||
*
|
||||
* @return the maximum size of the buffer (in bytes) required to hold the
|
||||
* image, or 0 if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT size_t tj3JPEGBufSize(int width, int height, int jpegSubsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The size of the buffer (in bytes) required to hold a unified planar YUV
|
||||
* image with the given parameters.
|
||||
*
|
||||
* @param width width (in pixels) of the image
|
||||
*
|
||||
* @param align row alignment (in bytes) of the image (must be a power of 2.)
|
||||
* Setting this parameter to n specifies that each row in each plane of the
|
||||
* image will be padded to the nearest multiple of n bytes (1 = unpadded.)
|
||||
*
|
||||
* @param height height (in pixels) of the image
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the size of the buffer (in bytes) required to hold the image, or 0
|
||||
* if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT size_t tj3YUVBufSize(int width, int align, int height, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The size of the buffer (in bytes) required to hold a YUV image plane with
|
||||
* the given parameters.
|
||||
*
|
||||
* @param componentID ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
|
||||
*
|
||||
* @param width width (in pixels) of the YUV image. NOTE: This is the width of
|
||||
* the whole image, not the plane width.
|
||||
*
|
||||
* @param stride bytes per row in the image plane. Setting this to 0 is the
|
||||
* equivalent of setting it to the plane width.
|
||||
*
|
||||
* @param height height (in pixels) of the YUV image. NOTE: This is the height
|
||||
* of the whole image, not the plane height.
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the size of the buffer (in bytes) required to hold the YUV image
|
||||
* plane, or 0 if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT size_t tj3YUVPlaneSize(int componentID, int width, int stride,
|
||||
int height, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The plane width of a YUV image plane with the given parameters. Refer to
|
||||
* @ref YUVnotes "YUV Image Format Notes" for a description of plane width.
|
||||
*
|
||||
* @param componentID ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
|
||||
*
|
||||
* @param width width (in pixels) of the YUV image
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the plane width of a YUV image plane with the given parameters, or 0
|
||||
* if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT int tj3YUVPlaneWidth(int componentID, int width, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The plane height of a YUV image plane with the given parameters. Refer to
|
||||
* @ref YUVnotes "YUV Image Format Notes" for a description of plane height.
|
||||
*
|
||||
* @param componentID ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
|
||||
*
|
||||
* @param height height (in pixels) of the YUV image
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the plane height of a YUV image plane with the given parameters, or
|
||||
* 0 if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT int tj3YUVPlaneHeight(int componentID, int height, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* Compress a packed-pixel RGB, grayscale, or CMYK image with 2 to 8 bits of
|
||||
* data precision per sample into a JPEG image with the same data precision.
|
||||
@ -1402,65 +1575,6 @@ DLLEXPORT int tj3Compress16(tjhandle handle, const unsigned short *srcBuf,
|
||||
unsigned char **jpegBuf, size_t *jpegSize);
|
||||
|
||||
|
||||
/**
|
||||
* Compress an 8-bit-per-sample unified planar YUV image into an
|
||||
* 8-bit-per-sample JPEG image.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance that has been initialized for
|
||||
* compression
|
||||
*
|
||||
* @param srcBuf pointer to a buffer containing a unified planar YUV source
|
||||
* image to be compressed. The size of this buffer should match the value
|
||||
* returned by #tj3YUVBufSize() for the given image width, height, row
|
||||
* alignment, and level of chrominance subsampling (see #TJPARAM_SUBSAMP.) The
|
||||
* Y, U (Cb), and V (Cr) image planes should be stored sequentially in the
|
||||
* buffer. (Refer to @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param width width (in pixels) of the source image. If the width is not an
|
||||
* even multiple of the iMCU width (see #tjMCUWidth), then an intermediate
|
||||
* buffer copy will be performed.
|
||||
*
|
||||
* @param align row alignment (in bytes) of the source image (must be a power
|
||||
* of 2.) Setting this parameter to n indicates that each row in each plane of
|
||||
* the source image is padded to the nearest multiple of n bytes
|
||||
* (1 = unpadded.)
|
||||
*
|
||||
* @param height height (in pixels) of the source image. If the height is not
|
||||
* an even multiple of the iMCU height (see #tjMCUHeight), then an intermediate
|
||||
* buffer copy will be performed.
|
||||
*
|
||||
* @param jpegBuf address of a pointer to a byte buffer that will receive the
|
||||
* JPEG image. TurboJPEG has the ability to reallocate the JPEG buffer to
|
||||
* accommodate the size of the JPEG image. Thus, you can choose to:
|
||||
* -# pre-allocate the JPEG buffer with an arbitrary size using #tj3Alloc() and
|
||||
* let TurboJPEG grow the buffer as needed,
|
||||
* -# set `*jpegBuf` to NULL to tell TurboJPEG to allocate the buffer for you,
|
||||
* or
|
||||
* -# pre-allocate the buffer to a "worst case" size determined by calling
|
||||
* #tj3JPEGBufSize(). This should ensure that the buffer never has to be
|
||||
* re-allocated. (Setting #TJPARAM_NOREALLOC guarantees that it won't be.)
|
||||
* .
|
||||
* If you choose option 1, then `*jpegSize` should be set to the size of your
|
||||
* pre-allocated buffer. In any case, unless you have set #TJPARAM_NOREALLOC,
|
||||
* you should always check `*jpegBuf` upon return from this function, as it may
|
||||
* have changed.
|
||||
*
|
||||
* @param jpegSize pointer to a size_t variable that holds the size of the JPEG
|
||||
* buffer. If `*jpegBuf` points to a pre-allocated buffer, then `*jpegSize`
|
||||
* should be set to the size of the buffer. Upon return, `*jpegSize` will
|
||||
* contain the size of the JPEG image (in bytes.) If `*jpegBuf` points to a
|
||||
* JPEG buffer that is being reused from a previous call to one of the JPEG
|
||||
* compression functions, then `*jpegSize` is ignored.
|
||||
*
|
||||
* @return 0 if successful, or -1 if an error occurred (see #tj3GetErrorStr()
|
||||
* and #tj3GetErrorCode().)
|
||||
*/
|
||||
DLLEXPORT int tj3CompressFromYUV8(tjhandle handle,
|
||||
const unsigned char *srcBuf, int width,
|
||||
int align, int height,
|
||||
unsigned char **jpegBuf, size_t *jpegSize);
|
||||
|
||||
|
||||
/**
|
||||
* Compress a set of 8-bit-per-sample Y, U (Cb), and V (Cr) image planes into
|
||||
* an 8-bit-per-sample JPEG image.
|
||||
@ -1527,160 +1641,62 @@ DLLEXPORT int tj3CompressFromYUVPlanes8(tjhandle handle,
|
||||
|
||||
|
||||
/**
|
||||
* The maximum size of the buffer (in bytes) required to hold a JPEG image with
|
||||
* the given parameters. The number of bytes returned by this function is
|
||||
* larger than the size of the uncompressed source image. The reason for this
|
||||
* is that the JPEG format uses 16-bit coefficients, so it is possible for a
|
||||
* very high-quality source image with very high-frequency content to expand
|
||||
* rather than compress when converted to the JPEG format. Such images
|
||||
* represent very rare corner cases, but since there is no way to predict the
|
||||
* size of a JPEG image prior to compression, the corner cases have to be
|
||||
* handled.
|
||||
*
|
||||
* @param width width (in pixels) of the image
|
||||
*
|
||||
* @param height height (in pixels) of the image
|
||||
*
|
||||
* @param jpegSubsamp the level of chrominance subsampling to be used when
|
||||
* generating the JPEG image (see @ref TJSAMP
|
||||
* "Chrominance subsampling options".) #TJSAMP_UNKNOWN is treated like
|
||||
* #TJSAMP_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 #TJSAMP_444.
|
||||
*
|
||||
* @return the maximum size of the buffer (in bytes) required to hold the
|
||||
* image, or 0 if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT size_t tj3JPEGBufSize(int width, int height, int jpegSubsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The size of the buffer (in bytes) required to hold a unified planar YUV
|
||||
* image with the given parameters.
|
||||
*
|
||||
* @param width width (in pixels) of the image
|
||||
*
|
||||
* @param align row alignment (in bytes) of the image (must be a power of 2.)
|
||||
* Setting this parameter to n specifies that each row in each plane of the
|
||||
* image will be padded to the nearest multiple of n bytes (1 = unpadded.)
|
||||
*
|
||||
* @param height height (in pixels) of the image
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the size of the buffer (in bytes) required to hold the image, or 0
|
||||
* if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT size_t tj3YUVBufSize(int width, int align, int height, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The size of the buffer (in bytes) required to hold a YUV image plane with
|
||||
* the given parameters.
|
||||
*
|
||||
* @param componentID ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
|
||||
*
|
||||
* @param width width (in pixels) of the YUV image. NOTE: This is the width of
|
||||
* the whole image, not the plane width.
|
||||
*
|
||||
* @param stride bytes per row in the image plane. Setting this to 0 is the
|
||||
* equivalent of setting it to the plane width.
|
||||
*
|
||||
* @param height height (in pixels) of the YUV image. NOTE: This is the height
|
||||
* of the whole image, not the plane height.
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the size of the buffer (in bytes) required to hold the YUV image
|
||||
* plane, or 0 if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT size_t tj3YUVPlaneSize(int componentID, int width, int stride,
|
||||
int height, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The plane width of a YUV image plane with the given parameters. Refer to
|
||||
* @ref YUVnotes "YUV Image Format Notes" for a description of plane width.
|
||||
*
|
||||
* @param componentID ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
|
||||
*
|
||||
* @param width width (in pixels) of the YUV image
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the plane width of a YUV image plane with the given parameters, or 0
|
||||
* if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT int tj3YUVPlaneWidth(int componentID, int width, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* The plane height of a YUV image plane with the given parameters. Refer to
|
||||
* @ref YUVnotes "YUV Image Format Notes" for a description of plane height.
|
||||
*
|
||||
* @param componentID ID number of the image plane (0 = Y, 1 = U/Cb, 2 = V/Cr)
|
||||
*
|
||||
* @param height height (in pixels) of the YUV image
|
||||
*
|
||||
* @param subsamp level of chrominance subsampling in the image (see
|
||||
* @ref TJSAMP "Chrominance subsampling options".)
|
||||
*
|
||||
* @return the plane height of a YUV image plane with the given parameters, or
|
||||
* 0 if the arguments are out of bounds.
|
||||
*/
|
||||
DLLEXPORT int tj3YUVPlaneHeight(int componentID, int height, int subsamp);
|
||||
|
||||
|
||||
/**
|
||||
* Encode an 8-bit-per-sample packed-pixel RGB or grayscale image into an
|
||||
* 8-bit-per-sample unified planar YUV image. This function performs color
|
||||
* conversion (which is accelerated in the libjpeg-turbo implementation) but
|
||||
* does not execute any of the other steps in the JPEG compression process.
|
||||
* Compress an 8-bit-per-sample unified planar YUV image into an
|
||||
* 8-bit-per-sample JPEG image.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance that has been initialized for
|
||||
* compression
|
||||
*
|
||||
* @param srcBuf pointer to a buffer containing a packed-pixel RGB or grayscale
|
||||
* source image to be encoded. This buffer should normally be `pitch * height`
|
||||
* bytes in size. However, you can also use this parameter to encode from a
|
||||
* specific region of a larger buffer.
|
||||
* @param srcBuf pointer to a buffer containing a unified planar YUV source
|
||||
* image to be compressed. The size of this buffer should match the value
|
||||
* returned by #tj3YUVBufSize() for the given image width, height, row
|
||||
* alignment, and level of chrominance subsampling (see #TJPARAM_SUBSAMP.) The
|
||||
* Y, U (Cb), and V (Cr) image planes should be stored sequentially in the
|
||||
* buffer. (Refer to @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param width width (in pixels) of the source image
|
||||
* @param width width (in pixels) of the source image. If the width is not an
|
||||
* even multiple of the iMCU width (see #tjMCUWidth), then an intermediate
|
||||
* buffer copy will be performed.
|
||||
*
|
||||
* @param pitch bytes per row in the source image. Normally this should be
|
||||
* <tt>width * #tjPixelSize[pixelFormat]</tt>, if the image is unpadded.
|
||||
* (Setting this parameter to 0 is the equivalent of setting it to
|
||||
* <tt>width * #tjPixelSize[pixelFormat]</tt>.) However, you can also use this
|
||||
* parameter to specify the row alignment/padding of the source image, to skip
|
||||
* rows, or to encode from a specific region of a larger packed-pixel image.
|
||||
* @param align row alignment (in bytes) of the source image (must be a power
|
||||
* of 2.) Setting this parameter to n indicates that each row in each plane of
|
||||
* the source image is padded to the nearest multiple of n bytes
|
||||
* (1 = unpadded.)
|
||||
*
|
||||
* @param height height (in pixels) of the source image
|
||||
* @param height height (in pixels) of the source image. If the height is not
|
||||
* an even multiple of the iMCU height (see #tjMCUHeight), then an intermediate
|
||||
* buffer copy will be performed.
|
||||
*
|
||||
* @param pixelFormat pixel format of the source image (see @ref TJPF
|
||||
* "Pixel formats".)
|
||||
* @param jpegBuf address of a pointer to a byte buffer that will receive the
|
||||
* JPEG image. TurboJPEG has the ability to reallocate the JPEG buffer to
|
||||
* accommodate the size of the JPEG image. Thus, you can choose to:
|
||||
* -# pre-allocate the JPEG buffer with an arbitrary size using #tj3Alloc() and
|
||||
* let TurboJPEG grow the buffer as needed,
|
||||
* -# set `*jpegBuf` to NULL to tell TurboJPEG to allocate the buffer for you,
|
||||
* or
|
||||
* -# pre-allocate the buffer to a "worst case" size determined by calling
|
||||
* #tj3JPEGBufSize(). This should ensure that the buffer never has to be
|
||||
* re-allocated. (Setting #TJPARAM_NOREALLOC guarantees that it won't be.)
|
||||
* .
|
||||
* If you choose option 1, then `*jpegSize` should be set to the size of your
|
||||
* pre-allocated buffer. In any case, unless you have set #TJPARAM_NOREALLOC,
|
||||
* you should always check `*jpegBuf` upon return from this function, as it may
|
||||
* have changed.
|
||||
*
|
||||
* @param dstBuf pointer to a buffer that will receive the unified planar YUV
|
||||
* image. Use #tj3YUVBufSize() to determine the appropriate size for this
|
||||
* buffer based on the image width, height, row alignment, and level of
|
||||
* chrominance subsampling (see #TJPARAM_SUBSAMP.) The Y, U (Cb), and V (Cr)
|
||||
* image planes will be stored sequentially in the buffer. (Refer to
|
||||
* @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param align 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.)
|
||||
* To generate images suitable for X Video, `align` should be set to 4.
|
||||
* @param jpegSize pointer to a size_t variable that holds the size of the JPEG
|
||||
* buffer. If `*jpegBuf` points to a pre-allocated buffer, then `*jpegSize`
|
||||
* should be set to the size of the buffer. Upon return, `*jpegSize` will
|
||||
* contain the size of the JPEG image (in bytes.) If `*jpegBuf` points to a
|
||||
* JPEG buffer that is being reused from a previous call to one of the JPEG
|
||||
* compression functions, then `*jpegSize` is ignored.
|
||||
*
|
||||
* @return 0 if successful, or -1 if an error occurred (see #tj3GetErrorStr()
|
||||
* and #tj3GetErrorCode().)
|
||||
*/
|
||||
DLLEXPORT int tj3EncodeYUV8(tjhandle handle, const unsigned char *srcBuf,
|
||||
int width, int pitch, int height, int pixelFormat,
|
||||
unsigned char *dstBuf, int align);
|
||||
DLLEXPORT int tj3CompressFromYUV8(tjhandle handle,
|
||||
const unsigned char *srcBuf, int width,
|
||||
int align, int height,
|
||||
unsigned char **jpegBuf, size_t *jpegSize);
|
||||
|
||||
|
||||
/**
|
||||
@ -1738,6 +1754,54 @@ DLLEXPORT int tj3EncodeYUVPlanes8(tjhandle handle, const unsigned char *srcBuf,
|
||||
int *strides);
|
||||
|
||||
|
||||
/**
|
||||
* Encode an 8-bit-per-sample packed-pixel RGB or grayscale image into an
|
||||
* 8-bit-per-sample unified planar YUV image. This function performs color
|
||||
* conversion (which is accelerated in the libjpeg-turbo implementation) but
|
||||
* does not execute any of the other steps in the JPEG compression process.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance that has been initialized for
|
||||
* compression
|
||||
*
|
||||
* @param srcBuf pointer to a buffer containing a packed-pixel RGB or grayscale
|
||||
* source image to be encoded. This buffer should normally be `pitch * height`
|
||||
* bytes in size. However, you can also use this parameter to encode from a
|
||||
* specific region of a larger buffer.
|
||||
*
|
||||
* @param width width (in pixels) of the source image
|
||||
*
|
||||
* @param pitch bytes per row in the source image. Normally this should be
|
||||
* <tt>width * #tjPixelSize[pixelFormat]</tt>, if the image is unpadded.
|
||||
* (Setting this parameter to 0 is the equivalent of setting it to
|
||||
* <tt>width * #tjPixelSize[pixelFormat]</tt>.) However, you can also use this
|
||||
* parameter to specify the row alignment/padding of the source image, to skip
|
||||
* rows, or to encode from a specific region of a larger packed-pixel image.
|
||||
*
|
||||
* @param height height (in pixels) of the source image
|
||||
*
|
||||
* @param pixelFormat pixel format of the source image (see @ref TJPF
|
||||
* "Pixel formats".)
|
||||
*
|
||||
* @param dstBuf pointer to a buffer that will receive the unified planar YUV
|
||||
* image. Use #tj3YUVBufSize() to determine the appropriate size for this
|
||||
* buffer based on the image width, height, row alignment, and level of
|
||||
* chrominance subsampling (see #TJPARAM_SUBSAMP.) The Y, U (Cb), and V (Cr)
|
||||
* image planes will be stored sequentially in the buffer. (Refer to
|
||||
* @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param align 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.)
|
||||
* To generate images suitable for X Video, `align` should be set to 4.
|
||||
*
|
||||
* @return 0 if successful, or -1 if an error occurred (see #tj3GetErrorStr()
|
||||
* and #tj3GetErrorCode().)
|
||||
*/
|
||||
DLLEXPORT int tj3EncodeYUV8(tjhandle handle, const unsigned char *srcBuf,
|
||||
int width, int pitch, int height, int pixelFormat,
|
||||
unsigned char *dstBuf, int align);
|
||||
|
||||
|
||||
/**
|
||||
* Retrieve information about a JPEG image without decompressing it, or prime
|
||||
* the decompressor with quantization and Huffman tables. If a JPEG image is
|
||||
@ -1898,43 +1962,6 @@ DLLEXPORT int tj3Decompress16(tjhandle handle, const unsigned char *jpegBuf,
|
||||
int pitch, int pixelFormat);
|
||||
|
||||
|
||||
/**
|
||||
* Decompress an 8-bit-per-sample JPEG image into an 8-bit-per-sample unified
|
||||
* planar YUV image. This function performs JPEG decompression but leaves out
|
||||
* the color conversion step, so a planar YUV image is generated instead of a
|
||||
* packed-pixel image. The @ref TJPARAM "parameters" that describe the JPEG
|
||||
* image will be set when this function returns.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance that has been initialized for
|
||||
* decompression
|
||||
*
|
||||
* @param jpegBuf pointer to a byte buffer containing the JPEG image to
|
||||
* decompress
|
||||
*
|
||||
* @param jpegSize size of the JPEG image (in bytes)
|
||||
*
|
||||
* @param dstBuf pointer to a buffer that will receive the unified planar YUV
|
||||
* decompressed image. Use #tj3YUVBufSize() to determine the appropriate size
|
||||
* for this buffer based on the scaled JPEG width and height (see #TJSCALED(),
|
||||
* #TJPARAM_JPEGWIDTH, #TJPARAM_JPEGHEIGHT, and #tj3SetScalingFactor()), row
|
||||
* alignment, and level of chrominance subsampling (see #TJPARAM_SUBSAMP.) The
|
||||
* Y, U (Cb), and V (Cr) image planes will be stored sequentially in the
|
||||
* buffer. (Refer to @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param align 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.)
|
||||
* To generate images suitable for X Video, `align` should be set to 4.
|
||||
*
|
||||
* @return 0 if successful, or -1 if an error occurred (see #tj3GetErrorStr()
|
||||
* and #tj3GetErrorCode().)
|
||||
*/
|
||||
DLLEXPORT int tj3DecompressToYUV8(tjhandle handle,
|
||||
const unsigned char *jpegBuf,
|
||||
size_t jpegSize,
|
||||
unsigned char *dstBuf, int align);
|
||||
|
||||
|
||||
/**
|
||||
* Decompress an 8-bit-per-sample JPEG image into separate 8-bit-per-sample Y,
|
||||
* U (Cb), and V (Cr) image planes. This function performs JPEG decompression
|
||||
@ -1979,52 +2006,40 @@ DLLEXPORT int tj3DecompressToYUVPlanes8(tjhandle handle,
|
||||
|
||||
|
||||
/**
|
||||
* Decode an 8-bit-per-sample unified planar YUV image into an 8-bit-per-sample
|
||||
* packed-pixel RGB or grayscale image. This function performs color
|
||||
* conversion (which is accelerated in the libjpeg-turbo implementation) but
|
||||
* does not execute any of the other steps in the JPEG decompression process.
|
||||
* Decompress an 8-bit-per-sample JPEG image into an 8-bit-per-sample unified
|
||||
* planar YUV image. This function performs JPEG decompression but leaves out
|
||||
* the color conversion step, so a planar YUV image is generated instead of a
|
||||
* packed-pixel image. The @ref TJPARAM "parameters" that describe the JPEG
|
||||
* image will be set when this function returns.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance that has been initialized for
|
||||
* decompression
|
||||
*
|
||||
* @param srcBuf pointer to a buffer containing a unified planar YUV source
|
||||
* image to be decoded. The size of this buffer should match the value
|
||||
* returned by #tj3YUVBufSize() for the given image width, height, row
|
||||
* @param jpegBuf pointer to a byte buffer containing the JPEG image to
|
||||
* decompress
|
||||
*
|
||||
* @param jpegSize size of the JPEG image (in bytes)
|
||||
*
|
||||
* @param dstBuf pointer to a buffer that will receive the unified planar YUV
|
||||
* decompressed image. Use #tj3YUVBufSize() to determine the appropriate size
|
||||
* for this buffer based on the scaled JPEG width and height (see #TJSCALED(),
|
||||
* #TJPARAM_JPEGWIDTH, #TJPARAM_JPEGHEIGHT, and #tj3SetScalingFactor()), row
|
||||
* alignment, and level of chrominance subsampling (see #TJPARAM_SUBSAMP.) The
|
||||
* Y, U (Cb), and V (Cr) image planes should be stored sequentially in the
|
||||
* source buffer. (Refer to @ref YUVnotes "YUV Image Format Notes".)
|
||||
* Y, U (Cb), and V (Cr) image planes will be stored sequentially in the
|
||||
* buffer. (Refer to @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param align row alignment (in bytes) of the YUV source image (must be a
|
||||
* power of 2.) Setting this parameter to n indicates that each row in each
|
||||
* plane of the YUV source image is padded to the nearest multiple of n bytes
|
||||
* (1 = unpadded.)
|
||||
*
|
||||
* @param dstBuf pointer to a buffer that will receive the packed-pixel decoded
|
||||
* image. This buffer should normally be `pitch * height` bytes in size.
|
||||
* However, you can also use this parameter to decode into a specific region of
|
||||
* a larger buffer.
|
||||
*
|
||||
* @param width width (in pixels) of the source and destination images
|
||||
*
|
||||
* @param pitch bytes per row in the destination image. Normally this should
|
||||
* be set to <tt>width * #tjPixelSize[pixelFormat]</tt>, if the destination
|
||||
* image should be unpadded. (Setting this parameter to 0 is the equivalent of
|
||||
* setting it to <tt>width * #tjPixelSize[pixelFormat]</tt>.) However, you can
|
||||
* also use this parameter to specify the row alignment/padding of the
|
||||
* destination image, to skip rows, or to decode into a specific region of a
|
||||
* larger buffer.
|
||||
*
|
||||
* @param height height (in pixels) of the source and destination images
|
||||
*
|
||||
* @param pixelFormat pixel format of the destination image (see @ref TJPF
|
||||
* "Pixel formats".)
|
||||
* @param align 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.)
|
||||
* To generate images suitable for X Video, `align` should be set to 4.
|
||||
*
|
||||
* @return 0 if successful, or -1 if an error occurred (see #tj3GetErrorStr()
|
||||
* and #tj3GetErrorCode().)
|
||||
*/
|
||||
DLLEXPORT int tj3DecodeYUV8(tjhandle handle, const unsigned char *srcBuf,
|
||||
int align, unsigned char *dstBuf, int width,
|
||||
int pitch, int height, int pixelFormat);
|
||||
DLLEXPORT int tj3DecompressToYUV8(tjhandle handle,
|
||||
const unsigned char *jpegBuf,
|
||||
size_t jpegSize,
|
||||
unsigned char *dstBuf, int align);
|
||||
|
||||
|
||||
/**
|
||||
@ -2083,6 +2098,55 @@ DLLEXPORT int tj3DecodeYUVPlanes8(tjhandle handle,
|
||||
int pixelFormat);
|
||||
|
||||
|
||||
/**
|
||||
* Decode an 8-bit-per-sample unified planar YUV image into an 8-bit-per-sample
|
||||
* packed-pixel RGB or grayscale image. This function performs color
|
||||
* conversion (which is accelerated in the libjpeg-turbo implementation) but
|
||||
* does not execute any of the other steps in the JPEG decompression process.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance that has been initialized for
|
||||
* decompression
|
||||
*
|
||||
* @param srcBuf pointer to a buffer containing a unified planar YUV source
|
||||
* image to be decoded. The size of this buffer should match the value
|
||||
* returned by #tj3YUVBufSize() for the given image width, height, row
|
||||
* alignment, and level of chrominance subsampling (see #TJPARAM_SUBSAMP.) The
|
||||
* Y, U (Cb), and V (Cr) image planes should be stored sequentially in the
|
||||
* source buffer. (Refer to @ref YUVnotes "YUV Image Format Notes".)
|
||||
*
|
||||
* @param align row alignment (in bytes) of the YUV source image (must be a
|
||||
* power of 2.) Setting this parameter to n indicates that each row in each
|
||||
* plane of the YUV source image is padded to the nearest multiple of n bytes
|
||||
* (1 = unpadded.)
|
||||
*
|
||||
* @param dstBuf pointer to a buffer that will receive the packed-pixel decoded
|
||||
* image. This buffer should normally be `pitch * height` bytes in size.
|
||||
* However, you can also use this parameter to decode into a specific region of
|
||||
* a larger buffer.
|
||||
*
|
||||
* @param width width (in pixels) of the source and destination images
|
||||
*
|
||||
* @param pitch bytes per row in the destination image. Normally this should
|
||||
* be set to <tt>width * #tjPixelSize[pixelFormat]</tt>, if the destination
|
||||
* image should be unpadded. (Setting this parameter to 0 is the equivalent of
|
||||
* setting it to <tt>width * #tjPixelSize[pixelFormat]</tt>.) However, you can
|
||||
* also use this parameter to specify the row alignment/padding of the
|
||||
* destination image, to skip rows, or to decode into a specific region of a
|
||||
* larger buffer.
|
||||
*
|
||||
* @param height height (in pixels) of the source and destination images
|
||||
*
|
||||
* @param pixelFormat pixel format of the destination image (see @ref TJPF
|
||||
* "Pixel formats".)
|
||||
*
|
||||
* @return 0 if successful, or -1 if an error occurred (see #tj3GetErrorStr()
|
||||
* and #tj3GetErrorCode().)
|
||||
*/
|
||||
DLLEXPORT int tj3DecodeYUV8(tjhandle handle, const unsigned char *srcBuf,
|
||||
int align, unsigned char *dstBuf, int width,
|
||||
int pitch, int height, int pixelFormat);
|
||||
|
||||
|
||||
/**
|
||||
* Losslessly transform a JPEG image into another JPEG image. Lossless
|
||||
* transforms work by moving the raw DCT coefficients from one JPEG image
|
||||
@ -2148,31 +2212,6 @@ DLLEXPORT int tj3Transform(tjhandle handle, const unsigned char *jpegBuf,
|
||||
size_t *dstSizes, const tjtransform *transforms);
|
||||
|
||||
|
||||
/**
|
||||
* Destroy a TurboJPEG instance.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance. If the handle is NULL, then
|
||||
* this function has no effect.
|
||||
*/
|
||||
DLLEXPORT void tj3Destroy(tjhandle handle);
|
||||
|
||||
|
||||
/**
|
||||
* Allocate a byte buffer for use with TurboJPEG. You should always use this
|
||||
* function to allocate the JPEG destination buffer(s) for the compression and
|
||||
* transform functions unless you are disabling automatic buffer (re)allocation
|
||||
* (by setting #TJPARAM_NOREALLOC.)
|
||||
*
|
||||
* @param bytes the number of bytes to allocate
|
||||
*
|
||||
* @return a pointer to a newly-allocated buffer with the specified number of
|
||||
* bytes.
|
||||
*
|
||||
* @see tj3Free()
|
||||
*/
|
||||
DLLEXPORT void *tj3Alloc(size_t bytes);
|
||||
|
||||
|
||||
/**
|
||||
* Load a packed-pixel image with 2 to 8 bits of data precision per sample from
|
||||
* disk into memory.
|
||||
@ -2438,45 +2477,6 @@ DLLEXPORT int tj3SaveImage16(tjhandle handle, const char *filename,
|
||||
int pitch, int height, int pixelFormat);
|
||||
|
||||
|
||||
/**
|
||||
* Free a byte buffer previously allocated by TurboJPEG. You should always use
|
||||
* this function to free JPEG destination buffer(s) that were automatically
|
||||
* (re)allocated by the compression and transform functions or that were
|
||||
* manually allocated using #tj3Alloc().
|
||||
*
|
||||
* @param buffer address of the buffer to free. If the address is NULL, then
|
||||
* this function has no effect.
|
||||
*
|
||||
* @see tj3Alloc()
|
||||
*/
|
||||
DLLEXPORT void tj3Free(void *buffer);
|
||||
|
||||
|
||||
/**
|
||||
* Returns a descriptive error message explaining why the last command failed.
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance, or NULL if the error was
|
||||
* generated by a global function (but note that retrieving the error message
|
||||
* for a global function is thread-safe only on platforms that support
|
||||
* thread-local storage.)
|
||||
*
|
||||
* @return a descriptive error message explaining why the last command failed.
|
||||
*/
|
||||
DLLEXPORT char *tj3GetErrorStr(tjhandle handle);
|
||||
|
||||
|
||||
/**
|
||||
* Returns a code indicating the severity of the last error. See
|
||||
* @ref TJERR "Error codes".
|
||||
*
|
||||
* @param handle handle to a TurboJPEG instance
|
||||
*
|
||||
* @return a code indicating the severity of the last error. See
|
||||
* @ref TJERR "Error codes".
|
||||
*/
|
||||
DLLEXPORT int tj3GetErrorCode(tjhandle handle);
|
||||
|
||||
|
||||
/* Backward compatibility functions and macros (nothing to see here) */
|
||||
|
||||
/* TurboJPEG 1.0+ */
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user