@database "New_in_2.0.guide"
@author "Eike Michael Lang"
@remark "$VER: Neu_in_2.0 Guide 1.0 (19. März 1997)"
@remark "Created with GoldED 4.5.0 (8.1.97)"

@node MAIN "Changes and additions of version 2.0"

Dear Users,

this AmigaGuide-file contains all changes and additions made to ArtEffect since
version 1.1.

Before you proceed, please read this @{"note" link note}.

Most likely you will not notice the biggest change - the entire program that was
originally developed with SAS/C and made use of the bgui.library has now been
completely converted to our own StormC-Compiler and relies on StormWizard for
its GUI:

However, you as a user will be more interested in the "real" additions and
changes made:

If you'd like a little more information on each topic without having to read
each section, go @{"here" link content} for a short description of all new and changed features.

@{"ARexx                     " link AE_Rexx.guide/main}  through the addition of ARexx, ArtEffect
                             has become even more flexible and powerful.

@{"Layers                    " link layers}  Working on several planes
@{"Eraser                    " link erase}  Erasing made easy
@{"PopUp-Menu                " link winpop}  more comfort in the project window
@{"virtual Memory            " link virtmem}  1.745.604 Chip RAM, 320.435.769 other RAM...
@{"multiple Undo/Redo-steps  " link undo}  Should I?  Wasn't it better before?
@{"new plugins               " link plugins}  Well, yes, plugins...
@{"Emergency Exit            " link emergency}  The life-vests are under your seat

@{"Program-Settings          " link newprefs}  important changes
@{"Smudge/Fingepaint         " link smudge}  are now functions in their own right
@{"Toolbox                   " system "SYS:Utilities/Multiview Toolbox"}  How it looks now
@{"Menu-Items                " link menugone}  Gone with the wind!
@{"Lighten/Darken            " link lightdark}  Now works slightly different

@{b}Moved!@{ub}                       "Blur" now resides in the Blur-submenu

@{b}Transparent Background@{ub}       When you generate a new project, the
                             background may now be transparent, too

@{b}Arithmetic Operations@{ub}        "1+1", "3*5", etc. are now valid entries
                             in integer-gadgets

@{b}Copy/Paste@{ub}                   The @{b}Copy@{ub} and @{b}Paste@{ub} items from the
                             @{b}Edit@{ub}-Menu now affect the current @{u}brush@{uu}.
@endnode
@node content "Overview"
@{b}@{u}Additions:@{uu}@{ub}

With the introduction of @{"layers" link layers} we place in your hands a very powerful tool to
work on several parts of a picture without risking to loose vital parts of it.

ArtEffect now features a dedicated @{"Eraser" link erase}.

Every project-window now has its own @{"PopUp-Menu" link winpop}.

Furthermore we have equipped ArtEffect with a complete @{"virtual memory-manager" link virtmem}
thus eliminating the need for VMem or other 3rd party virtual memory handlers.

As a direct result ArtEffect now also offers @{"multiple undo/redo" link undo} - there is no
longer the danger of completely destroying a project by making more than
one accidental change to it.

Last but not least we also generated a couple of @{"new plugins" link plugins} for ArtEffect.


@{b}@{u}Changes:@{uu}@{ub}

The space in the Toolbox that was formerly occupied by the trashcan is now taken
by the REDO-icon.  Also, we added @{"two new icons" system "SYS:Utilities/Multiview Toolbox"} to the toolbox.

Due to the increased number of prefs-options we have changed the @{"preferences" link newprefs} a
little bit.

For all those of you who have always enjoyed fingerpainting we have made the
airbrush-modes @{"Smudge/Fingerpaint" link smudge} a tool in its own right an gave it an icon in
the toolbox.

In the process of converting the program to StormC, a few @{"menu items" link menugone} have become
temporarily unavailable.

The @{b}Lighten@{ub} and @{b}Darken@{ub} modes now work slightly @{"different" link lightdark}.

You can use arithmetic operations into integer-gadgets:  1+1, 2*3+4, etc.
are all valid entries.

