TFT 16-bit Display Library
  mikroPascal PRO for PIC Libraries > Hardware Libraries > 
  

TFT 16-bit Library

Thin film transistor liquid crystal display (TFT-LCD) is a variant of liquid crystal display (LCD) which uses thin-film transistor (TFT) technology to improve image quality (e.g., addressability, contrast).
TFT LCD is one type of active matrix LCD, though all LCD-screens are based on TFT active matrix addressing.
TFT LCDs are used in television sets, computer monitors, mobile phones, handheld video game systems, personal digital assistants, navigation systems, projectors, etc.

The mikroPascal PRO for PIC provides a library for working with the following display controllers :


  Note :

External dependencies of TFT 16-bit Library

The following variables must be defined in all projects using TFT 16-bit Library: Description : Example :
var TFT_16bit_DataPort_Lo : byte; external; sfr; TFT Data Port Low. var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte; external; sfr; TFT Data Port High. var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_DataPort_Direction_Lo : byte; external; sfr; Direction of the TFT Data Port Low. var TFT_16bit_DataPort_Direction_Lo : byte at TRISB;
var TFT_16bit_DataPort_Direction_Hi : byte; external; sfr; Direction of the TFT Data Port High. var TFT_16bit_DataPort_Direction_Hi : byte at TRISC;
var TFT_16bit_WR : sbit; sfr; external; Write signal. var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit; sfr; external; Read signal. var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit; sfr; external; Chip Select signal. var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit; sfr; external; Command/Register Select signal. var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit; sfr; external; Reset signal. var TFT_16bit_RST : sbit at LATH4_bit;
var TFT_16bit_WR_Direction : sbit; sfr; external; Direction of the Write pin. var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit; sfr; external; Direction of the Read pin. var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit; sfr; external; Direction of the Chip Select pin. var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit; sfr; external; Direction of the Register Select pin. var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit; sfr; external; Direction of the Reset pin. var TFT_16bit_RST_Direction : sbit at TRISH4_bit;

Library Routines

TFT_Init_HX8347D

Prototype

procedure TFT_Init_HX8347D(display_width, display_height : word);
Returns

Nothing.
Description

Initializes HX8347D display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_HX8347D(240, 320);

TFT_Init_HX8352A

Prototype

procedure TFT_Init_HX8352A(display_width, display_height : word);
Returns

Nothing.
Description

Initializes HX8352A display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_HX8352A(240, 320);

TFT_Init_SSD1963

Prototype

procedure TFT_Init_SSD1963(display_width, display_height : word);
Returns

Nothing.
Description

Initializes SSD1963 display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_SSD1963(240, 320);

TFT_Init_ILI9340

Prototype

procedure TFT_Init_ILI9340(display_width, display_height : word);
Returns

Nothing.
Description

Initializes ILI9340 display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_ILI9340(240, 320);

TFT_Init_ILI9342

Prototype

procedure TFT_Init_ILI9342(display_width, display_height : word);
Returns

Nothing.
Description

Initializes ILI9342 display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_ILI9342(240, 320);

TFT_Init_ILI9481

Prototype

procedure TFT_Init_ILI9481(display_width, display_height : word);
Returns

Nothing.
Description

Initializes ILI9481 display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_ILI9481(240, 320);

TFT_Init_HX8347G_16bit

Prototype

procedure TFT_Init_HX8347G_16bit(display_width, display_height : word);
Returns

Nothing.
Description

Initializes HX8347G display controller in 16-bit working mode.

Parameters :

  • width: width of the TFT display.
  • height: height of the TFT display.
Requires

Global variables :

  • TFT_16bit_DataPort_Lo: Data Port Low
  • TFT_16bit_DataPort_Hi: Data Port High
  • TFT_16bit_WR: Write signal pin
  • TFT_16bit_RD: Read signal pin
  • TFT_16bit_CS: Chip Select signal pin
  • TFT_16bit_RS: Register Select signal pin
  • TFT_16bit_RST: Reset signal pin

  • TFT_16bit_DataPort_Direction_Lo: Direction of Data Port Low
  • TFT_16bit_DataPort_Direction_Hi: Direction of Data Port High
  • TFT_16bit_WR_Direction: Direction of Write signal pin
  • TFT_16bit_RD_Direction: Direction of Read signal pin
  • TFT_16bit_CS_Direction: Direction of Chip Select signal pin
  • TFT_16bit_RS_Direction: Direction of Register Select signal pin
  • TFT_16bit_RST_Direction: Direction of Reset signal pin
