Content-type: text/html Manpage of gui2bas

gui2bas

Section: GUI-File to X11-Basic converter (1)
Updated: 19-Sep-2004
Index Return to Main Contents
 

NAME

gui2bas - GUI-File to X11-Basic converter  

SYNOPSIS

gui2bas [ option ] <filename>

 

DESCRIPTION

X11-Basic is a dialect of the BASIC programming language with graphics capability that integrates features like shell scripting, cgi-Programming and full graphical visualisation into the easy to learn basic language on modern computers.

X11-Basic uses a graphical user interface (GUI) which is very similar to the ATARI ST TOS/GEM implementation. The *.gui file format, which is basically an ASCII representation of the ATARI ST recource files (*.rsc), can be converted to X11-Basic code, which then can handle message boxes and forms. For conversion of ATARI ST recource files to *.gui Files see rsc2gui(1).

gui2bas

can be used to make X11-Basic template programs out of gui Files, which represent the Object structure of the Graphical User Interface which is implemented into X11-Basic..

For a desciption of the X11-basic language and usage of the interpreter see xbasic(1).

 

The GUI file format

The *.gui file consists of Lines and Blocks which specify objects and their hirarchical dependencies.

The generic Format of such an object is:

label: TYPE(variables)

The label is optional and gives the object a name. Depending on TYPE of the object, one or more variables are given as a comma separated list in brackets.

Each Object may start a block with '{' at the end of the line. Inside this block there might be one or more objects given which then are considered as sub-objects of the one whichopened the block. The block will be closed by a '}' in a single line.

Example:

BOX(X=0,Y=0,W=74,H=14, FRAME=2, FRAMECOL=1, TEXTCOL=1, BGCOL=0, PATTERN=0, TEXTMODE=0, STATE=OUTLINED+) {
    BOXTEXT(X=2,Y=1,W=70,H=1, TEXT="Preferences ...", FONT=3, JUST=2, COLOR=4209, BORDER=65535, STATE=OUTLINED)
    STRING(X=2,Y=3,W=17,H=1, TEXT="Interface Device:", FONT=3, JUST=2, COLOR=4209)
    STRING(X=2,Y=4,W=7,H=1, TEXT="Breite:", FONT=3, JUST=2, COLOR=4209)
    STRING(X=2,Y=5,W=7,H=1, TEXT="Länge:", FONT=3, JUST=2, COLOR=4209)
    STRING(X=35,Y=4,W=7,H=1, TEXT="bis", FONT=3, JUST=2, COLOR=4209)
    STRING(X=35,Y=5,W=7,H=1, TEXT="bis", FONT=3, JUST=2, COLOR=4209)
  devtext: FTEXT(X=20,Y=3,W=30,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="/dev/ttyS0", PTMP="_______________________________________",PVALID="XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX", FLAGS=EDITABLE)
  br1:     FTEXT(X=20,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="N59:00:00.00", PTMP="____________",PVALID="XXXXXXXXXXXX", FLAGS=EDITABLE)
  br2:     FTEXT(X=40,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="N59:00:00.00", PTMP="____________",PVALID="XXXXXXXXXXXX", FLAGS=EDITABLE)
  lon1:    FTEXT(X=20,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="E009:00:00.00", PTMP="_____________",PVALID="XXXXXXXXXXXXX", FLAGS=EDITABLE)
  lon2:    FTEXT(X=40,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT="E009:00:00.00", PTMP="_____________",PVALID="XXXXXXXXXXXXX", FLAGS=EDITABLE)
  ok:      BUTTON(X=65,Y=4,W=7,H=4, TEXT="OK", FLAGS=SELECTABLE+DEFAULT+EXIT)
  cancel:  BUTTON(X=65,Y=9,W=7,H=4, TEXT="CANCEL", FLAGS=SELECTABLE+EXIT+LASTOB)
}
Comments are indicated by a '#' at the beginning of a line.

 

Filenames

gui2bas processes input files with extention .gui. The default output filename is b.bas.

 

OPTIONS

-o file
Place output in file file.

If you do not specify `-o', the default is to use `b.bas'

 

--version

shows version, program and other information and exits  

-h --help

print a short help

For detailed help and description of the implemented basic commands take a look at the README file.

 

EXAMPLES

gui2bas demo.gui
 produces an output file b.bas

 

The GUI File to X11-Basic converter

Actually this converter is not yet complete. Further improvenents may be applied in future.

 

VERSION

Page was created for V.1.11

 

BUG REPORTS

If you find a bug in the GUI-File to X11-Basic converter, you should report it. But first, you should make sure that it really is a bug, and that it appears in the latest version of the X11-Basic package that you have.

Once you have determined that a bug actually exists, mail a bug report to kollo@users.sourceforge.net. If you have a fix, you are welcome to mail that as well! Suggestions may be mailed to the x11-basic bug tracking system.

Comments and bug reports concerning this manual page should be directed to kollo@users.sourceforge.net.

 

AUTHOR

Markus Hoffmann <kollo@users.sourceforge.net>  

COPYRIGHT

Copyright (C) 1997-2004 Markus Hoffmann <kollo@users.sourceforge.net>

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

 

SEE ALSO

xbasic(1), rsc2gui(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
The GUI file format
Filenames
OPTIONS
--version
-h --help
EXAMPLES
The GUI File to X11-Basic converter
VERSION
BUG REPORTS
AUTHOR
COPYRIGHT
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 08:51:50 GMT, April 19, 2016