When generating a new project you can now choose a transparent background.

The menu-items @{b}Copy@{ub} and @{b}Paste@{ub} in the @{b}Edit@{ub}-menu no longer affect the current
@{i}project@{ui} but the current @{u}brush@{uu}.

Finally, the @{b}Blur@{ub}-plugin has been moved from the @{b}Pixelate@{ub}-submenu into the
@{b}Blur@{ub}-submenu.
@endnode
@node LAYERS "Layers"

@{u}@{b}What are layers?@{ub}@{uu}

Layers are several "planes" you can split your project into - just imagine
painting on several transparent films that are then placed on top of each other.

You could, for example, paint the background of a picture on one layer, the sky
on the second, and the foreground on the third one.  No changes made to a
particular layer will affect any of the others.

@{u}@{b}How do I work with layers?@{ub}@{uu}

By default, every document consists of @{b}one@{ub} layer called "Background".  If you
open the @{"Layers-Requester" system "SYS:Utilities/Multiview Layer_Reg1"} you can add layers to your project, delete them,
rename them, set their opacity, and decide whether you want them displayed at
all.  You can access the Layers-Requester by choosing @{b}Layers@{ub} from the
@{b}Windows@{ub}-Menu or by pressing @{b}F6@{ub}.
The maximum amount of layers available is @{b}three@{ub}.

In this requester you can see a list of all layers currently available in your
project with the active layer being highlighted in a different color.  Each
entry in the list has three parts:

 · The area to the left (with the lightbulb in it) allows you to switch the
   layer on and off - just toggle-switch the bulb by clicking on it.

 · to the right of that there is a small preview of the layer

 · and to the far right you can see a big area that contains the name of the
   layer

The order of the layers in the list equals their order in your project - this
means the topmost layer will be completely visible with only its transparent
areas letting the layers below show through.

@{u}Arranging layers@{uu}
By simply dragging and dropping the layers up and down in the list you can put
them in any order you want.  While using @{i}Drag&Drop@{ui} a white-and-black dashed
line shows you where the layer will end up.  In case you don't know what
@{i}Drag&Drop@{ui} means - just click left on the layer to move and keep the left button
pressed, move the mouse to the desired position and then let go of the button.
(@{b}Note@{ub}: if you chose a non-transparent background for your project, the
background-layer will completely cover all layers below it.  You could then use
the @{"eraser" link erase} to punch holes into this layer in order to let the other ones show
through.)

@{u}Combining Layers@{uu}
If your project contains two layers that you don't need to edit separately
anymore, you can combine those two layers into one.  First of all, make sure
these layers are next to each other in the list - then @{i}drag&drop@{ui} either one of
them on top of the other - they will be combined into one layer.

@{u}Setting layer opacity@{uu}
At the very top of the layers-requester there is a slider that controls the
current layers's opacity.  The higher the value set by this slider, the @{b}less@{ub}
transparent the layer will be.

@{u}Naming layers@{uu}
Directly below the slider you'll find a string-gadget which allows you to change
the name of the current layer.

@{u}Creating/deleting layers@{uu}
Finally, at the very bottom of the Requester, you'll find buttons to create and
delete layers.  If your project has only one layer, this layer can not be deleted.
If this last layer still contains transparency information, this information will
be deleted if you apply the @{b}Delete@{ub} button.

@{u}Saving Layers@{uu}
Please note that pictures containg more than one layer can only be saved in IFF
(ArtEffect will generate a separate chunk for each layer).
The Save-Requester also gives you the options @{b}flatten Layers@{ub} which will combine
all layers into one (not recommended unless you don't need to edit the
separately anymore) and @{b}include alpha channels@{ub} which will preserve all
transparency information.

@{u}Important Note@{uu}
When used with anything else than the cloner, the @{b}impressionist@{ub}-mode only "sees"
one layer - this leads to very strange effects if applied to layers that contain
transparent areas.

