Command SHOW
 
Description Show a Page on the Display or reveal a hidden Group or Entity
This puts the selected page on the top layer of the screen. If the HIDE() command has previously been used for an entity, it will now appear on a page when the page is shown on the display.
SHOW(Page) can also be used to refresh a page if entities have changed.

Reserved names provide relative navigation when the name of a page may not be known..
  SHOW(PREV_PAGE); Show the page which launched the current page.
  SHOW(THIS_PAGE); Refresh the current page
  SHOW(Entity1, Entity2, Entity3...);; multiple show entities then refresh current page
 
Syntax/Parameters SHOW(Name)
 
Options Smaller Pages / Pop Ups
Support for popup pages - ie smaller than 480 * 272.
When smaller page is displayed SHOW(SmallPage); it is overlayed onto the existing page which is then ‘frozen’.
Use SHOW(PREV_PAGE); to return.

SHOW(INT) - v49.03
Pending interrupts are now processed when an interrupt entity is unhidden.
All of the interrupts shown on the Int page are handled

SHOW() Groups of Entities - v49.51
Added array of pointer support to SHOW() commands.
This allows for groups of entities to be shown on a page by passing the single name for the array of pointers.

VAR(group>"",PTR,3);
LOAD(group.0>"img1");
LOAD(group.1>"text1");
LOAD(group.2>"shape1");

SHOW(group);; // Show img1, text1, shape1
 
Example INT( intRs2, RS2RXC, fncRs2Rx ); // Create RS2 receive interrupt
HIDE( intRs2 ); // Hide the interrupt
SHOW( intRs2 ); // Show (Enable) interrupt and process pending interrupts

If you don't want to process any pending interrupts when you show the interrupt then RESET the interrupt first 
INT( intTmr0, TIMER0, fncTmr0 ); // Create RS2 receive interrupt
HIDE( intTmr0 ); // Hide the interrupt
RESET( intTmr0 ); // Clear any pending interrupts
SHOW( intTmr0 ); // Show (Enable) interrupt for future interrupts
 
Update Information

 Version

 Title

Date  

 Details

49.51

 SHOW() and HIDE() Groups of Entities

18 Feb 14 

Show

Added array of pointer support to SHOW() and HIDE() commands.
This allows for groups of entities to be shown and hidden on a page by passing the single name for the array of pointers.

VAR(group>"",PTR,3);
LOAD(group.0>"img1");
LOAD(group.1>"text1");
LOAD(group.2>"shape1");

HIDE(group);; // Hide img1, text1, shape1
SHOW(group);; // Show img1, text1, shape1

Test code:

STYLE(stPage,PAGE){}
STYLE(stCirc1,DRAW){type=circle;col=white;width=1;back=red;}
STYLE(stCirc2,DRAW){type=circle;col=white;width=1;back=green;}
STYLE(stCirc3,DRAW){type=circle;col=white;width=1;back=blue;}
STYLE(stCirc4,DRAW){type=circle;col=white;width=1;back=yellow;}
STYLE(stText,TEXT){ maxRows=4; ySpace=4; }
STYLE(stBox,DRAW){type=box;col=lime;width=1;}

VAR(x,49,S32); VAR(y,49,S32);

PAGE(pgTest,stPage)
{
LOAD(x,49); LOAD(y,49); DRAW(circle1,80,stCirc1,x,y);
CALC(x,DISPX,50,"-"); LOAD(y,50); DRAW(circle2,60,stCirc2,x,y);
LOAD(x,90); CALC(y,DISPY,90,"-"); DRAW(circle3,150,stCirc3,x,y);
CALC(x,DISPX,70,"-"); CALC(y,DISPY,70,"-"); DRAW(circle4,100,stCirc4,x,y);

CALC(x,DISPX,2,1,"/-"); CALC(y,DISPY,2,1,"/-");
DRAW(box1,DISPX,DISPY,stBox,x,y);
TEXT(text1,"",stText,x,y);
KEY(key1,fncKey1,DISPX,DISPY,TOUCH,x,y);
}
LOAD(text1,
"Vers: ",VERS_IAPP,"\\0d\\0a",
"Width: ",DISPX,"px\\0d\\0a",
"Height: ",DISPY,"px\\0d\\0a",
"Rotate: ",DISPR,"deg"
);
SHOW(pgTest);

