gui2bas.1.html 7.42 KB
Newer Older
kollo committed
1 2 3 4 5 6 7 8 9 10 11
Content-type: text/html

<HTML><HEAD><TITLE>Manpage of gui2bas</TITLE>
</HEAD><BODY>
<H1>gui2bas</H1>
Section: GUI-File to X11-Basic converter (1)<BR>Updated: 19-Sep-2004<BR><A HREF="#index">Index</A>
<A HREF="http://localhost/cgi-bin/man/man2html">Return to Main Contents</A><HR>

<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>

kollo committed
12
gui2bas - GUI-File to X11-Basic converter
kollo committed
13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>

<B>gui2bas</B>

[ <I>option</I> ] <I>&lt;filename&gt;</I>

<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>

<P>
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.
<P>
kollo committed
30 31 32 33 34
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
kollo committed
35 36 37 38 39
<I><A HREF="http://localhost/cgi-bin/man/man2html?1+rsc2gui">rsc2gui</A>(1).</I>

<P>
<I>gui2bas</I>

kollo committed
40
<P>
kollo committed
41
can be used to make X11-Basic template programs out of gui Files, which
kollo committed
42
represent the Object structure of the Graphical User Interface which is
kollo committed
43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60
implemented into X11-Basic..
<P>
<B>For a desciption of the X11-basic language and usage of the interpreter see</B>

<I><A HREF="http://localhost/cgi-bin/man/man2html?1+xbasic">xbasic</A>(1).</I>

<P>
<A NAME="lbAE">&nbsp;</A>
<H2>The GUI file format</H2>

<P>
The *.gui file consists of Lines and Blocks which specify objects and their 
hirarchical dependencies.
<P>
The generic Format of such an object is:
<P>
label: TYPE(variables)
<P>
kollo committed
61 62
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. 
kollo committed
63
<P>
kollo committed
64 65 66 67
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.
kollo committed
68 69 70 71 72 73 74 75 76 77 78 79
<P>
Example:
<P>
<PRE>
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=&quot;Preferences ...&quot;, FONT=3, JUST=2, COLOR=4209, BORDER=65535, STATE=OUTLINED)
    STRING(X=2,Y=3,W=17,H=1, TEXT=&quot;Interface Device:&quot;, FONT=3, JUST=2, COLOR=4209)
    STRING(X=2,Y=4,W=7,H=1, TEXT=&quot;Breite:&quot;, FONT=3, JUST=2, COLOR=4209)
    STRING(X=2,Y=5,W=7,H=1, TEXT=&quot;L&#228;nge:&quot;, FONT=3, JUST=2, COLOR=4209)
    STRING(X=35,Y=4,W=7,H=1, TEXT=&quot;bis&quot;, FONT=3, JUST=2, COLOR=4209)
    STRING(X=35,Y=5,W=7,H=1, TEXT=&quot;bis&quot;, FONT=3, JUST=2, COLOR=4209)
  devtext: FTEXT(X=20,Y=3,W=30,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT=&quot;/dev/ttyS0&quot;, PTMP=&quot;_______________________________________&quot;,PVALID=&quot;XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX&quot;, FLAGS=EDITABLE)
kollo committed
80 81 82 83 84 85
  br1:     FTEXT(X=20,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT=&quot;N59:00:00.00&quot;, PTMP=&quot;____________&quot;,PVALID=&quot;XXXXXXXXXXXX&quot;, FLAGS=EDITABLE)
  br2:     FTEXT(X=40,Y=4,W=12,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT=&quot;N59:00:00.00&quot;, PTMP=&quot;____________&quot;,PVALID=&quot;XXXXXXXXXXXX&quot;, FLAGS=EDITABLE)
  lon1:    FTEXT(X=20,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT=&quot;E009:00:00.00&quot;, PTMP=&quot;_____________&quot;,PVALID=&quot;XXXXXXXXXXXXX&quot;, FLAGS=EDITABLE)
  lon2:    FTEXT(X=40,Y=5,W=13,H=1,COLOR=4513,FONT=3,BORDER=1,TEXT=&quot;E009:00:00.00&quot;, PTMP=&quot;_____________&quot;,PVALID=&quot;XXXXXXXXXXXXX&quot;, FLAGS=EDITABLE)
  ok:      BUTTON(X=65,Y=4,W=7,H=4, TEXT=&quot;OK&quot;, FLAGS=SELECTABLE+DEFAULT+EXIT)
  cancel:  BUTTON(X=65,Y=9,W=7,H=4, TEXT=&quot;CANCEL&quot;, FLAGS=SELECTABLE+EXIT+LASTOB)
kollo committed
86 87 88 89 90 91 92 93 94
}
</PRE>

