Graphics framework for GR-PEACH. When you use this program, we judge you have agreed to the following contents. https://developer.mbed.org/teams/Renesas/wiki/About-LICENSE

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:
dkato
Date:
Wed Aug 19 08:58:26 2015 +0000
Revision:
0:37e1e6a45ced
first comit

Who changed what in which revision?

UserRevisionLine numberNew contents of line
dkato 0:37e1e6a45ced 1 /*******************************************************************************
dkato 0:37e1e6a45ced 2 * DISCLAIMER
dkato 0:37e1e6a45ced 3 * This software is supplied by Renesas Electronics Corporation and is only
dkato 0:37e1e6a45ced 4 * intended for use with Renesas products. No other uses are authorized. This
dkato 0:37e1e6a45ced 5 * software is owned by Renesas Electronics Corporation and is protected under
dkato 0:37e1e6a45ced 6 * all applicable laws, including copyright laws.
dkato 0:37e1e6a45ced 7 * THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
dkato 0:37e1e6a45ced 8 * THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
dkato 0:37e1e6a45ced 9 * LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
dkato 0:37e1e6a45ced 10 * AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
dkato 0:37e1e6a45ced 11 * TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
dkato 0:37e1e6a45ced 12 * ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
dkato 0:37e1e6a45ced 13 * FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
dkato 0:37e1e6a45ced 14 * ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
dkato 0:37e1e6a45ced 15 * BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
dkato 0:37e1e6a45ced 16 * Renesas reserves the right, without notice, to make changes to this software
dkato 0:37e1e6a45ced 17 * and to discontinue the availability of this software. By using this software,
dkato 0:37e1e6a45ced 18 * you agree to the additional terms and conditions found by accessing the
dkato 0:37e1e6a45ced 19 * following link:
dkato 0:37e1e6a45ced 20 * http://www.renesas.com/disclaimer
dkato 0:37e1e6a45ced 21 * Copyright (C) 2015 Renesas Electronics Corporation. All rights reserved.
dkato 0:37e1e6a45ced 22 *******************************************************************************/
dkato 0:37e1e6a45ced 23 /**************************************************************************//**
dkato 0:37e1e6a45ced 24 * @file converter_wrapper.c
dkato 0:37e1e6a45ced 25 * @version 1.00
dkato 0:37e1e6a45ced 26 * $Rev: 1 $
dkato 0:37e1e6a45ced 27 * $Date:: 2015-08-06 16:33:52 +0900#$
dkato 0:37e1e6a45ced 28 * @brief Graphics driver wrapper function definitions in C
dkato 0:37e1e6a45ced 29 ******************************************************************************/
dkato 0:37e1e6a45ced 30
dkato 0:37e1e6a45ced 31 /******************************************************************************
dkato 0:37e1e6a45ced 32 Includes <System Includes> , "Project Includes"
dkato 0:37e1e6a45ced 33 ******************************************************************************/
dkato 0:37e1e6a45ced 34 #include "converter_wrapper.h"
dkato 0:37e1e6a45ced 35 #include "r_ospl.h"
dkato 0:37e1e6a45ced 36 #include "r_jcu_api.h"
dkato 0:37e1e6a45ced 37 #include "r_jcu_pl.h"
dkato 0:37e1e6a45ced 38
dkato 0:37e1e6a45ced 39
dkato 0:37e1e6a45ced 40
dkato 0:37e1e6a45ced 41 static r_ospl_async_t* pAsync;
dkato 0:37e1e6a45ced 42 static mbed_CallbackFunc_t* SetCallback;
dkato 0:37e1e6a45ced 43 static size_t* pDecodeSize;
dkato 0:37e1e6a45ced 44 static size_t decode_width;
dkato 0:37e1e6a45ced 45 static size_t decode_height;
dkato 0:37e1e6a45ced 46
dkato 0:37e1e6a45ced 47 /******************************************************************************
dkato 0:37e1e6a45ced 48 Imported global variables and functions (from other files)
dkato 0:37e1e6a45ced 49 ******************************************************************************/
dkato 0:37e1e6a45ced 50 /**************************************************************************//**
dkato 0:37e1e6a45ced 51 * @brief Set callback function address for decode
dkato 0:37e1e6a45ced 52 * @param[in] pSetCallbackAdr Callback function address
dkato 0:37e1e6a45ced 53 * @param[in] p_async ospl async data address
dkato 0:37e1e6a45ced 54 * @param[in] width Decode data width
dkato 0:37e1e6a45ced 55 * @param[in] height Decode data height
dkato 0:37e1e6a45ced 56 * @retval error code
dkato 0:37e1e6a45ced 57 ******************************************************************************/
dkato 0:37e1e6a45ced 58 errnum_t R_wrpper_set_decode_callback( mbed_CallbackFunc_t* pSetCallbackAdr, r_ospl_async_t* p_async, size_t width, size_t height )
dkato 0:37e1e6a45ced 59 {
dkato 0:37e1e6a45ced 60 errnum_t e;
dkato 0:37e1e6a45ced 61
dkato 0:37e1e6a45ced 62 pAsync = p_async;
dkato 0:37e1e6a45ced 63 SetCallback = pSetCallbackAdr;
dkato 0:37e1e6a45ced 64 p_async->InterruptCallback = &R_wrpper_LocalDecodeCallback;
dkato 0:37e1e6a45ced 65 decode_width = width;
dkato 0:37e1e6a45ced 66 decode_height = height;
dkato 0:37e1e6a45ced 67
dkato 0:37e1e6a45ced 68 return e;
dkato 0:37e1e6a45ced 69 }
dkato 0:37e1e6a45ced 70
dkato 0:37e1e6a45ced 71 /**************************************************************************//**
dkato 0:37e1e6a45ced 72 * @brief Set callback function address for encode
dkato 0:37e1e6a45ced 73 * @param[in] InterruptSource Interrput source data struct address
dkato 0:37e1e6a45ced 74 * @param[in] Caller ospl caller data address
dkato 0:37e1e6a45ced 75 * @retval error code
dkato 0:37e1e6a45ced 76 ******************************************************************************/
dkato 0:37e1e6a45ced 77 errnum_t R_wrpper_LocalDecodeCallback( const r_ospl_interrupt_t *InterruptSource, const r_ospl_caller_t *Caller )
dkato 0:37e1e6a45ced 78 {
dkato 0:37e1e6a45ced 79 errnum_t e;
dkato 0:37e1e6a45ced 80 mbed_jcu_err_t CallbackReturn = MBED_JCU_E_OK;
dkato 0:37e1e6a45ced 81 const jcu_async_status_t* status;
dkato 0:37e1e6a45ced 82 jcu_image_info_t image_info;
dkato 0:37e1e6a45ced 83 jcu_errorcode_t jcu_error;
dkato 0:37e1e6a45ced 84
dkato 0:37e1e6a45ced 85 e = E_OTHERS;
dkato 0:37e1e6a45ced 86
dkato 0:37e1e6a45ced 87 if (Caller == NULL) {
dkato 0:37e1e6a45ced 88 e=E_OTHERS;
dkato 0:37e1e6a45ced 89 goto fin;
dkato 0:37e1e6a45ced 90 }
dkato 0:37e1e6a45ced 91
dkato 0:37e1e6a45ced 92 if (R_JCU_OnInterruptDefault(InterruptSource, Caller) != 0) {
dkato 0:37e1e6a45ced 93 e = E_OTHERS;
dkato 0:37e1e6a45ced 94 SetCallback(MBED_JCU_E_JCU_ERR);
dkato 0:37e1e6a45ced 95 goto fin;
dkato 0:37e1e6a45ced 96 }
dkato 0:37e1e6a45ced 97 R_JCU_GetAsyncStatus( &status );
dkato 0:37e1e6a45ced 98 if (status -> IsPaused == true) {
dkato 0:37e1e6a45ced 99 if ((status->SubStatusFlags & JCU_SUB_INFOMATION_READY) == 0) {
dkato 0:37e1e6a45ced 100 e = E_OTHERS;
dkato 0:37e1e6a45ced 101 goto fin;
dkato 0:37e1e6a45ced 102 }
dkato 0:37e1e6a45ced 103 R_JCU_GetImageInfo( &image_info );
dkato 0:37e1e6a45ced 104 if ((image_info.width == 0u) || (image_info.height == 0u) ||
dkato 0:37e1e6a45ced 105 (image_info.width > decode_width) ||
dkato 0:37e1e6a45ced 106 (image_info.height > decode_height)) {
dkato 0:37e1e6a45ced 107 e = E_OTHERS;
dkato 0:37e1e6a45ced 108 SetCallback(MBED_JCU_E_FORMA_ERR);
dkato 0:37e1e6a45ced 109 goto fin;
dkato 0:37e1e6a45ced 110 }
dkato 0:37e1e6a45ced 111 if ((image_info.encodedFormat != JCU_JPEG_YCbCr444) &&
dkato 0:37e1e6a45ced 112 (image_info.encodedFormat != JCU_JPEG_YCbCr422) &&
dkato 0:37e1e6a45ced 113 (image_info.encodedFormat != JCU_JPEG_YCbCr420) &&
dkato 0:37e1e6a45ced 114 (image_info.encodedFormat != JCU_JPEG_YCbCr411)) {
dkato 0:37e1e6a45ced 115 e = E_OTHERS;
dkato 0:37e1e6a45ced 116 SetCallback(MBED_JCU_E_FORMA_ERR);
dkato 0:37e1e6a45ced 117 goto fin;
dkato 0:37e1e6a45ced 118 }
dkato 0:37e1e6a45ced 119 jcu_error = R_JCU_ContinueAsync(JCU_IMAGE_INFO, pAsync);
dkato 0:37e1e6a45ced 120 if (jcu_error != JCU_ERROR_OK) {
dkato 0:37e1e6a45ced 121 e = E_OTHERS;
dkato 0:37e1e6a45ced 122 SetCallback(MBED_JCU_E_JCU_ERR);
dkato 0:37e1e6a45ced 123 goto fin;
dkato 0:37e1e6a45ced 124 }
dkato 0:37e1e6a45ced 125 } else {
dkato 0:37e1e6a45ced 126 SetCallback( CallbackReturn );
dkato 0:37e1e6a45ced 127 }
dkato 0:37e1e6a45ced 128
dkato 0:37e1e6a45ced 129 fin:
dkato 0:37e1e6a45ced 130 return e;
dkato 0:37e1e6a45ced 131
dkato 0:37e1e6a45ced 132 }
dkato 0:37e1e6a45ced 133
dkato 0:37e1e6a45ced 134 /**************************************************************************//**
dkato 0:37e1e6a45ced 135 * @brief Set callback function address for encode
dkato 0:37e1e6a45ced 136 * @param[in] pSetCallbackAdr Callback function address
dkato 0:37e1e6a45ced 137 * @param[in] p_async ospl async data address
dkato 0:37e1e6a45ced 138 * @param[in] pSize Encode size input address
dkato 0:37e1e6a45ced 139 * @param[in] count_max Encode count max num
dkato 0:37e1e6a45ced 140 * @retval error code
dkato 0:37e1e6a45ced 141 ******************************************************************************/
dkato 0:37e1e6a45ced 142 errnum_t R_wrpper_set_encode_callback( mbed_CallbackFunc_t* pSetCallbackAdr, r_ospl_async_t* p_async, size_t* pSize, int32_t count_max )
dkato 0:37e1e6a45ced 143 {
dkato 0:37e1e6a45ced 144 errnum_t e;
dkato 0:37e1e6a45ced 145
dkato 0:37e1e6a45ced 146 pAsync = p_async;
dkato 0:37e1e6a45ced 147 SetCallback = pSetCallbackAdr;
dkato 0:37e1e6a45ced 148 p_async->InterruptCallback = &R_wrpper_LocalEncodeCallback;
dkato 0:37e1e6a45ced 149 pDecodeSize = pSize;
dkato 0:37e1e6a45ced 150
dkato 0:37e1e6a45ced 151 return e;
dkato 0:37e1e6a45ced 152 }
dkato 0:37e1e6a45ced 153
dkato 0:37e1e6a45ced 154 /**************************************************************************//**
dkato 0:37e1e6a45ced 155 * @brief Set callback function address for encode
dkato 0:37e1e6a45ced 156 * @param[in] InterruptSource Interrput source data struct address
dkato 0:37e1e6a45ced 157 * @param[in] Caller ospl caller data address
dkato 0:37e1e6a45ced 158 * @retval error code
dkato 0:37e1e6a45ced 159 ******************************************************************************/
dkato 0:37e1e6a45ced 160 errnum_t R_wrpper_LocalEncodeCallback( const r_ospl_interrupt_t *InterruptSource, const r_ospl_caller_t *Caller )
dkato 0:37e1e6a45ced 161 {
dkato 0:37e1e6a45ced 162 errnum_t e;
dkato 0:37e1e6a45ced 163 mbed_jcu_err_t CallbackReturn = MBED_JCU_E_OK;
dkato 0:37e1e6a45ced 164 const jcu_async_status_t* status;
dkato 0:37e1e6a45ced 165 jcu_errorcode_t jcu_error;
dkato 0:37e1e6a45ced 166
dkato 0:37e1e6a45ced 167 e = E_OTHERS;
dkato 0:37e1e6a45ced 168
dkato 0:37e1e6a45ced 169 if (Caller == NULL) {
dkato 0:37e1e6a45ced 170 e = E_OTHERS;
dkato 0:37e1e6a45ced 171 goto fin;
dkato 0:37e1e6a45ced 172 }
dkato 0:37e1e6a45ced 173 if (R_JCU_OnInterruptDefault(InterruptSource, Caller) != 0) {
dkato 0:37e1e6a45ced 174 e = E_OTHERS;
dkato 0:37e1e6a45ced 175 SetCallback(MBED_JCU_E_JCU_ERR);
dkato 0:37e1e6a45ced 176 goto fin;
dkato 0:37e1e6a45ced 177 }
dkato 0:37e1e6a45ced 178 R_JCU_GetAsyncStatus(&status);
dkato 0:37e1e6a45ced 179 if (status -> IsPaused == true) {
dkato 0:37e1e6a45ced 180 if (status->SubStatusFlags & JCU_SUB_DECODE_INPUT_PAUSE == 0) {
dkato 0:37e1e6a45ced 181 e=E_OTHERS;
dkato 0:37e1e6a45ced 182 goto fin;
dkato 0:37e1e6a45ced 183 }
dkato 0:37e1e6a45ced 184 jcu_error = R_JCU_ContinueAsync(JCU_OUTPUT_BUFFER, pAsync);
dkato 0:37e1e6a45ced 185 if (jcu_error != JCU_ERROR_OK) {
dkato 0:37e1e6a45ced 186 e = E_OTHERS;
dkato 0:37e1e6a45ced 187 goto fin;
dkato 0:37e1e6a45ced 188 }
dkato 0:37e1e6a45ced 189 } else {
dkato 0:37e1e6a45ced 190 SetCallback( CallbackReturn );
dkato 0:37e1e6a45ced 191 e = R_JCU_GetEncodedSize( pDecodeSize );
dkato 0:37e1e6a45ced 192 }
dkato 0:37e1e6a45ced 193
dkato 0:37e1e6a45ced 194 fin:
dkato 0:37e1e6a45ced 195 return e;
dkato 0:37e1e6a45ced 196
dkato 0:37e1e6a45ced 197 }
dkato 0:37e1e6a45ced 198