VAR(toggle,0,U8);
VAR(group>"",PTR,4);
LOAD(group.0>"circle1");
LOAD(group.1>"circle2");
LOAD(group.2>"circle3");
LOAD(group.3>"circle4");

FUNC(fncKey1)
{
//IF(toggle==0?[LOAD(toggle,1);HIDE(circle1,circle2,circle3,circle4);;]:[LOAD(toggle,0);SHOW(circle1,circle2,circle3,circle4);;]);
IF(toggle==0?[LOAD(toggle,1);HIDE(group);;]:[LOAD(toggle,0);SHOW(group);;]);
}

49.42

 Show/Hide of I/O Interrupts

06 Sep 13 

Show

* I/O interrupts are now handled the same as other interrupts therefore can now be enabled / disabled via the use of SHOW() / HIDE()

49.03

 HIDE / SHOW( INT ) - Pending interrupts are now processed when an interrupt entity is unhidden.

01 Jun 12 

Show

Pending interrupts are now processed when an interrupt entity is unhidden.
* The supported interrupts are RS2RXC, RS4RXC, AS1RXC, AS2RXC, DBGRXC, TWIRXC, SPIRXC, USBRXC, TIMER0..TIMER9
* Example
INT( intRs2, RS2RXC, fncRs2Rx ); // Create RS2 receive interrupt
...
HIDE( intRs2 ); // Hide the interrupt
...
SHOW( intRs2 ); // Show (Enable) interrupt and process pending interrupts
* If you don't want to process any pending interrupts when you show the interrupt then RESET the interrupt first
* Example
INT( intTmr0, TIMER0, fncTmr0 ); // Create RS2 receive interrupt
...
HIDE( intTmr0 ); // Hide the interrupt
...
RESET( intTmr0 ); // Clear any pending interrupts
SHOW( intTmr0 ); // Show (Enable) interrupt for future interrupts

48.24

 IF() - A page name as well as the existing function name are now supported in the IF() then/else statement.

10 Mar 12 

Show

A page name as well as the existing function name are now supported in the IF() then/else statement, thus allowing a RUN(function) or SHOW(page) to be directly called.
K00-K30 are now supported in IF() test, eg IF( K03 = 1 ? func );

27.00

 Smaller Pages / Pop Ups - Added popup pages.

10 Sep 10 

Show

Added popup pages - ie smaller than 480 * 272.
When smaller page is displayed SHOW(SmallPage); it is overlayed onto the existing page which is then ‘frozen’. Use SHOW(PREV_PAGE); to return.

27.00

 Entity Pointers - Entity pointers have been added.

10 Sep 10 

Show

Entity pointers have been added.
STYLE( PtrData, DATA ) { type = pointer; }
VAR( EntPtr1, PtrData );

To set/change which entity the entity pointer is pointing to you enclose its name in quotes.
LOAD( "EntPtr1", "Var1" ); // Set EntPtr1 to point to "Var1"

To access the entity pointed to by the entity pointer, do not enclose is quotes.
LOAD( EntPtr1, "ABC" ); // Load the Entity pointed to
by EntPtr1 with "ABC"

The following commands now support entity pointers:
> LOAD(name|ptr|"ptr",num|"txt"|var|ptr,...);
> CALC(var|ptr,var|ptr,num|var|ptr,"op");
> TEXT(name|ptr,"txt"|var|ptr,...);
> IF(var|ptr op num|"txt"|var|ptr ? func|func_ptr : func|func_ptr);
> KEY(name,func|func_ptr,...);
> INT(name,buf,func|func_ptr,...);
> SHOW(name|ptr,...);
> HIDE(name|ptr,...);
> RUN(name|func_ptr,...);
> IMG(name|img_ptr,lib|img_ptr,...);

See the tu480.mnu file for an example of using pointers to update images representing CNTSECS.

23.00

 SHOW ;; HIDE - Added ';;' command to redraw current page

17 Aug 10 

Show

Added ';;' command to redraw current page
e.g. HIDE(Btn1);; same as HIDE(Btn1);SHOW(THIS_PAGE);

23.00

 Multiple SHOW HIDE - Multiple entities can now be handled in one command.

17 Aug 10 

Show

Multiple entities can now be handled in one command:
eg SHOW(Ent1,Ent2,Ent3 ... EntN);
eg HIDE(Ent1,Ent2,Ent3 ... EntN);
eg DEL(Ent1,Ent2,Ent3 ... EntN);
eg RESET(Ent1,Ent2,Ent3 ... EntN);
eg RUN(Func1,Func2,Func3 ... FuncN);
eg INC(File1,File2,File3 ... FileN);