Comments are indicated by a '#' at the beginning of a line.
<P>
<A NAME="lbAF">&nbsp;</A>
<H2>Filenames</H2>

<P>
kollo committed
95 96
gui2bas processes input files with extention .gui. The default output filename
is b.bas.
kollo committed
97 98 99 100 101 102 103 104
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>OPTIONS</H2>

<DL COMPACT>
<DT><B>-o </B><I>file</I>

<DD>
kollo committed
105
Place output in file <I>file</I>. 
kollo committed
106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
<P>

If you do not specify `<B>-o</B>', the default is to use
`<B>b.bas</B>'
<P>
</DL>
<A NAME="lbAH">&nbsp;</A>
<H3>--version</H3>

shows version, program and other information and exits
<A NAME="lbAI">&nbsp;</A>
<H3>-h --help</H3>

print a short help
<P>
kollo committed
121 122
For detailed help and description of the implemented basic commands take a look
at the README file. 
kollo committed
123 124 125 126 127 128 129
<P>
<P>
<A NAME="lbAJ">&nbsp;</A>
<H2>EXAMPLES</H2>

<PRE>
gui2bas demo.gui
kollo committed
130
 produces an output file b.bas
kollo committed
131 132 133 134 135 136 137 138 139 140 141 142 143 144

</PRE>

<P>
<A NAME="lbAK">&nbsp;</A>
<H2>The GUI File to X11-Basic converter</H2>

Actually this converter is not yet complete. Further improvenents may 
be applied in future. 
<P>
<A NAME="lbAL">&nbsp;</A>
<H2>VERSION</H2>

Page was created for V.1.11
kollo committed
145
<P>
kollo committed
146 147 148 149
<A NAME="lbAM">&nbsp;</A>
<H2>BUG REPORTS</H2>

<P>
kollo committed
150 151 152
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.
kollo committed
153
<P>
kollo committed
154 155 156 157 158 159
Once you have determined that a bug actually exists, mail a bug report to
<A HREF="mailto:kollo@users.sourceforge.net">kollo@users.sourceforge.net</A>. If you have a fix, you are welcome to mail that as
well! Suggestions may be mailed to the x11-basic bug tracking system.
<P>
Comments and bug reports concerning this manual page should be directed to
<A HREF="mailto:kollo@users.sourceforge.net">kollo@users.sourceforge.net</A>.
kollo committed
160 161 162 163 164
<P>
<A NAME="lbAN">&nbsp;</A>
<H2>AUTHOR</H2>

Markus Hoffmann &lt;<A HREF="mailto:kollo@users.sourceforge.net">kollo@users.sourceforge.net</A>&gt;
kollo committed
165
<A NAME="lbAO">&nbsp;</A>
kollo committed
166 167 168 169
<H2>COPYRIGHT</H2>

Copyright (C) 1997-2004 Markus Hoffmann &lt;<A HREF="mailto:kollo@users.sourceforge.net">kollo@users.sourceforge.net</A>&gt;
<P>
kollo committed
170 171 172 173 174 175 176 177 178 179
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.
<P>
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.
<P>
<A NAME="lbAP">&nbsp;</A>
kollo committed
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201
<H2>SEE ALSO</H2>

<A HREF="http://localhost/cgi-bin/man/man2html?1+xbasic">xbasic</A>(1), <A HREF="http://localhost/cgi-bin/man/man2html?1+rsc2gui">rsc2gui</A>(1)
<P>

<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT><A HREF="#lbAB">NAME</A><DD>
<DT><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT><A HREF="#lbAE">The GUI file format</A><DD>
<DT><A HREF="#lbAF">Filenames</A><DD>
<DT><A HREF="#lbAG">OPTIONS</A><DD>
<DL>
<DT><A HREF="#lbAH">--version</A><DD>
<DT><A HREF="#lbAI">-h --help</A><DD>
</DL>
<DT><A HREF="#lbAJ">EXAMPLES</A><DD>
<DT><A HREF="#lbAK">The GUI File to X11-Basic converter</A><DD>
<DT><A HREF="#lbAL">VERSION</A><DD>
<DT><A HREF="#lbAM">BUG REPORTS</A><DD>
kollo committed
202 203 204
<DT><A HREF="#lbAN">AUTHOR</A><DD>
<DT><A HREF="#lbAO">COPYRIGHT</A><DD>
<DT><A HREF="#lbAP">SEE ALSO</A><DD>
kollo committed
205 206 207 208 209
</DL>
<HR>
This document was created by
<A HREF="http://localhost/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
kollo committed
210
Time: 08:51:50 GMT, April 19, 2016
kollo committed
211 212
</BODY>
</HTML>