Renesas H8S User Manual download pdf (Page 24)

Direct Drive LCD Design Guide

4.1.10 LCDSetLineSource

Defines the source regions of the active display window.

Format

sI16 LCDSetLineSource

(sI16 Region, sI16 LineCount, uI16 *pSource, sI16 LineStep);

Parameters

Region

Region of display (horizontal strip). Ranging from 0 to MAX_FRAME_REGIONS (defined in

DirectLCD_CNF.h). Normally, region 0 starts at the bottom of the screen. However; when

V_LINES_INVERT is defined to change line presentation on the screen, region 0 will start at the top

of the screen. MAX_FRAME_REGIONS should be set to 1 if multiple regions are not used (this will

eliminate any associated runtime overhead).

LineCount

Is the number of lines associated with this region. This value can vary from 1 to V_LINES_PANEL.

pSource

Address of the first pixel of the first line within the region. The entire memory space of the region

must be within the “LCD_Frames” section, or the request will not be accepted.

LineStep

Distance (in pixels/uI16’s) from first pixel of first line to first pixel of second line (source regions can

be wider than the panel).

Return Values

0 on success, non-0 on failure

Properties

Prototyped in file ”DirectLCD.h”

Implemented in file “DirectLCD_SBF.c” for H8S family or “DirectLCD_XBCFT.c” for H8SX family.

Description

LCDSetLineSource defines the source regions of the active display window.

Note that LCDSetActiveRaster, LCDSetRasterOffset and LCDSetLineSource are similar in function and

interact.

Example

#pragma section LCD_Frames

// SRAM allocated for GUI display

uI16 GUI_buffer[50 * H_DOT_DISPLAY];

// allocate panning buffer 4x panel

uI16 Image_buffer[2* V_LINES_PANEL * 2 * H_DOT_DISPLAY];

#pragma section

……

(void)LCDSetLineSource (0,50,GUI_buffer, H_DOT_DISPLAY); //GUI Region

(void)LCDSetLineSource (1,V_LINES_PANEL-50,

&Image_buffer[ offset], 2*H_DOT_DISPLAY); //Pan Region

……

1 2 ... 19 20 21 22 23 24 25 26

No comments

Renesas H8S User Manual Page 24