must be defined before using this function.
Example 
// TFT display connections
var TFT_16bit_DataPort_Lo : byte at LATB;
var TFT_16bit_DataPort_Hi : byte at LATC;
var TFT_16bit_WR : sbit at LATE1_bit;
var TFT_16bit_RD : sbit at LATE0_bit;
var TFT_16bit_CS : sbit at LATG3_bit;
var TFT_16bit_RS : sbit at LATH6_bit;
var TFT_16bit_RST : sbit at LATH4_bit;

var TFT_16bit_DataPort_Lo_Direction : byte at TRISB;
var TFT_16bit_DataPort_Hi_Direction : byte at TRISC;
var TFT_16bit_WR_Direction : sbit at TRISE1_bit;
var TFT_16bit_RD_Direction : sbit at TRISE0_bit;
var TFT_16bit_CS_Direction : sbit at TRISG3_bit;
var TFT_16bit_RS_Direction : sbit at TRISH6_bit;
var TFT_16bit_RST_Direction : sbit at TRISH4_bit;
// End of TFT display connections

// Initialize 240x320 TFT display
TFT_Init_HX8347G_16bit(240, 320);

TFT_16bit_Set_Index

Prototype

procedure TFT_16bit_Set_Index(index : byte);
Returns

Nothing.
Description

Accesses register space of the controller and sets the desired register.

Parameters :

  • index: desired register number.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Access register at the location 0x02
TFT_16bit_Set_Index(0x02);

TFT_16bit_Write_Command

Prototype

procedure TFT_16bit_Write_Command(cmd : byte);
Returns

Nothing.
Description

Accesses data space and writes a command.

Parameters :

  • cmd: command to be written.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Write a command
TFT_16bit_Write_Command(0x02);

TFT_16bit_Write_Data

Prototype

procedure TFT_16bit_Write_Data(_data : word);
Returns

Nothing.
Description

Writes date into display memory.

Parameters :

  • _data:data to be written.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Send data
TFT_16bit_Write_Data(0x02);

TFT_16bit_Set_Reg

Prototype

procedure TFT_16bit_Set_Reg(index, value : byte);
Returns

Nothing.
Description

Accesses register space of the controller and writes a value in the desired register.

Parameters :

  • index: desired register.
  • value: value to be written.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// 65K Color Selection
TFT_16bit_Set_Reg(0x17, 0x05);

TFT_16bit_Set_Ext_Buffer

Prototype

procedure TFT_16bit_Set_Ext_Buffer(getExtDataPtr : ^TTFT_16bit_Get_Ext_Data_Ptr);
Returns

Nothing.
Description

Function sets pointer to the user function which manipulates the external resource.

Parameters :

  • TTFT_16bit_Get_Ext_Data_Ptr - pointer to the user function.

User function prototype should be in the following format: function External(offset : dword; count : word; var num : word) : ^byte;

Parameters used in the function have the following meaning :

  • offset - offset from the beginning of the resource from where the data is requested.
  • count - requested number of bytes.
  • num - variable for holding the returned number of bytes (less or equal to the number of acquired bytes).
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Set_Ext_Buffer(@ReadExternalBuffer);

TFT_16bit_Set_Active

Prototype

procedure TFT_16bit_Set_Active(Set_Index_Ptr : ^TTFT_16bit_Set_Index_Ptr; Write_Command_Ptr : ^TTFT_16bit_Write_Command_Ptr; Write_Data_Ptr : ^TTFT_16bit_Write_Data_Ptr);
Returns

Nothing.
Description

This function sets appropriate pointers to a user-defined basic routines in order to enable multiple working modes.

Parameters :

  • Set_Index_Ptr: Set_Index handler.
  • Write_Command_Ptr: _Write_Command handler.
  • Write_Data_Ptr: Write_Data handler.
Requires

None.
Example

Please see controller's datasheet for working mode descriptions.

procedure Set_Index(index : byte);
begin
  // Set Index
end;

procedure Write_Command(cmd : byte);
begin
  // Write Command
end;

procedure Write_Data(_data : word);
begin
  // Write Data
end;

begin
  ...
  TFT_16bit_Set_Active(@Set_Index, @Write_Command, @Write_Data);
  TFT_Init_HX8352A (320, 240);
  ...
end.

TFT_16bit_Set_Default_Mode

Prototype

procedure TFT_16bit_Set_Default_Mode();
Returns

Nothing.
Description

