P A S T E D O C ================= CREDITS: This prog was written by ALPHA FLIGHT 1991 Coding: Erik Hilfrich Wittelbachstr. 14a 4000 Duesseldorf Germany PUBLIC DOMAIN MESSAGE: THIS PROGRAM IS COMPLETELY FOR PUBLIC USE. YOU MAY USE IT IN ON YOUR DISKS AS A CLI COMMAND OR WHATEVER. WHEN YOU WANT TO SPREAD THE PROGRAM ITSELF WITH DOCS AS PD STUFF YOU MAY NOT EARN MONEY WITH IT. THE INSTRUCTIONS AND THIS NOTE MUST BE LEFT INTACT. THE EXAMPLES MAY BE REMOVED OR OTHERS MAY BE ADDED. ALL RIGHT?! ENJOY IT... What is PASTE? -------------- The idea of PASTE is to paste any IFF picture or brush into your CLI screen of any other screen you want. I thought these ANSI converters are a big shit and this is much better. In fact PASTE has some more functions. You can see a number of flags and three inputs. All three inputs are optional. THE FUNCTIONS ------------- The first parameter allows to change the names of all windows on your screen and/or the screen name itself. Look for the syntax and dont forget the start/end chars: ©[window name][®[screen name]]© The second input load an ascii text and prints it to your currents output (which should the CLI window normally). It's identically to the normal TYPE command from you C directory. The sense of this funtion is that here you can clear you screen on with ANSI control sequences you can limit the text output into your window. So you can prevent your following text outputs from spoiling your picture. Syntax: (asciinamewithoutspaces Now you can optinally specify the desired x and y koordinate where the left edge of the brush will be at the screen. Otherwise there are format functions like center which can be toggled with the flags. You can set the x or the y koordinate or both together. The preset y position is 11. Attention, there is only a check if the values are within the screen size, but not if the brush will reach out of the screen later! [xkoord][*ykoord] And now finally the picture name. This can be every iff picture or brush you want, no matter which size and which number of colors. More about that when we talk about the flags. Syntax: !iffpicturename FLAGS ----- There are a lot of options which can be selected: a - all colours from the iff brush will be used as screen colors b - all foregroud colors from the iff brush will be used c - when the program ends the old screen colors will be restored When the width of the brush is smaller than the screen width the brush will normally be centered in the middle of the screen. The following flags will change that: d - left margin e - right margin f - together with one of the former function the brush will have 8 pixel distance from the side border. These function don't make sense when the brush isn't smaller than the screen and will be disabled then. When the brush is larger than the screen the left part of the brush will be diplayed and the right region will be lost. This is no problem. But there can occure a small graphic damage when right region of the last line contains data which will then be visible in the next line. The biplane number of the brush don't have to be the same as from the screen. When it has a lower number the existing will be displayed and the other bitplanes will not be changed (also not cleared!!). When the number is bigger the bitplanes before the last bitplane will be removed. More functions: m - wait for left mouse button p - Magnify all windows on your screen. When you have a normal PAL screen they will be set to PAL size. Anyway on not standart screen sizes or NTSC screens the window size will be turned to the screen size. q - Together with -p- freezes the windows at the maximal size. You cannot change their size with the gadget any more. Attention! This function can never taken back! EXAMPLES -------- Paste theoretically substitutes several other commands. You dont need a "waitmouse" or "click" or whatever again. Just try: PASTE -m When you want to remove the "type" command, no problem: PASTE (filename Or a "pal" command for your windows: PASTE -p The possibilities of these together with pasting brushes in your screen are enourmous. On the original archiv there are several examples with Logos, ANSI Codes, Text usw... You must learn the working together of these components and then you can make magnificient CLI starts. IMPORTANT --------- Paste uses always the last opened screen!! That means when you started any program which opened its own screen all effects will not happen on the CLI screen but on the new one. This allows you to use PASTE for presentations into your own or other software software. When you want a switch for this function contact me. PASTE WAS TESTED FOR SEVERAL WEEKS UNDER A LOT OF DIFFERENT HARDWARE AND SOFTWARE CONFIGURATIONS. SO THERE SHOULD BE NO FATAL ERROR. OF COURSE THERE IS NO RESPONSIBILITY FOR ANY PROBLEMS OR DAMAGE THIS PROGRAM WILL CAUSE. FOR BUG REPORTS, CONGRATULATIONS, TIPS, OR OTHER LEGAL REASONS CONTACT ME. WHEN YOU LIKE TO PAY SHAREWARE MONEY: I AM CODING A PD GAME AT THE MOMENT AND I AM PLANNING OTHER UTILS. WHEN YOU SEND ME 10 DM YOU WILL NOT REPENT IT.