

u32 SSP_StartJpegEncoder(const void* src, u8 *dst, u32 limit, u8 *wrk, u32 width, u32 height, u32 quality, u32 sampling, u32 option);
| src | Image data to be encoded. (RGB555 or YUV422) |
| dst | Buffer that stores encoded results. |
| limit | Represents the dst size. Encoding fails if this size is exceeded. |
| wrk | Work buffer. The SSP_GetJpegEncoderBufferSize function calculates the required size. |
| width | Width (in pixels) of the image to encode. |
| height | Height (in pixels) of the image to encode. |
| quality | Encode quality. Values can be from 1 to 100, where 100 represents the highest quality and the largest size. |
| sampling | Main image output formats (SSP_JPEG_OUTPUT_YUV444, SSP_JPEG_OUTPUT_YUV420, or SSP_JPEG_OUTPUT_YUV422). |
| option | Encoding options (SSP_JPEG_RGB555, SSP_JPEG_YUV422, or SSP_JPEG_THUMBNAIL). |
Returns the size of the created JPEG file when successful.
Returns 0 when it fails.
Encodes image data as a JPEG file. RGB555 and YUV422 images can be encoded. When you specify YUV422 image data as src, you must specify SSP_JPEG_YUV422 in option. If you want to encode a thumbnail icon, you must specify SSP_JPEG_THUMBNAIL in option.
Therefore, to encode a YUV422 image along with a thumbnail icon, you must specify SSP_JPEG_YUV422|SSP_JPEG_THUMBNAIL in option.
The height and width of images that can be encoded using this function differs depending on the value of sampling.
If SSP_JPEG_OUTPUT_YUV444 is specified, both the height and width of the image must be a multiple of 8.
If SSP_JPEG_OUTPUT_YUV420 is specified, both the height and width of the image must be a multiple of 16.
If SSP_JPEG_OUTPUT_YUV422 is specified, the height must be a multiple of 8, and the width a multiple of 16.
Note:
Regardless of whether this function succeeds or fails at encoding, after completion the values set by the SSP_SetJpegEncoderDateTime,SSP_SetJpegEncoderDateTimeNow,SSP_SetJpegEncoderMakerNote, and SSP_SetJpegEncoderMakerNoteEx functions are cleared.
If the SSP_SetJpegEncoderDateTime or SSP_SetJpegEncoderDateTimeNow functions are not called, the RTC_GetDateTime function is called internally.
SSP_SetJpegEncoderDateTime
SSP_SetJpegEncoderDateTimeNow
SSP_GetJpegEncoderBufferSize
2008/11/04 Added a description of values cleared after completion of this function.
2008/10/15 Added a description of the limitations on the height and width of images that can be encoded.
2008/10/09 Added a description of RSF file settings.
2008/09/15 Initial version.
CONFIDENTIAL