Command HIDE
 
Description Hide a Page, Group or Entity.
If the page on which a small sized page, group or entity is placed is showing on the screen and the page refreshed, the named page, group or entity will disappear from view. Touch, external keys are disabled. 

HIDE(Entity1, Entity2, Entity3...);; multiple hide entities then refresh current page
 
Syntax/Parameters HIDE(Name)
 
Options HIDE(INT) - v49.03
Pending interrupts are now processed when an interrupt entity is unhidden.
All of the interrupts shown on the Int page are handled

HIDE() Groups of Entities - v49.51
Added array of pointer support to HIDE() commands.
This allows for groups of entities to be hidden on a page by passing the single name for the array of pointers.

VAR(group>"",PTR,3);
LOAD(group.0>"img1");
LOAD(group.1>"text1");
LOAD(group.2>"shape1");

HIDE(group);; // Hide img1, text1, shape1
 
Example INT( intRs2, RS2RXC, fncRs2Rx ); // Create RS2 receive interrupt
HIDE( intRs2 ); // Hide the interrupt
SHOW( intRs2 ); // Show (Enable) interrupt and process pending interrupts

If you don't want to process any pending interrupts when you show the interrupt then RESET the interrupt first 
INT( intTmr0, TIMER0, fncTmr0 ); // Create RS2 receive interrupt
HIDE( intTmr0 ); // Hide the interrupt
RESET( intTmr0 ); // Clear any pending interrupts
SHOW( intTmr0 ); // Show (Enable) interrupt for future interrupts
 
Update Information

 Version

 Title

Date  

 Details

49.51

 SHOW() and HIDE() Groups of Entities

18 Feb 14 

Show

Added array of pointer support to SHOW() and HIDE() commands.
This allows for groups of entities to be shown and hidden on a page by passing the single name for the array of pointers.

VAR(group>"",PTR,3);
LOAD(group.0>"img1");
LOAD(group.1>"text1");
LOAD(group.2>"shape1");

HIDE(group);; // Hide img1, text1, shape1
SHOW(group);; // Show img1, text1, shape1

Test code:

STYLE(stPage,PAGE){}
STYLE(stCirc1,DRAW){type=circle;col=white;width=1;back=red;}
STYLE(stCirc2,DRAW){type=circle;col=white;width=1;back=green;}
STYLE(stCirc3,DRAW){type=circle;col=white;width=1;back=blue;}
STYLE(stCirc4,DRAW){type=circle;col=white;width=1;back=yellow;}
STYLE(stText,TEXT){ maxRows=4; ySpace=4; }
STYLE(stBox,DRAW){type=box;col=lime;width=1;}

VAR(x,49,S32); VAR(y,49,S32);

PAGE(pgTest,stPage)
{
LOAD(x,49); LOAD(y,49); DRAW(circle1,80,stCirc1,x,y);
CALC(x,DISPX,50,"-"); LOAD(y,50); DRAW(circle2,60,stCirc2,x,y);
LOAD(x,90); CALC(y,DISPY,90,"-"); DRAW(circle3,150,stCirc3,x,y);
CALC(x,DISPX,70,"-"); CALC(y,DISPY,70,"-"); DRAW(circle4,100,stCirc4,x,y);

CALC(x,DISPX,2,1,"/-"); CALC(y,DISPY,2,1,"/-");
DRAW(box1,DISPX,DISPY,stBox,x,y);
TEXT(text1,"",stText,x,y);
KEY(key1,fncKey1,DISPX,DISPY,TOUCH,x,y);
}
LOAD(text1,
"Vers: ",VERS_IAPP,"\\0d\\0a",
"Width: ",DISPX,"px\\0d\\0a",
"Height: ",DISPY,"px\\0d\\0a",
"Rotate: ",DISPR,"deg"
);
SHOW(pgTest);

VAR(toggle,0,U8);
VAR(group>"",PTR,4);
LOAD(group.0>"circle1");
LOAD(group.1>"circle2");
LOAD(group.2>"circle3");
LOAD(group.3>"circle4");

