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:
Mon Apr 24 08:16:23 2017 +0000
Revision:
13:1ee2176ef13f
Parent:
0:37e1e6a45ced
Add "SetQuality()" to JCU.
; Bug fixes.

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) 2012 - 2015 Renesas Electronics Corporation. All rights reserved.
dkato 0:37e1e6a45ced 22 *******************************************************************************/
dkato 0:37e1e6a45ced 23 /**
dkato 0:37e1e6a45ced 24 * @file r_ospl_os_less.h
dkato 0:37e1e6a45ced 25 * @brief OS Porting Layer API for OS less Compatibility
dkato 0:37e1e6a45ced 26 *
dkato 0:37e1e6a45ced 27 * $Module: OSPL $ $PublicVersion: 0.90 $ (=R_OSPL_VERSION)
dkato 0:37e1e6a45ced 28 * $Rev: 35 $
dkato 0:37e1e6a45ced 29 * $Date:: 2014-04-15 21:38:18 +0900#$
dkato 0:37e1e6a45ced 30 */
dkato 0:37e1e6a45ced 31
dkato 0:37e1e6a45ced 32 #ifndef OSPL_OS_LESS_H
dkato 0:37e1e6a45ced 33 #define OSPL_OS_LESS_H
dkato 0:37e1e6a45ced 34
dkato 0:37e1e6a45ced 35 /******************************************************************************
dkato 0:37e1e6a45ced 36 Includes <System Includes> , "Project Includes"
dkato 0:37e1e6a45ced 37 ******************************************************************************/
dkato 0:37e1e6a45ced 38 #include "r_ospl_os_less_typedef.h"
dkato 0:37e1e6a45ced 39 #include "./r_ospl.h"
dkato 0:37e1e6a45ced 40
dkato 0:37e1e6a45ced 41 #ifdef __cplusplus
dkato 0:37e1e6a45ced 42 extern "C" {
dkato 0:37e1e6a45ced 43 #endif /* __cplusplus */
dkato 0:37e1e6a45ced 44
dkato 0:37e1e6a45ced 45
dkato 0:37e1e6a45ced 46 /******************************************************************************
dkato 0:37e1e6a45ced 47 Typedef definitions
dkato 0:37e1e6a45ced 48 ******************************************************************************/
dkato 0:37e1e6a45ced 49 /* In "ospl_os_less_typedef.h" */
dkato 0:37e1e6a45ced 50
dkato 0:37e1e6a45ced 51 /******************************************************************************
dkato 0:37e1e6a45ced 52 Macro definitions
dkato 0:37e1e6a45ced 53 ******************************************************************************/
dkato 0:37e1e6a45ced 54 /* In "ospl_os_less_typedef.h" */
dkato 0:37e1e6a45ced 55
dkato 0:37e1e6a45ced 56 /******************************************************************************
dkato 0:37e1e6a45ced 57 Variable Externs
dkato 0:37e1e6a45ced 58 ******************************************************************************/
dkato 0:37e1e6a45ced 59 /* In "ospl_os_less_typedef.h" */
dkato 0:37e1e6a45ced 60
dkato 0:37e1e6a45ced 61 /******************************************************************************
dkato 0:37e1e6a45ced 62 Functions Prototypes
dkato 0:37e1e6a45ced 63 ******************************************************************************/
dkato 0:37e1e6a45ced 64
dkato 0:37e1e6a45ced 65 /**
dkato 0:37e1e6a45ced 66 * @brief Set waiting behavior of current thread.
dkato 0:37e1e6a45ced 67 *
dkato 0:37e1e6a45ced 68 * @param OnWait Behavior on waiting
dkato 0:37e1e6a45ced 69 * @return Error code. If there is no error, the return value is 0.
dkato 0:37e1e6a45ced 70 *
dkato 0:37e1e6a45ced 71 * @par Description
dkato 0:37e1e6a45ced 72 * @par - Case of <R_OSPL_IS_PREEMPTION> = 0
dkato 0:37e1e6a45ced 73 *
dkato 0:37e1e6a45ced 74 * Initial value is @ref R_OSPL_WAIT_POLLING.
dkato 0:37e1e6a45ced 75 * If this function was called from the interrupt context, E_STATE error is raised.
dkato 0:37e1e6a45ced 76 *
dkato 0:37e1e6a45ced 77 * @par - Case of <R_OSPL_IS_PREEMPTION> = 1
dkato 0:37e1e6a45ced 78 *
dkato 0:37e1e6a45ced 79 * This function is for compatibility only.
dkato 0:37e1e6a45ced 80 * Arguments are ignored.
dkato 0:37e1e6a45ced 81 * This function returns 0.
dkato 0:37e1e6a45ced 82 *
dkato 0:37e1e6a45ced 83 * Refer to: @ref R_OSPL_THREAD_GetIsWaiting
dkato 0:37e1e6a45ced 84 */
dkato 0:37e1e6a45ced 85 INLINE errnum_t R_OSPL_THREAD_SetOnWait( r_ospl_wait_t const OnWait )
dkato 0:37e1e6a45ced 86 {
dkato 0:37e1e6a45ced 87 return 0;
dkato 0:37e1e6a45ced 88 }
dkato 0:37e1e6a45ced 89
dkato 0:37e1e6a45ced 90
dkato 0:37e1e6a45ced 91 /**
dkato 0:37e1e6a45ced 92 * @brief Get waiting behavior of current thread.
dkato 0:37e1e6a45ced 93 *
dkato 0:37e1e6a45ced 94 * @par Parameters
dkato 0:37e1e6a45ced 95 * None
dkato 0:37e1e6a45ced 96 * @return Behavior on waiting
dkato 0:37e1e6a45ced 97 *
dkato 0:37e1e6a45ced 98 * @par Description
dkato 0:37e1e6a45ced 99 * @par - Case of <R_OSPL_IS_PREEMPTION> = 0
dkato 0:37e1e6a45ced 100 *
dkato 0:37e1e6a45ced 101 * Initial value is @ref R_OSPL_WAIT_POLLING.
dkato 0:37e1e6a45ced 102 * If this function was called from the interrupt context,
dkato 0:37e1e6a45ced 103 * this function returns @ref R_OSPL_WAIT_POLLING.
dkato 0:37e1e6a45ced 104 *
dkato 0:37e1e6a45ced 105 * @par - Case of <R_OSPL_IS_PREEMPTION> = 1
dkato 0:37e1e6a45ced 106 *
dkato 0:37e1e6a45ced 107 * This function is for compatibility only.
dkato 0:37e1e6a45ced 108 * This function returns R_OSPL_WAIT_POLLING.
dkato 0:37e1e6a45ced 109 * But it does not polling on waiting
dkato 0:37e1e6a45ced 110 *
dkato 0:37e1e6a45ced 111 * Refer to: @ref R_OSPL_THREAD_SetOnWait
dkato 0:37e1e6a45ced 112 */
dkato 0:37e1e6a45ced 113 INLINE r_ospl_wait_t R_OSPL_THREAD_GetOnWait(void)
dkato 0:37e1e6a45ced 114 {
dkato 0:37e1e6a45ced 115 return R_OSPL_WAIT_POLLING;
dkato 0:37e1e6a45ced 116 }
dkato 0:37e1e6a45ced 117
dkato 0:37e1e6a45ced 118
dkato 0:37e1e6a45ced 119 /**
dkato 0:37e1e6a45ced 120 * @brief Get whether the current thread is waiting or not.
dkato 0:37e1e6a45ced 121 *
dkato 0:37e1e6a45ced 122 * @par Parameters
dkato 0:37e1e6a45ced 123 * None
dkato 0:37e1e6a45ced 124 * @return Whether the current thread is waiting or not
dkato 0:37e1e6a45ced 125 *
dkato 0:37e1e6a45ced 126 * @par Description
dkato 0:37e1e6a45ced 127 * @par - Case of <R_OSPL_IS_PREEMPTION> = 0
dkato 0:37e1e6a45ced 128 *
dkato 0:37e1e6a45ced 129 * If @ref R_OSPL_WAIT_PM_THREAD was set by @ref R_OSPL_THREAD_SetOnWait function,
dkato 0:37e1e6a45ced 130 * some waiting functions return soon even if the state is waiting and
dkato 0:37e1e6a45ced 131 * @ref R_OSPL_THREAD_GetIsWaiting function returns true.
dkato 0:37e1e6a45ced 132 *
dkato 0:37e1e6a45ced 133 * If time out was set to 0, @ref R_OSPL_THREAD_GetIsWaiting function returns
dkato 0:37e1e6a45ced 134 * true at time out, even if any value was passed to @ref R_OSPL_THREAD_SetOnWait
dkato 0:37e1e6a45ced 135 * function,
dkato 0:37e1e6a45ced 136 *
dkato 0:37e1e6a45ced 137 * If this function was called from the interrupt context, this function
dkato 0:37e1e6a45ced 138 * returns false and @ref ASSERT_D in this function notifies in debug configuration.
dkato 0:37e1e6a45ced 139 *
dkato 0:37e1e6a45ced 140 * @par - Case of <R_OSPL_IS_PREEMPTION> = 1
dkato 0:37e1e6a45ced 141 *
dkato 0:37e1e6a45ced 142 * This function is for compatibility only.
dkato 0:37e1e6a45ced 143 * This function returns false.
dkato 0:37e1e6a45ced 144 *
dkato 0:37e1e6a45ced 145 * @par Example
dkato 0:37e1e6a45ced 146 * @code
dkato 0:37e1e6a45ced 147 * e= R_OSPL_Delay( 100 ); IF(e){goto fin;}
dkato 0:37e1e6a45ced 148 * if ( R_OSPL_THREAD_GetIsWaiting() ) { e=0; goto fin; }
dkato 0:37e1e6a45ced 149 * @endcode
dkato 0:37e1e6a45ced 150 */
dkato 0:37e1e6a45ced 151 INLINE bool_t R_OSPL_THREAD_GetIsWaiting(void)
dkato 0:37e1e6a45ced 152 {
dkato 0:37e1e6a45ced 153 return false;
dkato 0:37e1e6a45ced 154 }
dkato 0:37e1e6a45ced 155
dkato 0:37e1e6a45ced 156
dkato 0:37e1e6a45ced 157 /**
dkato 0:37e1e6a45ced 158 * @brief Exit waiting state, if current thread was waiting state.
dkato 0:37e1e6a45ced 159 *
dkato 0:37e1e6a45ced 160 * @par Parameters
dkato 0:37e1e6a45ced 161 * None
dkato 0:37e1e6a45ced 162 * @return None
dkato 0:37e1e6a45ced 163 *
dkato 0:37e1e6a45ced 164 * @par Description
dkato 0:37e1e6a45ced 165 * @par - Case of <R_OSPL_IS_PREEMPTION> = 0
dkato 0:37e1e6a45ced 166 *
dkato 0:37e1e6a45ced 167 * The thread returned true from @ref R_OSPL_THREAD_GetIsWaiting function
dkato 0:37e1e6a45ced 168 * after a waiting function must call the waiting function again.
dkato 0:37e1e6a45ced 169 * After exiting waiting state, other operation and other waiting can
dkato 0:37e1e6a45ced 170 * be done. If time out was set to 0, exiting does not have to do.
dkato 0:37e1e6a45ced 171 *
dkato 0:37e1e6a45ced 172 * If it was detected in OSPL API that necessary exiting was not done,
dkato 0:37e1e6a45ced 173 * E_STATE error is raised. However sometimes the state can not be detected.
dkato 0:37e1e6a45ced 174 * In this case, time out will be not correct.
dkato 0:37e1e6a45ced 175 *
dkato 0:37e1e6a45ced 176 * This function does not do anything called from the interrupt context.
dkato 0:37e1e6a45ced 177 * "ASSERT_D" in this function notifies in debug configuration.
dkato 0:37e1e6a45ced 178 *
dkato 0:37e1e6a45ced 179 * @par - Case of <R_OSPL_IS_PREEMPTION> = 1
dkato 0:37e1e6a45ced 180 *
dkato 0:37e1e6a45ced 181 * This function is for compatibility only.
dkato 0:37e1e6a45ced 182 * This function does not do anything.
dkato 0:37e1e6a45ced 183 */
dkato 0:37e1e6a45ced 184 INLINE void R_OSPL_THREAD_ExitWaiting(void)
dkato 0:37e1e6a45ced 185 {
dkato 0:37e1e6a45ced 186 }
dkato 0:37e1e6a45ced 187
dkato 0:37e1e6a45ced 188
dkato 0:37e1e6a45ced 189 /***********************************************************************
dkato 0:37e1e6a45ced 190 * End of File:
dkato 0:37e1e6a45ced 191 ************************************************************************/
dkato 0:37e1e6a45ced 192 #ifdef __cplusplus
dkato 0:37e1e6a45ced 193 } /* extern "C" */
dkato 0:37e1e6a45ced 194 #endif /* __cplusplus */
dkato 0:37e1e6a45ced 195
dkato 0:37e1e6a45ced 196 #endif /* OSPL_OS_LESS_H */
dkato 0:37e1e6a45ced 197