ENSE AGnEEMENr

'LrA~r nlA" III" DOtU"!H' CAnHULLY "flonr 5......... dl,,' " n .lU·JQI J. M",,'td_l Arr'" C...,..eer.
Ot(tiIlCl till PAUAO'.. If orE"'UG TillE 'AtKAO£. ih: .. 101l'lM .. II'" A..,. .. C"J""I1.... C"........ "Ot4.
TOU AM AOAElItfO TO BEcoME ROUND 'n rut un"" If "''' AM'I~ SIOh ... _
0, II"' AOnEl.HI. "'litH IHCllJllr ml SOfI"Anr
LICIHSf AND III!CLAIMIA Of "A"MHIY. If IOU 1)0
o.w.._ ........ ""'" " fit'' ' ' ,_ ,.......... _ ... ,..,
... ..". . . . . """. a (J1A 5.",..,..... ...

... ,""' ... Jr. ......... '""" "" SIIh ............ _ ...... thIt II
HO' AGnn '0 "'lllnMS Of' flU AOAUNt"', DO Nor ,....."...,. ,_ ,..uof.1re ""1M .. _-"....... t-.rpt-
.. ,.,. lee t.d~ ,.."..,..., ....
orEN 111( 'ACfI,MI. ,,,(JAPflY AEnnel",:: UUOI'(H(D
,,,r.KAOI '0 fl. PlACl WillA' rou OllNHU If FOR A
II lNe ..... _ _ ..... OIftNeA"'.. !eI._.,,~"""
..., , • ..,.· ...... •... _ ... • .... Atfkc-.--....
...
'UlL AEfIlIll.
H • ... '_A .....,...'tf ,._IH
.......,c·"w. J"n ..... ·' "'~""'. _ 1) U...... 'nff~."" . . - ........ ~ .... "" .............
"~', .., ,.... f., ......., . """" .., .10 ,,,''''''''''. --e "(14' Iotitlt,'"' .""' .... ".""10..6:..... ...... APPLE
K ...... ...,. -Ith,....,. .. ,.,.,ot, ,'Irt"'. Ie , .... ' " I""" "'" 1Wl_ J) If .......... Arr" """._ ".~;"-4"'" ~
'(oO""' ...... ......"'". PROGRAMMER'S &
• "'.11 h AfT'" !I .. h.,,. II .1,'-11, {It " " " " " " " ' ' ' , ......... ,t ..
II.~ ..... An-'- "',..... ~., "'1M .,."It. fIf . . Ant. 5.. " . . ..
'1""" ........... ,..~ ..I .._II __
... ............ 11t,t........... fI_, ..
~
N\p ....... ,.Io.e .... . .
"OI'_If. MIo.e .. Ani" 0...,.."......
t.,.,.,h-.",..
-rrtl',... ..
~"' ........... ... DEVELOPER'S
1. 1.' , .... , l ........... .n.... ,,....w.
l'II! ..
ASSOCIATION
••
~ 1J1It,.,An'I~""·_.,.."_ Io..""An't c....,.... Y"lmlif
of........ "11'Jt"'"'t.? ,"-- fn .... "",,8 ....... ,.. ",. h A.,....
W .. _ ... ~d"'" • ..,. _,IItoN, "",lIr" tmln' ~I""
• o..n 1_.....,.
(\,"",,"~"hf ~ltl "Ire tt.b An"- So" .. _ • .v.... ...... ......

IhII A"... ~e"

(11 (1~A St"'''• • "" Itt ..., o:w _1_ ....... '"
&t"!+:C'''N ... ktknI ... _ .. _ ••
... 1", ("""r"'" ... t.~. . . . ."'., .. , _ .... "'.w.. _ .. ~""""lJ'f'flr..... "'-.

til ~""""''''"'
• . • ",,'-'"tot ",W• .,."l,. nll,,"'~ S(J' rWAt:lU I~ mOV,Jf1D
M.\e _ ",", til . . Arrk lI.. " .... r.. midi_ ..... . t.l. r,,"" ·AS IS" "rnlOUl "Ak"""" JY or Al4'r ,1.1"").
e",n!k
"hi, r", Mo .... ,..,.... • . , ... AnI- !I~ ...... "......tled t.,- un~n~s OR IMlt.lr1).lHctJ.roItlCl WIIIIOUT UMU A110"
U"',"'J""'I~"I"'., ••. ,,,."' ...
~~ ....d.u'T ..
A"b ..'I"T' .... !W:lllb .... ..,.,.,.,.,.....,..il'-J .. ~.... _ _
A"T "AIil.MPHT "UIlkP.5f"f!Cf TO liS Mf!1II:(lIA~'·
AnIl.nT ~ In ""~P.JS .·OR AN' rMTk:\n.Ak rua·
...... " 1.",, "tT .
f, ..,d.n,.." ..........
,._,~. tI. A"... ,.".".,. .,... II 'lthtto .,..... , ..1. I~"" .. '"
I"'.,~ ....... A,, _ _ ptr"lduJ I~
MP.~ lfm '. ~IIM ftl~k AS 10 lilt qclAI.nr Armn",.
""'-MAflot (w mil Anu SOI""''''A'''' n "1111 YOO •
SlKMJJ 111111: AI'1J1S0nWAItII mow •. orIlT:.CIIV,\ TI'"
.1.. Artf"' ." __ ke .., •••_In .. 01.."' ......... ,...","'&.,., (AtfO ~o, AM'." OIl!. A~ 11.1'1.11 Aum01Un'.n 1iI.".I"MII·
• ...... ,"' ... ...". .... _ ... , ... "" .... .rf .... A....-... St!"'AlIYe, Aunt-I1,Irn 'J'ffJlllft (."OS, Of' AU. t/fttt,.
dJ c.... n....... ArT'- ,,,,,, .. _ ,.., , .............. '" .....n". til ,t\IiI.Y SfJtvKJtlO.Iil.FrAM OR COfUUI.c noH•
... _ ,............... " .............. ..,........... 1_.
"'".e DOf!~ "U, "AIII:fII:AI#' ttlATllm nlJ'fC1lUt1~ CO"·
1. 1iI.,.,,"' ........ T~~1 ..... & ..........
1>'11 ......... 1" .......kIW,
tJOT¥.eI ... AJT'e~..tI .. _ ...
s.."" ...
.... ft,o .... A"...
,....,._.101"' ...... _ ••1.."' •. 'toeA"".! ........ ~ ...
. . . ., 1'1" .... " 1M ~ ....... r~'d h,..,... _, .... ~"'"
f •. - _
TAIHf:D I" ll1n A'''''''' SonWAII:" "IU . ... ,·,u YOU"
"1 !QlIII\I'.Mr~I' f)IIIl.lA, l1IHOfUA.1Ott nrl''',,"l''
S(JnwMi! ,..."J.....
UJ'fIHI EftIll:UI'I1!DOft 1'1\AtM: 'ft'aiOW
,IIAl nCfF.Cn I" 11111 Arru son"MIi " U I I
OJUl:OC'EI>.
Apple IIGS
Demo
......" .. ""111.-,. "1I"",fllNl "' ",1.... 1", - ' _ 1M An-"
5."' •• .,- ", t..-rr_h .... ~ ....... T01' MAr NOT MI.Jl.' T. Sn"", UA1U 00 ffflT AUn'" tlln P.Jta.US,U" or I""
AI'Arr, • RAHJlAII!. IIP."'. tM!I!. WAH. Iil.r!YJ .1. f'OtIt ".mn "A"-"A"''' I~. so T1I8 AIH>V" eJ(Q.USfO" MAr
tRl" " . f)l~"'mv",.. ~IiIWOfI.K"" C'RP.A.ftOl:'UVA11V1I
""O'Ut~ 'AS'V Uf'Qrt 111" AnUl SOI" "A"" ~ A"T
""It Am.T TO 'OU. III1S "AIII:RA"IY (IIYB' YOU

Sampler
Sf'fClllC I.mAI. "1(;1115 A"D 'OU MAT AI..SO IIAVI
rAIU "",1mOf"'. olln~ "fGIIIS WlIKlf VAltT '''OM S,A.1I10I1AII ·
S. 1,,,..,,,.1,","- 11o .. U _ .. ,.tJr.;, ............"',*A. 1'h.. t~
• ., ktrooh," ..'....,.'1...", .~'" ..... I~ lml A".I.lf "'. 1.1 '"
,. U ...bl_", III:not"dl., .... "'_1"0
Il'I J'fQ ftVI!HT "'J~ AJl1Jt
Inl. UAAtIIl (I, 10 TOU '0lIl: ANY IHClon~IA' .. CON·
_. . "'.It", ... A"... Son."". Mol tit ,,"'ft.... r~_,
~ ..... -
t.,..
,-,.1, .11"""1 potWItlon J "'" L'"'".... v,.... _""I...tlkM ,.,.
.... 1.'"- ..., ... .., • ...,In.1M Ani' ,." .. _
S~Q"fl" riAL n" .,mUlncr DA",AOII! CI~ct .UDI,",
DMfAtIP..s 1'0" 1.051 Of' IIU~ltnU~ ntOfTTS. IIUSI'IRSS
f'I'FIII:Mn'1 kJ~ . I.OlI~ OfT IU~IHB..' .' IM'lJRMA1"Ht, AHD
ltllfll.llH!) AAISINCI oVl' OPl'''' U.UI. Of' OIil.IHAII1I1.JI' 10
.t .
.......11 """''''''',"""
r"r--'I ... A, _ _ T............... v.tI., ...
..u...... AnI- u~" NIT ""n.n
SOfTWA"R IYIlH I' AWlA OR A~Y
AUlllORt7J'J) AI"'~ a.r:l'A:lt\"~tAlIVIIIlAS III"" AI).. Version 1.2
5...' ...... "'. '"'I 'kd,.......~ ..... ~, .. .., .... " ... toe "';" ••
...... r. .... " .... 1ft.,.,... . "hIli, '" Irrlhflf,. ......", f O'''''' vlSln or nm ro5~UA'tJfY Of' SIIOI DAMA(JR!. 01. t_
...-. to, .... "".... ..,.,'
p M"''''_'' ~ 11,,-.., A,",,"bln1~ Ac' .... It. ('{)III: Al'ITO.AIM liT NIT 0110 rAAIY.
.......... - tt-. ......... '" ,d'• .,. r~ ".-oNbht,"r lI',r.AUJt! SOMl!. STA'"F~' 00 tfOT AI'.oWnlR VCU..IJS1Ott
0fII ",M'TA no~ (Jr LIA"I.f'T I~ C()"I'U~.mH1 VtI. OR
, • • Ior«t • ...,..", r.... ,,..,., n1111. A,or'e 50""_,, .... hit., tit flit 1t4C,O"JflAL DAMAORS. n_ AIOVIUMIIA,1lJt>I1 fMY APDAfl K2SGSD
"'.... f.r .... It tit 'P''''I ... h U,,'-4 !hlllt' Oo... ~ .... Nor Ant. T 10 TOU.
f'"I''""" ,"".. ,. "'II ~ 'of'I"'''''1 C.., .... &"I!I'tot ... "",,,',n.".,., lit ,... ... lItlfIII ..... ~ , . IItJ ~ .,,_ _•
r-"'IP. t'r"_. ...., .... ,. .. ef" .. " ""r--'
"''''''tot'' """._,-.., ............."••, ".... ,.. ..... 1t'......11 J., 11...",-, .....
h,.I,. , .... Ito, ...., _,.., A"... I" .n
ef"" ... _", ... A«.«) 1I·,.. _odflll~ .. oft"",,· ...
eI .....·... rol_
bfr:"" eI UO .... _'1:, r-u ..,.
!;he Atyll Jotl._ .... ,lid . .
Ie .......""

domt ...............bfr-d _1Wf "'• • II .... , ---"ta, . .

u.""""
I.... "'" " ... ., .... -. ,....."".... "_ k:t---.. If_ .. ~ .. . " U_.'k*"'.
~ .... t _• ......:"I ...... Itr 1M fli .. lilt ... ~Eh" rf'l"'ill'" & ..
..."....... ".~""'A~~.tr.:-. t . Ct""al 1"" At,....,mHIt _il.., C_MJ,.'" tI. h.t '" "-
Ih_ Coot"""",... ,..,,,,,.. """' ..... , .,1,•• ofIrI, ... i." """If."
I'....... lO' .... .,....,.,... ... '"
....."tot', .hI. ·R""'~.. ' R~"'" "1M
"",_t"'''',lit"""
"'" .t.r.....J""" ....."
A.,....
eI
eI ...... "..."r-"...... IMIoA• • ..-.ef
..,....,....'-""'Iw:~"r

D..., 5• .,..... ........

lon (")(l) (U,-,
'0'" r~ A,.,.hhl.,it R~.",,_, nUl.
tJ. '"""1"''""1 )-b!tk,!m..," "'""It, 18).... ... p ... &tw-. "II '"
"' ... "'" ..... ~ • ......,.. IlIItnI ,.".""It>,... _ .,.,.Ikd.
... "'-"*'r:
I~."'''' lr l' '' '''' ...td"" ........l1r'I'.. " ..... t,_ •.toe;I ,...,,, ... rtr"111_ ef ..... A~_"I .. II ~ .. hl1 , _

..... N.. ~ (tt,." (I, "',.111:,,,* _."dtool" bIo•••"" C"" ... '" """
) )
 
 Apple IIGS Demo Disk
January 6, 1987

The Apple IIGS Demo Sampler, written by members of : ~, e Apple II System

Software and Technical Communications groups , is a c: ,l ection of programs
that demonstrate most of the advanced features of the A:ple IIGS, including
menus , windows, sound, desk accessories, color, 320 a ~d 640 resolution,
graphics special effects, and printing .

These programs do not claim to be complete or bug free . but do demonstrate

some basic programming principles on the GS. They s ~ ::: uld be examined in
conjunction with the other documentation available from APDA.

Four disks are included : IDEMO.DISK, IDEMO.DATA, /SRC1, and ISRC2.

IDEMO.DISK is the startup disk and contains eight dem:nstration applications.
The IDEMO.DATA disk contains over 20 picture files for use with the Slide
Show demo and Color Dabbler on the first disk. ISRC1 and ISRC2 contain
much of the APW source code for the applications included on the first disk.

The Demo System is entirely self-contained; there is no need for a System Disk
or any other support programs. Please note that the required system
configuration is:

• Apple IIGS Memory Expansion Card with one megabyte RAM

• Two Apple 3.5 or UniDisk 3.5 drives connected to the SmartPort
• Apple IIGS mouse

To start the demo, place IDEMO.DISK in drive 1 and IDEMO.DATA in drive 2;

start the machine from slot 5. After a moment, a dialog box identifying the
program will appear in the lower left hand corner of the screen, and a menu bar
will appear at the top allowing you to select from four menus.

The four menus are:

The Apple menu:

About this demo: Displays a dialog box that identifi es the program, its authors,
creation date and version number. Also displays an example of color dithering
in 640 mode (the Apple logo in the dialog box has 6 different colors in it,
generated from just one color palette).

Clock: Example of a background desk accessory. The time is continually

updated, even when the clock's window is not active.

STV: Show Tools Versions. Displays the version numbers of the tools being
used by the current application. Since the "HodgePodge" application uses the
most tools, call STV while running "HodgePodge" to get the most information

Apple I1GS Demo Disk Page 1

about the current tools' versions. Clicking on a tool name will load in that tool
from the disk and display its version number.

The File menu:

Quit: Quits the Demo Launcher. This will bring up the text window that asks
whether you want to reboot the system, run the Startup program, or run a
specific program.

The Edit menu:

Contains the standard edit menu items: Undo, Cut, Copy, and Paste. They are
all disabled, since the Demo Launcher does not use them. They are there to
support any desk accessory which may need them.

The Demo menu:

Daleks: The familiar public domain Macintosh game written for the Apple IIGS.

HodgePodge: This program demostrates many features of the Apple IIGS

menu/window system including loading and saving normal and packed pictures
(file types $C1 and $CO respectively), changing from 320 to 640 mode and back
again, displaying proportional and mono-spaced fonts, and printing.

Color Dabbler: A program that "tweaks" pictures, the scanline control by1es
(SCBs) that determine color and resolution for a specific scanline, and color
palettes. It is primarily run with keyboard commands, with limited selection
capacity from the mouse. It can display any pictures, including the ones in the
HodgePodge directory, and any on /DEMO.DATA.

Slide Show: A BASIC program that loads all the pictures it can find in drive 2
and displays them on the screen. Press the spacebar to pause the slide show,
RETURN to continue scrolling, and the ESC key to quit. Since the program is
written in BASIC, it is simple to modify it to read the pictures from the RAM disk
rather than from a 3.5 disk; doing so, however, may prevent the rest of the
demos from working correctly, as they require a lot of memory.

QuickDraw Sampler: A potpourri of routines that put the QuickDraw calls

through their paces. Includes examples of custom menu bars, and a "Color
Control" desk accessory that allows fine tuning of screen colors and desktop
patterns.

GS Paint: An example of a primitive Paint program for the IIGS. You can draw,
but you cannot load, or print.

Apple IIGS Demo Disk Page 2

Keyboard Sounds: When selected, this choice brings up a dialog box that
allows you to play different sounds by pressing keys. Use the shift key to create
even more sounds.

Brickout: The old DOS 3.3 Applesoft program is back in Super-HiRes and
running under ProDOS 16. Demonstrates a mixture of animation and sound.

How to Install on a Hard Disk Drive

1) Create a directory on your disk to contain all of the files from the two 3.5"
disks. Copy all of the files - except the file "PRODOS" and the subdirectory
"SYSTEM" - to this directory.

2) Perform the same procedure for the picture data disk (these pictures can be
put in their own directory, or the same directory as the one created in step 1).

3) If the system software on the demo disk is more recent than that on your hard
disk, copy PRODOS to the root level of your hard disk and copy all of the files in
the "SYSTEM" subdirectory to the "SYSTEM" subdirectory on your hard disk.

4) The SlideShow program expects to find its pictures on the disk in drive 2 of
the boot slot, and will have to be modified in order to look for pictures
elsewhere. However, it is written in BASIC, and this is easily done.

