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:
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 * DISCLAIMER
1050186 3:9f857750e4e9 3 * This software is supplied by Renesas Electronics Corporation and is only
1050186 3:9f857750e4e9 4 * intended for use with Renesas products. No other uses are authorized. This
1050186 3:9f857750e4e9 5 * software is owned by Renesas Electronics Corporation and is protected under
1050186 3:9f857750e4e9 6 * all applicable laws, including copyright laws.
1050186 3:9f857750e4e9 7 * THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
1050186 3:9f857750e4e9 8 * THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
1050186 3:9f857750e4e9 9 * LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
1050186 3:9f857750e4e9 10 * AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
1050186 3:9f857750e4e9 11 * TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
1050186 3:9f857750e4e9 12 * ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
1050186 3:9f857750e4e9 13 * FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
1050186 3:9f857750e4e9 14 * ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
1050186 3:9f857750e4e9 15 * BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
1050186 3:9f857750e4e9 16 * Renesas reserves the right, without notice, to make changes to this software
1050186 3:9f857750e4e9 17 * and to discontinue the availability of this software. By using this software,
1050186 3:9f857750e4e9 18 * you agree to the additional terms and conditions found by accessing the
1050186 3:9f857750e4e9 19 * following link:
1050186 3:9f857750e4e9 20 * http://www.renesas.com/disclaimer
1050186 3:9f857750e4e9 21 * Copyright (C) 2014 - 2015 Renesas Electronics Corporation. All rights reserved.
1050186 3:9f857750e4e9 22 *******************************************************************************/
1050186 3:9f857750e4e9 23 /**
1050186 3:9f857750e4e9 24 * @file window_surfaces.hpp
1050186 3:9f857750e4e9 25 * @brief $Module: CLibCommon $ $PublicVersion: 1.20 $ (=CLIB_VERSION)
1050186 3:9f857750e4e9 26 * $Rev: 47 $
1050186 3:9f857750e4e9 27 * $Date:: 2014-01-06 18:18:48 +0900#$
1050186 3:9f857750e4e9 28 * - Description: Window Surfaces for mbed style C++ API
1050186 3:9f857750e4e9 29 */
1050186 3:9f857750e4e9 30
1050186 3:9f857750e4e9 31 #ifndef WINDOW_SURFACES_HPP
1050186 3:9f857750e4e9 32 #define WINDOW_SURFACES_HPP
1050186 3:9f857750e4e9 33
1050186 3:9f857750e4e9 34 /******************************************************************************
1050186 3:9f857750e4e9 35 Includes <System Includes> , "Project Includes"
1050186 3:9f857750e4e9 36 ******************************************************************************/
1050186 3:9f857750e4e9 37 #include "r_ospl_typedef.h"
1050186 3:9f857750e4e9 38 #include "window_surfaces_typedef.h"
1050186 3:9f857750e4e9 39 #include "RGA.h"
1050186 3:9f857750e4e9 40
1050186 3:9f857750e4e9 41
1050186 3:9f857750e4e9 42 /******************************************************************************
1050186 3:9f857750e4e9 43 Macro definitions
1050186 3:9f857750e4e9 44 ******************************************************************************/
1050186 3:9f857750e4e9 45
1050186 3:9f857750e4e9 46 /******************************************************************************
1050186 3:9f857750e4e9 47 Typedef definitions
1050186 3:9f857750e4e9 48 ******************************************************************************/
1050186 3:9f857750e4e9 49
1050186 3:9f857750e4e9 50 class WindowSurfacesConfigClass;
1050186 3:9f857750e4e9 51 #ifdef IS_WINDOW_SURFACES_EX
1050186 3:9f857750e4e9 52 class GraphicsClass;
1050186 3:9f857750e4e9 53 class LayerAttributes;
1050186 3:9f857750e4e9 54 #endif
1050186 3:9f857750e4e9 55
1050186 3:9f857750e4e9 56
1050186 3:9f857750e4e9 57 /***********************************************************************
1050186 3:9f857750e4e9 58 * Class: WindowSurfacesClass
1050186 3:9f857750e4e9 59 * mbed style C++ version of <window_surfaces_t>
1050186 3:9f857750e4e9 60 ************************************************************************/
1050186 3:9f857750e4e9 61 class WindowSurfacesClass {
1050186 3:9f857750e4e9 62 public:
1050186 3:9f857750e4e9 63 /**
1050186 3:9f857750e4e9 64 * @brief WindowSurfacesClass
1050186 3:9f857750e4e9 65 *
1050186 3:9f857750e4e9 66 * @par Parameters
1050186 3:9f857750e4e9 67 * None
1050186 3:9f857750e4e9 68 * @return None.
1050186 3:9f857750e4e9 69 */
1050186 3:9f857750e4e9 70 WindowSurfacesClass();
1050186 3:9f857750e4e9 71 ~WindowSurfacesClass();
1050186 3:9f857750e4e9 72
1050186 3:9f857750e4e9 73 /**
1050186 3:9f857750e4e9 74 * @brief initialize
1050186 3:9f857750e4e9 75 *
1050186 3:9f857750e4e9 76 * @par Parameters
1050186 3:9f857750e4e9 77 * None
1050186 3:9f857750e4e9 78 * @return None.
1050186 3:9f857750e4e9 79 */
1050186 3:9f857750e4e9 80 errnum_t initialize( WindowSurfacesConfigClass& in_out_config );
1050186 3:9f857750e4e9 81
1050186 3:9f857750e4e9 82 /**
1050186 3:9f857750e4e9 83 * @brief destroy
1050186 3:9f857750e4e9 84 *
1050186 3:9f857750e4e9 85 * @par Parameters
1050186 3:9f857750e4e9 86 * None
1050186 3:9f857750e4e9 87 * @return None.
1050186 3:9f857750e4e9 88 */
1050186 3:9f857750e4e9 89 void destroy();
1050186 3:9f857750e4e9 90
1050186 3:9f857750e4e9 91 /**
1050186 3:9f857750e4e9 92 * @brief get_layer_frame_buffer
1050186 3:9f857750e4e9 93 *
1050186 3:9f857750e4e9 94 * @par Parameters
1050186 3:9f857750e4e9 95 * None
1050186 3:9f857750e4e9 96 * @return None.
1050186 3:9f857750e4e9 97 */
1050186 3:9f857750e4e9 98 errnum_t get_layer_frame_buffer( int_fast32_t const layer_num, frame_buffer_t** const out_frame_buffer );
1050186 3:9f857750e4e9 99
1050186 3:9f857750e4e9 100 /**
1050186 3:9f857750e4e9 101 * @brief swap_buffers
1050186 3:9f857750e4e9 102 *
1050186 3:9f857750e4e9 103 * @par Parameters
1050186 3:9f857750e4e9 104 * None
1050186 3:9f857750e4e9 105 * @return None.
1050186 3:9f857750e4e9 106 */
1050186 3:9f857750e4e9 107 #ifdef IS_WINDOW_SURFACES_EX
1050186 3:9f857750e4e9 108 errnum_t swap_buffers( int_fast32_t const layer_num, Canvas2D_ContextClass& context );
1050186 3:9f857750e4e9 109 #else
1050186 3:9f857750e4e9 110 errnum_t swap_buffers( int_fast32_t const layer_num, const void* const null_context );
1050186 3:9f857750e4e9 111 #endif
1050186 3:9f857750e4e9 112
1050186 3:9f857750e4e9 113 /**
1050186 3:9f857750e4e9 114 * @brief swap_buffers_start
1050186 3:9f857750e4e9 115 *
1050186 3:9f857750e4e9 116 * @par Parameters
1050186 3:9f857750e4e9 117 * None
1050186 3:9f857750e4e9 118 * @return None.
1050186 3:9f857750e4e9 119 */
1050186 3:9f857750e4e9 120 errnum_t swap_buffers_start( int_fast32_t const layer_num, r_ospl_async_t* async );
1050186 3:9f857750e4e9 121
1050186 3:9f857750e4e9 122 /**
1050186 3:9f857750e4e9 123 * @brief wait_for_v_sync
1050186 3:9f857750e4e9 124 *
1050186 3:9f857750e4e9 125 * @par Parameters
1050186 3:9f857750e4e9 126 * None
1050186 3:9f857750e4e9 127 * @return None.
1050186 3:9f857750e4e9 128 */
1050186 3:9f857750e4e9 129 errnum_t wait_for_v_sync( int_fast32_t const swap_interval, bool_t const is_1_v_sync_at_minimum );
1050186 3:9f857750e4e9 130
1050186 3:9f857750e4e9 131 /**
1050186 3:9f857750e4e9 132 * @brief alloc_offscreen_stack
1050186 3:9f857750e4e9 133 *
1050186 3:9f857750e4e9 134 * @par Parameters
1050186 3:9f857750e4e9 135 * None
1050186 3:9f857750e4e9 136 * @return None.
1050186 3:9f857750e4e9 137 */
1050186 3:9f857750e4e9 138 errnum_t alloc_offscreen_stack( frame_buffer_t* const in_out_frame_buffer );
1050186 3:9f857750e4e9 139
1050186 3:9f857750e4e9 140 /**
1050186 3:9f857750e4e9 141 * @brief free_offscreen_stack
1050186 3:9f857750e4e9 142 *
1050186 3:9f857750e4e9 143 * @par Parameters
1050186 3:9f857750e4e9 144 * None
1050186 3:9f857750e4e9 145 * @return None.
1050186 3:9f857750e4e9 146 */
1050186 3:9f857750e4e9 147 errnum_t free_offscreen_stack( const frame_buffer_t* const frame_buffer );
1050186 3:9f857750e4e9 148
1050186 3:9f857750e4e9 149 #ifdef IS_WINDOW_SURFACES_EX
1050186 3:9f857750e4e9 150 /**
1050186 3:9f857750e4e9 151 * @brief do_message_loop
1050186 3:9f857750e4e9 152 *
1050186 3:9f857750e4e9 153 * @par Parameters
1050186 3:9f857750e4e9 154 * None
1050186 3:9f857750e4e9 155 * @return None.
1050186 3:9f857750e4e9 156 */
1050186 3:9f857750e4e9 157 errnum_t do_message_loop();
1050186 3:9f857750e4e9 158
1050186 3:9f857750e4e9 159 /**
1050186 3:9f857750e4e9 160 * @brief access_layer_attributes
1050186 3:9f857750e4e9 161 *
1050186 3:9f857750e4e9 162 * @par Parameters
1050186 3:9f857750e4e9 163 * None
1050186 3:9f857750e4e9 164 * @return None.
1050186 3:9f857750e4e9 165 */
1050186 3:9f857750e4e9 166 errnum_t access_layer_attributes( LayerAttributes& in_out_Attributes );
1050186 3:9f857750e4e9 167 #endif
1050186 3:9f857750e4e9 168
1050186 3:9f857750e4e9 169 private:
1050186 3:9f857750e4e9 170 window_surfaces_t* _self;
1050186 3:9f857750e4e9 171 };
1050186 3:9f857750e4e9 172
1050186 3:9f857750e4e9 173
1050186 3:9f857750e4e9 174 /***********************************************************************
1050186 3:9f857750e4e9 175 * Class: WindowSurfacesConfigClass
1050186 3:9f857750e4e9 176 * mbed style C++ version of <window_surfaces_config_t>
1050186 3:9f857750e4e9 177 ************************************************************************/
1050186 3:9f857750e4e9 178 class WindowSurfacesConfigClass : public window_surfaces_config_t {
1050186 3:9f857750e4e9 179 public:
1050186 3:9f857750e4e9 180 /**
1050186 3:9f857750e4e9 181 * @brief WindowSurfacesConfigClass
1050186 3:9f857750e4e9 182 *
1050186 3:9f857750e4e9 183 * @par Parameters
1050186 3:9f857750e4e9 184 * None
1050186 3:9f857750e4e9 185 * @return None.
1050186 3:9f857750e4e9 186 */
1050186 3:9f857750e4e9 187 WindowSurfacesConfigClass();
1050186 3:9f857750e4e9 188 };
1050186 3:9f857750e4e9 189
1050186 3:9f857750e4e9 190
1050186 3:9f857750e4e9 191 /***********************************************************************
1050186 3:9f857750e4e9 192 * Class: LayerAttributes
1050186 3:9f857750e4e9 193 * mbed style C++ version of <layer_attributes_t>
1050186 3:9f857750e4e9 194 ************************************************************************/
1050186 3:9f857750e4e9 195 #ifdef IS_WINDOW_SURFACES_EX
1050186 3:9f857750e4e9 196 class LayerAttributes : public layer_attributes_t {
1050186 3:9f857750e4e9 197 public:
1050186 3:9f857750e4e9 198 /**
1050186 3:9f857750e4e9 199 * @brief LayerAttributes
1050186 3:9f857750e4e9 200 *
1050186 3:9f857750e4e9 201 * @par Parameters
1050186 3:9f857750e4e9 202 * None
1050186 3:9f857750e4e9 203 * @return None.
1050186 3:9f857750e4e9 204 */
1050186 3:9f857750e4e9 205 LayerAttributes();
1050186 3:9f857750e4e9 206 };
1050186 3:9f857750e4e9 207 #endif
1050186 3:9f857750e4e9 208
1050186 3:9f857750e4e9 209
1050186 3:9f857750e4e9 210 /******************************************************************************
1050186 3:9f857750e4e9 211 Variable Externs
1050186 3:9f857750e4e9 212 ******************************************************************************/
1050186 3:9f857750e4e9 213
1050186 3:9f857750e4e9 214 /******************************************************************************
1050186 3:9f857750e4e9 215 Functions Prototypes
1050186 3:9f857750e4e9 216 ******************************************************************************/
1050186 3:9f857750e4e9 217
1050186 3:9f857750e4e9 218 #endif /* WINDOW_SURFACES_HPP */