--Original script by Steve Drazga, ART Incorpoated
--XFCNs used: none
--XCMDs used: none
--HANDLERS used: none
--FUNCTIONS used: installRes
--
if the optionkey is down then pass mouseup
put installres(XCMD,ResCopy) into it
put installres(DITL,ResCopy) into it
put installres(DLOG,ResCopy) into it
put installres(DITL,"RC Help") into it
put installres(DLOG,"RC Help") into it
end mouseup
-- part contents for background part 2
----- text -----
ResCopy
-- part contents for background part 3
----- text -----
This is version 4.0b19 of the ResCopy XCMD by Steve Maller.
ResCopy XCMD Stack Hints & Tips
Written by Steve Maller
ResCopy is (c) 1988 Apple Computer, Inc.
"...a license agreement allowing commercial distribution of ResCopy is available for $25 per product/year from Apple Computer Software Licensing. Contact them at (408) 996-1010..."
***************************
TO USE ResCopy:
- Click the “Open…” buttons to present a list of stacks on any inserted disk.
- Select from either list the resource or resources you want to copy, remove, rename or renumber.
- If you click on an ‘ICON’, it is displayed in the box in the middle of the window. If you click on a ‘snd ’, the “Play” button is activated. If you click on a ‘CURS’ the cursor is changed to that cursor until you click the mouse again.
- Click the “Copy” button to copy a selected resource(s) in the direction the arrows point. (The original stack is not changed by copying).
- Click the ΓÇ£RemoveΓÇ¥ button to remove the selected resource(s) from the stack.
- Click the ΓÇ£EditΓÇ¥ menu to select either
ΓÇ£Rename...ΓÇ¥ or ΓÇ£Renumber...ΓÇ¥ to rename or renumber the selected resource. (A dialog box will appear prompting you for the new name or number.)
- Click the “Close” buttons to close stacks that you have opened. (A stack must be closed before you can open another one in its place.)
- Click the ΓÇ£PlayΓÇ¥ button to listen to a selected sound resource. Press Command-Period if you want to stop the sound before it finishes.
- Click the ΓÇ£HelpΓÇ¥ button for help with ResCopy.
- Click the ΓÇ£QuitΓÇ¥ button to exit the ResCopy program and return to HyperCard.
***************************
B) ResCopy will not open any file that is already open, unless you open it as read-only (see next item).
 
C) The “Open…” button defaults to displaying a list of HyperCard stacks only. Click “All resource files (read only)” in the “Open” dialog to display all resource files. Use this method to look at HyperCard itself, the System file, or any file that contains resources (like applications). These files are opened read-only, meaning that you can copy from them, but you cannot make any changes to them.
 
D) Option-click the “Remove” button to avoid a warning alert.
E) The following command-key shortcuts are available:
      Command-R — “Rename…”
      Command-N — “Renumber…”
      Command-P — “Play”
      Command-? — “Help”
      Command-Q — “Quit”
E) To install ResCopy into another stack (bash copy protection!), copy these resources:
(required)
       XCMD=10000 "ResCopy"
       DITL=10000 "ResCopy"
       DLOG=10000 "ResCopy"
(optional)
       DITL=10001 "RC Help"
       DLOG=10001 "RC Help"
                     
F) If ResCopy finds the its two “Help” resources
(see above), itΓÇÖs ΓÇ£HelpΓÇ¥ button is highlighted. If it doesnΓÇÖt find the two resources, the button is disabled. You can tailor ResCopy for individual applications by modifying the text of the ΓÇ£RC HelpΓÇ¥ DITL using ResEdit.
G) If you wish to switch to another application while running MultiFinder, click the HyperCard icon in the upper right corner of the menu bar, or on larger monitors, click in one of that application’s windows. When you switch back to HyperCard, ResCopy will still be active.
H) • • Messages • •
* “Convert sound to HyperCard format?” - When copying 'snd ' resources, ResCopy will convert the sounds to HyperCard format if they are not already in that format. Click “OK” to do the conversion. Click “Convert all” to avoid further prompts when copying multiple sounds. The sound in the original file is left unchanged.
* “I am missing some of my resources!” - One of the resources listed above as “required” is missing from the current stack and the Home stack.
* “That file cannot be opened.” - There was a problem opening that file.
* “That file is locked or busy.” - ResCopy was unable to add a new resource to a file.
* ΓÇ£That number already exists! Enter another:ΓÇ¥ - The new number you entered for a resource is already assigned to a resource in that file.
* “Not enough memory to run ResCopy.” - ResCopy checks to see if there is at least 64K of free RAM. You can get this message if the RAM cache is turned up too high, or if you are running InBox™ or TOPS™. Turn off or disable one or more of these, or set the userLevel to 1 or 2 and try again.
* “Not enough memory to play sound.” - Just what it says.
* “Oops, not a playable Hypercard sound.” - This is a ‘type 1’ sound resource that is not a digitized sound, or is in some other way incompatible with HyperCard.
***************************
Use this in good health!
-- part contents for background part 10
----- text -----
Syntax:
Rescopy
--or--
ResCopy <fromFile>, <toFile>, <resType>,
<resIDnumber>
--or--
ResCopy <fromFile>, <toFile>, <resType>,
<resName>
If no parameters are passed, the Rescopy window will appear, which gives you a 'Font/DA mover' type interface to move resources.
Notes for scripted copying:
   a) you must supply the full pathname of
ΓÇ£fromFileΓÇ¥ and ΓÇ£toFileΓÇ¥ (you can use ΓÇ£the long name of this stackΓÇ¥ for the ΓÇ£from stackΓÇ¥, and use the ΓÇ£FileNameΓÇ¥ XFCN to allow the user to choose the ΓÇ£to stackΓÇ¥)
   b) you can specify a resource by either its name or ID number
   c) if by name the name must be in quotes
   d) if by number the number needn’t be in quotes
   e) If a resource with the given name or number already exists, it is replaced
   f) If an error is encountered, the resource is not copied, a beep is sounded, and the HyperTalk global variable “the result” is set to “Error!” (otherwise it is empty)
   g) Scripted copying can be used on any type of file, not just HyperCard stacks
