Meter Functions

 

Name 

Description 

 

MtrCreate 

This function creates a METER object with the parameters given. It automatically attaches the new object into a global linked list of objects and returns the address of the object. 

 

MtrDraw 

This function renders the object on the screen using the current parameter settings. Location of the object is determined by the left, top, right and bottom parameters. The colors used are dependent on the state of the object. The font used is determined by the style scheme set.
Depending on the defined settings, value of the meter will displayed or hidden. Displaying the value will require a little bit more rendering time depending on the size of the meter and font used.
When rendering objects of the same type, each object must be rendered completely before the rendering of the... more 

 

MtrSetVal 

This function sets the value of the meter to the passed newVal. newVal is checked to be in the minValue-maxValue range inclusive. If newVal is not in the range, minValue maxValue is assigned depending on the given newVal if less than minValue or above maxValue. 

 

MtrMsgDefault 

This function performs the actual state change based on the translated message given. Meter value is set based on parameter 2 of the message given. The following state changes are supported:  

 

MtrTranslateMsg 

This function evaluates the message from a user if the message will affect the object or not. The table below enumerates the translated messages for each event of the touch screen and keyboard inputs.