@{b}@{u}Examples:@{uu}@{ub}

 1. @{"Here" system "SYS:Utilities/Multiview Layer_Req1"} you can take a look at the layers-requester.
    The corresponding project-window would then look @{"like this" system "SYS:Utilities/Multiview Layer1"}.

 2. In @{"this case" system "SYS:Utilities/Multiview Layer_Req2"}, the layers "Foreground" and "Middle" were exchanged.
    @{"See" system "SYS:Utilities/Multiview Layer2"} how the planet is now in front (or on top) of the logo.

 3. Here you see a @{"picture" system "SYS:Utilities/Multiview Layer_NoBack-Req"} of the requester with the "Background" layer turned off.
    And here the corresponding @{"project-window" system "SYS:Utilities/Multiview Layer_NoBack"}.

 4. And here, to top things off, an @{"example" system "SYS:Utilities/Multiview Layer_Trans"} for an opacity of 84 set for the
    topmost layer.
@endnode
@node ERASE "Radierer"

@{u}@{b}The eraser@{ub}@{uu}

The eraser is located in the @{"toolbox" system "SYS:Utilities/Multiview Toolbox"}, directly below the airbrush.

The function of the eraser varies: if you only use one @{"layer" link layers}, the eraser will
always paint with the current background color while it will completely remove
all color if you use several layers, thus allowing lower layers to shine
through.  Erasing on the lowest layer will cause the chessboard-pattern of the
window-background to appear.

In the prefs-window for the eraser you will find the usual slider for the
strength and the "pressure" switch.  Aditionally, there is an "Erase Image"
gadget which takes the function the trashcan-icon in the toolbox used to have.
You can also achieve this by clicking on the eraser-icon with the shift-key held
down.  Either way, if you have more than one layer in your project, only the
current layer will be erased.
@endnode
@node winpop "Window-PopUp"

@{b}@{u}The popup-menu in the project window@{uu}@{ub}

If you have already taken a look at ArtEffect 2.0 before reading this manual,
you will probably have noticed the new gadget in the top left-hand corner of
every project-window.

Using this gadget opens a @{"popup-menu" system "SYS:Utilities/Multiview Window-PopUp"}.

This menu has five items:

    · @{b}mark as Source@{ub} - has the same effect as clicking on the top left
      corner of the window with the @{b}left@{ub} ALT-key pressed.

    · @{b}mark as Destination@{ub} - has the same effect as clicking on the top
      right corner of the window with the @{b}right@{ub} ALT-key pressed.

    · Pixel

    · cm

    · Inch

The last three items allow you to select the unit of measurement used for the
project's ruler.  Please note that this replaces the menu-item @{b}Settings/Ruler@{ub}.

@endnode
@node virtmem "Virtual Memory"

@{u}@{b}Virtual Memory@{ub}@{uu}

You probably know already:  Working with computer-based graphics takes lots and
lots of memory and you can never have enough of it...

Granted, the prices for RAM have been quite low for a considerable amount of
time, but not everybody is willing or able to get another 32 MByte-SIMM for his
computer.  Therefore some smart person came up with the idea to use the
computer's harddrive as a (slow, but big and cheap) RAM-expansion.

Programs for providing and managing virtual mem have been around on the Amiga
for a good while now, but those are often difficult to set up and/or use.

For this reason, the current version of ArtEffect features its own built-in
virtual memory handler - some of the new functions even require the use of
virtual memory:  without VMem you cannot make use of @{"layers" link layers} and there is no
@{"unlimited undo/redo" link undo}.

As long as you are not extremely low on harddisk-space, we suggest you give
ArtEffect a @{u}generous@{uu} amount of virtual memory to use - about 32 MB (or more) are
ideal for most tasks.

In the @{b}VMem@{ub}-area of the @{"program-settings" link newprefs} you can set the size and location of
the swapfile that serves as your virtual memory.
@endnode
@node undo "Unbegrenztes Undo/Redo"

@{u}@{b}Multiple Undo/Redo-steps@{ub}@{uu}

One disadvantage of many graphicsprograms is the lack of undo-buffers.  Most of
the programs (including older versions of ArtEffect) would only allow you @{i}one@{ui}
step of undo, making it virtually impossible to revert more than one false step
without loosing hours of work.

