____ ____ ____ ________ / | | _ \ | _ \ / / / _ | __ __ __ | | \ | | | \ | /_____ / / / | | | / / \ | |_/ | | |_/ | / / / /__| | | | | __/ | __/ / / / ____ | | /| /| | | | | | / /_____ / / | | | | | | | | | | | | / / __ /__/ |_| |_| |_| |_| |_| |_| /_______/ /_/ A m P P 2 (C) copyright 1991 M. Burbidge I have included my source code on the disk, this may be modified on the conditions that 1) Any updated program gives credit to the original author (M. Burbidge). 2) The original program is distributed, with it's icon, in the same directory as the modified program. 3) The original source code is also distributed, with it's memory banks unaltered. 4) All original documentation is included. 5) I am informed of the release, and to what library it's been sent. My address is M. Burbidge, 107 Heron Rd, Larkfield, Kent, ME 20 6JL, ENGLAND. AmPP has been written and tested on a 1 Meg Amiga 500. With External Diskdrive, and Kickstart 1.3. Any Bug reports are welcome. 1. Introduction. AmPP 1 was never written. But no, this isn't a cheap ploy to make you think this is an update. I wrote AmPP V0.9 last summer (1991) and have only just got round to releasing it. It was called AmPP V0.9 because I hadn't quite finished it and it was intended as a pre-release. When I came around to updating it, I found it more trouble than it was worth, and thought of new features which I would like to include, or rewrite. So I started again from scratch. So this is a Complete rewrite of AmPP. This program only took about a week or so from conception to the first working copy, and for the last fortnight I've hugged it and kissed it and called it George until it was finally mature enough to take a stand in the world. It had it's first compilation today, and thoroughly enjoyed the experience, you always remember your first time don't you?? AmPP is diskware. If you use it, then send me some PD, and as soon as I can I'll return your own disk with some new PD on it. (Although I wouldn't turn down Cash, cheques, postal orders, beer, gifts, legacies etc. etc.) AmPP stands for the (Am)os (P)ainting (P)ackage. Amos is a BASIC compiler/interpreter available from Mandarin Software, Europa House, Adlington Park, Adlington, Macclesfield, Cheshire SK10 4NP. ENGLAND. Amos is one of the best languages to program your Amiga in. 2. Multi-tasking ability. AmPP is fully multi-tasking. The processor is made available for other programs whenever you are not drawing. To hide AmPP and use other programs hold down the Amiga key and press A. The same combination will restore AmPP. AmPP is still running in the background but you will not be able to see it with the screen gadgets. 3. Background Colours. Later in this file I may refer to Background colour. The Background colour is defined as the last colour you selected. So if you have a white pen selected, and you change this to red, your background colour will be white. This is important for the fill patterns, and colour cycling. 4. Drawing tools. The Drawing tool icons can be accessed by pressing the right hand mouse button when on the drawing screen. If ever presented with a requester you will be presented with two options, respond be pressing either the right, or left mousebutton, as indicated. I am afraid that I cannot show you here what each icon looks like, but I hope that you should be able to work them out from the description of what they do. I have tried to make the icons as self-explanatory as possible. Sketch Hold the left button, Draws dots following the mouse. Draw Hold Left Button, Draws a line following the mouse. Line Hold the left mousebutton, a straight line will be drawn to the current mouse position. Release the mouse to fix the line. Ray Position the mouse, hold the left button. A series of lines will be drawn from the original mouse position to the current mouse position. This is best imagined by picturing a fan. Ellipse By holding the left button one can draw an ellipse. By using the filled ellipse tool filled ellipses can be drawn. Good innit?? Circle See Ellipse Box See ellipse Parallelogram Hold the left mousebutton, and draw your baseline as in the line tool. Upon releasing the button and moving the mouse, a parallelogram will come into view. Click the left mousebutton to fix it. It may sound convoluted, but as they say in the trade: suck it, and see! There is also a filled parallelogram tool. Triangle As Parallelogram Cut As Box, except an area of the screen will be copied into the sprite bank (AMOS jargon) and used as a brush when paste is selected. Paste Use the brush. The default brush is the AMOS sprite. Alphanumeric Put text on the screen. Click on the screen using your mouse, and type your text. Pressing return fixes the text. By holding the left mousebutton, and moving the mouse the text may be moved about. Cancel by deleting all the text and pressing return. Ban Red/Green/Blue. Each colour you see on the screen is made up of different components of Red, Green and Blue. The Ban tool sucks out all Red/Green or Blue from a picture. This doesn't save any memory. A requester is presented to check your intent. Flood Flood fills an area of the screen. Ensure that the area is closed or the colour may leak out to fill the screen unintentionally. Set Pattern Choose a pattern to use in the floods, filled boxes, triangles and parallelograms. To cancel these effects choose the first fill pattern. The plain one. The pattern will use the current foreground and background colours (see above) Magnify Allows you to look at a section of the screen in detail, be warned you may draw on the magnification and cancel your changes with no ill effect. But if you scroll around, or change magnification, any changes made before that will be permanent. Palette Adjust individual Colours, See Below. Save/Load Palette Save or load a set of colours. Spray This is the classic spraycan effect. Set-Spray This sets the spraycan size for the spray, star-spray and mix effects. You should see a prompt about halfway down the screen, type in a number. Star-Spray. Identical to spray but has a star effect. Ideal for pom-poms! Mix. Ignores the current ink colours and mixes the pixels about onscreen, ideal for blending colours, ie in a Sunset scene. Undo Unfortunately this isn't implemented. I just can't get my mind round it for some reason. But fret not! I shall sort it out sooner or later. Font Sets the font for use with the Alphanumeric function. BEWARE, you must have the font libraries on the boot disk, or you'll get an error. Some fonts eg V-INTRO, do not have lower case letters, so do not panic if Alphanumeric fails to work with your font. Try Upper case! Grid. Draws a grid in the current ink colour on the screen, the box size can be either 16x16 or 32x32. This is useful for map tiles and sprites. Cycle Cycles the colours between the foreground and background colours at the time of starting the cycle. You may use the up and down cursor keys to change the direction of the cycling, and the +/- keys to control the speed. When happy with the cycle press a mousebutton and you can continue drawing. The cycling is interrupt driven, and so will not affect the running of AmPP. The cycling can be stopped by clicking on cycle again and replying STOP IT! to the requester. Pic Load/Save Saves or loads an IFF picture. Pick If you want to choose a colour, but aren't sure which you need from the palette as there are many similar shades, then choose pick and select the colour you need directly from the screen. Clr Clears the screen. The option will be given to change the screen mode. Info All about me!!!! Use this option a lot !!!!!!!!!!! Bye Don't use this one, it blows up your computer. This program will someday be updated for HAM mode. Hence the inclusion of HAM on the Screen mode requester. 5. Palette The Palette is fairly standard. Except for the Merge tools. You will notice some boxes. The first gives a colour gradient of a specific component colour (chosen by clicking on the last three boxes) The gradient goes from 0 to 15, and so smooth transitions are possible. The next three boxes shift the palette up or down, or reverse the palette. The next box is the merge. This gives a smooth transition between the start colour component and finish colour component. As I've said choose whether to act upon the Red, Green or Blue components by selecting a colour box. The start and finish points can be changed by clicking on start or finish. The indicator arrows above the palette will move to indicate the end points for the palette operations. Although this is a simple system, and it does take some getting used to, it can be very powerful, giving smooth colour changes from red to yellow to green to blue, for instance (this operation needs changes of the start and finish points). Note the palette control icons will not do anything unless you have chosen a colour component for them to act upon. If they still don't work then check that start and finish don't point at the same colour. 6. Bye. I hope I've mentioned everything. Please note that if you distribute this disk, it may not work without certain libraries etc. There should be a file on this disk somewhere containing a directory of the disk I distributed. Some files may not be needed. But if you delete the wrong ones you may stop some obscure part of the program working. Anyone for Russian Roulette??