From: wndalouise@aol.com (WndaLouise)
Newsgroups: comp.sys.hp48
Subject: Magic Shift Keys...!!! ( Soft Directory )
Date: 9 Apr 1998 07:19:28 GMT
Lines: 242
Message-ID: <1998040907192801.DAA26605@ladder01.news.aol.com>
NNTP-Posting-Host: ladder01.news.aol.com
X-Admin: news@aol.com
Organization: AOL http://www.aol.com
Xref: republic.btigate.com comp.sys.hp48:9105



Magic Shift Keys Directory!
by TinyWanda & The 3rd of 5 Hamsters.

To Congratulate me on Another job well done,  
or To ask Questions; About these Programs, 
                     Or Your place in The Universe,
or To simply vent Incoherient anger in my direction...

Eep me @ WndaLouse@aol.com


---------------------------------------------------------
Magic Shift Keys Directory!
---------------------------------------------------------
Introduction:

To fully understand and appreciate the conceptual foundation of 
The Magic Shift Keys, you have to first become extremely lazy!

Let's say that there are certain -tasks- that you like to occasionally perform 
on various objects in various directories...

Such as:
Make a copy of an object.
or Move an object to a given Port, such as Port(0).
or whatever...
Those are the only two sample tasks the i wrote routines for...

To do these tasks fairly painlessly, 
and The Key Word here is painlessly...
...really painlessly...!!!
...you need the Magic Shift Keys!

Like if you wanted to make A Copy of an Object 
and Move it beside the Object that you're Copying, 
that would take alot of Menu finding and Command pushing...
and even if you wrote A Routine to do all that...
...you'd still have to perform the agonizing job of 
Pushing the ' key, 
Then the White Key for the Object you wanted to Copy, 
Then the ENTER key, 
Then find the Copy program 
And Execute it.

Ugh.

It Exhausts me just thinking about it!

What if though, 
You could just hit the UserKey Access code, 
then the White Key for the object.
Done!

That is the essence of the Magic Shift Keys!

The Magic Shift Key Routine Knows which WhiteKey you pushed, 
and What Object that it currently represents, 
and Then performs The Task that you want done to it...!!!

---------------------------------------
The Magic Shift Key Directory contains:

Key->     The Magic Shift Keyizer
Make      An Installer for the White UserKeys
->P0      Moves an Object to Port(0) & Deletes it from the User Menu.
Dup       Duplicates an Object & puts it Next to the dupped Object.
Put       Insert Put, Used by Dup.


How to Use Them:

-------------------------------------------o
Key->
Store this in Port(0).
To do that; 
Recall the name to the stack,
1:   Key->
DUP DUP it twice.
RCL one of them.
SWAP
Put a zero Tag on the bottom one. 
   If your not in STD mode, 
   use string delimiters around the zero!
"0" ->TAG 
STO
PURGE

The Input for Key-> is:
2:    White Key Position
1:            'Modifier'

Key-> is only accessed via the program that is assigned to the WhiteKey, 
And since the 'Make' program--Creates this program, 
There's really no need to know what or how Key-> works...
But, having mentioned this...

The White Key Position is the White Key that the Key-> program is assigned
to...this is provided by the user, or the Make program, 
It's not derived by somehow knowing which key was pressed...???
You -Tell It- which key was pressed...!

The 'Modifier' is a program that takes the name of the Object that the White
Key represents, and does something to it, or with it...
Such as duplicating it, or moving it to Port(0).
It should also either Use or Drop the reference on 2:, 
That tells the modifier where on the menu directory the Object came from...
This is useful if you want to change the object and then move it back to where
it came from...!
Or in the case of Dup, move the Duplicated object to the position right before
the Original object!

-------------------------------------------o
Make
This is the Installer program that assigns the necessary program to the
UserKeys under the WhiteKeys... (???)
This process could be rather tedious, so i thought i might write an application
that does it for you...!!!

The Input for Make is:
2:   Shift Key Designation
1:              'Modifier'

The Shift Key Designation is Which UserKey you want the Modifier program to be
assigned to, That will be active under each of the WhiteKeys, Making it
available for all objects that appear on the Menus of all Directories!

This would be some decimal number; .1 through .6
.1 is the face value of the UserKey Accessed White Key
   that is; left/alpha/whitekey
   assuming that flag -61 is Clear
.2 is left/alpha/left/whitekey
.3 is left/alpha/right/whitekey
.4 is left/alpha/alpha/whitekey
.5 is left/alpha/alpha/left/whitekey
.6 is left/alpah/alpha/right/whitekey

That may seem like alot of key pushing, 
But with a little practice, 
your fingers will dance right over them without even conscious thought!

The 'Modifier' is the name of the program that somehow modifies the object is
some way...
This is some program that YOU have to Write, 
Unless you never progress further than ->P0 or Dup.

The Input for the Modifier is:
2:       Where the Name came From
1:           'Name' of the Object

Where the Name came from, 
Is the position, that would be found on VARS, 
Of the object returned.
This position will be useful if you change the object somehow, 
STO the new object, 
then want to return it with ORDER to the old position!

The 'Name' of the object 
Is the 'Name' of the object, Under the WhiteKey that you just selected...!!!

When Make is Activated, the Modifier is put inside a program that calls Key->
which determines what object is under the WhiteKey you selected, 
then stores this program under each of the White Keys,
and puts everything else into motion...

-------------------------------------------o
->P0
Moves the selected object to Port(0) and deletes it from the Directory that it
was selected from!

-------------------------------------------o
Dup
Makes a copy of the selected object, 
gives it the name of the selected object, 
Plus a small middle centered dot, 
then moves it to the position in the Directory 
just before the selected object! 
( This may take awhile if there are lots of objects in the Directory! )

-------------------------------------------o
Put
Insert-Put is used by Dup.
It works just like the Regular PUT, 
except that instead of overwriting the object in the list,
it places it at that postion and moves the other objects after it,
down-along one position...

-------------------------------------------o

That explaination seems very unclear to me...??? (!)
Send Questions to WndaLouise@aol.com

Name:              Skey
CheckSum:       # 45CFh
Size:               488

%%HP: T(3)A(D)F(.);
DIR
  Key\->
    \<< VARS RCLMENU
FP 100 * 1 - 6 * 4
ROLL + SWAP OVER
GET ROT EVAL
    \>>
  Make
    \<<
"2: Shift .1 - .6
1: 'Modifier'"
"" INPUT OBJ\-> DUP
"0" \->TAG OVER RCL
OVER STO SWAP PURGE
1 6
      FOR $ OVER $
10 + + "\<<" $ " " +
+ 3 PICK +
" :0: Key\-> EVAL\>>" +
OBJ\-> SWAP ASN
      NEXT DROP2
    \>>
  \->P0
    \<< DUP RCL SWAP
DUP PURGE "0" \->TAG
STO DROP
    \>>
  Dup
    \<< VARS 3 ROLLD
DUP RCL SWAP \->STR 1
OVER SIZE 1 - SUB
"\183" + OBJ\-> SWAP
OVER STO Put ORDER
    \>>
  Put
    \<< 3 PICK SIZE \->
a b c z
      \<< a 1 b 1 -
SUB c + a b z SUB +
      \>>
    \>>
END

-[terminus]-