ArtEffect 2.0 allows you to save as many undo-steps as your (virtual) memory
permits - this means you can actually click yourself "backwards in time" by
repeatedly applying @{b}undo@{ub} until you reach a stage when everything still was to
your liking.

If you have gone back one or more steps too far, you can @{b}redo@{ub} any number of
steps to finally end up where you want to.

If for example you have undone 10 steps and then come to the conclusion that you
liked the situation better before undoing those, you can simply use @{b}redo@{ub} 10
times to get back where you came from.

If you are low on RAM and/or HD-space, you can set a maximum number of
undo-steps to save in the @{b}Other@{ub}-area of the @{"program-settings" link newprefs}.

Furthermore, UNDO can now take back @{u}all@{uu} operations, including
@{b}Imagesize/Canvassize/Crop@{ub}.
@endnode
@node plugins "New plugins"

@{u}@{b}Description of new plugins@{ub}@{uu}


The following @{b}blur@{ub}-filters have been added:.

@{b}@{"Radial Blur" system "SYS:Utilities/Multiview Radial_Blur"}@{ub}

Generates a circular blur-effect around the middle of the picture.  You can
control the strenght of the effect with the slider or the integer-gadget.


@{b}@{"Zoom Blur" system "SYS:Utilities/Multiview Zoom_Blur"}@{ub}

Generates a blur-effect very similar to the distortions generated towards the
rim of a strong magnifying-lens.  Again, the strength can be controlled through
the slider or the integer-gadget.


@{b}@{"Motion Blur" system "SYS:Utilities/Multiview Motion_Blur"}@{ub}

This filter generates the popular effect of an object that moves very quickly
past a camera.  The sliders control the speed and angle of the simulated
movement while the two radio-buttons determine whether the movement occurs at
constant speed or is accelerated.


@{i}Note@{ui}: the @{b}Blur@{ub}-Plugin has been moved from the Pixelate-submenu to the
blur-submenu.


These plugins have been added to the @{b}Other@{ub}-submenu:


@{b}@{"Make Tile" system "SYS:Utilities/Multiview Make_Tile"}@{ub}

This plugin generates a tile out of a picture by generating a smooth transition
between the left and right as well as the top and bottom edge.  Tiles generated
in this way can be seamlessy placed next to each other using the Tile-plugin.
aneinandergereiht werden.

The strenght-slider determines how many pixels of each edge are taken into
account for making the transition - the higher the value, the better the result.

Tiles that are generated this way are ideal for use as textures in raytracing
programs or as background-pictures for WWW-pages

@{b}@{"Tile" system "SYS:Utilities/Multiview Tile"}@{ub}

This plugin completey fills the active project with the current brush.  It is
ideally used with a brush that was generated by the @{b}Make Tile@{ub}-plugin - to do
this, use @{b}Make Tile@{ub} on a picture then use "Pic->" from the brush-manager and
finally use @{b}Tile@{ub} in the desired destination-project.
@endnode
@node EMERGENCY "Emergency Exit"

The "Emergency Exit"

To keep crashes from happening, ArtEffect now monitors the condition of several
parts of this program, automatically terminating itself if everything is not
well, but allowing the user to save all his work before doing so.

If this case ever occurs, ArtEffect will mostly output the number of an
"internal error" - please note down the number and send it to Haage&Partner
along with a detailed description of the steps leading to it, we will then try
and remedy this in future releases of the program.
@endnode
@node newprefs "Changes made to the preferences"

@{u}@{b}Changes made to the preferences@{ub}@{uu}

The four tabs in the prefs-window now have the following names and functions:


@{b}Screen@{ub}
This section has remained unchanged

@{b}@{"VMem" system "SYS:Utilities/Multiview Programsettings-VMem"}@{ub}
Here you can set everything concerning @{"virtual memory" link virtmem}.

In the upper area you can select how much RAM ArtEffect is supposed to leave
free for use by other programs and how much RAM it is allowed to use.

