home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Fresh Fish 5
/
FreshFish_July-August1994.bin
/
bbs
/
gfx
/
coppercontrol-1.0.lha
/
CopperControl-1.0
/
CC-ED.doc
< prev
next >
Wrap
Text File
|
1993-11-29
|
38KB
|
812 lines
_______________________________________________________________________________
-------------------------------------------------------------------------------
____ ____ ____ ____ ____ ____ ____ ____ __ __ _____ ____ ____ __
/\___\\___\\___\\___\\___\\___\ /\___\\___\\_\/\_\\____\\___\ \___\\_\
/ / __// // _ // _ // __//__ / / / __// // \/ //_ _//__ / / // /_
/ / /\ / / // __// __// __// / / / /\ / / // /\ // / / / / / / // /__\
\/___//___//_/ \/_/ \/___//_/\_\ \/___//___//_/\/_/ \/_/\/_/\_\/___//_____/
-=* THE EDITOR *=-
_______________________________________________________________________________
-------------------------------------------------------------------------------
Version 1.0, Every OS compatible (tested on 1.3, 2.0+, 3.0)
SHAREWARE ©1993 by Nadir Boussoukaia
>>> AUTHOR <<< >>> DISTRIBUTOR <<<
Write to: /--------------------------\ /----------------------------\
| Nadir Boussoukaia | | SILICONE-DP |
| 1 Rue Des Romanesques | | 5 Bld des Arceaux |
| 13015 Marseille (France) | | 34000 Montpellier (France) |
\--------------------------/ \----------------------------/
---> comments/Hellos ---> Purchasing the program:
suggestions/Bugs report 30 French Francs per disk
Demos swapping (compensed shareware).
==================================================
ANY SERIOUS JOB PROPOSITION IS WARMLY WELCOMED.
==================================================
-------------------------------------------------------------------------------
Introduction
-------------------------------------------------------------------------------
Copper Control Editor (Let's call it CC-ED) is a general purpose copperlist
editor, with practically no limitation (ie more than one color per rasterline
allowed). With it you can edit and save copperlists for your machine-code
programs or anything like.
Another interesting feature is that you can save copperlists for Copper
Control: That small program (3844 bytes) gives you the possibility to use your
own copperlist instead of ANY NUMBER of colors, in any Intuition Screen, like
Workbench screen for example. See other doc.
CC-ED offers a user friendly DeluxePaint style editor, with a lot of features
originals for this kind of program (like UNDO).
It has been made in the optics of a total simplicity and functionality in use,
in order that non-specialists could use it with no headaches ( You will find NO
esoteric function or message !).
However, it enforces no restrictions, so coders can use it and have at their
disposal practically all COPPER possibilities.
A French or German version could be available.
Features
--------
- Copper Control done in short & fast assembly
- The editor CC-ED done in AMOS 1.3 (maybe a 2.0 version in C)
- Intuitive interface (Hope so!)
- You can choose the color register of the copperlist
- More than one color per line possible (every 8 pixels)
- Possibility of multi-color register copperlists
- Copperlists also saved as RAW or ASCII files for coders
- Colors tables generated as RAW and ASCII files too
Non-Features
------------
- AGA support (not yet ?)
- 100% bug free ! (let's talk only 99%...)
-------------------------------------------------------------------------------
Disclaimer
-------------------------------------------------------------------------------
THIS PROGRAM IS PROVIDED ON AN `AS IS' BASIS, NO WARRANTIES ARE MADE, EITHER
EXPRESSED OR IMPLIED. SO THE AUTHOR DOES NOT ASSUME ANY RESPONSIBILITY OR
LIABILITY, AND ALL USE OF THIS PROGRAM IS AT YOUR OWN RISK.
-------------------------------------------------------------------------------
Distribution & ShareWare Donation
-------------------------------------------------------------------------------
This product is SHAREWARE: Using it assumes that you have already payed the
small CONTRIBUTION FEE of 30 French Francs (about 6$). Otherwise, it has been
fixed very low, so you have no excuse: You should do it now (You'll find the
distributor's adress at the beginning of text).
After that, You could use it like you want, including in commercial
productions, with reserve that it's not the principal object.
The future of this product depends on you. If you support me I'll continue
working on it and improve it. I have also some other projects in mind.
But everything depends on my moral... And my moral depends on my wallet.
-------------------------------------------------------------------------------
Installation
-------------------------------------------------------------------------------
Copper Control Editor may be placed anywhere you want.
It looks for an optionnal configuration file in current directory (in Workbench
this will be the same directory than CC-ED) or in S:
Note that This file is OPTIONNALLY needed. CC-ED needs no file, except for one
library: I removed the use of `Mathtrans.Library', but I wasn't able to remove
the use of `Diskfont.Library'. Though I only set ROM fonts, AMOS uses this
library. So it must be in your LIBS:
CC-ED has been compiled for Workbench, but It can be run either from CLI or
Workbench. From CLI you should use a `Run >NIL:' to keep hand.
-------------------------------------------------------------------------------
Using Copper Control Editor
-------------------------------------------------------------------------------
Preliminary: I call `Color Register' one of the 32 memory cells used to stock
colors of the palette.
Once program loaded, you can see on your screen:
- A pannel with quite a lot of gadgets,
- A cursor composed with two sprites on the left black screen,
- Your beautiful pinky mousepointer.
You can move the cursor with:
- Keyboard: Arrows up & down on main edit. You can speed up the move with
shift keys (there's a different step for each shift key).
Arrows left & right when you edit a line. Shift keys are used
here to go directly to the beginning or the end of the edited
line.
- Mouse: Just click wherever you want to place the cursor.
If you hold down mouse button on top or bottom of screen then
copperlist smoothly scrolls.
- Slider: Grab the slider bar and move it up and down to go where you
want. If you don't click on the bar then there will be just
a small jump.
The program philosophy is that everything must be as simple and intuitive as
possible. There are three ways of modifying the edited copperlist:
- With Cursor functions:
Most are in the `Current Line' pannel,like for example
modify color, Edit, Delete, Insert..
- With Block functions:
Such as Spread, Paste, Clr, Roll. Most are in `Block'
pannel. The using is quite logical: You first specify
the function limits then click on the function gadget
you want to use.
- With MousePointer functions:
Currently they're only two, Pick Color and Smooth. You
first click on gadget, then use it as long as needed.
To exit, click right mousebutton or simply go to
functions pannel.
Copper Control Editor allows you to display only one color per rasterline on
main screen, for speed (making use of AMOS functions) and for simplicity in
coding as much as in using. Imagine for example with spread function: when we
are spreading on a few lines, How could we simply determine if we take care of
the inside of any line or not ?
For those reasons I decided to separate vertical and horizontal edition of the
copperlist. So by using the EDIT LINE function, you can edit horizontally and
display far more colors per line (usually 44 !).
You will also have to use this in combination with TEST function to see the
real result (see below for details).
You can use the MIX feature to have multi-registers copperlists (this means
copperlists on color00 plus color01 plus color03 for example).
I will totally explain its using below.
Practically all functions have keyboard shortcut.
If you press the HELP key, you will change the cursor color. Test it !
You must know that the