home *** CD-ROM | disk | FTP | other *** search
/ AMOS PD CD / amospdcd.iso / 451-475 / apd467 / docs / screened.docs < prev    next >
Text File  |  1993-03-15  |  14KB  |  436 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.             THE STORM SCREEN EDITOR V2.2
  8.             
  9.             Written by Ejber Ozkan 1993
  10.  
  11.                  Features Include
  12.  
  13.           Can now deal with icons from 8 pixels by 8 To 32 by 32
  14.               80 screens can be now worked on IN ONE BANK
  15.            ALL screens stored in A Normal DATA Bank in AMOS
  16. Complete new Icon system to work with (NOT AMOS PRO!) looks like workbench 2
  17.      Copy Screens and Jump to screens now available for bigger projects!
  18.            A complete MAP editor to help make maze games ect!!.
  19.          Music while you work!(Power users can load BIG modules!)
  20.                    Fill Screen option available!
  21.        Procedures for USING the SCREEN bank and MAP editor on disk!.
  22.             AMOS PRO COMPATIBLE
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.             This program is SHAREWARE
  30.  
  31. If you like it and use it then please registor with me for further update
  32. news and a latest copy of Pick n Mix
  33. The Minimum is 3.50 (pounds) this is a small price to pay considering that
  34. you will get the latest pick n mix disk,News of the last update to the 
  35. program,Which if you send me a disk and a stamp I will send you a copy of it
  36. cant say fairer than that!!.
  37.  
  38. Please note that this situation could change and the program could be made
  39. AMOS Licenceware very soon!.
  40.  
  41.             My Address is:-)
  42.  
  43.             Ejber Ozkan
  44.             222 Tunnel Ave
  45.             Greenwich
  46.             London
  47.             Se10 Opl.
  48.  
  49.  
  50.  
  51.  
  52.              ---------------------
  53.  
  54. When I was making a game using AMOS I required the game to have a number of
  55. screens inorder for the game to be challenging.Using handpainted files takes
  56. up a lot of time and memory!.So I had to come up with way to store masses
  57. of screens in one single bunch which my program can then interogate and use.
  58. At first this program was RAW to say the least but due to the growing demands
  59. of my game the EDITOR grew and grew!!...
  60.  
  61. All the information about the screens are stored in one AMOS bank.This bank
  62. can be saved and used in other programs with the minimum of fuss.You will find
  63. out how to do this later on.
  64.  
  65.             Getting started
  66.             ---------------
  67.  
  68. There are several ways of which you can build a screen using AMOS,The most 
  69. usefull way is by pasting a number of Icons images (blocks) together to 
  70. slowly construct a screen.This program uses that principle to make screens.
  71. There are several icon sizes that can be used by this program so as not to
  72. inhibit anyone!.
  73. They are :-)
  74.  
  75. 8 pixels By 8
  76. 8 by 16
  77. 8 by 32
  78. 16 by 8
  79. 16 by 16
  80. 16 by 32
  81. 32 by 8
  82. 32 by 16
  83. 32 by 32
  84.  
  85. Icons any bigger or of varing lengths can get confusing and SLOW to work
  86. with.
  87. You must choose your icon size wisely as this will change the way your 
  88. GAME/PROGRAM looks and feels ,Although the best one is the 16 by 16 as it
  89. is quite fast to paste and you can get a bit of detail on it.
  90. You can construct your icons using any amos ICON/SPRITE editor or my
  91. own EDITOR!.But Please note You MUST SAVE YOUR IMAGES AS ICONS NOT SPRITES!.
  92. :-(
  93. The total size of the screen is 320 x 200.The extra width can be used for
  94. your scoreboards ect..
  95.   
  96. When you first load the EDITOR you may notice that it already has some ICONS
  97. present in memory for you to use these icons are 16 by 16 (but this doesnt
  98. mean you cant use the icons on the other settings!)
  99.  
  100. You can if you wish experiment with these first.Simply click on an area above
  101. the work screen and an icon will be pasted to the position you clicked at now
  102. try moving the mouse around! Enjoy...    :-)))))))
  103.  
  104.                   -----------
  105.  
  106.                 OPTIONS
  107.                 -------
  108.  
  109. You will need to let SCREENED know the amount of colours used by your icons
  110.  
  111. 4, 8, 16 or 32
  112.  
  113. Click on your choice.This option only appears on the startup!.
  114.  
  115.  
  116.  
  117.  
  118.  
  119. LOAD ICONS
  120. ----------
  121. This will let you load an AMOS ICON BANK using the OLD AMOS file requester.
  122. Click QUIT in the requester to cancel.
  123. There are some example files in the SED-EXAMPLES drawer.The files end with
  124. .ABK after the names.
  125.  
  126. And now the real power of Screen ed!!....
  127.  
  128. :-O
  129.  
  130. By Clickng on the + and - gadgets next to the Screen No indicator will
  131. move up and down the screen currently in memory.Dont worry if your original
  132. screen clears! you can get back to that screen anytime you wish by using the
  133.  + and - gadgets !
  134.  
  135. By clicking on the << and >> gadgets you can flick through the available 
  136. icon images. The image shown in the bottom right hand corner will be 
  137. the current image that can be pasted.
  138.  
  139. LOAD SCREENS
  140. ------------
  141. By clicking this icon you will be able to load a SCREEN ED V2.2 screen bank
  142. into memory.
  143. Please make sure the bank is a prevously saved SCREEN ED bank ,Also make sure
  144. that the bank is loaded into its apropriate icon size .The system wont
  145. crash if done by accident it will warn you so dont worry!.
  146.  
  147. SAVE SCREENS
  148. ------------
  149. Save your complete AMOS data bank by using this option.Please try to use
  150. a prefix of some sort so that you can identify it later on I.E :-
  151.  
  152. SED.Myscreens16by16
  153.  
  154.  
  155. CLEAR SCREEN
  156. ------------
  157. This icon will Clear the current screen from memory and display leaving you
  158. to start a fresh screen.
  159.  
  160.  
  161. CLEAR ALL
  162. ---------
  163. This will wipe out all the screens in memory and clean out all the data.
  164. Use this to start from the beggining.
  165.  
  166. Dont worry if you push these icons by mistake, A requester will pop up asking
  167. if you would like to deal some death before hand!!!.:-)))
  168.  
  169. SYSTEM
  170. ------
  171. This icon will display a window with relevant information about the current
  172. memory /drives /icons and banks sizes. 
  173. Like so :-)
  174.  
  175. Free Fast mem:                Icons Available:
  176. Free Chip mem:                Screen bank size:
  177. Totl Free mem:                 Blocks Used:
  178.  
  179. Free Df0:                Free DF1:Non
  180.  
  181. Palette + -                MUSIC ON OFF CLEAR     OKAY
  182.  
  183. By clicking on the plus and minus icons you can flick through a number of
  184. pre-defined colour settings for the icons page.
  185.  
  186. Also by clicking ON and OFF you can turn the music on/off respectivly.
  187.  
  188. If your running short on memory Clicking the clear icon will clear the song
  189. from memory so you can work in peace!.
  190.  
  191. Click OKAY to return to the editor
  192.  
  193. FILL SCN (Fill SCREEN)
  194. --------
  195.  
  196. This option will let you fill in the current screen with the current icon
  197. image from the icon bank!.
  198. So saving you the time to for example put down some floor tiles ,This does
  199. it in milliseconds!!!. :-O
  200.  
  201.  
  202. COPY MODE
  203. ---------
  204.  
  205. This Option will let you copy the current screen to another screen in memory!
  206. Simply choose the screen number to copy to by clicking the + / - icons and
  207. then click OKAY to proceed.
  208. This is usefull when you want to have to copys of a screen so that you can
  209. experiment on one screen and if it goes wrong you still have a copy of it!.
  210. Click CANCEL to er...ermmm... CANCEL!!!   :-&
  211.  
  212.  
  213. JUMP TO SCREEN
  214. --------------
  215. I found out pretty early on in version 2.1 that when you wanted to go to 
  216. another screen you had to flick through all the screens untill you got to the
  217. screen that you wanted.
  218. This option now lets you jump from the current screen to any screen from
  219. 0 to 79 !
  220.  
  221. Again simply by clicking on the + and  - icons to get to the screen you want 
  222. and then click OKAY and you will JUMP to that screen number!!!.
  223.  
  224. Click CANCEL to CANCEL! (patronizing aint I?!)
  225.  
  226. RESTART 
  227. -------
  228. This option will let you go back and choose a new pixel setting for your
  229. icon blocks.This will wipe out the current SCREENED bank!.
  230.  
  231. ABOUT
  232. -----
  233. More usefull Information about the Program ... PLUG! PLUG! 
  234.  
  235. Pressing F10 will now let you load in your own Soundtracker Music if
  236. you get bored with mine!(Uses AMOS file REQUESTER V1.34).
  237.  
  238.  
  239. MAP EDITOR V1
  240. -------------
  241. This is a new system that has just been built in to it.
  242. You must consider this independent of the main screeneditor program although
  243. it uses the same display!.
  244.  
  245. A display panel will pop up and you will see in the middle of the display
  246. a grid.This grid signifies where a screen is located in memory (Rather like
  247. a map).The actaul information in the map is stored in a 2 dimensional array.
  248.  
  249.  MAP(14,10)
  250.  
  251. Hense the map size 14 x 10 !
  252.  
  253. All this map editor really does is store screen numbers in this MAP array.
  254.  
  255. First of all you can move around the map using the four << /\ >> \/ icons,
  256. This will move the little blue cursor around the map.If you have just 
  257. turned on the editor all the map location will have screen number 0 in them.
  258. You can turn this map editor on or off without losing data! so experiment!.
  259.  
  260. To the left you can see a display with four bits of information :-
  261.  
  262. MAP X :    ( X Position on map)
  263. MAP Y :    ( Y Position on map)
  264. STORED SCREEN NO:      (The screen number stored at position X and Y)
  265. CURRENT SCREEN NO:     (The current screen number ready to store)
  266.  
  267. Clicking on the SCREEN + and  SCREEN - icons will move up and down the
  268. screens just like the SCREENEDITOR!.
  269.  
  270. Once you have choosen a screen and found the position on the map for the 
  271. screen to be stored on click on the STORE SCREEN icon.This will now store
  272. the current screen number at the current MAP location.
  273.  
  274. Clicking on the SAVE ASCII icon to save to MAP data to disk ,This data can
  275. be later loaded back into your own programs using the Procedure provided
  276. on this disk!.
  277. Clicking on the LOAD ASCII will load in a saved map file so you can continue
  278. where you left off!.
  279. The Jump to SCREEN option is also included in this editor READ earlier to
  280. find out how to use.
  281.  
  282. With this editor it is now possible to make complex maze/puzzel infact any
  283. game that requires screens!!!.You could make a flick screen gauntlet clone
  284. with the minimum of fuss!.
  285.  
  286. Click EXIT to return to the SCREEN EDITOR .You will not lose your data so
  287. you can switch between the two!.
  288.  
  289. Pressing the Backpage gadget will switch you out of the editor into the
  290. CLI.You will now notice a CLI window With the SCREEN EDITOR title.Simply
  291. press return in this window when it is active to return to the editor!.
  292.  
  293. Pressing the close Gadget will exit the editor (BUT YOU DONT WANNNA DO IT 
  294. LIKE THAAAAT!!!)  :-))))))
  295.  
  296.         Using the Extra Procedures
  297.         --------------------------
  298.  
  299. _SCREENUM[NO]
  300.  
  301. First load in the program SCREENPASTEPROC.AMOS into amos.In this program
  302. you will find the above procedure.This Procedure will print up a screen
  303. made by screen editor v2.2 very quickly indeed!.
  304.  
  305. To use Load in your Screen ED bank into bank 7
  306. Next load in the icon bank associated with the screen bank into amos
  307. Now for the tasty bit:-
  308.  
  309. The SIZEX and SIZEY array are the size of the icons used in pixels
  310. Input these where it says in the code
  311.  
  312. SIZEX= 8, 16 or 32
  313. SIZEY= 8, 16 or 32
  314.  
  315. Also input the colour into the array SRC 
  316.  
  317. SRC= 4 ,8,16 or 32
  318.  
  319. By Simply typing the actual screen number you want to display instead of
  320. NO you will make that screen instantly appear!.
  321.  
  322. _SCREENUM[5] 
  323. Will Show screen 5!
  324.  
  325.                 --------
  326. Load the program SCREENMAPPROC.AMOS and read on...
  327.  
  328. Procedure _loadasciimap[ Filename$ ]     
  329.  
  330.  
  331.  
  332. This loads the array SCRNMAP(14,10) with all the map data 
  333. Created using ScreenMAPEditor V2.2 
  334. This array can now be interrogated to find out at what location on the
  335. map a screen is 
  336. E.I 
  337.  
  338.  Array scrnmap(14,10) 
  339.  
  340.  0 1 2 3 4 5 6 7 ...14
  341.  1  
  342.  2     1
  343.  3   1 2 1  
  344.  4     3
  345.  .
  346.  .
  347.  10
  348.  
  349.  So at location 4,3 screen 1 would be used  
  350.  And at loctation 3,4 screen 3 would be used  
  351.  
  352.  So...  
  353.  
  354.  SCREENUMBER=SCRNMAP(4,3) 
  355.     ... 
  356.  SCREENUMBER=1
  357.   
  358.  Once the screennumber is found you can now use the screen display proc 
  359.  To paste the choosen screen on the screen!.
  360.  
  361.  This system can be used to make complex maze games with multiple screens 
  362.  
  363.                 History
  364.                 -------
  365.  
  366.  
  367. Version 1.01
  368. ------------
  369. The original SCREENED.I had the cheek to release this into PD it only dealt
  370. with one screen!,Which was then saved as an ASCII file anyway!.No icons
  371. system either everything by keyboard and the cursor was moved by using the 
  372. joystick!.The icons size was only 16 by 8! no other choice! Pathetic! 
  373. Destroy this if you are unfortunate enougth to have a copy.It was my first 
  374. bit of coding I used it for a breakout game!.I can laugh about it now 
  375. SPEEWWW!!!   8-)
  376.  
  377. Version 2.0
  378. ----------- 
  379. The big one I decided this would be it! Everything MUST be possible with this
  380. new version!.
  381. Only used 40 screens (Found later not to be Enough!)
  382. Workbench 2 feel!
  383. Not released to public only a beta test
  384.  
  385. Version 2.1
  386. -----------
  387. Added Jump to and Copy to for easier and quicker use!
  388. Added Music Options to relieve bordem!
  389. Added New pop up requester that pops up from behind the panel! Excellent!!!
  390. Added Bob image to the mouse pointer now you can see what icon your using!
  391. Added space for 80 screens 
  392. Added System bits information panel
  393.  
  394. Version 2.2
  395. -----------
  396. Wrote Map editor V1 section.This was needed by me for a game that I am about
  397. to write!.Watch out for it its called PONGO! it great! (but I would say that!)
  398. Rewrote the icon system as it used the old paint routine to indicate 
  399. selection.Now its much quicker using the bar system written by me.Also eats
  400. less memory.(You can check out the old system as I couldnt be bothered to
  401. change to icons in the MAP EDITOR!)
  402. Reduced Screen colour on the icon panel from 8 to 4.Faster and frees up 
  403. even more lovely memory!.
  404. Added a flick option between CLI.A window will be created in CLI everytime 
  405. you flick out of the editor! (SLEEP MODE!) Looks cool as well.
  406. Added Option to load in other soundtracker SONGS.
  407. Seems To multiTask Pretty well now also!!!.
  408. Added much needed but forgoten FILL SCREEN option.
  409. Added The clear music option to free even more memory!
  410. Now displays the current icon while flicking through! 
  411. Fixed Some silly bugs!(Read ASCII in map editor didnt work proparly!)
  412.  
  413. The future...
  414. -------------
  415.  
  416.  
  417. These things have to be said....
  418. Please dont hold me responsible if this program causes distress to you and 
  419. your system or if it chews a disk/explodes a chip or starts world war III
  420. that sort of thing!.
  421. Any further updates will be largely due to YOU so please write to me!.If
  422. there is enough response or intrest I will make an AMOS PRO version when
  423. the compiler comes out!(Hurry up Francois!!!).
  424.  
  425. I hope you can use this program ,The potential is there to produce huge
  426. amazing screens....But maybe later!....
  427. Any bug reports/ critisms or if you would like to chat to me about AMOS ect
  428. then write to the address earlier!. 
  429. Going to go now...
  430.  
  431.                  |-)
  432.  
  433. Ejber Ozkan 1993. 
  434. Last docs update 17 Feb 1993.
  435. Storm.
  436.