In the lower area you can specify a pathname and the size for the swapfile.

@{b}@{"Priorities" system "SYS:Utilities/Multiview Programsettings-Priority"}@{ub}
With the upper slider you can specify a task-priority for ArtEffect and its
plugins when you are actively using it.
The lower slider allows you to set a priority for the occasions when ArtEffect
has do do time-intensive calculations in the background (such as the
twirl-effect).  The Plugins will always have a priority that is one lower than
ArtEffect's thus keeping your machine usable even if ArtEffect has to some heavy
calculations.

@{b}@{"Other" system "SYS:Utilities/Multiview Programsettings-Other"}@{ub}
In the upper area you can control how ArtEffect frees undo-memory if your
(virtual) memory starts to run low:

 · @{b}oldest@{ub}    :  the oldest undo-step of the active project is freed

 · @{b}all oldest@{ub}:  the oldest undo-step of all projects is freed

 · @{b}other@{ub}     :  only undo-steps of non-active projects are freed

Please be aware, that this only controls the desired behaviour - even if you
chose @{b}other@{ub}, ArtEffect will delete Undo-Buffers from the current project as soon
as there aren't any left in other projects.

The slider below controls the maximum number of @{b}undo@{ub}-steps to save - if you move
this slider all the way to the right this means "unlimited undo/redo".

In the lower half you will find a slider to control the number of available
colors (formerly located in the "Other 1" section of the prefs).

Below the slider there is a checkmark to toggle the @{b}One picture path@{ub} option
that used to reside in @{b}Other 2@{ub}.

In addition to the @{b}program settings@{ub}-requester there also is a @{"settings-requester" system "SYS:Utilities/Multiview Settings"}.

In this requester you will find the options for @{b}Brush display@{ub}, @{b}Anti-Alias@{ub},
@{b}Snap windows@{ub}, @{b}auto Preview@{ub}, @{b}Auto. activation@{ub}, and @{b}Stencil color@{ub}, all of
which used to be in the @{b}Other 1@{ub} and @{b}Other 2@{ub} sections of the program settings.
@endnode
@node SMUDGE "Smudge/Fingerpaint"

@{u}@{b}Smudge/Fingerpaint@{ub}@{uu}

The Smudge/Fingerpaint-tool provides these two paint-modes that were part of the
airbrush in earlier version as separate tools in their own right.

The behaviour of the tool is toggled with the @{b}Fingerpaint@{ub}-checkmark in the
tool-settings:

@{b}No checkmark@{ub} - the tool acts as "Smudge"

   @{b}checkmark@{ub} - the tool acts as "Fingerpaint"

The actual function of the tools is still identical to the description provided
in the printed manual.
@endnode
@node menugone "Removed menu-items"

@{u}@{b}These menu itmes are not available anymore:@{ub}@{uu}


- Window/Create Workspace
- Window/write back Workspace

- Settings/Crosshair

The item @{b}Settings/Ruler@{ub} has been rendered obsolete through the introduction of
the @{"window-popup" link winpop}.
@endnode
@node lightdark "Lighten/Darken"

@{u}@{b}Lighten/Darken@{ub}@{uu}

The function of these paint-modes has been slightly changed:

@{b}Lighten@{ub} only lightens up to the current pencolor, while @{b}Darken@{ub} only darkens down
to the currecnt background-color.

Using a white foreground and a black background reproduces the behaviour you are
used to from earlier versions.
@endnode
@node note "Note"

To make this manual even better we have included links to graphics in several
places - these graphics are there to help you understand certain functions of
the program better and are displayed through the "Multiview" program.

For this reason, Multiview should be located in your SYS:Utilities/ drawer,
wehre it is very likely to be unless you run a very customized workbench.

Because these graphics are displayed in a separate window, the manual should
be opened on the workbench screen, so that the text and images can be viewed
at the same time.

If this manual does open on its own screen, just de-select the @{b}Use separate screen@{ub}
item from the @{b}Window@{ub}-menu.
@endnode