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

Dependencies:   GR-PEACH_video GraphicsFramework R_BSP LCD_shield_config


For a sample program of with GR-PEACH 4.3 inch LCD Shield, please refer to RGA_HelloWorld_4_3inch.

GR-PEACH 4.3 inch LCD Shield用のサンプルプログラムについては、 RGA_HelloWorld_4_3inchを参照ください。


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



Trouble shooting

There is a problem with Exporter currently, the compilation fails if you export to DS-5 or e2 studio.
The compilation successes if you export with GCC (ARM Embedded) or import it with mbed CLI.
Please refer to the below link for workaround.
Compilation fails after Export to DS-5 or e2 studio

現在Exporterで問題があり、DS-5又はe2 studioにExportするとコンパイルが失敗します。
GCC(ARM Embedded)でExportするか、mbed CLIでimportすればコンパイルは成功します。
Compilation fails after Export to DS-5 or e2 studio


Japanese version is available in lower part of this page.


What is this ?

RGA(Renesas Graphics Architecture) sample program using GR-PEACH.
The following lists features of the RGA.

  • Allows high-speed drawing using the hardware acceleration.
  • The API created based on the W3C standard HTML Canvas 2D Context achieves easy learning.
    In addition, the RGA provides C++API that is operable as an interface that is backward compatible with HTML Canvas 2D Context.
  • The memory area was defined by the application is available as a drawing destination or for input images.
  • Allows drawing of translucent images and translucent drawing using an alpha mask.

Please refer to the following link about RGA.
This sample program draws in the frame buffer by using the buffer drawing mode of RGA.
In addition, supporting compiler is ARMCC, GCC ARM and IAR.


GR-PEACH and LCD Shield.
/media/uploads/1050186/gr-peach-lcd_shield_01.jpg /media/uploads/1050186/gr-peach-lcd_shield_02.jpg

How to use

  1. Please connect GR-PEACH and LCD Shield. Then turn on the power to GR-PEACH.
  2. Please press the reset button of GR-PEACH.
  3. The top screen which "RGA Library Sample" is drawn is displayed on the LCD.
  4. There are seven touch buttons at the bottom of the top screen.When you press each button, the function of RGA that have been linked to the panel is executed, and the output image will be displayed on the LCD.
    Please refer to the "Drawing using the RGA" below about the function of RGA that have been linked to the panel.
  5. When RGA of the execution is completed, "Return Top Screen" button displaies at the top right of the screen. When you press it, the top screen is displayed.

Drawing using the RGA

Touch ButtonDiscriptions
Drawing of RectangleDrawing the rectangle.
The sample program draws a rectangle in the range that you swaipe on the LCD.
Drawing of ImageDraw the image.
The sample program draws by overlapping the two images(flower and crystal image).
In addition, the sample program draws a picture of Crystal to the swipe position on the LCD.
DissolutionDissolve by carry out the fade-in and the fade-out at the same time.
The sample program draws by overlapping the two images. And the sample program draws while changing the transparency of the two images by the swipe operation of sideways on the LCD.
ScrollScroll the image.
The sample program draws while shifting the position of cutting out of the rendering source by the swipe operation of sideways on the LCD while fixing the display position of the drawing destination.
ZoomZoom the image.
The sample program draws while changing the size of cutting out of the rendering source by the swipe operation of sideways on the LCD while fixing the display position of the drawing destination.
RotationRotate the image.
The sample draws the image while changing the tilt by the swipe operation of sideways on the LCD.
AccelerationMovement of the image along with the acceleration.
The sample program draws while moving the image from right to left along with the acceleration.
You can select the type of the following acceleration in LCD touch operation.
- ease ...... Move smoothly the start and the end (default)
- linear ...... Move constant speed
- ease-in ...... Move slowly the start
- ease-out ...... Move slowly the end
- ease-in-out ...... Move slowly the start and the end

About image to be drawn

Image files that are used in the sample program is easily possible replacement by using the "Convert Image to Binary Table" tool below.
This tool generates "BinaryImage_RZ_A1H.c" and "BinaryImage_RZ_A1H.h" in the Images folder and converts each image file to binary. Then, this tool outputs the data to "RGA_Sample_BinaryImage" table of "BinaryImage_RZ_A1H.c" and defines the macro name indicating the offset position in the table to "BinaryImage_RZ_A1H.h".
The sample program executes with reference to this macro name for offset.

