Build the Interface

This is the preliminary step. The Define mode allows to prepare the interface. 

An interface consists of two kinds of elements:
  • passive elements as background colour, labels... 
  • and active elements or controls, as text box, cursor, button controls...

On the Define mode, touch is suspended but files operations like write and read are allowed.

Procedure

Functions
Prepare the screen
sC_beginScreen initialises the screen, deletes all the controls and sets mode to Define mode
  • Input: None
  • Output: None
  • Exit: So if valid, ER if initialisation failed

sC_defineBackground defines background colour and clears screen
  • Input: 
  • Output: 
Define passive elements
Passive elements offer no interaction.
sC_defineShape draws a line, an empty or solid rectangle
  • Input: 
  • Output: 

sC_defineDisplay defines a single-line display control for numbers or text
  • Input: 
  • Output: 
Define active controls
Each active control has a unique identifier, called control unique identifier.

A good idea is to have an integer variable for each control with the name of the control.
sC_defineDisplay defines a single-line display control for numbers or text
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer
 
sC_defineText control with defines a multi-line display control for numbers or text
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer 

sC_defineButton defines a button
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer 
     
sC_defineCursor defines a cursor or slider control
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer 
     
sC_defineMetre defines a metre or gauge control
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer 
     
sC_defineLamp defines a on-or-off rectangular lamp control
sC_defineBulb defines a on-or-off circular lamp control
  • Input: option, Integer
  • Input: 16-bit coded RGB ON colour, Integer
  • Input: 16-bit coded RGB OFF colour, Integer
  • Input: x-axis coordinate, Integer
  • Input: y-axis coordinate, Integer
  • Output: 0 if error, otherwise control unique identifier, Integer 
 
sC_defineCheckBox defines a check box control
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer 
     
sC_defineRadioButtons defines a set of radio buttons control
  • Input: 
  • Output: 0 if error, otherwise control unique identifier, Integer 
     
Prepare active controls
sC_setValue sets the value of a control
  • Input: control unique identifier, Integer non zero
  • Input: value, Integer
  • Output: None
    •  
sC_setText displays text on a display or text control
  • Input: control unique identifier, Integer non zero
  • Input: text, String
  • Output: None
 
sC_setColour sets the colour of a control
  • Input: control unique identifier, Integer non zero
  • Input: 16-bit coded colour from the RGB_colour utility, Integer
Colour utility
RGB_colour calculates the 16-bit coded colour from primary red-green-blue components
  • Input: red component, Integer
  • Input: green component, Integer
  • Input: blue component, Integer
  • Output: 16-bit coded colour, Integer
Change mode
When the interface is built, call sC_setMode to use the interface.
sC_setMode sets mode to Define or Run
  • Input: mode, 0 for Definition, 1 for Run, Integer
  • Output: None

Previous

Next