From: Detlef Mueller <detlef@mwhh.hanse.de>
Subject:  v04i011:  fade_dm - Amazing screen fader v1.1, Part01/01
Newsgroups: comp.sources.hp48
Keywords: HP48 PICT ADISP grob demo
Organization: Nothin' is organized here.
Followup-To: comp.sys.hp48
Summary: Amazing
Approved: spell@seq.uncwil.edu

Checksum: 4242299209 (verify with brik -cv)
Submitted-by: Detlef Mueller <detlef@mwhh.hanse.de>
Posting-number: Volume 4, Issue 11
Archive-name: fade_dm/part01


BEGIN_DOC fade_dm.doc
Hi all.

A few days ago I found in a library a program to fade a fullsize-grob into
the PICT. Really impressed I rewrote the code. Here's the result, a little
directory filled with some programs:

    SETUP
    ( --> )
	Execute this program after the d/l.
	Purges itself.

    RFU
    ( --> )
	Redundancy fighter unpacker.
	Purged by SETUP.

    Show
    ( --> )
	A little demonstration program (user-RPL) to present FADE, FROW and
	R2D2. It takes care about the PICT, if you interrupt the Show by
	pressing [ON], you'll find your previous PICT grob in the last stack
	level. To see the whole demo, only press a key if the program tells
	you to do so.
	Unpacked by SETUP.

    MAN
    ( --> grob )
	A grob used by Show.
	Unpacked by SETUP.

    FROW
    ( $text %row --> )
	Fade ROW (sys-RPL). Feed it with a string in level 2 and a row number
	in level 1 (1-7 if text display is active, 1-8 if PICT is active).
	FROW fades the 1st 22 chars of the string into the active display
	grob using the medium font. Row numbers > 8 wraps to 8, numbers < 1
	wraps to 1. Trying to write row 8 in the text grob may be an error
	condition (normally the text grob is only 56 lines hight).
	Calls FADE.

    FADE
    ( grob %flag --> )
	Copy grob starting at the upper line into the active display grob
	(text screen or PICT), using an amazing fading algorithm. If %flag
	<> 0, every step a nibble is copied ('fast' mode). X-size of grob
	<> X-size of display grob or Y-size of grob > Y-size of display grob
	are error conditions.
	Examine the source of FROW and Show to get some usage examples.

    R2D2
    ( %n --> )
	The 'Starwars' R2D2 captured in your handheld ... (saw the films
	again yesterday :-). Try 5 R2D2.

    ITYPES
    ( --> )
	This is a program very similar to the OBJVIEW (shows an object type
	reminder grob) posted by Stephen J Thomas a few days ago. When
	starting with sys-RPL, I never remember the type values needed for
	CKx&Dispatch/CK&DISPATCHx so I made myself a little program that
	shows me all the internal types. The version I offer here contains a
	modified kernel of FADE (only fade with speed 1) to run standalone.

Credits:
    - RFU is a creation from Lutz Vieweg.
    - I found the original version of the fade program in a library named
      FACE, ID 1307. I neither know who has made it, nor if it ever was
      shown up as an article in a newsgroup (I only own the nacked copy of
      the lib in binary form). Anyway, thanks for the impressive program
      (even it was buggy).

Have fun,
	8-Detlef
END_DOC

	Sources
	=======

FROW - Use RPL:2.1 (with installed ref. table) to compile it.


-- 
+-----------------------------------+---------------------------------------+
|      `What a depressingly         |             Detlef Mueller            |
|         stupid machine`           |          detlef@mwhh.hanse.de         |
|             Marvin                |...!uunet!mcsun!unido!mcshh!mwhh!detlef|
+-----------------------------------+---------------------------------------+
