home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / geos / c128 / MouseEdit-2.0.doc.cvt (.txt) < prev    next >
Encoding:
GEOS ConVerT  |  1998-01-17  |  14.3 KB  |  148 lines

  1. mOUSEeDIT.dOCS
  2. prg FORMATTED geos FILE v1.0
  3. wRITE iMAGE v2.1
  4. GEOwRITE    v2.1
  5. "mOUSE eDITOR v2.0"
  6. fOR geos 128, v2.0, IN 80 COLUMN MODE only!!!!!
  7. ** warning **
  8. pLEASE GIVE YOURSELF SOME TIME, SIT DOWN AND READ THIS INSTRUCTIONAL REFERENCE.
  9. will not
  10.  BE RESPONSIBLE FOR ANY DAMAGES WHATSOEVER.  uSE THIS PROGRAM AT YOUR OWN RISK!
  11.  @mOUSEeDITOR
  12. " IS FOR USE WITH geos 128, v2.0 (OR HIGHER), ON A cOMMODORE 128, IN 80 COLUMN MODE "
  13.  @only
  14. ".  iF YOUR MACHINE IS EQUIPPED WITH 
  15.  @64k vdc
  16.  IT WILL RUN IN "
  17.  @color
  18. ", IF YOU ONLY HAVE 
  19.  @16k vdc
  20.  IT WILL RUN IN 
  21.  @STANDARD
  22.  SCREEN 
  23.  @ONLY
  24. fIRST A BRIEF DESCRIPTION OF HOW THE MOUSE PICTURE IS CONSTRUCTED FOR geos 128, v2.0.....
  25. tHE MOUSE PICTURE ACTUALLY CONTAINS TWO SMALL SOFT-SPRITES, ONE MAKSING THE OTHER, (THE MASK SURROUNDING THE ACTUAL IMAGE).  tO CONSTRUCT A NEW MOUSE PICTURE YOU NEED TO PROVIDE DATA FOR BOTH THE image AND THE mask FOR THE MOUSE TO OPERATE PROPERLY.
  26. tHE "mOUSE eDITOR" PROVIDES YOU WITH A FEW OPTIONS TO MAKE CHANGES EASILY IN THE image DESIGN AND THE mask DESIGN. yOU CAN USE THE geos DEFAULT MOUSE PICTURE OR MAKE UP YOUR OWN MOUSE PICTURE.
  27. iT ALSO ALLOWS YOU TO SAVE geos aUTO-eXECUTE TYPE FILES SO YOUR CHANGES CAN BE IMPLEMENTED AUTOMATICALLY ANY TIME YOU WISH. 
  28. a FUTURE VERSION WILL ALLOW YOU TO SAVE YOUR DATA IN A TEXT SCRAP FORMAT, PHOTO SCRAP FORMAT, RUN DESK ACCESSORIES, CHANGE THE COLOR OF MOUSE PICTURE ITSELF.
  29. (ALL THESE FEATURES WILL BE INCLUDED IN A VERY POPULAR ALTERNATE DESKTOP.)
  30.  [ i CAN'T MENTION THE NAME YET ]
  31. nOW ON WITH THE sHOW.....
  32. tO RUN THE PROGRAM JUST DOUBLE-CLICK ON ITS' FILE ICON (OR ALTERNATE METHOD) AND YOU ARE ON YOUR WAY...
  33. tHE FOLLOWING PAGES GIVE YOU BOTH SMALL PICTORAL AND TEXT REFERENCES OF THE ITEMS AND ICONS FUNCTIONS.
  34.  hmAIN sCREEN iTEMS:
  35. @1image editor
  36. 2mask editor
  37. 3 image sample pic
  38. 4 mask sample pic
  39. 5oPTION "buttons" 
  40. 8current actual mouse picture
  41. 9preview ( reference of editor screens )
  42. menu items:
  43. gEOS :
  44. INFO
  45. fUTURE
  46. fUTURE
  47. fUTURE
  48. fUTURE
  49. eXIT :
  50. fUTURE
  51. sAVE eDITS & qUIT
  52. sAVE dEFAULT & qUIT
  53. 1image editor
  54. tHIS IS YOUR MAIN EDITOR SCREEN.  yOU CAN CHANGE THE SHAPE OF THE MOUSE IMAGE JUST BY CLICKING ON ONE OF THE BOXES.  tHE BOX WILL REVERSE ITS' COLOR TO INDICATE A SELECTION.
  55. BLACK IS ON
  56. WHITE IS OFF
  57. ** yOU WILL PLEASE TAKE note THAT WHEN YOU FIRST RUN THIS PROGRAM THE DEFAULT MOUSE IS SET UP IN THE EDITORS **
  58. (ALSO SEE SAMPLE)
  59. 2mask editor
  60. tHIS IS YOUR 2ND EDITOR SCREEN.  yOU CAN SURROUND (MASK) THE SHAPE OF THE MOUSE IMAGE JUST BY CLICKING ON ONE OF THE BOXES.  tHE BOX WILL REVERSE ITS' COLOR TO INDICATE A SELECTION.
  61. BLACK IS ON
  62. WHITE IS OFF
  63. ** yOU WILL PLEASE TAKE note THAT WHEN YOU FIRST RUN THIS PROGRAM THE DEFAULT MOUSE IS SET UP IN THE EDITORS **
  64. (ALSO SEE SAMPLE)
  65. 3 image sample pic
  66. ctHIS IS A sample PICTURE FOR YOUR REFERENCE IN USING THE EDITOR.  iT IS NOT ACTIVE, IT IS JUST A REFERENCE.  iT "is" A REPRESENTATION OF THE STANDARD dEFAULT mOUSE image SECTION.
  67. 4 mask sample pic
  68. dtHIS IS A sample PICTURE FOR YOUR REFERENCE IN USING THE EDITOR.  iT IS NOT ACTIVE, IT IS JUST A REFERENCE.  iT "is" A REPRESENTATION OF THE STANDARD dEFAULT mOUSE mask SECTION.
  69. (( THIS SHOULD GIVE YOU A GOOD IDEA OF WHAT IS EXPECTED TO BE IN THE MASK DATA))
  70. yOU WILL NOTE THAT THE image IS "SURROUNDED" WITH THE mask DATA.
  71. iN ACTUAL USE YOU WILL ONLY SEE THIS mask WHEN YOU MOVE THE MOUSE OVER AN AREA THAT IS THE SAME COLOR AS THE MOUSE.  tHE mask APPEARS SO WILL STILL KNOW EXACTLY WHERE YOUR MOUSE IS!
  72. 5oPTIONS buttons
  73. (CENTER SCREEN, FROM TOP TO BOTTOM)
  74. tHERE ARE CURRENTLY 9 BUTTONS IN THE CENTER OF THE SCREEN, EACH WITH A SEPERATE FUNCTION:
  75. dEFAULT:AUTOMATICALLY PLACES THE geos dEFAULT mOUSE PICTURE IN THE EDITORS
  76. ( THE dEFAULT mOUSE PICTURE ALWAYS APPEARS WHEN FIRST RUNNING THIS PROGRAM)
  77. cURRENT:AUTOMATICALLY PLACES YOUR CURRENT mOUSE PICTURE IN THE EDITORS
  78. (THIS IS THE MOUSE PICTURE YOU ARE USING WHEN YOU OPENED THIS PROGRAM)
  79. eRASE:AUTOMATICALLY ERASES (CLEARS) THE EDITORS (ALL PREVIOUS EDIT DATA LOST)
  80. sWAP a&b:AUTOMATICALLY sWAPS THE PICTURES IN THE image AND mask AREAS
  81. ** SEE CAUTION **
  82. cOPYa>b:COPIES THE image PICTURE TO THE mask EDITOR
  83. uNDOa>b:RECOVERS YOUR mask EDITOR PICTURE ** SEE NOTE **
  84. cOPYb>a:COPIES THE mask PICTURE TO THE image EDITOR
  85. uNDOb>a:RECOVERS YOUR image EDITOR PICTURE ** SEE NOTE **
  86.  @abort
  87. :qUITS TO THE dESKtOP WITHOUT SAVING YOUR EDITS.
  88. (( NOTHING WILL BE SAVED, ALL DATA CHANGES WILL BE LOST ))
  89. (ALSO SEE fILE MENU ITEMS FOR sAVING YOUR PICTURES)
  90. **note**
  91.     iF YOU MAKE ANY CHANGES (LOAD DEFAULT OR CURRENT PICTURES) YOU WILL LOSE THE BUFFERS CONTENTS AND YOUR SWAP WILL BE LOST.
  92. ** caution **
  93.      wHEN YOU SWAP THE image AND mask PICTURES THE "entire" mask IS COPIED TO THE image EDITOR.  tAKE DUE PRECAUTIONS BEFORE SAVING IT.  
  94. (YOU WILL NOTICE PART OF THE DARKENED mask IS STILL SURROUNDING YOUR image)
  95. 8current actual mouse picture
  96. iN THE LOWER LEFT CORNER OF THE SCREEN YOU WILL SEE A BOX WITH A PICTURE OF YOUR CURRENTLY ACTIVE MOUSE PICTURE IN IT.   iT'S JUST FOR REFERENCE, IT IS NOT ACTIVE.
  97. EVERY TIME YOU ENTER THE PROGRAM IT WILL SHOW THE MOUSE PICTURE YOU ARE CURRENTLY USING.
  98. 9preview 
  99. itHIS IS A REFERENCE OF WHAT YOU ARE DOING IN THE MAIN EDITOR BOXES.  aNY CHANGES YOU MAKE IN EITHER EDITOR BOX WILL BE REFLECTED HERE TO SHOW YOU JUST WHAT A WONDERFUL JOB YOU ARE DOING!
  100. tHE uPPER PORTION WILL REFLECT THE image YOU ARE CREATING,
  101. tHE lOWER PORTION WILL REFLECT THE mask YOU ARE CREATING.
  102. hEY, BEFORE YOU EVEN ASK....
  103. iF i PUT THEM BOTH TOGETHER (LIKE THEY SHOULD BE) YOU'D NEVER SEE YOUR MASK CHANGES!
  104. ( SO DON'T ASK) (HEE HEE) ;d
  105. menu items:
  106. gEOS :
  107. INFOSHOWS AUTHOR STUFF, AND CREDITS
  108. fUTUREnot active this version!
  109. fUTUREnot active this version!
  110. fUTUREnot active this version!
  111. fUTUREnot active this version!
  112. tHE "fUTURE" MENU ITEMS ARE NOT ACTIVE HERE, BUT ARE ACTIVE IN THE FUTURE VERSIONS.  
  113. iT IS NOW A FEATURE OF A POPULAR ALTERNATE DESKTOP TO BE RELEASED IN THE NEAR FUTURE.
  114. wHEN THE TIME IS RIGHT, i'LL LET YOU KNOW WHEN AND WHERE.
  115. mOUSE eDITOR v2.5 IS NOT AVAILABLE TO THE PUBLIC AT THIS MOMENT.
  116. menu items:
  117. eXIT :
  118.  @fUTURE
  119. tHIS ITEM not ACTIVE IN THIS VERSION...
  120.  @sAVE eDITS & qUIT
  121. tHIS ITEM WILL OPEN UP A FILENAME SELECTION SCREEN.
  122. dELETE THE STANDARD FILENAME, AS YOU WOULD IN GEOWRITE,
  123. eNTER THE NAME YOU WISH THE AUTO-EXECUTE FILE TO BE,
  124. THEN HIT THE RETURN KEY.
  125. aN auto-execute FILE WILL BE WRITTEN TO YOUR DISK WITH THE
  126. MOUSE PICTURE INFORMATION YOU CREATED.
  127. yOU CAN PLACE THIS FILE ON YOUR BOOT DISK (ANYPLACE AFTER THE CONFIGURE FILE) TO HAVE YOUR NEW MOUSE PICTURE INSTALLED AT BOOT-UP, OR, PLACE IT ON ANY DISK AND JUST DOUBLE CLICK ON ITS' FILE ICON TO INSTALL THE NEW MOUSE PICTURE WHEN YOU DESIRE.
  128.  p** warning **
  129.  iF YOU ATTEMPT TO NAME A FILE WITH A NAME THAT ALREADY EXISTS ON YOUR DISK YOU WILL GET AN ERROR DIALOG BOX, WHICH THEN RETURNS YOU TO THE mOUSE EDITOR SCREEN.
  130.  @"all" YOUR PREVIOUS DATA WILL BE LOST, AND YOU WILL HAVE TO START ALL OVER AGAIN!
  131. sO BE CAREFUL WHAT YOU NAME YOUR FILE!!!
  132.  @sAVE dEFAULT & qUIT
  133. aN auto-execute FILE WILL BE AUTOMATICALLY WRITTEN TO YOUR 
  134. DISK WITH THE default MOUSE PICTURE INFORMATION YOU CREATED.
  135.  @** note **
  136.  iF YOU HAVE A FILE ON DISK WITH THE SAME NAME IT WILL NOT WRITE THE FILE, BUT INSTEAD RETURN YOU TO THE PROGRAM WITH NOTHING SAVED.  iF YOU WISH, YOU CAN USE THE sAVE eDITS & qUIT MENU ITEM AND YOU CAN THEN RENAME THE FILE AND SAVE IT.
  137. yOU CAN PLACE THIS FILE ON YOUR BOOT DISK (ANYPLACE AFTER THE CONFIGURE FILE) TO HAVE YOUR NEW MOUSE PICTURE INSTALLED AT BOOT-UP, OR, PLACE IT ON ANY DISK AND JUST DOUBLE CLICK ON ITS' FILE ICON TO INSTALL THE NEW MOUSE PICTURE WHEN YOU DESIRE.
  138. cONCLUSION:
  139. tHIS FILE CAN BE FREELY DISTRIBUTED AS LONG AS YOU KEEP THE ORIGINAL .sfx "INTACT", MAKE no changes TO THE FILE OR THE INSTRUCTIONS.  iT MAY not BE SOLD FOR ANYTHING OTHER THAN THE NORMAL CONNECTION, AND FILE TRANSFER, FEES INVOLVED IN USING THAT SERVICE.
  140. a SPECIAL EXCEPTION IS PROVIDED TO parsec iNC., FOR DISTRIBUTION.  parsec MAY INCLUDE THIS FILE IN ANY OF THEIR PRODUCTS.
  141. B""(@
  142. B""(@
  143. B""(@
  144. """ c
  145. B""(@
  146. """ c
  147. B""(@
  148.