a) Enter BASIC, and load the program named "STARTUP". This is the
Slide Show program.
b) Change line 124 to .read '124 PFX$="<name of the directory where
the pictures are>"'.
c) Change line 125 to read '125 PRINT D$;"PREFIX ";PFX$'.
d) Save the program.

Bugs, limitations, and Pitfalls

HodgePodge: This program been known to sometimes crash when trying to

change modes with lots of windows displayed. In addition, it takes a long time
to change modes with lots of windows displayed; we suggest that you only
change modes when one or two windows are open. Many of the features of the
font selection dialog box (specifically: italiCS, shadow, and scaling a font to a
non-installed size) are not supported. Also, changing modes will close any
open desk accessories. You will have to reopen them in the new mode if you
want to see them. Finally, there is a documented bug that occurs when exiting
the program while in 320 and later returning to it in 640 mode. It is non-fatal (the
picture window size and drawing routine are not set for the proper mode), but
can be embarrassing. To avoid the problem, switch to 640 mode before exiting.
To remedy the problem if it occurs, simply switch to 320 mode and back again to
640 (this can be done before loading any pictures, so no one may notice).

Apple 1I0S Demo Disk Page 3

BrickOut: When the paddle hits the ball at the extreme edge of either side of the
screen, the ball will go straight up the side of the screen. This will cause the
"ball-hitting-the-side-of-the-wall" sound to be emitted constantly. Also, the
program was not designed to support desk accessories. Finally, to hide the
cursor, click the mouse button once inside the Brickout window.

GS Paint: This program will load in a picture called SCREEN.0 if it can find it in
the directory from which the program is run.

Keyboard Sounds: Lower case keys sound the best. The number and symbol
keys produce sounds that are too low to be heard well.

Apple IIGS Demo Disk Page 4