Renesas / GraphicsFramework

Dependents:   ImageZoomInout_Sample ImageRotaion_Sample ImageScroll_Sample GR-PEACH_LCD_4_3inch_Save_to_USB ... more

License

When you use this library, we judge you have agreed to the following contents.

https://developer.mbed.org/teams/Renesas/wiki/About-LICENSE

Note

If you import the GraphicsFramework library, please import GR-PEACH_video library and R_BSP library together.



JPEG Converter

The JPEG Converter driver implements encode and decode functionality which uses the JCU of the RZ/A Series.

Hello World!

Import programJCU_HelloWorld

Hello World for JCU(JPEG Codec Unit). JCU is JPEG codec unit of RZ/A1. When you use this program, we judge you have agreed to the following contents. https://developer.mbed.org/teams/Renesas/wiki/About-LICENSE

API

Import library

Data Structures

struct bitmap_buff_info_t
Bitmap data setting struct. More...
struct encode_options_t
Encode option setting. More...

Public Types

enum jpeg_conv_error_t {
JPEG_CONV_OK = 0, JPEG_CONV_JCU_ERR = -1, JPEG_CONV_FORMA_ERR = -2, JPEG_CONV_PARAM_ERR = -3,
JPEG_CONV_BUSY = -4, JPEG_CONV_PARAM_RANGE_ERR = -7
}

Error codes.

More...
enum wr_rd_swa_t {
WR_RD_WRSWA_NON = 0, WR_RD_WRSWA_8BIT = 1, WR_RD_WRSWA_16BIT = 2, WR_RD_WRSWA_16_8BIT = 3,
WR_RD_WRSWA_32BIT = 4, WR_RD_WRSWA_32_8BIT = 5, WR_RD_WRSWA_32_16BIT = 6, WR_RD_WRSWA_32_16_8BIT = 7
}

Write/Read image pixcel frame buffer swap setting.

More...
enum wr_rd_format_t { WR_RD_YCbCr422 = 0x00, WR_RD_ARGB8888 = 0x01, WR_RD_RGB565 = 0x02 }

Write/Read image pixcel format selects.

More...
enum sub_sampling_t { SUB_SAMPLING_1_1 = 0x00, SUB_SAMPLING_1_2 = 0x01, SUB_SAMPLING_1_4 = 0x02, SUB_SAMPLING_1_8 = 0x03 }

Thinning output image selects.

More...
enum cbcr_offset_t { CBCR_OFFSET_0 = 0x00, CBCR_OFFSET_128 = 0x01 }

Cb/Cr range selects for decode.

More...

Public Member Functions

JPEG_Converter ()
Constructor method of JPEG converter(encode/decode)
virtual ~JPEG_Converter ()
Destructor method of JPEG converter(encode/decode)
JPEG_Converter::jpeg_conv_error_t decode (void *pJpegBuff, bitmap_buff_info_t *psOutputBuff)
Decode JPEG to rinear data.
JPEG_Converter::jpeg_conv_error_t decode (void *pJpegBuff, bitmap_buff_info_t *psOutputBuff, decode_options_t *pOptions)
JPEG data decode to bitmap.
JPEG_Converter::jpeg_conv_error_t encode ( bitmap_buff_info_t *psInputBuff, void *pJpegBuff, size_t *pEncodeSize)
Encode rinear data to JPEG.
JPEG_Converter::jpeg_conv_error_t encode ( bitmap_buff_info_t *psInputBuff, void *pJpegBuff, size_t *pEncodeSize, encode_options_t *pOptions)
Bitmap data encode to JPEG.
JPEG_Converter::jpeg_conv_error_t SetQuality (const uint8_t qual)
Set encode quality.

Correspondence file

A correspondence file of JPEG Converter is as the following table.

JPEGCorrespondence
Width>0(greater than 0)
Height>0(greater than 0)
Color formatYCbCr444, YCbCr422, YCbCr420, YCbCr411
BitmapCorrespondence
Width>0(greater than 0)
Height>0(greater than 0)
Color formatYCbCr422

Notice

You run JPEG converter once destruction each time.

You set whether these JPEG files aren't input, or it check error setting decode(set in "flag" = true). The JPEG file which becomes correspondence outside will be the following condition.

  • File besides the above-mentioned correspondence file.
  • As information in the JPEG file, WIDTH or HEIGHT is larger than output buffer setting.

Buffer area is used encode/decode, set 8 bytes align and non-cash memory area. The output buffer when decoding, is made beyond the size decided in the size of the JPEG file, the format, setting of thinning out. You make output buffer for decode/encode to enough big size in order to stock this result. JPEG Converter, if you do not particularly perform specified, does not check size against the output data at the time of encoding and decoding. You set the output buffer so that there is no effect of corruption by the output data.

Color format

