@database ART-Pro @master Storage2:ART-Pro/ART-Pro.Guide @$VER: 0.62 @author "Timm S. Müller, Frank Pagels" @(c) "© 1994, Frank Pagels / Defect Softworks" @node "Main" "ART-Pro v0.62 © 1994 Frank Pagels / Defect Softworks" @{b}@{u}ART-PRO v0.62@{ub}@{uu} multi-purpose graphics converter and image processor © 1994 by Frank Pagels Defect Softworks the Doomsday Party tool-competition winning tool @{" Copyright    " link "Copyright" 0} Copyright notes @{" Disclaimer   " link "Disclaimer" 0} Warranties? No way. @{" Distribution " link "Distribution" 0} How to distribute @{" Shareware    " link "Shareware" 0} About the shareware concept @{" Registration " link "Registration" 0} How to register @{" Author       " link "Author" 0} How to reach the author @{" Introduction " link "Introduction" 0} Introducing ART-Pro @{" Requirements " link "System_requirements" 0} What's required to run ART-Pro @{" Installation " link "Installation" 0} How to install ART-Pro @{" Usage        " link "Usage" 0} How to use ART-Pro @{" Future plans " link "FuturePlans" 0} What's up to come @{" Acknowledges " link "Acks" 0} The people involved @{" History      " link "History" 0} The History of ART-Pro @endnode @node "Copyright" "Copyright" @{b}Copyright@{ub} The entire ART-Pro package was created and is copyrighted © 1994 by Frank Pagels, except for reqtools.library which is copyrighted © by Nico François. @endnode @node "Disclaimer" "Disclaimer" @{b} Disclaimer@{ub} The @{" author " link "author" 0} makes no guarantee of any kind for the reliability of the software described in this documentation, and thereof he is in no way liable for any damages or loss of data directly or indirectly caused by the use or misuse of this software. This documentation and the ART-Pro program are provided "as is" without any warranty, either expressed or implied. @endnode @node "Distribution" "Distribution" @{b}Distribution@{ub} The ART-Pro package may be redistributed freely, as long as there are no changes made to any part of this software. No parts of this package may be omitted or altered by any means except for archiving. You are not allowed to copy single parts, you have to reproduce the package completely. Please refer to the list of contents for verification: ART-Pro (dir) icons (dir) ARTProLace.info 5306 ARTProMagicWB.info 8758 ARTProNoLace.info 2854 libs (dir) reqtools.library 43628 ART-Pro 45888 ART-Pro.guide 48011 ART-Pro.guide.info 503 ART-Pro.info 3567 Orderform.doc 4082 Orderform.dok 4391 ART-Pro.info 2657 Neither fees may be charged nor profits may be made by distributing this piece of software. Only a nominal fee for costs of magnetic media is acceptable, whereby the amount of US $3 or DM 5,- must not be exceeded for a disk containing ART-Pro. @endnode @node "Shareware" "Shareware" @{b}Shareware@{ub} ART-Pro is shareware, which means this software may be used and redistributed freely, as long you accept the conditions and limitations stated in the @{" distribution " link "distribution" 0} and @{" disclaimer " link "disclaimer" 0} sections. Please consider @{" registration " link "Registration" 0} if you wish to use ART-Pro frequently. This initial release of ART-Pro is no way restricted, that means no functions are disabled, no nasty registration reminder will pop up. You may use and test this unregistered version of ART-Pro as long as you wish. Keep in mind that ART-Pro is under heavy development. There will be many additional features available in the future and registered users will be preferred in some ways. First of all, registered users will get one major update for free as soon it is completed. More free updates are available if you send in a disk and include either german stamps or enough money for postage. In addition to that, a lot of oncoming powerful features will be available to registered users only, e.g. an ARexx port and some external modules. Ideas and suggestions for improvements proposed by registered users will be taken into consideration first. The  shareware  idea behind ART-Pro is quite different from that of shareware groups like SASG. The development is and will stay transparent to you, and there are no uniformed update conditions imposed on the user. The earlier you register, the better your demands can be taken into account. Last not least, updates stay free until doomsday. @endnode @node "Registration" "Registration" @{b} Registration@{ub} To register, fill out the registration form included, print it out in some way and send it to the @{" author " link "author" 0}. The registration fee is DM 20,- or US $15 or UK £10. Try to get a registration with other currencies if you dare. Include cash, international money order, or cheque. Coins in currencies different from German Marks cannot be accepted. Cheques are only acceptable from within Germany. Make international money orders and cheques payable to @{u}Frank Pagels@{uu}. Registered users will get one major update for free, whereby "free" implies postage. More updates will be available if you send disks and additional money or stamps for postage. Futural releases will differenciate between evaluation and registered versions, whereby some features will be reserved for the registered version only. @endnode @node "Author" "Author" @{b} Author@{ub} Submit suggestions, bug reports, registrations to: Crazy Copper / Defect Softworks Frank Pagels Kolumbusring 39 18106 Rostock FR of Germany Phone +49 (0)381 1207938 E-Mail: henryk.richter@stud.uni-rostock.de @endnode @node "Introduction" "Introduction" @{b} Introduction@{ub} Have you ever been looking for a tool that cross-converts graphics in several popular formats, enables powerful color and image control, allows you to cut brushes and offers saving them in various formats, such as binary, source code, IFF, etc. - supporting all the additional AGA features, such as AGA sprites, and copperlists? With ART-Pro, you've found a program to satisfy these needs. Or let's say you've found another one, due to the fact that there are numerous programs available offering features included in the list above. So why should I use ART-Pro then, you may ask. The idea behind ART-Pro is to combine image format conversion with IFF-to-RAW conversion for programmers with powerful image and color processing with a well-designed and comfortable graphical user interface. Though ART-Pro is just at the beginning of its development, the basic functions are yet complete, and you'll find IFF to RAW conversion (and vice versa) in quite innumerable ways implemented. There are features included to ART-Pro you won't find in any other program of that kind, and several great ideas are implemented that will help you making life easier. If you take a first look at ART-Pro, you'll find a fully-featured, comfortable GUI - rather than an empty screen with dozends of menues, driving you berzerk with unsuitable colors and screen resolutions. Having a closer look, you'll get a first impression of the modular concept provided by ART-Pro. This is in some ways similar to Artdepartment Professional (as you might have guessed, the names "ART-Pro" and "AdPro" are more than mere coincidence :-). Various loaders and savers, image, color, and brush operators are available. Talking of image and color operators, those will be avaible, to be more precise - as mentioned before, ART-Pro is under development and many features are still to come. ART-Pro is not yet a replacement for commercial high-tech image processors like Artdepartment or ImageFX and it will never be one. Right now, it's a great image converter for programmer's purposes and in addition to that, it will offer many essential color and image processing features in the future. Last not least, ART-Pro was written in carefully hand-optimized assembler code and is for that reason quite short and pretty fast. Some people urged me to release this very early version of ART-Pro in order to get your interest and to find out what are the demands for a program like this in the world outside. So feel welcome to submit your suggestions. Some features of ART-Pro 0.62: * comfortable GUI: * all functions driven by gadgets or keyboard equivalents * no menus on screens with weird resolutions and colors * lots of options and settings for your individual taste * comfortable brush cutting controlled on a seperate screen * highly flexible source code generation * save load/savepath after Exit and load it at the Start * image converting: * handles IFF to RAW as well as RAW to IFF * supports interleaved blitter formats * outputs as source / binary / linkobjekt * includes additional blitter words for shifted blitting * automatically saves the colors associated with an image * extensive sprite support: * handles sprites in either 4 or 16 colors * handles sprites being 16 / 32 / 64 pixels wide * outputs as source / binary / linkobjekt * allows you to cut several sprites in a single go * automatically calculates sprites' control words according to their screen positions * color functions: * supports LoadRGB / RAW / copperlist formats * generates AGA copperlists * handles 4 and 32 bit color depths for LoadRGB * outputs as IFF, source, binary or linkobjekt * masking functions: * generates brush masks for either interleaved or noninterleaved blitting * supports specific mask colors @endnode @node "System_requirements" "System requirements" @{b} System requirements@{ub} ART-Pro requires an Amiga with operating system 2.04 (V37) or higher. If not present (either no Amiga or no Kickstart 2.04), ART-Pro won't run. ART-Pro is very compact and handles low-memory situations, so you are able to use it even with a minimal memory supply. The amount of additional memory required for images depends on the pictures' dimensions and depths you're working with. The presence of a hard disk and a lot of memory is no bad idea, but not required. @endnode @node "Installation" "Installation" @{b} Installation@{ub} There is no installation script for ART-Pro supplied right now, sorry. This initial public release is so easy to install to your system that you should be able to perform that task manually. If not, you're not advised to use ART-Pro anyway. This is subject to change - with external modules becoming part of ART-Pro, installation gets more complicated and therefore, an installation script will be included some day. Copy ART-Pro and ART-Pro.info to any location on your hard drive or working-disk. If not already present, copy reqtools.library into your sys:libs drawer. In addition to that, you should create a new directory in ENVARC: named "ART-Pro" which will be ART-Pro's default path to its preferences. After these steps, ART-Pro can be started via Shell or Workbench. @endnode @node "Usage" "Usage" @{b} Usage@{ub} After starting ART-Pro from either Shell or Workbench, you find its main screen opened. Most actions can be performed by both clicking the appropriate buttons and pressing their keyboard equivalents. @{" Main Control Panel " link "Main_Control_Panel" 0} @{" File Operation     " link "File_Operation" 0} @{" Image Control           " link "Image_Control" 0} @{" Brush Operation    " link "Brush_Operation" 0} @{" Image/Palette Operation " link "ImagePalOp" 0} @{" Selecting Modules  " link "Module_Selection" 0} @{" Settings Window    " link "Settings_Window" 0} @endnode @node "Main_Control_Panel" "Main Control Panel" @{b}Main Control Panel@{ub} There are four buttons and several text fields located in this area, affecting global operations and displaying general information. The status line reflects ART-Pro's current status - errors are displayed here as well as messages of any kind. At startup, you find a welcome message there. The three text fields below inform you about the memory currently being available, seperated into "Memory" (total free), "Chip" and "Fast". I suppose you know what this is for. Images to be displayed require chip memory. Futural versions of ART-Pro will additionally keep the image in 8 bit internally, using fast memory for that purpose if available. @{" About " link "About" 0} @{" Settings " link "Settings" 0} @{" Iconify " link "Iconify" 0} @{" Exit " link "Exit" 0} @endnode @node "About" "About" @{b} About@{ub} "About" opens a stunning about requester with some information concerning the ART-Pro revision running, the @{" author's address " link "Author" 0} and stuff like that. @endnode @node "Settings" "Settings" @{b}Settings@{ub} This button will open the @{" settings window " link "settings_window" 0} which will be described in the settings window section. @endnode @node "Iconify" "Iconify" @{b} Iconify@{ub} As the name suggests, "Iconify" leads to iconification of ART-Pro, thus freeing as much memory as possible. ART-Pro opens a tiny window on the Workbench then, appends an AppItem to the tool menu, or leaves an AppIcon on your Workbench, depending on the selected iconification mode. Refer to the @{" settings window " link "Iconify_Mode" 0} section for details. @endnode @node "Exit" "Exit" @{b}Exit@{ub} Clicking this button or triggering its keyboard equivalent "x" quits ART-Pro @{u}without@{uu} verification.ART-Pro will save the load/savepath to ENVARC:. @endnode @node "File_Operation" "File Operation" @{b} File Operation@{ub} You find four buttons and three text fields in this area. They allow you to import and export files, they reflect the status of currently selected loaders and savers, and they inform you about the image file you're actually working at. @{" Load " link "Load" 0} @{" Selecting a Loader " link "Loader_Selector" 0} @{" Save " link "Save" 0} @{" Selecting a Saver  " link "Saver_Selector" 0} @endnode @node "Load" "Load" @{b}Load@{ub} Clicking this button opens a file requester, thus allowing you to select an image file to be loaded. You find the actual loader displayed in the text field right beside. Read the @{" loaders " link "loaders" 0} section for details and the available formats. @endnode @node "Save" "Save" @{b}Save@{ub} Clicking this button opens a file requester, thus allowing you to specify a path and name for an image or brush to be saved. You find the actual saver displayed in the text field right beside. Refer to the @{" savers " link "savers" 0} section for details and the available formats. By default, you will be prompted to confirm overwriting files which already exist. This behaviour can be changed in the @{" settings window " link "Overwrite" 0}. @endnode @node "Loader_Selector" "Selecting a loader" @{b}Selecting a loader@{ub} This is the tiny button on the right hand of the text field displaying the currently selected loader. On activation, the loaders window will be opened for you to select a loader that suites to your needs. Please refer to the @{" module selection " link "Module_Selection" 0} section for details. See the @{" loaders " link "Loaders" 0} section for the available file formats. @endnode @node "Saver_Selector" "Selecting a Saver" @{b}Selecting a saver@{ub} This is the tiny button on the right hand of the text field displaying the currently selected saver. On activation, the savers window will be opened for you to select a saver that suites to your needs. Please refer to the @{" module selection " link "Module_Selection" 0} section for details. See the @{" savers " link "Savers" 0} section for the available file formats. @endnode @node "Image_Control" "Image Control" @{b} Image Control@{ub} There are three buttons and three text fields located in this area. They affect the screen's resolution, display mode, and depth, and they reflect the size and depth of the picture currently being loaded. The screen mode is displayed in the topmost text field. You find the image size and depth below. The cycle gadget reflecting the image's depth is ghosted in this release of ART-Pro, for changing it is not yet implemented. @{" Screenmode Selection " link "Screen_Mode_Selector" 0} @{"  Render / ReDisplay  " link "Render_\_Redisplay" 0} @endnode @node "Screen_Mode_Selector" "Selecting a Screen Mode" @{b} Screen Mode Selection@{ub} This button is located at the right hand of the text field that displays the screen mode. It brings up a list of all screen modes available to your system. The set of screen modes offered here depends on your machine's chipset revision and on the monitors located in your Devs/Monitors system drawer. With this feature you can easily change a picture's screen mode. It depends on the picture's depth and your machine's chip set whether a screen mode modification will succeed or fail. E.g. it's not possible to change a 32 color LoRes picture to HighRes on an OCS/ECS machine in this version of ART-Pro. This is subject to change - futural versions will handle this by rerendering the image. @endnode @node "Render_\_Redisplay" "Render / Redisplay" @{b} Render / Redisplay@{ub} In ART-Pro's current version, this button will just display a previously loaded picture. In future, this gadget will additionally render a picture when necessary. This will occur when changes of the screen's mode or depth require color reduction. @endnode @node "Brush_Operation" "Brush Operation" @{b}Brush Operation@{ub} This area displays the selected brush operator, the actual brush's dimensions and its size in bytes. There is only one brush operator available in this version of ART-Pro - "normal cut" - and for that reason the brush operation selector appears ghosted. Select "Execute" to cut a brush. You will then enter your currently loaded image with a tiny control screen at the bottom. @{" Control Screen    " link "Control_Screen" 0} @{" Selecting a Frame " link "Selecting_a_Frame" 0} @{" Grid              " link "Grid" 0} @{" AutoCut           " link "AutoCut" 0} @endnode @node "Control_Screen" "Control Screen" @{b}Control Screen@{ub} There are three buttons and four text fields located on this control screen. They are named as follows: X - displays the current horizontal position of the cursor, relative to the left screen border Y - displays the current vertical position of the cursor, relative to the upper screen border BW - the current brush width BH - the current brush height empty box - indicates whether the brush width is a multiple of 16. Check it out to see the effect. @{" AutoCut " link "AutoCut" 0} - to automatically enclosure the brush Accept - to accept a brush selection Cancel - to leave this section without a new brush @endnode @node "Selecting_a_Frame" "Selecting a Frame" @{b} Selecting a Frame@{ub} Move your mouse to an appropriate location inside your picture, press the left mouse button and size the rubber frame to the dimensions of your choice. There's no need to keep the left mouse button pressed. If the frame's size suites to your needs, press the left mouse button once again. To redo that operation, press the right mouse button and reselect another brush. If you're satisfied with your brush selection, leave this section by either clicking the "Accept" button or by pressing its keyboard equivalent "a" - or just press "ESCape" for the same purpose. To abort, click on "Cancel" or press "c". If you're too lazy to cut your brush at its exact borders, try clicking @{" AutoCut " link "AutoCut" 0} after you've selected a rough frame. @endnode @node "Grid" "Grid" @{b} Grid@{ub} You may toggle the grid by pressing the "g" key. The grid's width amounts to 16 pixels which corresponds to the number of 16 bit words your brush is wide. You might wish to switch off the grid on heavy DMA torture screens such as SuperHiresInterlace HAM8 :-). By default, a grid is drawn. This can be changed in the  settings@{" settings" link "Heddley_Error" 0} @{"window " link "Draw_Grid" 0}. @endnode @node "AutoCut" "AutoCut" @{b}AutoCut@{ub} This feature is very handy when there's no need to cut a brush at its exact borders. The rubber frame will automatically enclosure your brush at its outmost edges. The keyboard equivalent is "u". @endnode @node "Module_Selection" "Selecting a Module" @{b} Selecting a Module@{ub} Whenever you wish to select another @{" loader " link "Loaders" 0} or @{" saver " link "Savers" 0}, image or color operator, you'll be confronted with a list window containing the modules currently being available to ART-Pro. The gadgats "add", "add dir", "kill", and "kill all" appear ghosted due to the fact that there are no external operators available in this version of ART-Pro. To select a module, highlight an entry in the list view, then hit "Okay" or "Accept". Accept will execute the selected operator immediately. Hitting the close gadget will abort the module selection, as well as selecting "Cancel". Doubleclicking an operator is equivalent to "Accept" and leads to immediate execution. @endnode @node "Loaders" "Loaders" @{b} Loaders@{ub} In this version, ART-Pro supports the following loader formats: @{" IFF-ILBM " link "IFF-ILBM" 0} @{" RAW       " link "RAWW" 0} @{" SCREEN   " link "Screen" 0} @{" RAW-BLITT " link "RAW-BLIT" 0} @endnode @node "IFF-ILBM" "IFF-ILBM" @{b}IFF-ILBM@{ub} Simply loads an IFF ILBM picture. @endnode @node "Screen" "Screen" @{b}Screen@{ub} This handy function allows you to grab any screen currently open on your system. Simply select a screen of your choice after the screen selector has popped up. @endnode @node "RAWW" "RAW" @{b} RAW@{ub} This loader allows you to load a standard (i.e. non interleaved) raw file. After selecting "Load" a requester will pop up and prompt you to specify the raw-formatted picture's width, height, depth, and display mode. The cycle gadget entitled "Display" allows you to choose between normal, halfbright and HAM display mode. Using the TAB key, you can cycle between the string gadgets. Select "Do it" or press its keyboard equivalent "d" to load the raw image file, or "Cancel" for abortion. You will then be prompted to select a screen mode, and finally, the raw picture will be loaded. @endnode @node "RAW-BLIT" "RAW-BLITT" @{b}RAW-BLITT@{ub} This loader allows you to load an interleaved raw picture file. After selecting "Load" a requester will pop up and prompt you to specify the raw-formatted picture's width, height, depth, and display mode. The cycle gadget entitled "Display" allows you to choose between normal, halfbright and HAM display mode. Using the TAB key, you can cycle between the string gadgets. Select "Do it" or press its keyboard equivalent "d" to load the raw image file, or "Cancel" for abortion. You will then be prompted to select a screen mode, and finally, the raw picture will be loaded. @endnode @node "Savers" "Savers" @{b}Savers@{ub} In this version, ART-Pro supports the following saver formats: @{" IFF-ILBM  " link "IFF_ILBM" 0} @{" COLOR      " link "COLOR" 0} @{" RAW       " link "RAW" 0} @{" MASK       " link "MASK" 0} @{" RAW-BLITT " link "RAW-BLITT" 0} @{" MASK-BLITT " link "MASK-BLITT" 0} @{" SPRITE    " link "SPRITE" 0} @endnode @node "IFF_ILBM" "IFF-ILBM" @{b}IFF-ILBM@{ub} This saver allows you to save your current picture or brush as IFF-ILBM. @endnode @node "RAW" "RAW" @{b}RAW@{ub} This will save your current picture or brush as RAW non-interleaved. Please refer to the @{" settings window " link "Image_Format" 0} section for all the available settings and options for this.If you have selected "Link" as outputformat then you must @{"specify the linkdata" link "link" 0} before save. @endnode @node "RAW-BLITT" "RAW-BLITT" @{b}RAW-BLITT@{ub} This will save your current picture or brush as RAW interleaved. Please refer to the @{" settings window " link "Image_Format" 0} section for all the available settings and options for this.If you have selected "Link" as outputformat then you must @{"specify the linkdata" link "link" 0} before save. @endnode @node "SPRITE" "SPRITE" @{b}SPRITE@{ub} This will save your current brush as one or multiple sprite(s). Please refer to the @{" settings window " link "settings_window" 0} section for all the available settings and options for this.If you have selected "Link" as outputformat then you must @{"specify the" link "link" 0} @{"linkdata" link "link" 0} before save. @endnode @node "COLOR" "COLOR" @{b}COLOR@{ub} This will save your current picture's palette. Please refer to the @{" settings  window " link "Color_Format" 0} section for all the available settings and options for this.If you have selected "Link" as outputformat then you must @{"specify the linkdata" link "link" 0} before save. @endnode @node "MASK" "MASK" @{b}MASK@{ub} This will save your current picture or brush as a mask for non-interleaved blitting. All colors different from the background color will be taken into account. If @{" Ask Mask-Color " link "Ask_Mask-Color" 0} is enabled in the @{" settings window " link "Settings_Window" 0}, you will be prompted to enter a specific mask color instead.If you have selected "Link" as outputformat then you must @{"specify the linkdata" link "link" 0}. A normal mask save results in a single-bitplaned mask to be used for each bitplane-oriented blitter operation. @endnode @node "MASK-BLITT" "MASK-BLITT" @{b}MASK-BLITT@{ub} This will save your current picture or brush as a mask for interleaved blitting. All colors different from the background color will be taken into account. If @{" Ask Mask-Color " link "Ask_Mask-Color" 0} is selected, you will be prompted to enter a specific mask color instead. Please refer to the @{" settings" link "Settings_Window" 0} @{"window " link "Settings_Window" 0} section for details. If you have selected "Link" as outputformat then you must @{"specify the linkdata" link "link" 0}. A blitter mask save results in an interleaved, multi-bitplaned mask, whereby the masking bits appear identical for each bitplane. @endnode @node "Settings_Window" "Settings Window" @{b} Settings Window@{ub} Here you can adjust all your preferred settings and options for the use of ART-Pro. @{" Global Settings " link "GlobalSettings" 0} @{" Source Format " link "Source_Format" 0} @{" Image Format " link "Image_Format" 0} @{" Color Format " link "Color_Format" 0} @{" Sprite Format " link "Sprite_Format" 0} @{" Save " link "SavePrefs" 0} @{" Load " link "LoadPrefs" 0} @{" Use " link "UsePrefs" 0} @{" Cancel " link "CancelPrefs" 0} @endnode @node "Show_Pic_after_Load" "Show Pic after Load" @{b}Show Pic after Load@{ub} With this switch enabled, any picture will be displayed right after loading. @endnode @node "Center_Pic" "Center Pic" @{b} Center Pic@{ub} This one will automatically center your picture to the middle of the screen. @endnode @node "Draw_Grid" "Draw Grid" @{b}Draw Grid@{ub} This switch represents your preferred setting whether a grid shall be drawn when you're @{" selecting a frame " link "Selecting_a_Frame" 0} for cutting a brush. @endnode @node "Overwrite" "Overwrite" @{b}Overwrite@{ub} With this option enabled, you'll be prompted to confirm overwriting already existing files. @endnode @node "Auto_save_Colors" "Auto save Colors" @{b}Auto save Colors@{ub} If you want to automatically save a picture's palette along with the image, this switch is the right one for you. When active, saving an image will generate a color output as well, whereby your preferred color settings will be used. The name will be the same as of the image, with an appropriate extension added, such as .s for source code or .col for binary etc. This switch appeared useful to me, because I sometimes forget to save the colors :-). @endnode @node "Ask_Mask-Color" "Ask Mask-Color" @{b} Ask Mask-Color@{ub} When saving a @{" MASK " link "mask" 0} or @{" MASK-BLITT " link "mask-blitt" 0}, normally all colors are taken into account, except for the background color which will appear transparent. When this switch is enabled, you will be asked for a specific, single mask color instead. @endnode @node "Iconify_Mode" "Iconify Mode" @{b} Iconify Mode@{ub} ART-Pro offers three different ways of iconification - AppItem, AppIcon, and Window. You can adjust your preferred mode here. An AppItem named "ART-Pro" will be appended to the Workbench's tool menu, an appicon will be put somewhere on your Workbench, or a tiny window will be opened. To re-enter ART-Pro, select the menu item, double-click the appicon or click the zip gadget in the tiny window's title bar. Be careful, clicking the window's close gadget is equivalent to @{" Exit " link "Exit" 0}. @endnode @node "Screen_Palette" "Screen Palette" @{b} Screen Palette@{ub} Adjust your favourite screen colors here. @endnode @node "Source_Format" "Source Format" @{b}Source Format@{ub} In this area you can configure all the settings associated with the source code generation. @{" Language " link "Language" 0} @{" Indent   " link "Indent" 0} @{" Tabs     " link "Tabs" 0} @{" Spaces   " link "Spaces" 0} @endnode @node "Language" "Language" @{b}Language@{ub} In this release of ART-Pro, only Assembler source code generation is supported. With other words, the "Language" cycle gadget has no effect on the language right now. At least C, Pascal, E, and Basic will be supported in the future, other languages, such as Modula2, Oberon etc. may be taken into consideration as well. @endnode @node "Indent" "Indent" @{b}Indent@{ub} This cycle gadget allows you to specify the character to be used for indenting. This can be either Tabs or Spaces. @endnode @node "Tabs" "Tabs" @{b}Tabs@{ub} Enter the number of tabs to be used for indenting here. @endnode @node "Spaces" "Spaces" @{b}Spaces@{ub} Enter the number of spaces to be used for indenting here. @endnode @node "Image_Format" "Image Format" @{b}Image Format@{ub} In this area you can configure all the settings associated with the image output. In this ART-Pro release, this will affect the @{" RAW " link "RAW" 0} and @{" RAW-BLITT " link "RAW-BLITT" 0} savers, as well as @{" MASK " link "MASK" 0} and @{" MASK-BLITT " link "MASK-BLITT" 0}. @{" Output       " link "Output" 0} @{" Width        " link "Width" 0} @{" BlitWord     " link "BlitWord" 0} @{" Line Entries " link "Line_Entries" 0} @endnode @node "Output" "Output" @{b} Output@{ub} Specify either "Source" or "Binary" here for the image data output. In oncoming versions of ART-Pro, more output formats will be available as well, such as "LinkObject". @endnode @node "Width" "Width" @{b}Width@{ub} This cycle gadget will only be available if the @{" Output " link "Output" 0} selector is adjusted to "Source". Here you can specify the data width to be output - choose between bytes, words, or longwords. @endnode @node "BlitWord" "BlitWord" @{b}BlitWord@{ub} You can adjust this cycle gadget to "None", "Left", or "Right". To treat a brush in a normal manner, select "None". For shifted blitting, you may wish to add extra words at either the left or right side, whereby the brush will be enlarged by one word (16 pixels) in width. @endnode @node "Line_Entries" "Line Entries" @{b}Line Entries@{ub} This string gadget will be disabled when @{" Output " link "Output" 0} is adjusted to "Binary". It allows you to specify the number of data entries per line when source code generation is enabled. Enter 0 here if you want to omit line feeds in order to fill up a line completely. Note: Not all editors can handle lines with extreme lengths. @endnode @node "SavePrefs" "Save" @{b} Save@{ub} Click this gadget or press its keyboard equivalent "s" to save the current settings. A file requester will pop up and prompt you to specify a path and file name for your settings file. Remember, the default path for ART-Pro's settings is ENV:ART-Pro respectively ENVARC:ART-Pro. The default name is ART-Pro.prefs. @endnode @node "LoadPrefs" "Load" @{b}Load@{ub} Click this button or press its keyboard equivalent "l" to load a previously saved ART-Pro settings file. A file requester will pop up and prompt you to specify a path and file name for your settings file. @endnode @node "UsePrefs" "Use" @{b} Use@{ub} Activate this button or press its keyboard equivalent "u" to accept and use ART-Pro's current settings. The settings window will be closed and you'll get back to the main screen. @endnode @node "CancelPrefs" "Cancel" @{b}Cancel@{ub} Activate this button or press its keyboard equivalent "c" to forget the actual settings and to go back to the main screen. @endnode @node "GlobalSettings" "Global Settings" @{b}Global settings@{ub} All switches affecting ART-Pro's general behaviour and global appearance are grouped together in the settings window's upper left. @{" Show Pic after Load " link "Show_Pic_after_Load" 0} @{" Auto save Colors " link "Auto_save_Colors" 0} @{" Center Pic          " link "Center_Pic" 0} @{" Ask Mask-Color   " link "Ask_Mask-Color" 0} @{" Draw Grid           " link "Draw_Grid" 0} @{" Iconify          " link "Iconify_Mode" 0} @{" Overwrite           " link "Overwrite" 0} @{" Screen Palette   " link "Screen_Palette" 0} @endnode @node "ImagePalOp" "Image / Palette Operations" @{b}Image / Palette Operations@{ub} These functions are not yet implemented. @endnode @node "Color_Format" "Color Format" @{b}Color Format@{ub} In this area you can configure all the settings associated with the @{" COLOR " link "COLOR" 0} saver output. @{" Output       " link "ColOutput" 0} @{" Format       " link "ColFormat" 0} @{" Depth        " link "ColDepth" 0} @{" Line Entries " link "ColEntries" 0} @endnode @node "ColOutput" "Output" @{b}Output@{ub} Using this cycle gadget, you can configure the color data output. Choose between Source, Binary, or IFF. @endnode @node "ColFormat" "Format" @{b} Format@{ub} Here you can specify the color format defining the source or binary @{" output " link "ColOutput" 0}. Choose between Copper, LoadRGB, or Pure. @{u}Copper@{uu} will generate a copperlist. Depending on the @{" Depth " link "ColDepth" 0} setting, this applies to standard or AGA copperlists. Copperlist means in detail that there are MOVE commands included for the appropriate color registers. @{u}LoadRGB@{uu} will generate color data for the use with the graphics.library LoadRGB function. Depending on the @{" Depth " link "ColDepth" 0} setting, this applies to LoadRGB4 or LoadRGB32 (V39). @{u}Pure@{uu} will generate a raw color table. @endnode @node "ColDepth" "Depth" @{b} Depth@{ub} Adjust this to either 4 or 8 Bit. This will affect all color @{" output " link "ColOutput" 0} and @{" format " link "ColFormat" 0} settings, except for IFF. If you plan to use AGA color resolutions in your software projects, adjust this switch to 8 Bit. @endnode @node "ColEntries" "Line Entries" @{b}Line Entries@{ub} This string gadget will be disabled when @{" Output " link "ColOutput" 0} is adjusted to Binary or IFF. It allows you to specify the number of data entries per line when source code generation is enabled. Enter 0 here if you want to omit line feeds in order to fill up a line completely. Note: Not all editors can handle lines with extreme lengths. @endnode @node "Sprite_Format" "Sprite Format" @{b}Sprite Format@{ub} In this area you can configure all the settings associated with the @{" SPRITE " link "SPRITE" 0} saver output. @{"      Output      " link "SprOutput" 0} @{" Cols " link "SprCols" 0} @{" Width " link "SprWidth" 0} @{"   Ctrl. Words    " link "SprCtrl" 0} @{"   Line Entries   " link "SprEntries" 0} @endnode @node "SprOutput" "Output" @{b}Output@{ub} Using this cycle gadget, you can configure the sprite data output. Choose between Source or Binary. @endnode @node "SprCols" "Colors" @{b}Number of Colors@{ub} Here you can adjust the number of colors for the sprite conversion. Select either 4 or 16 colors. The Amiga customchip hardware supports sprites in either 4 or 16 colors. For the use of 16 colors, a sprite pair of two 4colored sprites has to be "attached". Attaching means, the positions of sprites belonging to a pair have to be identical (the sprites would appear in the normal 4 color display otherwise), and the attach-bit of at least the second (odd) sprite has to be set. Using ART-Pro, there's no need to bother. Just select 16 colors, and ART-Pro does the rest for you - Your brush selection is interpreted as one or a multiple of 16colored sprites. If you select ART-Pro's @{" control  word  calculation " link "SprCtrl" 0}, even that position and attach-bit stuff will be performed automatically. @endnode @node "SprWidth" "Width" @{b}Width@{ub} Select a sprite width for your purpose here. Choose between 16, 32, or 64 pixels. Keep in mind that sprites wider than 16 pixels are not supported prior to AGA. @endnode @node "SprCtrl" "Control Words" @{b}Control Words@{ub} Sprite datalists for hardware-proramming purposes require control words at their beginning. These control words contain all the information needed for the sprite display, such as horizontal and vertical start positions, vertical stop position, and the attach-bit mentioned in the @{" colors " link "SprCols" 0} section. ART-Pro supports sprite control words in three ways: None, Empty, or Position. Use the cycle gadget to adjust one of these. @{u}None@{uu} ART-Pro doesn't care about control words. They will be omitted. @{u}Empty@{uu} ART-Pro includes control words at the beginning of the sprite datalists, but they're empty, i.e. set to zero. @{u}Position@{uu} ART-Pro includes sprite control words containing ALL the information needed for proper display. The last setting can be extremely useful for you, if you're one of those hardware programmers who use static sprites for complex screen layouts. In this release of ART-Pro, the control word calculation will be performed as follows: VerticalStart = raster line $2c + brush's Y position inside your picture VerticalStop = raster line $2c + brush's Y position + brush's height HorizontalStart = DMA start $80 + brush's X position inside your picture Experienced programmers will have noticed that these values apply to standard non-overscan screens. In futural versions of ART-Pro, these calculations might be customized to the user. @endnode @node "SprEntries" "Line Entries" @{b}Line Entries@{ub} This string gadget will appear ghosted when @{" output " link "SprOutput" 0} is adjusted to Binary. It allows you to specify the number of data entries per line when source code generation is enabled. Enter 0 here if you want to omit line feeds in order to fill up a line completely. Note: Not all editors can handle lines with extreme lengths. @endnode @node "FuturePlans" "Future Plans" @{b} Future plans@{ub} This is just a list of ideas that may become part of ART-Pro some day. Don't belt @{" me " link "Author" 0} if you don't find your favourite ideas realized in the next release - you should rather get in contact with @{" me " link "Author" 0} in order to lay stress upon features listed herein, or if you've got other suggestions. @{u}Savers@{uu} RAW-CHUNKY-LEFT left-justified 8Bit chunkies RAW-CHUNKY-RIGHT right-justified 8Bit chunkies RAW-16BIT-RGB any pixel represented by a $0RGB color value STENCIL MASK mask generated with a specific set of colors STENCIL MASK-BLITT interleaved mask generated with a specific set of colors some popular gfx-formats @{u}Loaders@{uu} DATATYPE universal loader using system datatypes RAW-CHUNKY-LEFT left-justified 8Bit chunkies RAW-CHUNKY-RIGHT right-justified 8Bit chunkies RAW-16BIT-RGB any pixel represented by a $0RGB color value some popular gfx-formats @{u}Brush operators@{uu} MULTICUT VERTICAL allowing multiple brushs to be cut, and linked vertically MULTICUT HORIZONTAL allowing multiple brushs to be cut, and linked horizontally @{u}Image operators@{uu} SCALE flexible scaling LESS COLORS to reduce the number of colors used @{u}Palette operators@{uu} PALETTE RGB/HSV palette adjustments BIAS global color adjustments for saturation, brightness, contrast, RGB PACK COLORS removing unused colors and re-ordering the palette @{u}Miscellaneous@{uu} Implementation of C, Pascal, Basic, and E source code generation Customized sprite control word calculation ARexx port Don't forget that it depends on YOUR feedback what ideas will be implemented first or if at all. @endnode @node "Acks" "Acknowledges" @{b}Acknowledgements@{ub} - Thanks to @{u}Captain Bifat@{uu} / The Electronic Knights for suggestions, testing, redesigning the graphical user interface, drawing the logo and icons, and writing the documentation. - Thanks to @{u}Buggs@{uu} / Defect for suggestions, additional help, and testing. - Thanks to M.U.D.U. / Defect for the nice Mona Lisa-Icon @endnode @node "History" "History" @{b} History@{ub} V0.62 21.10.1994 - added save LinkObjekt - added save Load/Savepath after Exit - some Bugfixes V0.60 08.10.1994 First puplic release for the Tool-Competition at the Doomsday Party. @endnode @node "link" "Specify Linkdata" @{b}Specify Linkdata@{ub} After selecting "Save" and define a Filename a requester will pop up and prompt you to specify the Linkdata.The Stringgadget entitled "External definiton" allows you to enter a Labelname for the Objektfile.With the Cyclegadget "Memory Type" you can specify a Memory Type for the data. Select "Do it" or press its keyboard equivalent "d" to save the linkdatafile, or "Cancel" for abortion. @endnode