FUNC(fncKey1)
{
//IF(toggle==0?[LOAD(toggle,1);HIDE(circle1,circle2,circle3,circle4);;]:[LOAD(toggle,0);SHOW(circle1,circle2,circle3,circle4);;]);
IF(toggle==0?[LOAD(toggle,1);HIDE(group);;]:[LOAD(toggle,0);SHOW(group);;]);
}

49.42

 Show/Hide of I/O Interrupts

06 Sep 13 

Show

* I/O interrupts are now handled the same as other interrupts therefore can now be enabled / disabled via the use of SHOW() / HIDE()

49.03

 HIDE / SHOW( INT ) - Pending interrupts are now processed when an interrupt entity is unhidden.

01 Jun 12 

Show

Pending interrupts are now processed when an interrupt entity is unhidden.
* The supported interrupts are RS2RXC, RS4RXC, AS1RXC, AS2RXC, DBGRXC, TWIRXC, SPIRXC, USBRXC, TIMER0..TIMER9
* Example
INT( intRs2, RS2RXC, fncRs2Rx ); // Create RS2 receive interrupt
...
HIDE( intRs2 ); // Hide the interrupt
...
SHOW( intRs2 ); // Show (Enable) interrupt and process pending interrupts
* If you don't want to process any pending interrupts when you show the interrupt then RESET the interrupt first
* Example
INT( intTmr0, TIMER0, fncTmr0 ); // Create RS2 receive interrupt
...
HIDE( intTmr0 ); // Hide the interrupt
...
RESET( intTmr0 ); // Clear any pending interrupts
SHOW( intTmr0 ); // Show (Enable) interrupt for future interrupts

27.00

 Entity Pointers - Entity pointers have been added.

10 Sep 10 

Show

Entity pointers have been added.
STYLE( PtrData, DATA ) { type = pointer; }
VAR( EntPtr1, PtrData );

To set/change which entity the entity pointer is pointing to you enclose its name in quotes.
LOAD( "EntPtr1", "Var1" ); // Set EntPtr1 to point to "Var1"

To access the entity pointed to by the entity pointer, do not enclose is quotes.
LOAD( EntPtr1, "ABC" ); // Load the Entity pointed to
by EntPtr1 with "ABC"

The following commands now support entity pointers:
> LOAD(name|ptr|"ptr",num|"txt"|var|ptr,...);
> CALC(var|ptr,var|ptr,num|var|ptr,"op");
> TEXT(name|ptr,"txt"|var|ptr,...);
> IF(var|ptr op num|"txt"|var|ptr ? func|func_ptr : func|func_ptr);
> KEY(name,func|func_ptr,...);
> INT(name,buf,func|func_ptr,...);
> SHOW(name|ptr,...);
> HIDE(name|ptr,...);
> RUN(name|func_ptr,...);
> IMG(name|img_ptr,lib|img_ptr,...);

See the tu480.mnu file for an example of using pointers to update images representing CNTSECS.

24.00

 INT - Used to receive data from other interfaces other than host.

25 Aug 10 

Show

Used to receive data from other interfaces other than host
This is currently set to interrupt on each character received.
Use HIDE(Name); to disable an interrupt.
Added INT( Name, Buffer, Function ); where 'Buffer' can be:
> RS2RXC = RS232 Receive Character
> RS4RXC = RS485 Receive Character
> AS1RXC = Async1 Receive Character
> AS2RXC = Async2 Receive Character
> DBGRXC = Debug Receive Character
> I2CRXC = I2C Receive Character

NOTE: The Buffer must be read to clear the interrupt otherwise the Function will keep getting called!
Interrupts for counters, transmit, I/O triggers are to follow.

23.00

 SHOW ;; HIDE - Added ';;' command to redraw current page

17 Aug 10 

Show

Added ';;' command to redraw current page
e.g. HIDE(Btn1);; same as HIDE(Btn1);SHOW(THIS_PAGE);

23.00

 Multiple SHOW HIDE - Multiple entities can now be handled in one command.

17 Aug 10 

Show

Multiple entities can now be handled in one command:
eg SHOW(Ent1,Ent2,Ent3 ... EntN);
eg HIDE(Ent1,Ent2,Ent3 ... EntN);
eg DEL(Ent1,Ent2,Ent3 ... EntN);
eg RESET(Ent1,Ent2,Ent3 ... EntN);
eg RUN(Func1,Func2,Func3 ... FuncN);
eg INC(File1,File2,File3 ... FileN);