Color format in case to be converted from Bitmap to JPEG is either ARGB8888 or RGB555, YCbCr422. Color format of the If you want to convert from JPEG file to Bitmap file is YCbCr422. You correct "alpha(member of decode_options_t)" of setting and "output_cb_cr_offset(member of decode_options_t)" according to color format when decoding.

  • example
    decode to ARGB8888(WR_RD_ARGB8888 set in format member of bitmap_buff_info_t)
    alpha = 0x01-0xFF
    output_cb_cr_offset = CBCR_OFFSET_0

    decode to YCbCr422(WR_RD_YCbCr422 set in format member of bitmap_buff_info_t)
    alpha = 0
    output_cb_cr_offset = CBCR_OFFSET_0 or CBCR_OFFSET_128

    decode to RGB565(WR_RD_RGB565 set in format member of bitmap_buff_info_t)
    alpha = 0
    output_cb_cr_offset = CBCR_OFFSET_0

Decode/encode settings are optional

If omitted encode/decode settings, it will work with the following settings.
[Decode option setting (member of decode_options_t)]

  • Vertical sub sampling is thinning output image to 1/1.
  • Horizontal sub sampling is thinning output image to 1/1.
  • Output data of Cb/Cr range is -128 to 127.
  • Output data of swap in 8-bit units: 2-1-4-3-6-5-8-7.
  • Alpha value of 0.
  • JPEG format correspondence outside error check.
  • It decode in a synchronous function.

[Encode option setting (member of encode_options_t)]

  • DRI value is 0.
  • Encoding JPEG file start width offset is 0.
  • Encoding JPEG file start height offset is 0.
  • Input data of Cb/Cr range of input data is -128 to 127.
  • Input data swap in 8-bit units: 2-1-4-3-6-5-8-7.
  • It don't check encode size.
  • Quantization Y use default table(Quality75).
  • Quantization C use default table(Quality75).
  • Huffman Y DC use default table.
  • Huffman C DC use default table.
  • Huffman Y AC use default table.
  • Huffman C AC use default table.
  • It encode in a synchronous function.

Synchronous/asynchronous switching

Decoding and encoding setting to operate asynchronously by setting a callback function(decode_options_t and encode_options_t).

Quality

Quality changes are possible. If you want to change the Quality, please specify the table made of Quality you want to change the address of the setting. If you do not want to change the Quality, it will operate at Quality75.

RGA

The RGA library implements fast drawing functionality which uses the RGA of the RZ/A Series.
Supporting compiler is ARMCC, GCC ARM and IAR.

Hello World!

Import programRGA_HelloWorld

Hello World for RGA(Renesas Graphics Architecture). RGA is the Graphics Library of RZ/A1. When you use this program, we judge you have agreed to the following contents. https://developer.mbed.org/teams/Renesas/wiki/About-LICENSE

Committer:
1050186
Date:
Wed Jan 20 02:35:17 2016 +0000
Revision:
3:9f857750e4e9
Add RGA library

Who changed what in which revision?