This function sets TFT in default working mode.

Parameters :

  • None.
Requires

None.
Example 
TFT_16bit_Set_Default_Mode();
TFT_Init_HX8352A(320, 240);

TFT_16bit_Set_Font

Prototype

procedure TFT_16bit_Set_Font(activeFont : ^const far byte; font_color : word; font_orientation : byte);
Returns

Nothing.
Description

Sets font, its color and font orientation.

Parameters :

  • activeFont: desired font. Currently, only TFT_16bit_defaultFont (Tahoma14x16) is supported.
  • font_color: sets font color :

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

  • font_orientation: sets font orientation :

    Value Description
    FO_HORIZONTAL_16bit Horizontal orientation
    FO_VERTICAL_16bit Vertical orientation

Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Set_Font(@TFT_16bit_defaultFont, CL_BLACK_16bit, FO_HORIZONTAL_16bit);

TFT_16bit_Set_Ext_Font

Prototype

procedure TFT_16bit_Set_Ext_Font(activeFont : dword; font_color : word; font_orientation : byte);
Returns

Nothing.
Description

Sets font, its color and font orientation. Font is located in an external resource

Parameters :

  • activeFont: desired font. This parameter represents the address in the exteral resource from where the font data begins.
  • font_color: sets font color :

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit/td> White color
    CL_YELLOW_16bit Yellow color

  • font_orientation: sets font orientation :

    Value Description
    FO_HORIZONTAL_16bit Horizontal orientation
    FO_VERTICAL_16bit Vertical orientation

Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Set_Ext_Font(173296, CL_BLACK_16bit, FO_HORIZONTAL_16bit);

TFT_16bit_Write_Char

Prototype

procedure TFT_16bit_Write_Char(ch, x, y : word);
Returns

Nothing.
Description

Writes a char on the TFT at coordinates (x, y).

  • c: char to be written.
  • x: char position on x-axis.
  • y: char position on y-axis.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Write_Char('A',22,23);

TFT_16bit_Write_Text

Prototype

procedure TFT_16bit_Write_Text(var text : string; x, y : word);
Returns

Nothing.
Description

Writes text on the TFT at coordinates (x, y).

Parameters :

  • text: text to be written.
  • x: text position on x-axis.
  • y: text position on y-axis.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Write_Text('TFT 16-bit LIBRARY DEMO, WELCOME !', 0, 0);

TFT_16bit_Write_Const_Text

Prototype

procedure TFT_16bit_Write_Const_Text(const text : ^far byte; x, y : word);
Returns

Nothing.
Description

Writes text located in the program memory on the TFT at coordinates (x, y).

Parameters :

  • text: text to be written.
  • x: text position on x-axis.
  • y: text position on y-axis.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
const char ctext[] = "mikroElektronika";
...
TFT_16bit_Write_Const_Text(ctext, 0, 0);

TFT_16bit_Fill_Screen

Prototype

procedure TFT_16bit_Fill_Screen(color : word);
Returns

Nothing.
Description

Fills screen memory block with given color.

Parameters :

  • color: color to be filled :

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Fill_Screen(CL_BLACK_16bit);

TFT_16bit_Dot

Prototype

procedure TFT_16bit_Dot(x, y : integer; color : word);
Returns

Nothing.
Description

Draws a dot on the TFT at coordinates (x, y).

Parameters :

  • x: dot position on x-axis.
  • y: dot position on y-axis.
  • color: color parameter. Valid values :

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Dot(50, 50, CL_BLACK_16bit);

TFT_16bit_Set_Pen

Prototype

procedure TFT_16bit_Set_Pen(pen_color : word; pen_width : byte);
Returns

Nothing.
Description

Sets color and thickness parameter for drawing line, circle and rectangle elements.

Parameters :

  • pen_color: Sets color.

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

  • pen_width: sets thickness.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Set_Pen(CL_BLACK_16bit, 10);

TFT_16bit_Set_Brush

Prototype

procedure TFT_16bit_Set_Brush(brush_enabled : byte; brush_color : word; gradient_enabled, gradient_orientation : byte; gradient_color_from, gradient_color_to : word);
Returns

Nothing.
Description

Sets color and gradient which will be used to fill circles or rectangles.

