Renesas SH7268 Application Note
Renesas SH7268 Application Note

Renesas SH7268 Application Note

Graphics library "rga"
Table of Contents

Advertisement

Quick Links

SH7268/SH7269 Group
Graphics Library "RGA"
Introduction
This application note describes the Graphics Library RGA (Renesas Graphics Architecture) of SH7268/SH7269.
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 provided 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.
The RGA provides a conversion tool that can access image files as global variables. (This conversion tool
operates on the host PC.)
Target Device
SH7268/SH7269 Group
When applying the sample program covered in this application note to another microcomputer, modify the program
according to the specifications for the target microcomputer and conduct an extensive evaluation of the modified
program.
Restrictions
This library is not compatible with the vector graphics supported by OpenVG™-Compliant Renesas Graphics
Processor (R-GPVG).
The hardware acceleration is used only for a part of drawing (Table 1-2), (5.11.1).
This library cannot be used in multiple tasks. Use the RGA in a single task.
R01AN2840EJ0212 Rev. 2.12
Jan.27, 2018
APPLICATION NOTE
R01AN2840EJ0212
Rev. 2.12
Jan.27, 2018
Page 1 of 123

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the SH7268 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Renesas SH7268

  • Page 1 R01AN2840EJ0212 Rev. 2.12 Graphics Library "RGA" Jan.27, 2018 Introduction This application note describes the Graphics Library RGA (Renesas Graphics Architecture) of SH7268/SH7269. 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.
  • Page 2: Table Of Contents

    Porting layer functions of OSPL ..................86 5.8.5 Porting layer functions of RGPNCG ................... 87 Interrupt Handler ........................... 91 5.9.1 OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) Interrupt ......91 5.9.2 Video Display Controller 4 (VDC4) Interrupt............... 91 5.9.3 JPEG Codec Unit (JCU) Interrupt ..................91 5.10...
  • Page 3 SH7268/SH7269 5.11.2 Internal operation in initialize function ................96 5.11.3 Identifying Image Format ....................97 5.11.4 Flush Mode ......................... 98 5.11.5 Sample Screen Control Layer Configuration ..............99 5.11.6 Flagged Structure Parameters ..................100 5.11.7 Defaultable Flags ......................101 5.11.8 Function to Initialize Internal Variables with Constants (*_initConst Function) ....
  • Page 4: Specifications

    Image file Outline of (*.bmp, *.jpg, *.png) image data Binary module provided by Renesas Sample source provided by Renesas Interface Figure 1.1 Block Diagram The coordinate system of this library has an origin at the upper left. The value in the X-axis direction increases from left to right.
  • Page 5 SH7268/SH7269 Left Right (1279,0) (0,0) X axis Source Image Frame buffer to be drawn (0,1023) Down Y axis Figure 1.2 Max size of drawing target and source image Table 1-2 Available Pixel Formats of Drawing Destination ✓ ✓ ✓ ✓...
  • Page 6 The JPEG above is a case where JPEG data is specified for arguments of the image drawing function (R_GRAPHICS_DrawImage). The SH7269 uses hardware JPEG Codec Unit (JCU) and OpenVG™-Compliant Renesas Graphics Processor(R-GPVG). Table 1-4 shows supported JPEG format. When a JPEG file or PNG file is converted to the raw format (including XRGB8888) by using the ImagePackager tool, see the column of the pixel format.
  • Page 7 SH7268/SH7269 ARGB4444 bit 15 Alpha Green Blue R8G8B8A8 address +0 Green Blue Alpha YCbCr422 address +0 Y (Left) Y (Right) FourCC = UYVY, CbCr center (grayscale) = 0x80 CLUT8 bit 7 Index CLUT4 bit 7 Index (Left) Index (Right) CLUT1...
  • Page 8: File Configuration

    SH7268/SH7269 File Configuration SH7269_RGA C/C++ language header of RGA C/C++ language library of RGA Example source of RGA Sample_Common Example source (common code for platforms) Sample_SH7269 Example source (main for SH7269) src\driver\ospl Example of porting layer OSPL for OS less...
  • Page 9 SH7268/SH7269 RGAH.lib OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) driver for RGA R01AN2840EJ0212 Rev. 2.12 Page 9 of 123 Jan.27, 2018...
  • Page 10: Operation Verification Conditions

    SH7268/SH7269 Operation Verification Conditions Operations of the sample code of this application note are verified under the following conditions. Table 3.1 Operation Verification Conditions Item Description Microcomputer SH7269 Operating frequency 266 MHz Operating voltage Internal: 1.25 V, I/O: 3.3 V Integrated development environment High-performance Embedded Workshop 4.09.01.007...
  • Page 11: Hardware

    SH7268/SH7269 Hardware Example of Hardware Configuration Figure 4.1 shows Example of Connection. LCD panel VDC4 board (bottom of LCD) USB cable (to host PC) ICE E10A-USB To host PC's CPU board serial port ICE's connector Audio board (Optional) Power supply (*1) Figure 4.1 Example of Connection...
  • Page 12: Software

    SH7268/SH7269 Software Outline of Operations 5.1.1 When Drawing on a Buffer Defined by the Application Flowchart 5.1.1.1 Figure 5.1 shows a flowchart of drawing on a frame buffer defined by the application. For the actual operation procedure, see the attached document, RGA Tutorial.
  • Page 13: Drawing On The Display Screen

    SH7268/SH7269 Application Drawing hardware Frame buffer Prepare a frame buffer. Always displayed or display is Create an object of graphics_t class. controlled by the application. Initialization Call the drawing API. (1) Drawing (1) Call the drawing API. (2) When the frame...
  • Page 14 SH7268/SH7269 When using the C++ language API, see the description below using the C language API and the relationship between the C language API described in section 5.11.1, Correspondence to Canvas 2D and Correspondence to Hardware Acceleration, and the C++ language API.
  • Page 15 SH7268/SH7269 Application Drawing hardware Display hardware and frame buffer Create a display screen and a frame buffer. Create a graphics_t class object. (For details, refer to section 5.1.1.2.) Initialization Initialization; black color is displayed. Call the drawing API twice or more.
  • Page 16: Required Memory Size

    SH7268/SH7269 Required Memory Size Table 5.1 shows Required Memory Size. Table 5.1 Required Memory Size Memory Size Note 43114 Section *_RGA, *_RGAH, *_JCU 1644 Section *_RGA, *_RGAH, *_JCU See R_RGA_CalcWorkBufferSize Work buffer 5.7.14.3. See R_RGA_CalcWorkBufferB_Size Work buffer B 5.7.14.4. 1536000 (2x800x480x16bit) Frame buffer...
  • Page 17: List Of Constants

    SH7268/SH7269 List of Constants Table 5.2 lists Constants Used for the Sample Code. Table 5.2 Constants Used for the Sample Code Constant Name Value Description RGA_VERSION 210 RGA version RGA_VERSION_STRING "2.10" RGA version string RGA_FRAME_BUFFER_ADDRESS_ALIGNMENT 32 Address alignment of drawing target frame...
  • Page 18: Types And Classes

    SH7268/SH7269 Types and Classes 5.4.1 Basic Types and Values Symbol Description int_t Signed high-speed integer (a 32-bit integer in this library) uint32_t Unsigned 32-bit integer int32_t Signed 32-bit integer uint16_t Unsigned 16-bit integer int16_t Signed 16-bit integer uint8_t Unsigned 8-bit integer...
  • Page 19: Error Codes

    SH7268/SH7269 5.4.2 Error Codes Symbol Value Description 0 No error E_OTHERS 0x0001=1 Parameter error; see section 6.2, Searching for Error Information. E_LIMITATION 0x040F=1039 Restrictions E_FEW_ARRAY 0x0411=1041 Insufficient number of array elements E_NOT_SUPPORTED_PI 0x9400 Unsupported pixel format XEL_FORMAT =37888 E_ACCESS_DENIED 0x0417=1047 Access denied R01AN2840EJ0212 Rev.
  • Page 20: Types Only For The C Language

    _graphics_t graphics_t; This is a graphics drawing context type. The OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) or software rendering is used in the SH7269. The application must not access any member variable. Function equivalent to the member function: See section 5.7.1.
  • Page 21: Classes Only For The C++ Language

    This is a graphics drawing context class only for the C++ language. This class follows a coding rule of JavaScript. The OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) or software rendering is used in the SH7269. For the description on properties, refer to property specifications (section 5.6.1).
  • Page 22 SH7268/SH7269 Description Default value is set by the constructor. Member frame_buffer_t* Drawing target frame buffer. This variable must be set. Variable frame_buffer Set the address of frame_buffer_t type structure. bool_t Fast manual flush mode (section 5.11.4) or not. Default value is_fast_manual_flush is "false".
  • Page 23: Types/Classes Available For C Language And C++ Language

    SH7268/SH7269 5.4.5 Types/Classes Available for C Language and C++ Language For types available from the C language, also see section 5.4.3, Types Only for the C Language. For types available from the C++ language, also see section 5.4.4, Classes Only for the C++ Language.
  • Page 24 SH7268/SH7269 int_fast32_t height Frame buffer height (pixels) pixel_format_t pixel_format Pixel format frame_buffer_delegate_t* User-defined variable delegate Sample: static uint8_t gs_frame_buffer_memory[2][800][480][4]; frame_buffer_t frame; frame.buffer_address[0] = gs_frame_buffer_memory [0]; frame.buffer_address[1] = gs_frame_buffer_memory [1]; frame.buffer_count = 2; frame.show_buffer_index = 0; frame.draw_buffer_index = 1; frame.width = 800;...
  • Page 25 SH7268/SH7269 graphics_quality_flags_t Drawing quality; see section 5.4.5.4. quality_flags r8g8b8a8_t Background color; see section 5.7.1.22. background_color bool_t Whether the mode is fast manual flush mode (section 5.11.4) is_fast_manual_flush void* Work buffer B starting address that must be set, if in following work_buffer_b_address condition.
  • Page 26 SH7268/SH7269 Description Member Variable bit_flags_fast32_t flags For flags, see section 5.11.6, Flagged Structure Parameters. F_WINDOW_SURFACES_PIXEL_FORMAT F_WINDOW_SURFACES_LAYER_COUNT F_WINDOW_SURFACES_BUFFER_HEIGHT F_WINDOW_SURFACES_BACKGROUND_COLOR pixel_format_t Pixel format of showing window. See section 5.4.5.10. pixel_format [Condition] The following value can be set for the sample of SH7269.
  • Page 27 SH7268/SH7269 int_fast32_t height Reserved int_fast32_t offset_x Reserved int_fast32_t offset_y Reserved uint32_t* CLUT Array of colors to set to CLUT (Color Look Up Table). (optional) Set "CLUT" of graphics_image_properties_t (section 5.4.5.14). Pixel format is ARGB8888. If CLUT was overwritten for second image, first image using CLUT is not shown correctly.
  • Page 28 SH7268/SH7269 PIXEL_FORMAT_RGB565 3 0x03 RGB565 PIXEL_FORMAT_ARGB4444 5 0x05 ARGB4444 PIXEL_FORMAT_A1 13 0x0D 1bit alpha (Reserved) PIXEL_FORMAT_A4 14 0x0E 4bit alpha (Reserved) PIXEL_FORMAT_A8 11 0x0B 8bit alpha (Reserved) PIXEL_FORMAT_RGB888 15 0x0F RGB888 (Reserved) PIXEL_FORMAT_R8G8B8A8 6 | (1 << 4) 0x16 R8G8B8A8 PIXEL_FORMAT_XRGB8888 0 | (1 <<...
  • Page 29 SH7268/SH7269 graphics_image_properties_t 5.4.5.14 Outline This is a type of image properties. Header RGA.h Description Related function : (5.7.2.6) R_GRAPHICS_IMAGE_GetProperties If the source image is created in the program, call "R_GRAPHICS_IMAGE_InitByShareFrameBuffer" function (5.7.2.5). Member int_fast32_t width Width of image (pixel) Variable...
  • Page 30 SH7268/SH7269 Member Variable Access Inhibit graphics_matrix_float_t 5.4.5.17 #include <RGA.h> typedef float graphics_matrix_float_t; This is a matrix element type. repetition_t 5.4.5.18 This is a type that specifies the pattern repetition method. #include "RGA.h" Constant Name Value Description GRAPHICS_REPEAT 1 Repeating r8g8b8a8_t 5.4.5.19...
  • Page 31: String Format

    SH7268/SH7269 5.4.6 String Format #rrggbb, #rgb 5.4.6.1 This format describes a color by hex number of CSS Color format Target : fillStyle (5.6.1.3) e.g.) "#FFFF00" : Red component is 255, Green component is 255, Blue component is 0 and Alpha component is 1.0 e.g.) "#FF0"...
  • Page 32: Type Of Porting Layers

    SH7268/SH7269 5.4.7 Type of porting layers List 5.4.7.1 Type Description NCGvoid Abstract of void type for NCG NCGenum Abstract of enumeration type for NCG NCGboolean Abstract of _Bool type for NCG NCGbitfield Abstract of bit flags type for NCG NCGchar...
  • Page 33: Changing State Of Class

    SH7268/SH7269 5.4.8 Changing state of class Figure 6-1 shows a Figure of changing state of graphics_t class, and Table 6-1 shows List of functions of each class having R_*_Finalize member function. The function not changing state can be called at Normal state.
  • Page 34: List Of Variables

    SH7268/SH7269 List of Variables Table 5.6 shows Global Variables, Table 5.7 shows Static-Type Variables, and Table 5.8 shows Const-Type Variables. Table 5.6 Global Variables Type Variable Description Applicable Function None Table 5.7 Static-Type Variables Type Variable Description Applicable Function None Table 5.8 Const-Type Variables...
  • Page 35: Properties

    SH7268/SH7269 Properties 5.6.1 Canvas2D_ContextClass Properties List of Properties 5.6.1.1 Section Property Description 5.6.1.2 c_LanguageContext Context available for the C language API 5.6.1.3 fillStyle Fill style 5.6.1.4 globalAlpha One alpha value (opacity) multiplied by all drawings 5.6.1.5 globalCompositeOperation Calculation method for alpha blend c_LanguageContext 5.6.1.2...
  • Page 36 SH7268/SH7269  clearRect (Canvas2D_ContextClass) globalCompositeOperation 5.6.1.5 char* Canvas2D_ContextClass::globalCompositeOperation; /* get,set */ This property retains the calculation method for alpha blend. See 5.4.5.15 graphics_composite_operation_t. R01AN2840EJ0212 Rev. 2.12 Page 36 of 123 Jan.27, 2018...
  • Page 37: Canvas2D_Imageclass Properties

    SH7268/SH7269 5.6.2 Canvas2D_ImageClass Properties List of Properties 5.6.2.1 Section Property Description 5.6.2.2 Image data structure 5.6.2.3 width Image width 5.6.2.4 height Image height 5.6.2.5 data Array containing pixel color components 5.6.2.2 GraphicsImageClass* Canvas2D_ImageClass::src; /* set only */ This property retains the raw image data structure created by ImagePackager.
  • Page 38: Functions And Methods

    SH7268/SH7269 Functions and Methods 5.7.1 Functions Equivalent to graphics_t Class Member Function List of Functions 5.7.1.1 Section Function Name Description 5.7.1.2 R_GRAPHICS_InitConst Initializes the constant part. 5.7.1.3 R_GRAPHICS_Initialize Initializes the graphics drawing context object. 5.7.1.4 R_GRAPHICS_Finalize Finalizes the graphics drawing context object.
  • Page 39 SH7268/SH7269 5.7.1.37 R_GRAPHICS_SetGlobalCompositeO Sets the calculation method for alpha blend. peration 5.7.1.38 R_GRAPHICS_GetGlobalComposite Acquires the calculation method for alpha blend. Operation 5.7.1.39 R_GRAPHICS_STATIC_SetOnInitiali Registers a callback function that sets the default graphics_config_t value. 5.7.1.40 R_GRAPHICS_STATIC_SetOnFinaliz Registers a function that releases the memory allocated in the R_GRAPHICS_OnInitialize_FuncType function.
  • Page 40 R_GRAPHICS_Initialize (graphics_t* self, graphics_config_t* config ); Description Initializes internal variables. Initializes OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) and JPEG Codec Unit (JCU). When "self" is no longer be used, call R_GRAPHICS_Finalize. There is only one context. When two or more frame buffers was drawn, change the frame buffer by "R_GRAPHICS_SetFrameBuffer"...
  • Page 41 SH7268/SH7269 Return value Error code. If there is no error, the return value is 0. R_GRAPHICS_Finish 5.7.1.7 Outline Waits until drawing is completed. Header RGA.h Declaration errnum_t R_GRAPHICS_Finish( graphics_t* self ); Description In fast manual flush mode (see section 5.11.4), when the CPU directly reads or...
  • Page 42 SH7268/SH7269 Argument graphics_t* self Graphics drawing context graphics_matrix_float_t sx, 2x3 matrix graphics_matrix_float_t ky, graphics_matrix_float_t kx, graphics_matrix_float_t sy, graphics_matrix_float_t tx, graphics_matrix_float_t ty Return value Error code. If there is no error, the return value is 0. R_GRAPHICS_SetMatrix_3x3 5.7.1.12 Outline Sets each element of the current matrix (Matrix[]) (3x3).
  • Page 43 SH7268/SH7269 R_GRAPHICS_TranslateMatrix 5.7.1.15 Outline Translates the current matrix (M). (Floating-point type specified) Header RGA.h Declaration errnum_t R_GRAPHICS_TranslateMatrix( graphics_t* self, graphics_matrix_float_t tx, graphics_matrix_float_t ty ); Description M=M⋅ [Limitation] RGA often stops by drawing image with matrix set translated whole of image to out of frame buffer.
  • Page 44 SH7268/SH7269 When (shx, shy) = (1.0, 0.0), a parallelogram is generated with perpendicular sides tilted 45 degrees. Note, however, that the matrix is shifted unless the origin is at the upper left of the rectangle. When (shx, shy) = (-0.5, 0.0), a parallelogram is generated with hypotenuses of a triangle (base : height = 1 : 2).
  • Page 45 SH7268/SH7269 R_GRAPHICS_MultiplyMatrix 5.7.1.20 Outline Multiplies the current matrix (M) by the specified 3x3 matrix (Matrix[]). Header RGA.h Declaration errnum_t R_GRAPHICS_MultiplyMatrix( graphics_t* self, graphics_matrix_float_t * matrix ); Description Matrix[0] Matrix[3] Matrix[6] Matrix[1] Matrix[4] Matrix[7] M=M⋅ Matrix[2] Matrix[5] Matrix[8] When the library was ported, take care computing error.
  • Page 46 SH7268/SH7269 Declaration errnum_t R_GRAPHICS_GetBackgroundColor(graphics_t* self, r8g8b8a8_t* out_color ); Description Argument graphics_t* self Graphics drawing context r8g8b8a8_t* out_color (Output) Background color Return value Error code. If there is no error, the return value is 0. R_GRAPHICS_GetClearColor 5.7.1.24 Outline Acquires the color used for R_GRAPHICS_Clear.
  • Page 47 SH7268/SH7269 An example of pixel format including the alpha component: ARGB8888, ARGB4444, ARGB1555 An example of pixel format without alpha component: XRGB8888, RGB565, YUV422 Specify a CLUT-format image as same bit count as the frame buffer for drawing in the CLUT format frame buffer. Only min_x = 0 and min_y = 0 can be specified as a drawing position.
  • Page 48 SH7268/SH7269 Description Image SourceMinY Frame buffer Source MinX SourceHeight SourceWidth DestinationMinY DestinationMinX DestinationHeight DestinationWidth When source_width ≠ destination_width or source_height ≠ destination_height, images are enlarged or reduced. See the description on the R_GRAPHICS_DrawImage function. Argument graphics_t* self Graphics drawing context...
  • Page 49 SH7268/SH7269 Argument graphics_t* self Graphics drawing context r8g8b8a8_t color Fill color. Use R_RGA_Get_R8G8B8A8() for the fill color setting. Return value Error code. If there is no error, the return value is 0. R_GRAPHICS_SetFillPattern 5.7.1.31 Outline Sets the pattern for the current fill paint object.
  • Page 50 SH7268/SH7269 Declaration errnum_t R_GRAPHICS_SetGlobalAlpha( graphics_t* self, uint8_t alpha_value ); Description The default value is 255. This function affects the following drawing functions. Figure fill functions such as R_GRAPHICS_FillRect Pattern drawing function R_GRAPHICS_FillRect Border drawing functions such as R_GRAPHICS_StrokeRect Image drawing functions such as R_GRAPHICS_DrawImage This function does not affect the following drawing function.
  • Page 51 SH7268/SH7269 Description The R_GRAPHICS_STATIC_OnInitializeDefault function is called back when this function is not called. Argument R_GRAPHICS_OnInitialize_FuncT Callback function or NULL ype callback_function Return value Error code. If there is no error, the return value is 0. R_GRAPHICS_STATIC_SetOnFinalize 5.7.1.40 Outline Registers a function that releases the memory allocated in the R_GRAPHICS_OnInitialize_FuncType function.
  • Page 52 SH7268/SH7269 Description This function is affected by line width, border color, and clipping. Fill is not made. When the current matrix is not the unit matrix, an error occurs. This function is affected by R_GRAPHICS_SetGlobalAlpha. Argument graphics_t* self, Graphics drawing context...
  • Page 53: Functions Equivalent To Graphics_Image_T Class Member Function

    SH7268/SH7269 5.7.2 Functions Equivalent to graphics_image_t Class Member Function List of Functions 5.7.2.1 Section Function Name Description 5.7.2.2 R_GRAPHICS_IMAGE_InitR8G8B8A8 Initializes the r8g8b8a8_t image object. 5.7.2.3 R_GRAPHICS_IMAGE_InitSameSizeR Initializes the image object to the same width and 8G8B8A8 height. 5.7.2.4 R_GRAPHICS_IMAGE_InitCopyFrame Initializes the image object to which a part of frame BufferR8G8B8A8 buffer being displayed is copied.
  • Page 54 SH7268/SH7269 void* image_data_array, size_t image_data_array_size, graphics_t* context, int_t min_fast32_x, int_fast32_t min_y, int_fast32_t width, int_fast32_t height ); Description Initializes internal variables. Acquirable image data is arranged in a uint8_t-type array in the order of Red, Green, Blue, and Alpha from the upper-left pixel to the lower-right pixel.
  • Page 55: Functions Equivalent To Graphics_Pattern_T Class Member Function

    SH7268/SH7269 5.7.3 Functions Equivalent to graphics_pattern_t Class Member Function List of Functions 5.7.3.1 Section Function Name Description 5.7.3.2 R_GRAPHICS_PATTERN_Initialize Initializes the pattern object. R_GRAPHICS_PATTERN_Initialize 5.7.3.2 Outline Initializes the pattern object. Header RGA.h Declaration errnum_t R_GRAPHICS_PATTERN_Initialize( graphics_pattern_t* self, graphics_image_t* image, repetition_t repetition, graphics_t* context );...
  • Page 56: Functions Related To Canvas2D_Contextclass

    SH7268/SH7269 5.7.4 Functions Related to Canvas2D_ContextClass List of Functions 5.7.4.1 Section Function Name Description 5.7.4.2 R_RGA_New_Canvas2D_ContextClass Creates an object of Canvas2D_ContextClass. 5.7.4.3 R_RGA_New_Canvas2D_ImageClass Creates an object of Canvas2D_ImageClass R_RGA_New_Canvas2D_ContextClass 5.7.4.2 Outline Creates an object of Canvas2D_ContextClass. Header RGA.h Declaration Canvas2D_ContextClass R_RGA_New_Canvas2D_ContextClass( Canvas2D_ContextConfigClass&...
  • Page 57: Canvas2D_Contextclass Member Functions

    SH7268/SH7269 5.7.5 Canvas2D_ContextClass Member Functions List of Functions 5.7.5.1 Section Function Name Description 5.7.5.2 destroy Deletes the object of Canvas2D_ContextClass. 5.7.5.3 clearError Clears the error in the object of Canvas2D_ContextClass. 5.7.5.4 clearRect Clears the rectangle area. 5.7.5.5 save Saves the set value of context in the internal stack.
  • Page 58 SH7268/SH7269 This function is affected by clipping. Argument int_t MinX, int_t MinY Minimum X and Y coordinates of rectangle int_t Width, int_t Height Width and height of rectangle Return value None save (Canvas2D_ContextClass) 5.7.5.5 Outline Saves the set value of context in the internal stack.
  • Page 59 SH7268/SH7269 Image SourceMinY Frame buffer Source MinX SourceHeight SourceWidth DestinationMinY DestinationMinX DestinationHeight DestinationWidth When SourceWidth ≠ DestinationWidth or SourceHeight ≠ DestinationHeight, images are enlarged or reduced. This function is affected by Canvas2D_ContextClass::GlobalAlpha and the current matrix. When drawing an image in the YUV422 format, if the value converted from MinX or MinY by the matrix is not an even number, an error occurs.
  • Page 60 SH7268/SH7269 Canvas2D_ImageClass ImageReferencedWidthHeight ); Description Secures a memory area internally from the heap area. This function calls "new" operator. Argument int_t Width, int_t Height Width and height of image Canvas2D_ImageClass Image object that references width and height ImageReferencedWidthHeight Return value Generated Image object.
  • Page 61 SH7268/SH7269 createPattern (Canvas2D_ContextClass) 5.7.5.12 Outline Generates a pattern object. Header RGA.h Declaration Canvas2D_PatternClass Canvas2D_ContextClass::createPattern( GraphicsImageClass* Image, char* Repetition ); Description Set the pattern object for the fillStyle property. Argument GraphicsImageClass* Image as a pattern component Image char* Repetition Repetition setting. Specify "repeat."...
  • Page 62 SH7268/SH7269 graphics_matrix_float_t sy, graphics_matrix_float_t tx, graphics_matrix_float_t ty Return value None translate (Canvas2D_ContextClass) 5.7.5.17 Outline Translates the current matrix (M). Header RGA.h Declaration void Canvas2D_ContextClass::translate( graphics_matrix_float_t tx, graphics_matrix_float_t ty ); Description M=M⋅ Argument graphics_matrix_float_t tx, Displacement (When the origin is at the upper left, plus...
  • Page 63 SH7268/SH7269 Argument graphics_matrix_float_t sx A 2x3 matrix to be multiplied graphics_matrix_float_t ky graphics_matrix_float_t kx graphics_matrix_float_t sy graphics_matrix_float_t tx graphics_matrix_float_t ty Return value None R01AN2840EJ0212 Rev. 2.12 Page 63 of 123 Jan.27, 2018...
  • Page 64: Functions Related To Canvas2D_Imageclass

    SH7268/SH7269 5.7.6 Functions Related to Canvas2D_ImageClass List of Functions 5.7.6.1 Section Function Name Description 5.7.6.2 destroy Deletes the Canvas2D_ImageClass object. destroy (Canvas2D_ImageClass) 5.7.6.2 Outline Deletes the Canvas2D_ImageClass object. Header RGA.h Declaration void Canvas2D_ImageClass::destroy(); Description Argument None Return value None R01AN2840EJ0212 Rev. 2.12 Page 64 of 123 Jan.27, 2018...
  • Page 65: Functions Related To Canvas2D_Patternclass

    SH7268/SH7269 5.7.7 Functions Related to Canvas2D_PatternClass List of Functions 5.7.7.1 Section Function Name Description 5.7.7.2 destroy Deletes the Canvas2D_PatternClass object. destroy (Canvas2D_PatternClass) 5.7.7.2 Outline Deletes the Canvas2D_PatternClass object. Header RGA.h Declaration void Canvas2D_PatternClass::destroy(); Description Argument Return value R01AN2840EJ0212 Rev. 2.12 Page 65 of 123 Jan.27, 2018...
  • Page 66: Functions Related To Windowsurfacesclass

    SH7268/SH7269 5.7.8 Functions Related to WindowSurfacesClass List of Functions 5.7.8.1 Section Function Name Description 5.7.8.2 initialize Initialize an object as WindowSurfacesClass 5.7.8.3 destroy Destroy an object as WindowSurfacesClass 5.7.8.4 get_layer_frame_buffer Acquires the pointer to the frame buffer structure of the specified layer.
  • Page 67 SH7268/SH7269 Argument int_fast32_t layer_num Layer number 0: Innermost, +1: Next to the innermost layer Outline Canvas2D_ContextClass& Drawn graphics context context Return value Error code. If there is no error, the return value is 0. alloc_offscreen_stack (WindowSurfacesClass) 5.7.8.6 Outline Allocates the off-screen buffer from VRAM stack.
  • Page 68: Functions Equivalent To Window_Surfaces_T Class Member Functions

    SH7268/SH7269 5.7.9 Functions Equivalent to window_surfaces_t Class Member Functions List of Functions 5.7.9.1 Section Function Name Description 5.7.9.2 R_WINDOW_SURFACES_InitConst Initializes internal variables with constants. 5.7.9.3 R_WINDOW_SURFACES_Initialize Initializes the display device or window and starts displaying graphics. 5.7.9.4 R_WINDOW_SURFACES_Finalize Finalizes the display device.
  • Page 69 SH7268/SH7269 Declaration errnum_t R_WINDOW_SURFACES_Finalize (window_surfaces_t* self, errnum_t e ); Description Argument window_surfaces_t* self Frame buffer and screen display errnum_t e Errors that have occurred. No error = 0 Return value Error code or e, 0 = successful and e = 0 R_WINDOW_SURFACES_GetLayerFrameBuffer 5.7.9.5...
  • Page 70 SH7268/SH7269 In the case of "is_1_v_sync_at_minimum = false", when the V-Sync interrupt has already entered for the number of times specified by SwapInterval, the processing immediately returns from this function. Argument window_surfaces_t* self Frame buffers and screen display int_fast32_t swap_interval Number of V-Sync interrupts until the frame buffer is swapped.
  • Page 71 SH7268/SH7269 Argument window_surfaces_t* self Frame buffers and screen display frame_bufer_t* (Input/output) The freeing off-screen buffer in_out_frame_buffer Return value Error code. If there is no error, the return value is 0. R01AN2840EJ0212 Rev. 2.12 Page 71 of 123 Jan.27, 2018...
  • Page 72: Functions Related To Byte_Per_Pixel_T Class

    SH7268/SH7269 5.7.10 Functions Related to byte_per_pixel_t Class List of Functions 5.7.10.1 Section Function Name Description 5.7.10.2 R_RGA_BitPerPixelType_To_Byte Converts the number of bits per pixel to the number of bytes PerPixelType per pixel (with decimal part). 5.7.10.3 R_RGA_BytePerPixelType_To_Bit Converts the number of bytes per pixel (with decimal part) PerPixelType to the number of bits per pixel.
  • Page 73: Functions Related To V_Sync_T Class

    SH7268/SH7269 5.7.11 Functions Related to v_sync_t Class List of Functions 5.7.11.1 Section Function Name Description 5.7.11.2 R_V_SYNC_InitConst Initializes internal variables with constants. 5.7.11.3 R_V_SYNC_Initialize Attaches to the V-Sync interrupt. 5.7.11.4 R_V_SYNC_Finalize Detaches from the V-Sync interrupt. 5.7.11.5 R_V_SYNC_WaitForInterrupt Waits until the V-Sync interrupt enters.
  • Page 74 SH7268/SH7269 bool_t Information on whether at least one V-Sync is waited is_1_v_sync_at_minimum Return value Error code. If there is no error, the return value is 0. R01AN2840EJ0212 Rev. 2.12 Page 74 of 123 Jan.27, 2018...
  • Page 75: Functions Related To Vram_Ex_Stack_T Class

    SH7268/SH7269 5.7.12 Functions Related to vram_ex_stack_t class List of Functions 5.7.12.1 Section Function Name Description 5.7.12.2 R_VRAM_EX_STACK_Initialize Initialize the stack in the external RAM. 5.7.12.3 R_VRAM_EX_STACK_Alloc Allocates the off-screen buffer from the external RAM. 5.7.12.4 R_VRAM_EX_STACK_Free Frees the off-screen buffer to the external RAM.
  • Page 76: Functions Related To Animation_Timing_Function_T Class

    SH7268/SH7269 5.7.13 Functions Related to animation_timing_function_t class List of Functions 5.7.13.1 Section Function Name Description 5.7.13.2 R_Get_AnimationTimingFunction Gets defined animation timing. 5.7.13.3 R_ANIMATION_TIMING_FUNCTI Calculates an attribute value at the specified elapsed time ON_GetValue from the time starting animation. R_Get_AnimationTimingFunction 5.7.13.2 Outline Gets defined animation timing.
  • Page 77 SH7268/SH7269 timing_name="linear", value_of_previous_keyframe=10, value_of_next_keyframe=20, clamp_time=0.5 This case returns 15. Argument animation_timing_function_t* The animation timing object self float32_t clamp_time The percentage of time from previous key frame (clamp_time=0.0) to next key frame (clamp_time=1.0). (decimal from 0.0 to 1.0) float32_t The value of attribute at the previous key frame...
  • Page 78: Other Functions

    SH7268/SH7269 5.7.14 Other Functions List of Functions 5.7.14.1 Section Function Name Description 5.7.14.2 R_RGA_Get_R8G8B8A8 Returns the R8G8B8A8 color value. 5.7.14.3 R_RGA_CalcWorkBufferSi Calculates the size required for the work buffer. 5.7.14.4 R_RGA_CalcWorkBufferB Calculates the size required for the work buffer B.
  • Page 79 SH7268/SH7269  The matrix is unit matrix or translation only. The return value is set in "graphics_config_t" type. See 5.4.5.3. graphics_config_t Argument int_t MaxWidthOfJPEG The maximum width of JPEG image int_t MaxHeightOfJPEG The maximum height of JPEG image int_t The maximum bytes of the drawing target frame MaxBytePerPixelOfFrameB buffer.
  • Page 80: Functions In Strings

    SH7268/SH7269 5.7.15 Functions in strings List of Functions 5.7.15.1 Section Function Name Description 5.7.15.2 Returns the value of color from CSS Color format 5.7.15.3 rgba Returns the value of color from CSS Color format with alpha 5.7.15.2 Outline Returns the value of color from CSS Color format Header RGA.h...
  • Page 81: Porting Layer Functions

    SH7268/SH7269 Porting Layer Functions This section describes porting layer functions called back from this module for other OS and board. The package contains a sample which can be modified by the user. R01AN2840EJ0212 Rev. 2.12 Page 81 of 123 Jan.27, 2018...
  • Page 82: Functions On Default Settings Of Rga

    SH7268/SH7269 5.8.1 Functions on Default Settings of RGA Section Function Name Description 5.8.1.1 R_GRAPHICS_STATIC_O Default of the callback function that sets the default nInitializeDefault graphics_config_t value 5.8.1.2 R_GRAPHICS_OnInitialize Type of the callback function that sets the default _FuncType graphics_config_t value 5.8.1.3...
  • Page 83 SH7268/SH7269 Description Default of the R_GRAPHICS_OnFinalize_FuncType function type. See. 5.8.1.4. R_GRAPHICS_OnFinalize_FuncType Argument graphics_t* self Address of the object that has been finalized void* default_object (Output) Memory allocated in this function errnum_t e Errors that have occurred. No error = 0...
  • Page 84: Functions On Cache

    SH7268/SH7269 5.8.2 Functions on Cache Section Function Name Description 5.8.2.1 NCGSYS_WriteBackAndInvalidate Writes back data stored in the cache and invalidates. NCGSYS_WriteBackAndInvalidate 5.8.2.1 Outline Writes back data stored in the cache to the RAM and invalidates it. Header RGA_Callback.h Declaration errnum_t NCGSYS_WriteBackAndInvalidate( void* start, void* end );...
  • Page 85: Functions On The Display Controller Interrupt

    SH7268/SH7269 5.8.3 Functions on the Display Controller Interrupt Section Function Name Description 5.8.3.1 NCGDU_Attach_ISR Attaches the display controller interrupt to the interrupt function. 5.8.3.2 NCGDU_Detach_ISR Detaches the interrupt function from the display controller interrupt. NCGDU_Attach_ISR 5.8.3.1 Outline Attaches the display controller interrupt to the interrupt processing function.
  • Page 86: Porting Layer Functions Of Ospl

    RGA uses following functions of OSPL API. If the memory map or OS was changed, change define of OSPL API functions or replace to functions already changed. More information is in the document of SH7268/SH7269 group OS Porting Layer "OSPL" Sample Program (R01AN2339EJ).
  • Page 87: Porting Layer Functions Of Rgpncg

    SH7268/SH7269 5.8.5 Porting layer functions of RGPNCG RGA uses following functions of RGPNCG. If the OS was changed, change define of RGPNCG functions or replace functions to functions already changed. If NCGSYS_*State functions use event flags of OSPL, it is necessary to port NCGSYS_*State functions.
  • Page 88 SH7268/SH7269 Declaration NCGint32 NCGSYS_DestroyState( NCGvoid *pObj ); If thread attached event of OSPL was called, it does not have to change define. Description Change define of this function for the target OS. Argument NCGvoid* pObj The event flags object Return value Error code.
  • Page 89 SH7268/SH7269 NCGuint32 ui32Flags Case of NCGSYS_STATE_WAIT_AND: Waits for all bits are 1 that bits are 1 in the specified ui32State argument. Case of NCGSYS_STATE_WAIT_OR: Waits for any bits are 1 that bits are 1 in the specified ui32State argument. NCGuint32 ui32Timeout NCG_TIMEOUT_INFINITE is passed.
  • Page 90 NCGVGISRfp pfnInterrupt The interrupt callback function Return value Error code. If there is no error, the return value is NCG_no_err. NCGVGISRfp 5.8.5.11 Outline Type of the interrupt callback function for OpenVG™-Compliant Renesas Graphics Processor (R-GPVG). Header ncg_defs.h Declaration NCGuint32 (*NCGVGISRfp)(void); Description Call "R_GRAPHICS_OnInterrupting"...
  • Page 91: Interrupt Handler

    5.9.1 OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) Interrupt NCGVG_RGPVG_ISR 5.9.1.1 Outline Interrupt handler of OpenVG™-Compliant Renesas Graphics Processor (R-GPVG) Header (None) Declaration void NCGVG_RGPVG_ISR( void ); Description Call this function from all interrupts INT3 (184), INT2 (185), INT1 (186), and INT0 (187) of the OpenVG™-Compliant Renesas Graphics Processor (R-GPVG).
  • Page 92: Sections

    SH7268/SH7269 5.10 Sections Register the following sections in the memory map section information. The following error is raised, if they are not registered. L1120 (W) Section address is not assigned to "P_RGA" Add to setting of linker option of "Mapping sections from ROM to RAM".
  • Page 93: Supplementary Explanation

    SH7268/SH7269 5.11 Supplementary Explanation 5.11.1 Correspondence to Canvas 2D and Correspondence to Hardware Acceleration In the hardware column, ✓: Hardware is used, x: No hardware is used, —: Not applicable Hard Canvas2D API RGA - C++ API RGA - C language API...
  • Page 94 SH7268/SH7269 .strokeStyle gradation .strokeStyle pattern .createLinearGradient() .createRadialGradient() CanvasGradient.addColorStop() .createPattern() .createPattern() R_GRAPHICS_PATTERN_Initialize — 8 The current default path .beginPath() .beginPath() R_GRAPHICS_BeginPath — .fill() .stroke() .drawSystemFocusRing() .drawCustomFocusRing() .scrollPathIntoView() ✓ .clip() .clip() R_GRAPHICS_Clip (Only a single rectangle) (Only a single rectangle) .isPointInPath() 9 Drawing rectangles to the canvas ✓...
  • Page 95 SH7268/SH7269 R_GRAPHICS_DrawImageChild 13 Compositing ✓ .globalAlpha .globalAlpha R_GRAPHICS_SetGlobalAlpha ✓ .globalCompositeOperation .globalCompositeOperation R_GRAPHICS_- SetGlobalCompositeOperation 14 Shadows R01AN2840EJ0212 Rev. 2.12 Page 95 of 123 Jan.27, 2018...
  • Page 96: Internal Operation In Initialize Function

    SH7268/SH7269 5.11.2 Internal operation in initialize function Take care by referring the following call tree and comment, if RGA initialize was failed, please. R_GRAPHICS_Initialize A function registered by "R_GRAPHICS_STATIC_OnInitializeDefault" or "R_GRAPHICS_STATIC_SetOnInitialize" // Sets default value of "graphics_config_t" and work buffer...
  • Page 97: Identifying Image Format

    SH7268/SH7269 5.11.3 Identifying Image Format The first few bytes of the graphics_image_t-type structure to be specified for the argument of the R_GRAPHICS_DrawImage (section 5.7.1.26), R_GRAPHICS_DrawImageResized (section 5.7.1.27), or R_GRAPHICS_DrawImageChild (section 5.7.1.28) function are used to identify image formats. Therefore, JPEG file data can be specified directly for the graphics_image_t-type argument of the R_GRAPHICS_DrawImage function.
  • Page 98: Flush Mode

    SH7268/SH7269 5.11.4 Flush Mode In auto-flush mode, drawn content can be displayed only by calling R_GRAPHICS_Finish or R_WINDOW_SURFACES_SwapBuffers. In fast manual flush mode, however, cache flush operation is required. Auto-flush mode is enabled by default. In this mode, you need not pay attention to the description of this section.
  • Page 99: Sample Screen Control Layer Configuration

    SH7268/SH7269 5.11.5 Sample Screen Control Layer Configuration The following table shows correspondence between layer configuration supported by window_surfaces_t (section 5.4.5.5) and planes of Video Display Controller 4 (VDC4). ID of section 5.4.5.7, layer_attributes_t Plane Name of Video Display Controller 4 (VDC4)
  • Page 100: Flagged Structure Parameters

    SH7268/SH7269 5.11.6 Flagged Structure Parameters Flags member variables in the structure are used as a bit field. When the bit is 1, the corresponding member variable is enabled in this coding pattern. When the bit is 0, it is treated that the default value is set or not change for the member variable as omitted.
  • Page 101: Defaultable Flags

    SH7268/SH7269 5.11.7 Defaultable Flags Defaultable flags are the type that can select three options: setting to ON, setting to OFF, and no setting (unchanged) for each array element when setting logic-type array variables. Symbols for setting to ON and setting to OFF are defined.
  • Page 102 SH7268/SH7269 Inverted value of lower 16 bits Current flag (upper 16 bits) (lower 16 bits) R01AN2840EJ0212 Rev. 2.12 Page 102 of 123 Jan.27, 2018...
  • Page 103: Function To Initialize Internal Variables With Constants (*_Initconst Function)

    SH7268/SH7269 5.11.8 Function to Initialize Internal Variables with Constants (*_initConst Function) In the C language class that includes the finalizing function (*_finalize function), the *_initConst function must be called first (before calling the *_initialize function). This is to prevent any exception from occurring even if the *_finalize function is called when an error occurs from another object before initialization.
  • Page 104: Compatibility Between C++ Language And Javascript Object

    SH7268/SH7269 5.11.9 Compatibility between C++ Language and JavaScript Object JavaScript codes using the Canvas 2D object can be operated as they are by using the C++ language class provided by this library. The following shows codes using variables of the class provided by this library, which are the same description of codes using variables that reference the JavaScript object.
  • Page 105: Tools

    Double click RGA_Tools.vbs file at armcc\common\src\samples\RGA, select "ImagePackager" command in opened window, specify .image.xml file. This makes header file and binary file or C language data source. --------------------------------------------------------------------------- RGA Tools - Copyright(c) 2012-2016 Renesas Electronics Corporation 1. Convert image format [RunImagePackager] 2. Search error information [SearchErrorInformation] Number or command >1...
  • Page 106: Types Of Output Binary File (Language)

    SH7268/SH7269 <?xml version="1.0" encoding="UTF-8"?> <ImagePackager> <OutputBinary path="BinaryImage_SH7269.c" language="C" symbol="g_RGA_Sample_BinaryImage" source_template="${ImagePackagerLib}\SourceTemplate.xml#default" super_class="${ImagePackagerLib}\SuperClass.xml#default"> <OutputHeader path="BinaryImage_SH7269.h" include_define="BINARYIMAGE_SH7269_H"/> </OutputBinary> <InputFiles> <File path="BinaryHeader.txt" type="char[]" symbol="g_BinaryHeader"/> <Image path="picture.bmp" type="graphics_image_t*" symbol="g_Picture_bmp" output_format="RGB565"/> <Image path="smile32.bmp" type="graphics_image_t*" symbol="g_Smile_bmp" output_format="ARGB4444"/> <File path="JPEG.jpg" type="graphics_image_t*" symbol="g_JPEG_jpg"/> </InputFiles> </ImagePackager> Refer 6.1.8 regarding the basic forms of writing XML and XPath.
  • Page 107: Input Formats

    SH7268/SH7269 [bit1] (reserved) [bit2] 1=Premultiplied alpha, 0=not Premultiplied alpha [bit3-bit15] (reserved) [bit16-bit31] 0 This endian is depended on the setting of "@endian". 0x04 4byte The offset value to the image data from the first of Raw-format image. This endian is depended on the setting of "@endian".
  • Page 108 SH7268/SH7269 When outputting multiple binary files, do not change this parameter in each binary file. When /ImagePackager/OutputHeader/@address is set, this parameter is a macro name having the address value. @language Programming language of output binary data (Optional) "Binary" and "C", "SRec"(S-record) can be set. "Binary" is set by default.
  • Page 109 SH7268/SH7269 Default value is the following value.  If @language="Binary", @table_format="Offset"  If @language="C", @table_format="Embed" @source_template ID of the template of the output source file in the case of @language="C". (Optional) Set the value of "/ImagePackager/SourceTemplate/@id". It is able to set the reference to the other XML file.
  • Page 110 SH7268/SH7269 /ImagePackager/InputFiles/Image: Zero, one or more elements 6.1.7.5 The data converted to Raw-format are embedded in the binary file. @path Path of image files to be input (Essential) As the reference of relative paths, the path of the /ImagePackager/InputFiles/@base_folder folder and the sub-folder are also input when a wild card is specified.
  • Page 111 SH7268/SH7269  "already_yes": The input image has already been multiplied. This choice is available only when the alpha component is not contained in the drawing destination. /ImagePackager/InputFiles/File: Zero, one or more elements 6.1.7.6 Not converted data are embedded in the binary file.
  • Page 112 SH7268/SH7269  ${Section} : Section name. The value of /ImagePackager/OutputBinary/@section  ${Symbol} : Variable name. The value of /ImagePackager/OutputBinary/@symbol  ${Size} : Size of the binary file (bytes)  ${BinaryData} : Binary data SourceWithSection/text() Template of source file, if a section was specified. (Optional) If SourceWithSection tag was not specified, the content specified by Source tag is used, even if a section was specified.
  • Page 113: Basic Forms Of Writing Xml

    SH7268/SH7269 /ImagePackager/SuperClass: Zero, one or more elements 6.1.7.9 ID of SuperClass tag. (Essential) This value is referred from /ImagePackager/OutputBinary/@super_class. /ImagePackager/SuperClass/OutputBinary : Zero or one 6.1.7.10 @endian Default value of /ImagePackager/OutputBinary/@endian. This default value is "LittleEndian". @raw_image_alignment Default value of /ImagePackager/OutputBinary/@raw_image_alignment. This default value is 4.
  • Page 114 SH7268/SH7269 <Root> <LeafA></LeafA> <LeafB></LeafB> </Root> Start-tag and end-tag can be replaced to one tag that has a name appended slash at the tail of tag name. Data passing to target program are not changed, even if they were replaced like it.
  • Page 115 SH7268/SH7269 <Root> <LeafA>ABC</LeafA> <LeafB attribute="1" other="no"/> </Root> The following text is an XPath that points to the position at the text value "ABC". Between XML nodes are split by slash character. "text()" points a text between tags. It is necessary to write "()" at the tail of "text". Difference between upper case and lower case is treated as different name.
  • Page 116: Searching For Error Information By Searcherrorinformation

    Window after RGA_Tools.vbs is double-clicked: RGA Tools - Copyright(c) 2012-2016 Renesas Electronics Corporation 1. Image format conversion [RunImagePackager] 2. Error information search [SearchErrorInformation] Number or command >2...
  • Page 117: Converting Binary By Convertbin

    Execute address is usually 0 for data binary. SRecToBin Converts from S-record format to binary file. Window after RGA_Tools.vbs is double-clicked: RGA Tools - Copyright(c) 2012-2016 Renesas Electronics Corporation 1. Convert image format [RunImagePackager] 2. Search error information [SearchErrorInformation] 3. Convert to binary [ConvertBin] Number or command >3...
  • Page 118: Creating Image File By Rawtobmp

    Creating image file by RawToBmp RawToBmp creates a BMP image file from Raw data in frame buffer. Window after RGA_Tools.vbs is double-clicked: RGA Tools - Copyright(c) 2012-2015 Renesas Electronics Corporation 1. Convert image format [RunImagePackager] 2. Search error information [SearchErrorInformation] 3.
  • Page 119: The Restriction Of Drawing An Image With Zooming

    SH7268/SH7269 Contents of Software Update The main revision contents are shown in this chapter. For all revisions, please refer to the section of Revision Record. Improved phenomenon that cannot be drawn immediately after power on Some chip sometimes not be able to draw immediately after the power is turned on, if the system used RGA 2.10 or lower.
  • Page 120: The Restriction Of Drawing An Image That Has Not Transparent Color

    SH7268/SH7269 RGA must not be used any above combination of drawing source and drawing destination format. The restriction of drawing an image that has not transparent color When it meets the following condition, you should not use in all versions of RGA.
  • Page 121: Sample Codes

    SH7268/SH7269 Sample Codes Sample codes are contained in the RGA folder. The HEW project file in RGA\Sample_SH7269 is available to operate sample codes on the SH7269. The Visual Studio 2008 project file in RGA\Sample_PC is available to operate sample codes on a PC.
  • Page 122: Reference Documents

    SH7268/SH7269 Reference Documents User's Manual: Hardware SH7268/SH7269 Group User's Manual (Hardware) Rev.1.00 (Obtain the latest version from the Renesas Electronics homepage.) User's Manual: Development Environment SuperH™ RISC engine C/C++ Compiler, Assembler, Optimizing Linkage Editor Compiler Package V.9.04 User's Manual Rev.1.01 (Obtain the latest version from the Renesas Electronics homepage.)
  • Page 123: Website And Support

    SH7268/SH7269 Website and Support Renesas Electronics Website http://www.renesas.com/ Inquiries http://www.renesas.com/contact/ All trademarks and registered trademarks are the property of their respective owners. R01AN2840EJ0212 Rev. 2.12 Page 123 of 123 Jan.27, 2018...
  • Page 124: Revision Record

    Revision Record Rev. Date Description  2.12 Jan. 27, 2018 Modify: section 5.11.2: to modify the following function name  wrong: NCGSYS_SetStateEventValue  right: NCGSYS_GetLastCreatedState  New: section 7: Contents of Software Update The following items are revision record of the code: ...
  • Page 125: General Precautions In The Handling Of Mpu/Mcu Products

    General Precautions in the Handling of MPU/MCU Products The following usage notes are applicable to all MPU/MCU products from Renesas. For detailed usage notes on the products covered by this manual, refer to the relevant sections of the manual. If the descriptions under General Precautions in the Handling of MPU/MCU Products and in the body of the manual differ from each other, the description in the body of the manual takes precedence.
  • Page 126: Notice

    10. It is the responsibility of the buyer or distributor of Renesas Electronics products, or any other party who distributes, disposes of, or otherwise sells or transfers the product to a third party, to notify such third party in advance of the contents and conditions set forth in this document.

This manual is also suitable for:

Sh7269

Table of Contents