[net.micro.atari16] Rcs V1 bug list

bammi@cwruecmp.UUCP (Jwahar R. Bammi) (09/30/86)

#!/bin/sh
# This is a shell archive, meaning:
# 1. Remove everything above the #!/bin/sh line.
# 2. Save the resulting text in a file.
# 3. Execute the file with /bin/sh (not csh) to create the files:
#	rsbug.not
# This archive created: Tue Sep 30 02:52:33 1986
# By:	Jwahar R. Bammi ()
export PATH; PATH=/bin:$PATH
echo shar: extracting "'rsbug.not'" '(2668 characters)'
if test -f 'rsbug.not'
then
	echo shar: over-writing existing file "'rsbug.not'"
fi
sed 's/^X//' << \SHAR_EOF > 'rsbug.not'
X		Bugs in the ST Resource Construction Set
X
XThe RCS originally shipped with the Atari Developers' Kit did not receive
Xadequate testing, and as a result contains a number of bugs, two of which
Xare show stoppers.  Due to numerous questions on the SIG, and Tom Hudson's
Xsuggestion, I am documenting them here.  (The statements here are my
Xown, and have nothing to with Atari or DRI.  Use them at your own risk.)
X
XBug #1)  The RCS does not work properly with color systems.  The character
Xsize used is incorrect, resulting in objects which are twice as high as
Xintended.  The only solution is to use the RCS with a monochrome system only.
X
XBug #2)  When using icons or bit images, the RCS may produce a resource file
Xwhich causes an address error on the 68000.  This occurs because the RCS
Xis not forcing the images to an even byte boundary.  Since the images are
Xwritten immediately after strings, any resource with an odd number of bytes
Xin the string will suffer from this problem (if it contains images as well).
XTo work around: make a copy of the resource BEFORE adding ANY images.
XThen add the images and attempt to save the resource from the RCS.  If you
Xget an error, restore from your backup, add one byte to any string, and try
Xagain.  Whenever editing ANY string, do the same thing.  ALWAYS keep a
Xbackup copy!  By the time the RCS bombs, your resource is history!
X
X"Feature" #3)  The icon format expected by the RCS is rather obscure,
Xshall we say.  This happened because the RCS expects to find icons written
Xby the GEM IconEditor, which was never ported to the ST.  If you want to
X"roll your own", an example of the correct format follows.  You may change
Xthe hex size values, and add or subtract data lines to suit.  You must
Xmaintain the EXACT format of the data lines.  Easiest place to go wrong:
Xthere is one and ONLY one padding blank at the end of each of the hexadecimal
Xdata lines.  It's important!
X
X/* GEM Icon Definition: */
X#define ICON_W 0x0030
X#define ICON_H 0x0018
X#define DATASIZE 0x0048
XUWORD clock[DATASIZE] =
X{ 0x0000, 0x0000, 0x0000, 0x0000, 
X  0x3FFC, 0x0000, 0x000F, 0xC003, 
X  0xF000, 0x0078, 0x0180, 0x1E00, 
X  0x0180, 0x0180, 0x0180, 0x0603, 
X  0x0180, 0xC060, 0x1C00, 0x0006, 
X  0x0038, 0x3000, 0x018C, 0x000C, 
X  0x60C0, 0x0198, 0x0306, 0x6000, 
X  0x01B0, 0x0006, 0x4000, 0x01E0, 
X  0x0002, 0xC000, 0x01C0, 0x0003, 
X  0xCFC0, 0x0180, 0x03F3, 0xC000, 
X  0x0000, 0x0003, 0x4000, 0x0000, 
X  0x0002, 0x6000, 0x0000, 0x0006, 
X  0x60C0, 0x0000, 0x0306, 0x3000, 
X  0x0000, 0x000C, 0x1C00, 0x0000, 
X  0x0038, 0x0603, 0x0180, 0xC060, 
X  0x0180, 0x0180, 0x0180, 0x0078, 
X  0x0180, 0x1E00, 0x000F, 0xC003, 
X  0xF000, 0x0000, 0x3FFC, 0x0000
X};
SHAR_EOF
if test 2668 -ne "`wc -c 'rsbug.not'`"
then
	echo shar: error transmitting "'rsbug.not'" '(should have been 2668 characters)'
fi
#	End of shell archive
exit 0
-- 
usenet: .....!decvax!cwruecmp!bammi		jwahar r. bammi
csnet:       bammi@case
arpa:        bammi%case@csnet-relay
compuServe:  71515,155