File Release Notes and Changelog
Release Name: 0.5a1
Notes:
What is rsrc2rcp?
-----------------
rsrc2rcp is a Perl script that takes a Codewarrior Constructor .rsrc
file as input and generates a PilRC .rcp file, along with a C .h file
and bitmap files. The generated files can then be used to build a Palm
application using PilRC and PRC-Tools.
Using rsrc2rcp
--------------
You must have Perl 5.0 and later in order to use rsrc2rcp.
The syntax for using rsrc2rcp is:
rsrc2rcp.pl [ -b | -p ] [ -F filename ] rsrc-file ...
where
-b Create bitmaps in Windows .bmp format
-p Create bitmaps in .pbitm text format (default)
-F filename Use "filename" to create .rcp and .h file instead
of resource filename.
Examples:
1. rsrc2rcp.pl myApp.rsrc
The following files are created:
myApp.rcp
myApp.h
myAppIcon.pbitm
myAppPict.pbitm
The .pbitm files are created only if ICON, tAIB or PICT resources exist
in myApp.rsrc
2. rsrc2rcp.pl -b myApp.rsrc
Same as above except myApp.bmp is created instead of myApp.pbitm
3. rsrc2rcp.pl -F bigApp myApp1.rsrc myApp2.rsrc
The following files are created:
bigApp.rcp
bigApp.h
...
Resources Handled by rsrc2rcp
-----------------------------
At the moment, only the following resource types are handled:
ICON, tAIN, tver, tTTL, tFRM, MBAR, MENU, tLBL, tFLD, Talt,
tSTR, tBTN, tPUL, tPUT, tLST, tCBX, tGSI, tPBN, tREP, tSCL,
tTBL, tGDT, tSLT, tSTL, tAIS, PICT (partial)
Other resource types can be added easily.
Bug Reporting
-------------
rsrc2rcp is still a work in progress. Some resource handlers may not have
been tested completely. Please report any bugs to me at the following email:
Alvin Koh
<alvinkoh@mac.com>
References
----------
Inside Macintosh - More Macintosh Toolbox, Apple Computer.
Palm OS SDK Reference, Palm Computing.
PilRC v2.7b User Manual
Source for NETPBM picttoppm, George Phillips <phillips@cs.ubc.ca>
Changes:
# Change Log:
#
# 21 Mar 2001 0.5a1 Alvin Koh <alvinkoh@mac.com>
# Support for PICT with packed bits.
#
# 10 Mar 2001 0.4a7 Alvin Koh <alvinkoh@mac.com>
# Support for tgpb
#
# 8 Mar 2001 0.4a6 Alvin Koh <alvinkoh@mac.com>
# Support for PICT with uncompressed and unpacked
# bits. Now we have an option of creating .bmp or
# .pbitm bitmap files.
# Added -b option to create .bmp file. .pbitm files
# are created by default.
# Process multiple resource files.
# Parsing of .rsrc file is now handled by the
# process_RSRC_File routine.
# Added handler for tAIS contributed by
# Olaf Dietsche <olaf.dietsche@gmx.net>.
#
# 6 Mar 2001 0.4a5 Alvin Koh <alvinkoh@mac.com>
# Fixed bug in tGDT and tSLT where resource count
# was not decremented as they were processed.
# Added back check for unhandled resources before
# program exit.
#
# 5 Mar 2001 0.4a4 Alvin Koh <alvinkoh@mac.com>
# Uncommented FORMBITMAP output command in tFBM.
# (Bitmaps still not handled though)
# Added check for " in strings and convert to \".
#
# 2 Mar 2001 0.4a3 Alvin Koh <alvinkoh@mac.com>
# Change interpretation of 0x0d in strings to
# '\r' instead of '\n'.
# BITMAP keyword for tFBM was omitted.
# Non-Boldframe was incorrectly handled.
# Fixed bug in tGDT handler where USABLE was
# always 0.
#
# 1 Mar 2001 0.4a2 Alvin Koh <alvinkoh@mac.com>
# Fixed bug in tGDT handler where gadget ID was
# used inadvertently used as top left origin.
# Added support for String Lists (tSTL).
#
# 26 Feb 2001 0.4a1 Alvin Koh <alvinkoh@mac.com>
# Implemented a process dispatcher by using the
# AUTOLOAD subroutine to handle any undefined
# process_XXXX routines.
# Added support for tGDT and tSLT.
# Added check for MacOS resource fork.
#
# 24 Feb 2001 0.3a1 Alvin Koh <alvinkoh@mac.com>
# Modified code to provide more info about resources
# that rsrc2rcp did not handle.
#
# 23 Feb 2001 0.2a1 Alvin Koh <alvinkoh@mac.com>
# Added support for tBTN, tPUL, tPUT, tLST, tCBX,
# tGSI, tPBN, tREP, tSCL, tTBL, tFBM.
#
# 22 Feb 2001 0.1a1 Alvin Koh <alvinkoh@mac.com>
# Support for ICON, tAIN, tver, tTTL, tFRM, MBAR,
# MENU, tLBL, tFLD, Talt, tSTR.
#
