These files were taken from the WExtras class, package wababin Copyright 1999-2001 Rob Nielsen Enhanced by Guilherme Campos Hazan for SuperWaba 2 and 3 To learn how to compile your applications using them, please see the make.bat files at the examples directory. There are 4 callable files in this directory: . warp - pachages your class files into a pdb . exegen - creates an "executable" file that calls the vm inside the device . RenameFont - renames a font pdb file so it fits in the SuperWaba Font-Name Pattern. . Wxgn - calls warp and exegen with one only command @@@@@@@@@@@@@@@@@@@@@@@@@ Warp Instructions @@@@@@@@@@@@@@@@@@@@@@@@@ Usage: java Warp command [options] warpfile [files] Commands (case insensitive): c Create new warp file l List contents of a warp file Options (case insensitive): /? Displays usage text /c Override and assign PDB database creator (e.g. /c CrTr) /r If a directory is specified in the files, recurse any subdirs /q Quiet mode (no output except for errors) /$ Set the Palm OS copy protection attribute /x Specify a list of package/class names whose classes won't be added. You can specify a list without spaces as 'class1,class2/,package1,...' . The files whose full package name starts with the given string . The files whose class name starts with the given string . If string ends with \, only the whole class name is used for compare E.g.: /x extra,jgui.sio.server,NativeMethods4JDK,Graphics\ -> packages extra.* and jgui.sio.server are excluded, -> all class names starting with NativeMethods4JDK are excluded, -> Graphics class is excluded (but GraphicsNat is included) /i Specify a list of package/class names whose classes will be the only ones that will be included. The opposite of /x option. /ll Specify that this file will be a SuperWaba Local Extension Library. /lg Specify that this file will be a SuperWaba Global Extension Library. This program creates a .pdb file, used in all SuperWaba platforms. The creator will be generated automatically from the name of the pdb file if not overridden with the /c option. The input file can be a Jar (in this case, all .class and .bmp files in the jar will be added). Warp will automatically check any class files for dependencies and add these files so you will only need to specify the main class file and everything else will be added automatically, even directly referenced .bmp files. (ie. Image im=new Image("rob.bmp) If no input files are specified, it will look for a .class file with the same name of the pdb file you are creating. Examples: java Warp c HelloApp java Warp c /c Crea HelloApp helloapp.jar java Warp c helloApp *.class util\\*.class java Warp c /r helloApp extra\\ java Warp c /lg wextrasLib *.class extra\\ java Warp l helloApp.pdb @@@@@@@@@@@@@@@@@@@@@@@@@ Exegen instructions @@@@@@@@@@@@@@@@@@@@@@@@@ Usage: java Exegen [options] exefile [main-window-class] [pdbfile] Options (case insensitive): /? Displays usage text /$ Turns on the PalmOS copy protection attribute /C Override and assign PDB creator (e.g. /c CrTr) /H Assign height of application's main window /W Assign width of application's main window /P Subdirectory name for the application under Windows CE. Note that in SuperWaba all applications stay under SuperWaba at '\SuperWaba' Spaces, /, \ and " in the directory name are not alowed. /V Assign the version for the application /Z Creates CAB installation files to deploy your application /E generates .exe files for Windows CE and Pocket PC. /L generates .lnk file for Windows CE and Pocket PC. /I Specifies the icon PREFIX. This program generates a Palm OS .prc and Windows CE application .exe files These executables are used to launch (start up) a SuperWaba program. If you don't specify the pdb file, its name will be the same of the exefile. If you don't specify the [main-window-class], its name will be the same of the exefile too File extensions are generated automatically. For example, if you specify myapp as the exefile, a myapp.exe and myapp.prc will be created. The /W and /H parameters define the default width and height of the application's window. The value of 0 for either will cause the main window to appear at a default size which is different on each platform. If no icon is defined, a default is one used. Icons are scanned first in the current directory, next in the classpath. You may provide the following files (WIDTHxHEIGHTxBPP): icon15x9x1.bmp, icon15x9x8.bmp, icon16x16x4.bmp, icon22x22x1.bmp, icon22x22x8.bmp, icon32x32x1.bmp, icon32x32x4.bmp, icon32x32x8.bmp, icon48x48x8.bmp. If you specify a prefix (E.g.: AAAA), the searched files will be AAAAicon22x22x8.bmp, etc. The 15x9 and 22x22 are for Palm OS and the others for Windows CE. Note that for Palm OS you must create bitmaps with the web-safe-palette. A gif with this palette is located under /superwaba/examples For Windows CE, the palette CANNOT BE THE WEBSAFE one. This happens because in the Web safe palette, index 0 is white, and WinCE devices expect that index 0 will be black. A warning will be issued if you use an incorrect palette when generating the exe files for WinCE. To correct this problem, you may use any image editor to increase the image to 16bpp or more and then decrease it again to 256 colors and save the image. Most editors don't use the web safe palette, what will correct the problem. A PalmOS PRC creator and PRC name will be assigned based on the class name and exefile respectively. The exefile must be 30 characters or less. The /Z parameter is used to create eight cab files so your application can easily be installed in all compatible Windows CE platforms. You may pass, optionally, a .swz file with some global and local libraries used by your app. For example, if you need to install the TinyLarge.pdb font and also a custom database, E.g. mydata.pdb, you must copy all files to the current directory, then create a myapp.swz file with the following contents: [G]TinyLarge.pdb [L]mydata.pdb The [G] denotes a global library (fonts are always global libraries), and the [L] denotes a local library. The user will then have two options to start the installation process: 1. Run the created xxx_install.bat file, or 2. If the cab files are available in the internet, the user may launch the browser from inside the device, connect to the site and choose the appropriate cab file. The browser will then download and install the file. The /Z parameter works on in the Windows platform. Examples: java Exegen /I myicons.ico /P Scribble scribble java Exegen /W 160 /H 160 Calc CalcWindow calc java Exegen /Z SWCalc.swz SWCalc @@@@@@@@@@@@@@@@@@@@@@@@@ RenameFont instructions @@@@@@@@@@@@@@@@@@@@@@@@@ Usage: RenameFont Please dont append the .pdb extension to the font names. Note that the original files are preserved. @@@@@@@@@@@@@@@@@@@@@@@@@ Wxgn instructions @@@@@@@@@@@@@@@@@@@@@@@@@ Usage: java Wxgn Warp_commands z Exegen_commands Note that z is the separator