Frozen Fish 1: Amiga

home *** CD-ROM | disk | FTP | other *** search

/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d531 / graffiti.lha / GraffitiE / UserGuide < prev next >

Wrap

Text File | 1991-08-26 | 30KB | 897 lines

[0m[0 p [0;1mUser Guide for[0m [0;1m Graffiti V1.0[0m Copyrights 1990-91 by [0;1m Marcus Schießer[0m written in the Years 1990-91 by [0;1m Marcus Schießer[0m [0;1;3;4mREAD FIRST READ ME![0m [0;1mCONTENTS[0m [0;1m1[0m. [0;1mINTRODUCTION[0m................................... 4/181 [0;1m2. [mTHE MENU[0m....................................... 4/198 [0;1m3. THE DRAW-FUNCTIONS[0m [0ma) Pencil ..................................... 4/216 [0mb) Dots ....................................... 4/223 [0mc) Line ....................................... [0m4[0m/231 [0md) Bezier-Arcs ................................ 5/241 [0me) Fill ....................................... 5/252 [0mf) Airbrush ................................... 5/259 [0mg) Rectangle .................................. 5/267 [0mg2) 3D-Rectangle .............................. 5/274 [0mh) Filled Rectangle ........................... 5/285 [0mi) Circle ..................................... 5/291 [0mj) Filled Circle .............................. 6/301 [0mk) Ellipse .................................... 6/307 [0mk2)Rotatable Ellipse .......................... 6/313 [0ml) Filled Ellipse ............................. 6/321 m) Polygon .................................... 6/327 n) Text ....................................... 6/334 o) Get new Brush .............................. 6/343 [0;1m4. THE COLOURS[0m [0ma) Change present Colour ...................... 7/363 [0mb) Mix a new Colour ........................... 7/372 [0m1) Spread .................................. 7/391 [0m2) Cycle ................................... 7/402 [0m3) RGBH .................................... 7/408 [0m4) Random Colours .......................... 7/414 [0m5) B&W ..................................... 8/421 [0m6) Antique ................................. 8/425 [0m7) Negative ................................ 8/432 [0;1m5. CHANGE FILL-PATTERN [0m........................... 8/439 [0;1m6. FONT-REQUESTER [0m................................ 8/453 [0;1m7. [mINPUT/OUTPUT FUNCTIONS[0m [0ma) Install a new Font ......................... [0m8[0m/467 [0mb) Load an IFF-Picture ........................ 9/481 [0mc) Save an IFF-Picture ........................ 9/493 [0md) Delete a File .............................. 9/500 [0;1m8. SCREEN-OPERATIONS[0m [0ma) Open new Screen ............................ 9/510 [0mb) Convert present Screen ..................... 9/517 [0mc) Flip Screen ................................ 9/526 [0;1m9. CHANGE VALUES[0m [0ma) Change Draw-Mode ........................... 10/543 [0mb) Change Preferences ......................... 10/555 [0;1m10.BRUSH-OPERATIONS[0m [0ma) Flip ....................................... 10/582 [0mb) Zoom ....................................... 10/586 [0mc) Load & Save ................................ 10/592 [0md) Hot Spot ................................... 11/601 [0;1m11.CLEAR[0m [0ma) Undo ....................................... 11/611 [0mb) Clear Screen ............................... 11/616 [0;1m12.MAGNIFIER[0m [0ma) Magnifier on/off ........................... 11/629 [0mb) Change Magnification ....................... 11/637 [0;1m13.GRID[0m [0ma) Grid on/off ................................ 11/652 [0mb) Change Size of Grid ........................ 12/661 [0;1m14.OTHER THINGS[0m [0ma) The ON-LINE Calculator ..................... 12/672 [0mb) Autoscrolling .............................. 12/680 [0mc) Coords on/off .............................. 12/686 [0md) The INFO Window "NORM LOW" ................. 12/694 [0me) The Banks .................................. 12/701 [0mf) Change present pre-defined Brush ........... 12/710 [0mg) About ...................................... 13/721 [0mh) How to use the FILE-SELECTOR(TM) ........... 13/729 i) Quit Graffiti .............................. 13/741 j) Multi-Tasking .............................. 13/745 [0;1mAPPENDIX[0m [0mA. KEYBOARD-TABLE ............................. 14/783 [0mB. KNOWN BUGS ................................. 14/827 [0mC. UPDATES .................................... 15/841 [0mD. ERROR MESSAGES ............................. 15/852 [0mE. SPECIALS ................................... 15/873 [0mF. REQUEST .................................... 15/885 [0mG. MY ADRESS .................................. 15/890 [0;1m1. INTRODUCTION[0m Graffiti is an art progam for the art computer called Amiga. You can use it also as a sprite editor for AMOS. The program was made with love and was declared as nearly bug-free by myself. But if you find an error, so please call me. The program uses as first art program the third mouse button called MMB. But I wasn't able to test if the MMB-routine runs or not, because I'm not a happy owner of a third mouse button mouse. At this point I want to send thanks to Helene Taran who wrote the PD-Bezier-Arc-Routine. I also thank François Lionet, the guy who coded AMOS and the Fastzoom- Routine of Graffiti. I wish you much fun using Graffiti. And always remember: Send the money to me and you'll get the full version. [0;1m2. THE MENU[0m All functions of the menu are called by pressing the left mouse button, all instead of a few others. But these are extra marked. You can turn on and off the menu by pressing either the third Mouse-Button called MMB or the space key. You can also move it up and down by pressing the cursor keys. Pressing the right shift key raises the speed with that the menu is moving. The left shift key places the menu on the upper corner of the screen, the left alt key places it on the lower corner. [0;1m3. THE DRAW FUNCTIONS[0m In the toolbox of the menu you can find all draw functions. They are normaly called by pressing the left Mouse-Key over the icon. [0;1ma) Pencil[0m After clicking [0mon the icon with the "snake", you can draw like with a pencil. Only move the mouse cursor on any point of the screen, press a mouse key, keep on pressing and move the mouse. You are Drawing! [0;1mb) Dots[0m Just a click on the icon of the "pointed snake" calls the function "Dots". Using the function is like using the function "Pencil". Only the result is not the same. "Dots" makes dots and no lines. But if you want to draw with a selfmade Brush you can only draw with your Brush with this function. [0;1mc) Line[0m Icon: "line". Just move the mouse cursor at the start point of the line, then press good old mouse key and keep on pressing. After that move the Mouse to the end point of the line and at last get your finger of the button. [0;1md) Bezier-arcs[0m Icon: "arc". The most complex function. At first you draw a line analogous to the Line-Function. After that at the start point and at the end point of the line two small squares appear. If you click on one of these squares (and keep on pressing), you are able to change the amplitude of the arc by moving the mouse. After a short click on the left mouse button, the final arc will be drawn. [0;1me) Fill[0m Icon: "next to arc-icon". Just move the mouse cursor over the place which should be filled, press the mouse button and the region will be filled in the selected colour. [0;1mf) Airbrush[0m Icon: "airbrush-can". When you are pressing a mouse button, a few dots are randomly drawn in a given radius. By pressing the icon with the right button you can change the given radius. It's like the circle function. [0;1mg) Rectangle[0m Icon: "hollow rectangle". It's like the line function, but the start point of the line is this time the left upper corner of the rectangle and the end point is the right lower corner of the rectabgle. [0m [0;1mg2)3D-Rectangle[0m This function is activated by pressing the right mouse button on the icon "Rectangle". It's the same as the normal rectangle function, but the upper and the left line of the rectangle are drawn in the colour of the first pen. The lower and the right line are drawn in the colour of the second pen. If the first pen is white, the second is black and the background colour is grey, then it looks like a three dimensional button. The buttons of the menu are drawn with this function for examples. [0;1mh) Filled Rectangle[0m Icon: "filled rectangle". It's like the function with the hollow rectangle, but the rectangle is drawn filled this time. [0;1mi) Circle[0m Icon: "hollow circle". After pressing the mouse button, the position of the mouse cursor is used as mid-point of the circle. Now you can change by moving the x-position of the mouse cursor the radius of the circle. At last get your finger of the mouse button and the final circle will be drawn. [0;1mj[m) [mFilled Circle[0m Icon: "filled circle". Like function circle, but this time there's no hollow circle, there's a filled circle. [0;1mk) Ellipse[0m Icon: "hollow ellipse". Like the circle function, but you can change the y-radius of the ellipse by moving the y-position of the mouse cursor. [0;1mk2)Rotatable Ellipse[0m This function is a[0mc[0mtivated by pressing the "hollow ellipse" icon with the right mouse button. You can use it like the "Ellipse" function, but after depressing the mouse button you are able to rotate the ellipse my moving by mouse. After another click the final ellipse will be drawn. [0;1ml) Filled Ellipse[0m Icon: "filled ellipse". It's like the "Ellipse" function, but the ellipse is drawn filled this time. [0;1mm) Polygon[0m Icon: "just right to "filled ellipse"". After every mouse click (right or left) a new point of the polygon will be set. Pressing the space key or the third mouse button will draw the final polygon. [0;1mn) Text[0m Icon: "hollow T". After activating the function, you have to input a text by using the keyboard. The text will be used in the actual font as a brush. You can change the actual font with the [0;1mFONT-[0m [0;1mREQUESTER[0m. If you push the ENTER key without input a text before, the last text will be used. [0;1mo) Get new brush[0m Icon: "right to the T". It's like the "rectangle" function, but the contents of the rectangle is used as a brush. With this new brush you can draw with the "dots" function. The brush will be saved in the brush- bank under the a[0mctual number. [0;1m4. THE COLOURS[0m [0;1ma) Change present Colour[0m Just above the menu all colours of the active screen are listed. Pressing one colour with the left mouse button uses the colour as first colour pen. Pressing the right one will use it as second colour pen. Usually you can use the the first pen by pressing the left button and the second pen by pressing the right button. [0;1mb) Mix a new Colour[0m If you press the icon with the four-coloured square, the colour requester appears. With this you can mix your own colours. In the colour list (just above the requester) you can choose the colour you want to change. On the left side of the requester you are able to change the RGB values of the colour. R stands for Red, G for Green and B for Blue. For changing one value just press the mouse button over the slider and move the mouse. Just next to it you can find the sliders for changing the HSV values of the colour. H stands for Hue, S for Saturation and V for Value. On the right side of the requester are three other buttons: OK,UNDO and QUIT. Pressing OK uses the mixed colours and quits the requester. UNDO sets all colours to the last ones. QUIT just quits the requester without using the new mixed colours. With this knowledge you are able to mix a few colours, but the colour requester of [0;1mGRAFFITI(TM) [0mis able to do lots of other nice things. [0;1m1[m) Spread[0m This allows you spreading from one colour to another colour. Think of you want in a 16-Colour Screen a spread from black to white. At first click at the first colour and set the RGB values to zero then click on the last colour and set the values to F. Then click on the "Spread" button. Another mouse cursor (An arrow) appears. Now you click on the first colour and you're the proud owner of a black to white spread. The function also should work with other colours. [0;1m2) Cycle[0m With this you're able to set the colour range of the [0;1mCYCLE[0m draw mode. It's the same use like "[0;1mSpread[0m". The slider just under the cycle button allows you to change the [0mcycle speed. [0;1m3) RGBH[0m This allows you to change the Red-, the Green-, the Blue- or the brigHtness values of all colours at the same time! Pressing "+" increases the value "-" decreases the value. [0;1m4) Random Colours[0m This changes randomly all colours. Maybe that can look pretty pretty at a few pictures. [0;1m5) B&W[0m Calculates all colours to black and white values. [0;1m6) Antique[0m Calculates all colours to black and white values and after that it increases the red value of all colours with the pregiven value (fr[0mo[0mm 1 to 3). A picture looks after calling the function like a very old black and white photo. [0;1m7) Negative[0m This nice function changes the actual screen to a photo negative. Negations all colours of a screen. [0;1m5. CHANGE FILL-PATTERN[0m If you wanna like to change the actual fill pattern, so just click with the right mouse button on the "fill" icon. All possible fill pattern appear on the same position where before the menu was. Just click with the left mouse button on the pattern you want to use and you'll be able to use it. On the right-down side of the requester appear the self-defined fill pattern. If you want to create other self-defined fill pattern use the [0;1m"Get new brush"[0m function. But be careful: The fill pattern uses only 16 pixels (in the width) of the brush. [0;1m6. FONT-REQUESTER[0m The requester appears when you are pressing the "T" icon with the right mouse button. Now you can choose one of the installed fonts. On the right side of the screen is an example of the font shown. Pressing the left mouse button uses the selected font in the [0;1m"Text" [0mfunction. With the right mouse button you are able to change the font attribute: normal, bold, italic, outline, shadow and a few combinations of them. [0;1m7. INPUT/OUTPUT FUNCTIONS[0m [0;1m a) Install a new Font[0m [0;1m [0mIcon: "hollow F". This function only copies one with the file-selector selected font (*.font) into the FONTS: device. Using this function with sense, you have to make a new directory in the RAM: device called fonts. Then define it as FONTS: device. You can make it like this: makedir[0m ram:fonts (or makedir dh0:fonts) assign fonts: ram:fonts (or assign fonts: dh0:fonts) After that you should find your new-installed font in the [0;1mFONT-[0m [0;1mREQUESTER[0m. If you're a happy owner of a hard-disc (I'm not), [0myou can also use the hard-disc as font-cache-memory. [0;1m b) Load an IFF-Picture[0m Icon: "Arrow-Up". This loads an IFF-Picture (ILBM). There are two differences: You can load the picture on the actual screen, but you can also let open a new screen with the same size of the picture before and then load the picture on the screen. Pressing right one loads picture on actual screen, pressing left one open new screen before. Before loading the picture the [0;1mFILE-SELECTOR[0m(TM) appears and wants to know what picture you want to load. [0;1m c) Save an IFF-Picture[0m Icon: "Arrow-Down". The [0;1mFILE-SELECTOR[0m(TM) appears and asks you kindly about a filename. After that the actual screen will be saved in IFF- ILBM-FILE-FORMAT under this name. [0;1m d) Delete a File[0m Icon: "Pfeil nach Unten". Once again the [0;1mFILE-SELECTOR[0m(TM) appears and wants to know a filename again. This filename would be deleted. This is quite useful if you want to delete an installed font. [0;1m8. SCREEN-OPERATIONS[0m [0;1ma) Open new Screen[0m Icon: "S in a square". Many requesters apears one after the other and asks you lots of things about the screen you want to open. Resolution, Number of Colours and Size. [0;1m b) Convert present Screen[0m Icon: "S in a Quadrat". It's the same like [0;1ma)[0m, but the contents of the screen will be copied into the new screen. If you answer the question "Shall I resize the picture?" with yes, then it tooks a while, because the screen will be look in the new resolution like in the old resolution after that (When you know what I mean?). [0;1mc) Flip Screen[0m First you will be asked if you want to flip the picture on the X-Axis or on the Y-Axis. After that the picture will be flipped on this axis. [0;1m9. CHANGE VALUES[0m [0;1m a) Change Draw-Mode[0m [0;1m [0mIcon: "?!". A Requester appears. He asks you with which draw mode you want to draw. Graffiti knows three draw modes: Normal, CycleF, Cycle1. If you use normal, the colours aren't changed during drawing. CycleF changes the colours every time. It cycles from the first cycle mark to the last cycle mark and starts then at the first mark and so on... You can set the cycle marks with function [0;1m4.2)b)[0m. Cycle1 is the same as CycleF, but it changes every time the colour mark in the colour palette, too. [0;1mb) Change Preferences[0m [0mIcon: "?!". Right mouse button. A requester appears and wants to know what you want to change. If you want to change the position of the shadow, then a few direction arrows appear and an example for the actual shadow position. You can change it with the arrows. Clicking on OK saves the position. You can also change the preferences of the arc. The size of the button, the resolution at start and at end. The higher the value, the lower is the resolution. Use only start values which are greater than the end values. The cross which normaly appears by the line and the rectangle functions could be turned off by pressing the "OFF" button and turned on by pressing the "ON" button. [0;1m10. BRUSH-OPERATIONS[0m Icon: "The Smilie". Here you can choose what you want to do with the actual brush. You are able to flip and zoom it. Also you can load or save a brush-bank (AMOS *.abk compatible! Because of this you can use it as AMOS Sprite-Editor). If want to use the brush colours saved in the brush bank as screen colours then press the "Colour" button. It's also possible to change the hot spot of the brush. [0;1ma) Flip[0m Just flips a bob at the selected axis! [0;1mb) Zoom[0m The present brush will be always zoomed from the upper-left screen corner to the actual mouse position. After being at the wished zoom-factor press the left mouse button. [0;1mc) Load & Save[0m The [0;1mFILE-SELECTOR[0m(TM) appears and you have to choose a *.abk file. [0;1md) Hot Spot[0m The same picture appears like by the shadow position function. If you press the left arrow, the hot spot of the brush will be set on the left side. Pressing the right arrow and the hot spot will set to the right side. And so on.... [0;1m11. CLEAR[0m [0;1m a) Undo[0m [0;1m [0mIcon: "UNDO". Undos the things that you had drawn before. [0;1m b) Clear Screen[0m [0;1m [0mIcon: "CLR". Clears the whole screen. There are two differences: Clicking the icon with the left mouse button uses the old colours, Clicking on the right button sets all colours to the default. [0;1m12. MAGNIFIER[0m [0;1m [0m Icon: "THE MAGNIFIER". [0;1ma) Magnifier on/off[0m With the magnifier you're able to draw more exactly. After calling this function, you have to choose the part of the picture which should be magnified. Using the magnifier of Graffiti you're able to use all draw functions instead of zooming brushes. Pressing the icon turn on/off magnifier. [0;1mb) Change Magnification[0m Pressing the icon "THE MAGNIFIER" with the right mouse button changes the magnification of the magnifier. So far there are only two magnifications: factor 2 and factor 4. But in a later version I will add factor 8 and factor 16. Also you're able to scroll into the magnified screen by going to end of the screen. [0;1m13. GRID[0m [0;1m [0mIcon: "Cross in a square". [0;1ma) Grid on/off[0m With this you're able to draw only every 6th pixel position (grid is on). If the grid is off then every position a new pixel will be drawn. This is useful if you want to draw a diagramm. But I can't explain that function that well, so try it and you will see it. [0;1mb) Change Size of Grid[0m If you press the icon with the right mouse button, then you can change the width of the grid (for example instead drawing every 6th pixel, every 10th pixel). Using this function is like changing the radius of the airbrush. [0;1m14. OTHER THINGS[0m [0;1m a) The ON-LINE Calculator[0m [0mIcon: "1+2=4". Instead of the colour palette a small window appears. Now you can use the part of the keyboard with the numbers to input your calculations. It's very useful, if you want to calculate coordinates. [0;1m b) Autoscrolling[0m Every time when you move the mouse cursor on the end of the screen, the screen will be scrollt to this direction. Only by screens which are larger than the monitor screen. [0;1m c) Coords on/off[0m Graffiti gives the possibility to show the coordinates of the mouse cursor. Press the "NORM LOW " button and instead of "NORM LOW ", the coordinates appear in the following position: At first the X-Position and then the Y-Position. Pressing the button turns the function on or off. [0;1m d) The INFO Window "NORM LOW"[0m This gives you information about the draw mode (NORM for NORMAL, CYCF for CYCLEF and CYC1 for CYCLE1) and about the resolution of the actual screen (LOW for LOW-RES, HI for HI- RES and I for Inter-Laced) [0;1m e) The Banks[0m You maybe have asked what sense the numbers at the menu have. Simple! With the small numbers from 1 to 20 you can change the actual brush. With the great numbers from 1 to 6 you are able to change the actual screen. Changing a screen tooks a bit time, because Graffiti crunches and decrunches the screens. But with a low-res screen with 2 colours it's quite fast. [0;1m f) Change present pre-defined Brush[0m Just click on the wished brush on the right side of the menu and you can draw with it! [0;1mg) About[0m If you click on the great Graffiti sign, then an even more greater Graffiti sign appears and a few informations about the author. If you click on the icon with the right mouse button then a few infos about the actual screen and the memory appear. There are not so important like them from the author. [0;1m h) How to use the FILE-SELECTOR(TM)[0m A click on the small circle changes to the PARENT-directory. Pressing on the right mouse button shows all available devices. You can choose one with the left mouse button. Arrow- Up scrolls the entry up, arrow-down scrolls it down. OK loads, saves or deletes the selected file (depends on the selected function). Quit quits the [0;1mFILE-SELECTOR[0m(TM) without doing anything. Sort sorts the entry in alphabetical order. SetDir sets the actual directory as main directory. It's like CD from CLI. [0;1mi) Quit Graffiti[0m Only press at the same time Ctrl & C. [0;1mj) Multi-Tasking[0m Pressing Amiga + A at the same time toggles between the workbench- and the Graffiti-screen. [0;1mAPPENDIX[0m [0;1mA. KEYBOARD-TABLE[0m [0;1mWarning: [0mPut this into your brain: R stands for Right L stands for Left Ami stands for Amiga-key SH stands for Shift-key Ctr stands for Control-key CUP stands for Cursor up CDO stands for Cursor down MMB stands for middle(third) mouse button SPC stands for Space-key But now, let's go: X Flip brush on X-Axis X+RSH Flip screen -||- Y Flip brush on Y-Axis Y+RSH Flip screen -||- Z Zoom brush LSH Place Menu at the upper end of the screen LALT Place Menu at the lower end of the screen SPC o. MMB Menu on/off CUP Menu up (slow) CUP+RSH Menu up (fast) CDO Menu down (slow) CDO+RSH Menu down (fast) Ctr o. MMB Deletes (during a draw operation) not every time that what before was drawn 1-10 Changes to 1.-10. Brush 1-10+RSH Changes to 11.-20. Brush Ctr+C Quits Graffiti LAmi+A Toggles between the workbench and the Graffiti screen RAlt Changes (during a draw operation) only Y-Coordinates RAmi Verändert (during a draw operation) only X-Coordinates TAB Color-Cycling on/off Pressing a key on the part of the keyboard with the numbers activates the On-Line Calculator! [0;1mB. KNOWN BUGS[0m - Beware of the [0;1mFILE-SELECTOR[0m(TM): (Error of the AMOS-Compiler) If a System-Requester appears, do what he say! If not, Guru calls you to a medidation hour. - It's not possible to open a Hires interlaced screen greater than 640*400 pixel. Sorry, I don't know why! [0;1mC. UPDATES[0m - HBrite Mode - Drawing with brushes with only one colour (COLOR MODE) - Printer - 8x and 16x Magnifier - Perspective-function - Brush-Rotating Please write if you've got another idea! [0;1mD. ERROR MESSAGES[0m If you should have any problems with error numbers: 32: Can't fit picture in current screen! 86: Device not available! 85: Directory not empty! 80: Directory not found! 88: Disc full! 83: Disc is not validated! 84: Disc is write-protected! 95: File format not recognised! 89: File is protected against deletion! 91: File is protected against reading! 90: File is write protected! 81: File not found! 94: I/O error! 93: No disc in drive! 92: Not an AmigaDOS disc! [0;1mE. SPECIALS[0m - More than one brush at one time in memory - More than one screen in memory - Flipping whole screens - Changing RGB values from all colours at the same time - Autoscrolling - Ability to move the menu - Ability to convert the screen to another resolution - Full NTSC-compatible (I hope!) - 4-Point Bezier-arc [0;1mF. REQUEST[0m I'm searching for the AMOS Screen and Sprite offsets! If you know them, so please send them to me! [0;1mG. MY ADRESS[0m Marcus Schießer Heimatstr. 8 W-6460 Gelnhausen 2 WEST GERMANY Tel.: 06051/66949 [0m[1 p