Parameters :

  • brush_enabled: enable brush fill.

    Value Description
    1 Enable brush fill.
    0 Disable brush fill.

  • brush_color: set brush fill color.

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

  • gradient_enabled: enable gradient

    Value Description
    1 Enable gradient.
    0 Disable gradient.

  • gradient_orientation: sets gradient orientation :

    Value Description
    LEFT_TO_RIGHT_16bit Left to right gradient orientation
    TOP_TO_BOTTOM<_16bit/td> Top to bottom gradient orientation

  • gradient_color_from: sets the starting gradient color.

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

  • gradient_color_to: sets the ending gradient color.

    Value Description
    CL_AQUA_16bit Aqua color
    CL_BLACK_16bit Black color
    CL_BLUE_16bit Blue color
    CL_FUCHSIA_16bit Fuchsia color
    CL_GRAY_16bit Gray color
    CL_GREEN_16bit Green color
    CL_LIME_16bit Lime color
    CL_MAROON_16bit Maroon color
    CL_NAVY_16bit Navy color
    CL_OLIVE_16bit Olive color
    CL_PURPLE_16bit Purple color
    CL_RED_16bit Red color
    CL_SILVER_16bit Silver color
    CL_TEAL_16bit Teal color
    CL_WHITE_16bit White color
    CL_YELLOW_16bit Yellow color

Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Enable gradient from black to white color, left-right orientation
TFT_16bit_Set_Brush(0, 0, 1, LEFT_TO_RIGHT_16bit, CL_BLACK_16bit, CL_WHITE_16bit);

TFT_16bit_Line

Prototype

procedure TFT_16bit_Line(x1, y1, x2, y2 : integer);
Returns

Nothing.
Description

Draws a line from (x1, y1) to (x2, y2).

Parameters :

  • x1: x coordinate of the line start.
  • y1: y coordinate of the line end.
  • x2: x coordinate of the line start.
  • y2: y coordinate of the line end.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Line(0, 0, 239, 127);

TFT_16bit_H_Line

Prototype

procedure TFT_16bit_H_Line(x_start, x_end, y_pos : integer);
Returns

Nothing.
Description

Draws a horizontal line on TFT.

Parameters :

  • x_start: x coordinate of the line start.
  • x_end: x coordinate of the line end.
  • y_pos: y coordinate of horizontal line.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Draw a horizontal line between dots (10,20) and (50,20)
TFT_16bit_H_Line(10, 50, 20);

TFT_16bit_V_Line

Prototype

procedure TFT_16bit_V_Line(y_start, y_end, x_pos : integer);
Returns

Nothing.
Description

Draws a vertical line on TFT.

Parameters :

  • y_start: y coordinate of the line start.
  • y_end: y coordinate of the line end.
  • x_pos: x coordinate of vertical line.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Draw a vertical line between dots (10,5) and (10,25)
TFT_16bit_V_Line(5, 25, 10);

TFT_16bit_Rectangle

Prototype

procedure TFT_16bit_Rectangle(x_upper_left, y_upper_left, x_bottom_right, y_bottom_right:integer);
Returns

Nothing.
Description

Draws a rectangle on TFT.

Parameters :

  • x_upper_left: x coordinate of the upper left rectangle corner.
  • y_upper_left: y coordinate of the upper left rectangle corner.
  • x_bottom_right: x coordinate of the lower right rectangle corner.
  • y_bottom_right: y coordinate of the lower right rectangle corner.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Rectangle(20, 20, 219, 107);

TFT_16bit_Rectangle_Round_Edges

Prototype

procedure TFT_16bit_Rectangle_Round_Edges(x_upper_left, y_upper_left, x_bottom_right, y_bottom_right, round_radius : word);
Returns

Nothing.
Description

Draws a rounded edge rectangle on TFT.

Parameters :

  • x_upper_left: x coordinate of the upper left rectangle corner.
  • y_upper_left: y coordinate of the upper left rectangle corner.
  • x_bottom_right: x coordinate of the lower right rectangle corner.
  • y_bottom_right: y coordinate of the lower right rectangle corner.
  • round_radius: radius of the rounded edge.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Rectangle_Round_Edges(20, 20, 219, 107, 12);

TFT_16bit_Circle

Prototype

procedure TFT_16bit_Circle(x_center, y_center, radius : integer);
Returns

Nothing.
Description

Draws a circle on TFT.

Parameters :

  • x: x coordinate of the circle center.
  • y: y coordinate of the circle center.
  • r: radius size.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Circle(120, 64, 110);

TFT_16bit_Image

Prototype

procedure TFT_16bit_Image(left, top : word; image : ^const far byte; stretch : byte);
Returns

Nothing.
Description