UserRevisionLine numberNew contents of line
1050186 3:9f857750e4e9 1 /******************************************************************************
1050186 3:9f857750e4e9 2 * Copyright(c) 2010-2012 Renesas Electronics Corporation. All rights reserved.
1050186 3:9f857750e4e9 3 *
1050186 3:9f857750e4e9 4 * brief : NCG state variable control functions header.
1050186 3:9f857750e4e9 5 *
1050186 3:9f857750e4e9 6 * author : Renesas Electronics Corporation
1050186 3:9f857750e4e9 7 *
1050186 3:9f857750e4e9 8 * history: 2010.10.08
1050186 3:9f857750e4e9 9 * - Created the initial code.
1050186 3:9f857750e4e9 10 * 2012.08.22
1050186 3:9f857750e4e9 11 * - Updated coding format.
1050186 3:9f857750e4e9 12 *
1050186 3:9f857750e4e9 13 *******************************************************************************/
1050186 3:9f857750e4e9 14
1050186 3:9f857750e4e9 15 #ifndef NCG_STATE_H
1050186 3:9f857750e4e9 16 #define NCG_STATE_H
1050186 3:9f857750e4e9 17
1050186 3:9f857750e4e9 18 #ifdef __cplusplus
1050186 3:9f857750e4e9 19 extern "C" {
1050186 3:9f857750e4e9 20 #endif
1050186 3:9f857750e4e9 21
1050186 3:9f857750e4e9 22
1050186 3:9f857750e4e9 23 /*=============================================================================
1050186 3:9f857750e4e9 24 * Definitions
1050186 3:9f857750e4e9 25 */
1050186 3:9f857750e4e9 26
1050186 3:9f857750e4e9 27 /*
1050186 3:9f857750e4e9 28 * Mode Flags
1050186 3:9f857750e4e9 29 */
1050186 3:9f857750e4e9 30
1050186 3:9f857750e4e9 31 #define NCGSYS_STATE_CALL_MASK (0x00000003U)
1050186 3:9f857750e4e9 32 #define NCGSYS_STATE_CALL_NORMAL (0x00000000U)
1050186 3:9f857750e4e9 33 #define NCGSYS_STATE_CALL_INTERRUPT (0x00000001U)
1050186 3:9f857750e4e9 34 #define NCGSYS_STATE_CALL_CALLBACK (0x00000002U)
1050186 3:9f857750e4e9 35
1050186 3:9f857750e4e9 36 #define NCGSYS_STATE_WAIT_MASK (0x00000004U)
1050186 3:9f857750e4e9 37 #define NCGSYS_STATE_WAIT_OR (0x00000004U)
1050186 3:9f857750e4e9 38 #define NCGSYS_STATE_WAIT_AND (0x00000000U)
1050186 3:9f857750e4e9 39
1050186 3:9f857750e4e9 40 #define NCGSYS_STATE_SET_MASK (0x00000018U)
1050186 3:9f857750e4e9 41 #define NCGSYS_STATE_SET_AND (0x00000000U)
1050186 3:9f857750e4e9 42 #define NCGSYS_STATE_SET_OR (0x00000008U)
1050186 3:9f857750e4e9 43 #define NCGSYS_STATE_SET_SET (0x00000010U)
1050186 3:9f857750e4e9 44
1050186 3:9f857750e4e9 45 #define NCGSYS_STATE_OR NCGSYS_STATE_SET_OR
1050186 3:9f857750e4e9 46 #define NCGSYS_STATE_SET NCGSYS_STATE_SET_SET
1050186 3:9f857750e4e9 47 #define NCGSYS_STATE_CLEAR NCGSYS_STATE_SET_AND
1050186 3:9f857750e4e9 48
1050186 3:9f857750e4e9 49
1050186 3:9f857750e4e9 50 /*=============================================================================
1050186 3:9f857750e4e9 51 * Structures
1050186 3:9f857750e4e9 52 */
1050186 3:9f857750e4e9 53
1050186 3:9f857750e4e9 54
1050186 3:9f857750e4e9 55 /*=============================================================================
1050186 3:9f857750e4e9 56 * Function prototyping
1050186 3:9f857750e4e9 57 */
1050186 3:9f857750e4e9 58
1050186 3:9f857750e4e9 59 /*
1050186 3:9f857750e4e9 60 * State control
1050186 3:9f857750e4e9 61 */
1050186 3:9f857750e4e9 62
1050186 3:9f857750e4e9 63 NCGint32
1050186 3:9f857750e4e9 64 NCGSYS_CreateState (
1050186 3:9f857750e4e9 65 NCGvoid **ppObj,
1050186 3:9f857750e4e9 66 NCGuint32 ui32StateID
1050186 3:9f857750e4e9 67 );
1050186 3:9f857750e4e9 68
1050186 3:9f857750e4e9 69 NCGint32
1050186 3:9f857750e4e9 70 NCGSYS_DestroyState (
1050186 3:9f857750e4e9 71 NCGvoid *pObj
1050186 3:9f857750e4e9 72 );
1050186 3:9f857750e4e9 73
1050186 3:9f857750e4e9 74 NCGint32
1050186 3:9f857750e4e9 75 NCGSYS_SetState (
1050186 3:9f857750e4e9 76 NCGvoid *pObj,
1050186 3:9f857750e4e9 77 NCGuint32 ui32State,
1050186 3:9f857750e4e9 78 NCGuint32 ui32Flags
1050186 3:9f857750e4e9 79 );
1050186 3:9f857750e4e9 80
1050186 3:9f857750e4e9 81 NCGuint32
1050186 3:9f857750e4e9 82 NCGSYS_GetState (
1050186 3:9f857750e4e9 83 NCGvoid *pObj,
1050186 3:9f857750e4e9 84 NCGuint32 ui32Flags
1050186 3:9f857750e4e9 85 );
1050186 3:9f857750e4e9 86
1050186 3:9f857750e4e9 87 NCGint32
1050186 3:9f857750e4e9 88 NCGSYS_WaitState (
1050186 3:9f857750e4e9 89 NCGvoid *pObj,
1050186 3:9f857750e4e9 90 NCGuint32 ui32State,
1050186 3:9f857750e4e9 91 NCGuint32 ui32Flags,
1050186 3:9f857750e4e9 92 NCGuint32 ui32Timeout
1050186 3:9f857750e4e9 93 );
1050186 3:9f857750e4e9 94
1050186 3:9f857750e4e9 95 NCGvoid
1050186 3:9f857750e4e9 96 NCGSYS_SetStateEventValue (
1050186 3:9f857750e4e9 97 NCGvoid *pObj,
1050186 3:9f857750e4e9 98 NCGuint32 ui32EventValue
1050186 3:9f857750e4e9 99 );
1050186 3:9f857750e4e9 100
1050186 3:9f857750e4e9 101 NCGvoid *
1050186 3:9f857750e4e9 102 NCGSYS_GetLastCreatedState(void);
1050186 3:9f857750e4e9 103
1050186 3:9f857750e4e9 104
1050186 3:9f857750e4e9 105 #ifdef __cplusplus
1050186 3:9f857750e4e9 106 }
1050186 3:9f857750e4e9 107 #endif
1050186 3:9f857750e4e9 108
1050186 3:9f857750e4e9 109 #endif /* NCG_STATE_H */