Renesas / Mbed OS RGA_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

Dependencies:   GR-PEACH_video GraphicsFramework R_BSP LCD_shield_config

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.
https://www.renesas.com/en-us/software/D3018075.html
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.

Composition

GR-PEACH and LCD Shield.

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 Button	Discriptions
Drawing of Rectangle	Drawing the rectangle. The sample program draws a rectangle in the range that you swaipe on the LCD.
Drawing of Image	Draw 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.
Dissolution	Dissolve 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.
Scroll	Scroll 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.
Zoom	Zoom 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.
Rotation	Rotate the image. The sample draws the image while changing the tilt by the swipe operation of sideways on the LCD.
Acceleration	Movement 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

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
   
   

概要

GR-PEACHを使ったRGA(ルネサスグラフィックスライブラリ)サンプルプログラムです。
RGAの特徴は以下の通りです。

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

RGAの詳細については、以下を参照下さい。
https://www.renesas.com/ja-jp/software/D3018074.html
本サンプルプログラムでは、RGAのバッファー描画モードを使ってフレームバッファに描画しています。
なお、対応するコンパイラはARMCC、GCC ARM、IARです。

構成

GR-PEACH、LCDシールド

使い方

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

RGAを使った描画

タッチボタン	説明
Drawing of Rectangle	四角形の描画を行ないます。 サンプルでは、LCD上をスワイプさせた範囲に四角形を描画します。
Drawing of Image	画像を描画を行ないます。 サンプルでは、2つの画像(花とクリスタルの画像)を重ねて描画します。 LCD上をスワイプした位置にクリスタルの画像を描画します。
Dissolution	フェードインとフェードアウトを同時に行うことでディゾルブを行ないます。 サンプルでは、2つの画像を重ねて表示して、LCD上の横方向のスワイプ操作によって2つの画像の透明度を変化させながら描画します。
Scroll	画像のスクロールを行ないます。 サンプルでは、描画先の表示位置は固定のまま、LCD上の横方向のスワイプ操作によって描画元の取り出す位置をずらしながら描画します。
Zoom	画像のズームを行ないます。 サンプルでは、描画先の表示位置は固定のまま、LCD上の横方向のスワイプ操作によって描画元の取り出すサイズを変化させながら描画します。
Rotation	画像の回転を行ないます。 サンプルでは、LCD上の横方向のスワイプ操作によって傾きを変化させながら画像を描画します。
Acceleration	加速を伴って画像の移動を行ないます。 サンプルでは、加速を伴って、画像を右から左に移動させながら描画します。 LCDのタッチ操作で以下の加速の種類を選択できます。 - 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

ファイル説明

使い方

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. プログラムをビルドします
   
   

diff -r 7db04a743588 -r a21861228739 GraphicsFramework.lib
--- a/GraphicsFramework.lib	Thu Mar 09 15:14:41 2017 +0900
+++ b/GraphicsFramework.lib	Mon Apr 24 16:40:18 2017 +0900
@@ -1,1 +1,1 @@
-https://developer.mbed.org/teams/Renesas/code/GraphicsFramework/#9bf28e65755e
+https://developer.mbed.org/teams/Renesas/code/GraphicsFramework/#80f4beab1243

diff -r 7db04a743588 -r a21861228739 mbed-os.lib
--- a/mbed-os.lib	Thu Mar 09 15:14:41 2017 +0900
+++ b/mbed-os.lib	Mon Apr 24 16:40:18 2017 +0900
@@ -1,1 +1,1 @@
-https://github.com/ARMmbed/mbed-os/#5faf4b26c5954d15c7c1cccac6498e0c690ad101
+https://github.com/ARMmbed/mbed-os/#42be5c01a7f91292d5e27124ad9584236025f6ab