home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 126-150 / scopedisk142 / multibinder / themultibinder.doc < prev    next >
Encoding:
Text File  |  1995-03-19  |  5.4 KB  |  102 lines
  1. TheMultiBinder -- A Deck Resource Binder
  2.  
  3.      A characteristic feature of CanDo applications is their use of
  4. external resources such as picture files, brush files, sound files, and
  5. brushanim files.  Often, after an application has been completed, the
  6. creator of the application wishes to "bind" all the external resources to
  7. the Deck so that it becomes a single, "stand-alone" program which can be
  8. easily given to friends, or sold.
  9.  
  10.      TheBinder allowed Decks to be made "stand-alone" in the sense of no
  11. longer requiring the cando.library.  TheMultiBinder allows Decks to be made
  12. completely "stand-alone," no longer requiring the use of external resources
  13. nor the cando.library.  With TheMultiBinder, all resources are "bound" to
  14. the Deck, creating a single, executable file.
  15.  
  16. Limits of TheMultiBinder:
  17.  
  18.      TheMultiBinder is designed to "bind" only certain types of files,
  19. known as IFF, to an application.  These includes the picture files, brush
  20. files, sound files, and brushanim files, but not document files.
  21. Therefore, text files used by an application cannot be bound to the Deck.
  22. Text files must still be copied and moved by TheRelocator.  This may change
  23. in a future release of CanDo.
  24.  
  25.      Also, since the Deck must now have all resources loaded at one time,
  26. we recommend that TheMultiBinder not be used for Decks which use large
  27. amounts of resources.  If all resources are bound, in such cases, the Deck
  28. may not run on smaller memory systems.
  29.  
  30. Installing TheMuliBinder:
  31.  
  32.      TheMultiBinder requires the following files to be available:
  33. DeckBrowser, DeckRunner, and the new DeckBinder.  By default, these files
  34. must be located in your "C:" directory.  If they are located elsewhere,
  35. then the TOOLTYPES in TheMultiBinder Icon must be changed to reflect their
  36. new location.  NOTE:  the old DeckBinder will not work with TheMultiBinder
  37. so be sure to copy the new DeckBinder to your "C:" directory; the new
  38. DeckBinder does everything the old DeckBinder does and more.
  39.  
  40.      To change the TOOLTYPES, simple click once on TheMultiBinder Icon,
  41. then select the WorkBench menu option, info.  A requester will appear and
  42. you will be able to scroll through the list of TOOLTYPES and change them as
  43. necessary.  When you are finished, simply select the "SAVE" option.
  44.  
  45. Using TheMultiBinder:
  46.  
  47.      Run TheMultiBinder by double clicking on its Icon.  Select the Deck
  48. you wish to "bind" by either using the "Project" menu option "Open Deck,"
  49. or by clicking on the words "Deck Name." With the file requester, locate
  50. the Deck you wish to bind, then select "Ok."
  51.  
  52.      After TheMultiBinder scans your Deck, it will present the list of
  53. files it found which may be bound.  This list indicates the file name, its
  54. type, and its status for binding.  The status is either No, indicating that
  55. you do not wish to bind it; Yes, indicating that you do wish to bind it;
  56. and ---, indicating that it could not be found.  If the file is found, then
  57. its status can be toggled by double clicking on the files line.  To select
  58. all of the listed files, press the "All" button or choose the "Edit" menu
  59. option "Select All." To deselect all of the listed files, press the "Clear"
  60. button or choose the "Edit" menu option "Clear All."
  61.  
  62.      Select whether you would like to program to require the cando.library,
  63. pressing the "Needs the Library" button, or if you would like the program
  64. to be completely "stand-alone" by pressing the "As a Standalone" button.
  65. Next, select the name of the resulting Deck by typing the name into the
  66. "Dest Name" Field.  Finally, press the "Bind the Deck" button, and
  67. TheMultiBinder will perform the binding process.  When it is finished, the
  68. newly created Deck will be bound and ready to run.
  69.  
  70. Features for Advanced Users:
  71.  
  72.      A problem encountered primarily by advanced users of CanDo involves
  73. the method by which TheMultiBinder identifies which files are used by the
  74. Deck.  TheMultiBinder searches for all commands and Objects that can load a
  75. file, examines them and takes the name from there.  If variables are used
  76. to designate the file name, however, TheMultiBinder is unable to identify
  77. which file is needed.
  78.  
  79.      If TheMultiBinder cannot find one or more of the resources used by
  80. your deck, then you can add the names of these resources to the list within
  81. TheMultiBinder.  First, test to see if you can access the "Expert" menu
  82. within TheMultiBinder.  If not, quit the program and request info on
  83. TheMultiBinder's Icon.  Step through the TOOLTYPES and change one from
  84. "ExpertMode=Off" to "ExpertMode=On" and save the info, then restart
  85. TheMultiBinder.  You should now have access to the "Expert" menu.
  86.  
  87.      Within the "Expert" menu are two options:  "Add Entry" and "Delete
  88. Entry." If you select "Add Entry" a file requester will appear and you will
  89. be able to find the file not found by TheMultiBinder.
  90.  
  91.      After you have found and selected the file you wish to add to the list
  92. of files to be bound, a requester will appear asking you how this file
  93. should be referred to when bound.  It is important here to change the
  94. reference to be EXACTLY as your application refers to it.  For example:
  95. "Work:picture" is not the same as "dh0:picture" even though they are the
  96. same file on disk.  If your application referred to the file as
  97. "Work:picture" and you selected the file as "dh0:picture", this requester
  98. will give you the opportunity to change the reference to "Work:picture".
  99. This feature is also very useful for files which contain no path names
  100. within your application.  You can ensure that "PATH:picture" is bound as
  101. "picture".
  102.