Displays an image on a desired location.

Parameters :

  • left: position of the image's left edge.
  • top:position of the image's top edge.
  • image: image to be displayed. Bitmap array is located in code memory.
  • stretch: stretches image by a given factor (if 2, it will double the image.).
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Image(0, 0, @image, 1);

TFT_16bit_Ext_Image

Prototype

procedure TFT_16bit_Ext_Image(left, top : word; image : dword; stretch : byte);
Returns

Nothing.
Description

Displays an image from an external resource on a desired address.

Parameters :

  • left: position of the image's left edge.
  • top:position of the image's top edge.
  • image: image to be displayed. This parameter represents the address in the exteral resource from where the image data begins.
  • stretch: stretches image by a given factor (if 2, it will double the image.).
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Image(0, 0, 153608, 1);

TFT_16bit_Partial_Image

Prototype

procedure TFT_16bit_Partial_Image(left, top, width, height : word; image : ^const far byte; stretch : byte) ;
Returns

Nothing.
Description

Displays a partial area of the image on a desired location.

Parameters :

  • left: left coordinate of the image.
  • top: top coordinate of the image.
  • width: desired image width.
  • height: desired image height.
  • image: image to be displayed. Bitmap array is located in code memory.
  • stretch: stretches image by a given factor (if 2, it will double the image.).
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Draws a 10x15 part of the image starting from the upper left corner on the coordinate (10,12)  
TFT_16bit_PartialImage(10, 12, 10, 15, @image, 1);

TFT_16bit_Ext_Partial_Image

Prototype

procedure TFT_16bit_Ext_Partial_Image(left, top, width, height : word; image : dword; stretch : byte) ;
Returns

Nothing.
Description

Displays a partial area of the image, located on an external resource, on a desired location of the screen.

Parameters :

  • left: left coordinate of the image.
  • top: top coordinate of the image.
  • width: desired image width.
  • height: desired image height.
  • image: image to be displayed. This parameter represents the address in the exteral resource from where the image data begins.
  • stretch: stretches image by a given factor (if 2, it will double the image.).
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Ext_Partial_Image(159,0,160,120,0,1);

TFT_16bit_Image_Jpeg

Prototype

function TFT_16bit_Image_Jpeg(left, top : word; image : ^const byte): byte;
Returns
  • 0 - if image is loaded and displayed successfully.
  • 1 - if error occured.
Description

Displays a JPEG image on a desired location.

Parameters :

  • left: left coordinate of the image.
  • top: top coordinate of the image.
  • image: image to be displayed. Bitmap array is located in code memory.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Image_Jpeg(0, 0, @image);

TFT_16bit_RGBToColor16bit

Prototype

function TFT_16bit_RGBToColor16bit(rgb_red, rgb_green, rgb_blue : byte) : word;
Returns

Returns a color value in the following bit-order : 5 bits red, 6 bits green and 5 bits blue color.
Description

Converts 5:6:5 RGB format into true color format.

Parameters :

  • rgb_red: red component of the image.
  • rgb_green: green component of the image.
  • rgb_blue: blue component of the image.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
color16 := TFT_16bit_RGBToColor16bit(150, 193, 65);

TFT_16bit_Color16bitToRGB

Prototype

procedure TFT_16bit_Color16bitToRGB(color : word; rgb_red, rgb_green, rgb_blue : ^byte);
Returns

Nothing.
Description

Converts true color into 5:6:5 RGB format.

Parameters :

  • color: true color to be converted.
  • rgb_red: red component of the input color.
  • rgb_green: green component of the input color.
  • rgb_blue: blue component of the input color.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
TFT_16bit_Color16bitToRGB(start_color, @red_start, @green_start, @blue_start);

TFT_16bit_Rotate_180

Prototype

procedure TFT_16bit_Rotate_180(rotate : byte);
Returns

Nothing.
Description

Rotates the TFT display.

Parameters :

  • rotate: parameter for rotating display. Valid values :
    • 0 - display will not be rotated.
    • 1 - display will be rotated for 180 degrees.
Requires

TFT module needs to be initialized. Please, see appropriate TFT initialization routine.
Example 
// Rotate TFT display for 180 degrees
TFT_16bit_Rotate_180(1);

// Initialize TFT display
TFT_Init_HX8352A(240, 320);
Copyright (c) 2002-2012 mikroElektronika. All rights reserved.
What do you think about this topic ? Send us feedback!
Want more examples and libraries? 
Find them on LibStock - A place for the code