Convert Image to Binary Table

File Description

Folder and FileDiscriptions
Images folder
BinaryImage_RZ_A1H.c[Output File]
Source file which binary table is generated
BinaryImage_RZ_A1H.h[Output File]Header file which macro name for the offset is defined
BinaryImageConfigRGAH.image.xmlSetting file
*.jpg, *.png, *.bmp[Input File]
Image files for drawing
scriptlib folder
Files omittedCommand files called from a script
RGA_Tools.vbsScript file
BinaryImageMakeRGAH.batExecute file

How to use

  1. Please download the "Convert Image to Binary Table" tool and unzip it.
  2. Please put the image file to the Images folder and edit "BinaryImageConfigRGAH.image.xml".
  3. Please execute "BinaryImageMakeRGAH.bat". Then, "BinaryImage_RZ_A1H.c" and "BinaryImage_RZ_A1H.h" is generated.
  4. Please replace "BinaryImage_RZ_A1H.c" and "BinaryImage_RZ_A1H.h" in your program to the generated files.
  5. If necessary, please change macro name for the offset that is referenced in your program.
  6. Please build your program



  • ハードウェア アクセラレーションを使って高速に描画
  • W3C 標準である HTML Canvas 2D Context をベースに作成した API のため、学習が容易。
    また HTML Canvas 2D Context の下位互換として動作できる C++API を提供
  • アプリケーション側で用意したメモリー領域を描画先、または、入力画像として使用可能
  • 半透明な画像の描画と、アルファマスクを使った任意の形状の描画

なお、対応するコンパイラはARMCC、GCC ARM、IARです。


/media/uploads/1050186/gr-peach-lcd_shield_01.jpg /media/uploads/1050186/gr-peach-lcd_shield_02.jpg


  1. GR-PEACHとLCDシールドを接続し、GR-PEACHに電源を入れます。
  2. GR-PEACHのリセットボタンを押します。
  3. "RGA Library Sample"というトップ画面がLCDに表示されます。
  4. 画面下に7個のタッチボタンがあり、それぞれを押すと、各パネルに紐付けられたRGAの機能が実行され、その出力画像がLCDに表示されます。
  5. RGA機能の実行が終わると、画面右上に"Return Top Screen"のボタンが表示されますので、押すとトップ画面に戻ります。


Drawing of Rectangle四角形の描画を行ないます。
Drawing of Image画像を描画を行ないます。
- ease …… 開始と終了が滑らかに動く(デフォルト)
- linear …… 一定の速度
- ease-in …… 開始がゆっくり動く
- ease-out …… 終了がゆっくり動く
- ease-in-out …… 開始と終了がゆっくり動く


サンプルプログラムで使用している画像ファイルは、下記の"Convert Image to Binary Table"ツールを利用する事で、簡単に差し替えが可能です。
このツールは、Imagesフォルダ内にBinaryImage_RZ_A1H.c ファイルと BinaryImage_RZ_A1H.h ファイルを生成し、各画像ファイルをバイナリ変換します。そして、そのデータをBinaryImage_RZ_A1H.c ファイルのRGA_Sample_BinaryImageテーブルに出力し、BinaryImage_RZ_A1H.h ファイルにテーブル内のオフセット位置を示すマクロ名を定義します。

Convert Image to Binary Table


*.jpg, *.png, *.bmp[入力ファイル]


  1. "Convert Image to Binary Table"ツールをダウンロードして解凍します
  2. Imagesフォルダ内に画像ファイルを入れ、BinaryImageConfigRGAH.image.xmlを編集します
  3. BinaryImageMakeRGAH.batを実行し、BinaryImage_RZ_A1H.cとBinaryImage_RZ_A1H.hを生成します
  4. 生成されたファイルをプログラム内のBinaryImage_RZ_A1H.cとBinaryImage_RZ_A1H.hと置き換えます
  5. 必要であれば、プログラム内で参照しているオフセット用のマクロ名を変更します
  6. プログラムをビルドします

Revision graph

The revision graph only works with JavaScript-enabled browsers.