@database ArtPRO @master Data:Texte/ArtPRO/ArtPRO.Guide @$VER: 1.12 @author "Timm S. Müller, Jörg Krempien, Frank Pagels" @(c) "© 1994-1997, Frank Pagels / Defect Softworks" @index Indx @remark Created with Heddley v1.1 (c) Edd Dumbill 1994 @node "Main" "ArtPRO v1.12 © 1994-1998 Frank Pagels / Defect Softworks" @{b}ArtPRO v1.12@{ub} multi-purpose graphics converter and image processor © 1994-1998 by Frank Pagels Defect Softworks @{" Copyright         " link "Main_Copyright" 0} Copyright notes @{" Disclaimer        " link "Main_Disclaimer" 0} Warranties? No way. @{" Distribution      " link "Main_Distribution" 0} How to distribute @{" Shareware         " link "Main_Shareware" 0} About the shareware concept @{" Registration      " link "Main_Registration" 0} How to register @{" Author            " link "Main_Author" 0} How to reach the author @{" Overview          " link "Main_Introduction" 0} Introduction and new features @{" Requirements      " link "Main_System_requirements" 0} What's required to run ArtPRO @{" Installation      " link "Main_Installation" 0} How to install ArtPRO @{" Usage             " link "Main_Usage" 0} Using the graphical user interface @{" Problems          " link "Main_Probs" 0} Being worked at @{" History           " link "Main_History" 0} What happened meanwhile @{" Acknowledges      " link "Main_Acks" 0} The people involved @{" Todo              " link "Main_Todo" 0} What should be done @endnode @node "Main_Copyright" "Copyright" @{b}Copyright@{ub} The entire ArtPRO package was created and is copyrighted © 1994-1997 by Frank Pagels, except for reqtools.library which is copyrighted © by Nico François and render.library and guigfx.library which are copyrighted © by Timm S. Müller. ArtPRO makes use of the Tower JPEG Codec Class. The JPEG codec is Copyright © 1994 Christoph Feck, TowerSystems. All Rights Reserved. It is based in part on the work of the Independent JPEG Group. @endnode @node "Main_Disclaimer" "Disclaimer" @{b} Disclaimer@{ub} This software is provided "as-is" without any warranty, either expressed or implied. the author accepts no responsibility for damage and/or loss of data/equipment resulting from the use of this software. @endnode @node "Main_Distribution" "Distribution" @{b}Distribution@{ub} The ArtPRO package may be redistributed freely, as long as there are no changes made to any part of this software or documentation. No parts of this package may be omitted or altered by any means except for archiving. You have to reproduce the package completely. 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 4,- must not be exceeded for a disk containing ArtPRO. @endnode @node "Main_Shareware" "Shareware" @{b}Shareware@{ub} ArtPRO is shareware. You're requested to @{"register" link "Main_Registration" 0} if you use ArtPRO frequently. First of all this helps to ensure further development. Second, registered users will get a private keyfile along with the latest version available, and finally, you'll be able to use ALL the features provided by ArtPRO without limitations. @{u}Limitations for non-registered users@{uu} - No requester for customized sprite control-word calculations - No screenmode lock - Registration reminder pops up at exit - The GIFANIM saver does not handle 24bit images. The number of features reserved for registered users will grow in the future, of course. The shareware idea behind ArtPRO is that development stays transparent to you. The earlier you @{"register" link "Main_Registration" 0}, the better your demands can be taken into account. Last not least, updates stay free until doomsday. @endnode @node "Main_Registration" "Registration" @{b} Registration@{ub} To register, fill out the included registration form, bring it to paper and send it to the @{"author" link "Main_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 receive a sending by mail, including your personal keyfile and the latest ArtPRO revision. More updates are available if you send disks and additional money or stamps for postage. Updates should also be available at your local bulletin board systems and on Aminet. @endnode @node "Main_Author" "Author" @{b}Author@{ub} Submit suggestions, bug reports, registrations to: Frank (Copper) Pagels Kolumbusring 39 18106 Rostock FR of Germany Phone +49 (0)381 1207938 E-Mail: frank.pagels@rostock.netsurf.de copper@Hysteria.dssd.sub.org Subject: ArtPRO WWW: http://home.pages.de/~defect @endnode @node "Main_Introduction" "Overview" @{b}Overview@{ub} Interchange of different file formats ArtPRO supports a lot of different file formats, such as ILBM, GIF, TIFF, BMP, PCX, and everything that can be loaded via Datatypes. Even a variety of raw formats can be loaded and saved. RAW conversion Highly flexible source code generation is supported as well as binary and linkable output. Images can be saved as bitplanes, chunky and truecolor in many variations. Copperlists and sprite control-words can be generated automatically. The AGA hardware features are extensively supported. ArtPRO even creates labels for your source code and lets you convert raw data back to images. ArtPRO has got a configurable saver section. That's what programmers always have been looking for. Create and configure all the different raw format savers you require for your projects - with a few simple mouse clicks! Palette and image processing ArtPRO offers blazingly fast color reduction and rendering, palette optimization, realtime color bias (even with truecolor images), and a fully-featured palette editor. Comfortable GUI ArtPRO doesn't consist of an empty screen with dozens of menus, driving you berzerk with unsuitable colors and weird screen resolutions - instead, it has got an expensive GUI which can be driven by both gadgets and keyboard shortcuts. It can be configured in many ways to suit your taste. Programmable interfaces If you want to customize ArtPRO with a bunch of your own, special weirdo formats: Just contact the @{"author" link "Main_Author" 0} to get the documentation of the external interfaces for loaders, savers, and operators. @endnode @node "Main_System_requirements" "System requirements" @{b}System requirements@{ub} - an Amiga - OS 3.0 (v39) - MC 68020 CPU - 1-2 MB RAM (more suggested) @endnode @node "Main_Installation" "Installation" @{b}Installation@{ub} That's the easiest part. Just double-click on the 'Install' icon. All steps to ensure proper functionality will be performed in the installation script. No bad hacks are getting installed, and there won't be fiddled around with your user-startup. There's no reason to risk a installation by hand. @endnode @node "Main_Usage" "Usage" GUI Usage @{" Main Control Panel " link "Main_Control_Panel" 0} @{" Image Control           " link "Image_Control" 0} @{" File Operation     " link "File_Operation" 0} @{" Image Operation         " link "ImagePalOp" 0} @{" Brush Operation    " link "Brush_Operation" 0} @{" Palette Operation       " link "PalOp" 0} @{" Selecting a loader / saver " link "Module_Selection" 0} @{" Settings Window            " link "Settings_Window" 0} @endnode @node "Main_History" "History" @{b}History@{ub} @{b}V1.12 @{ub} 15.01.1998 - cut brush and colorbias crashed when no image was loaded. fixed. - brush section changed in the main window. added clear gadget. - the cut controlwindow had now integergadgets,you can type the brush koordinates with it. - artpro now works on all kinds of custom screens. - fixed saver and operator message when starting ArtPRO. - fixed iconify problems. - fixed accuracy problems in the colorbias operator. - pack colors crashed. fixed. - corrected problems with MCP newgadtools. - EHB images were not displayed correctly in the preview and on operator screens. fixed. - added FLIP operators. - minor problems corrected @{b}V1.10@{ub} 07.12.1997 - added image preview in the main window - uses guigfx.library for operator screens - Kickstart 2.x no longer supported - better monitor selection for 24bit images, especially for graphics cards - v43 picture datatype import implemented - new screen handling for brush selection and colorbias, now working fine with graphics cards. - IFF24 saver implemented - JPEG loader/saver implemented - new operators: MakeButton, ListRender, Count Colors - fixed rgb chunky12 loader - fixed rgb chunky 24 saver - fixed GIF loader for transparent images and extensions - fixed TIFF loader - fixed GIF saver - datatype loading didn't work after saving GIFs - of course lots of minor changes :-) @{b}V1.03@{ub} 23.03.1997 - render.library_020 crashed on machines without fpu --> fixed - 24bit display with Picasso96 now possible - Random dither has been implemented - lots of minor changes @{b}V1.02@{ub} 16.02.1997 - "Load RAW" crashed --> fixed - Universal loader didn't work under Kick 2.0 --> Fixed - The palette editor didn't work under Kick 2.0 because I used only OS 3.0 functions :( --> Fixed - "Conf. Overwrite" in the Global Settings worked opposite to the intended function --> Fixed - After a Iconify the loader/saver names were not correctly restored --> Fixed - Documentation completely reworked - Render.Library developer package now included to ArtPRO's distribution @{b}V1.00@{ub} 04.02.1997 - Settings window reworked and cleaned up - Colorbias with HAM and 24bit images realtime with a preview 8/4 bit picture - font problem with meminfo in the main window fixed - implemented local prefs for loaders and savers - false loading of raw HAM8 images fixed - rendering and render control window added - progress indicator window added - universal loader added - image is situated in fast memory now - new, fantastic loader and saver management implemented - GIF, raw rgb, and raw chunky loaders added - TIFF, BMP, PCX, IFF support 24bit now - CybergraphX 24/16/15 bit display implemented - GIF and GIFANIM savers added - tooltypes for loader & saver configs implemented - problems with message handling fixed - some user interface changes @{b}V0.94@{ub} 18.06.1995 - Palette Editor added. - TIFF loader/saver available - ArtPro uses now an appwindow. - External appicon can be changed by tooltypes. - Can save a image structure (only for sources) - The loader/saverwindow can now handled by keyboard completely. - Should work better on GFX cards. ;-) - The cut-frame can now moved by mouse. - Shortcuts for 'Add dir'/'Kill all' fixed. Also shortcut for 'Execute Operator' and 'Change ID-Mode.' - View Pic can now exit by ESC. - To exit while ArtPRO is iconified as window should work. - Now there is an error message while loading IFF24. - To exit without saving the config can reached by pressing Shift+'x' or Shift+Exit button. - Removed a bug in autocut @{b}V0.90@{ub} 18.06.1995 - Saving RAW HAM8 produced wrong output. Fixed. - Ask Mask-Color didn't work 100% all the time. Problem solved hopefully. - The sprite control word calculation for 32 and 64 pixel wide sprites generated non-AGA control words - bug removed. - The "Kill" gadget shortcut had no effect - finally, it works - An "Info" gadget has been added to the module windows for quick reference on the loaders and savers. - Automatic and semi-automatic label generation implemented (assembler only so far). - Serious bug fixed: If you saved a brush having an odd with with one of the CHUNKY savers, the machine crashed. (Yuck) - Another heavy bug: Saving a link object with no object name crashed. - Finally, an installation script has been included to the distribution package. - External savers included: PCX and BMP. - Pack Colors image operator included. - The cut-frame is now kept when re-entering the control screen. - Minor bug removed that caused problems with the control screen and screenmode promoting programs. @{b}V0.88u@{ub} 05.04.1995 - Special release for the Amiga Inside CD by UMD! Read the ArtPRO.readme file! @{b}V0.87@{ub} 03.04.1995 - Cosmetic: "ART-Pro" changed to "ArtPRO". - GUI completely reworked. ArtPRO now opens a font-sensitive window on the Workbench or on a public screen, or opens an own public screen. A font can be selected. - Color-Bias screen overwork. - The windows' positions and a locked screenmode are saved on exit now. - External loaders included: PCX and BMP. - The Settings section has got a "Save" and a "Save as" button now. - "Confirm exit" included. - Bug removed when selecting a frame NOT from upper-left to lower-right. The brush size should be correct now. - The logo is scaled according to the window's dimensions and is rendered to a screen's palette (V37) or its sharable/obtainable pens (V39). - The "Center Pic" option caused some problems. Believe it or not, this mighty important feature has been REMOVED. - Few minor bugs removed. @{b}V0.79@{ub} 4.1.1995 (major bugfix) - Parts of the guide have been rewritten for V0.78. Some passages were linked incorrectly, some were completely wrong, some were malformatted. Fixed. - Saving images which have been loaded as RAW HAM6 crashed. Fixed. - Displaying or saving images which have been loaded as RAW EHB could crash under certain circumstances. In addition to that, saving images which have been loaded as RAW-EHB led to 64color non-EHB images. Fixed. - Iconify plus un-iconify "un-registered" ArtPRO. Solved. - The Load-RAW screenmode requester will now keep the last selected screenmode. - The RGB-CHUNKY-12Bit and RGB-CHUNKY-24Bit savers crashed on 68000 and 68010 based machines. This has been fixed. Now the code differenciates correctly between 68000 and 680x0 based machines for the use of optimized routines. - Minor bugs and several Enforcer-hits removed. @{b}V0.78@{ub} 30.12.1994 (The Party 4 release) - After cutting a brush and iconifying, ArtPRO saved the complete picture instead of the brush. Solved. - GUI layout in the preference section changed, for the source code settings are now global and apply to all output formats. - RAW-CHUNKY (LEFT/RIGHT) savers implemented. - RGB-CHUNKY-12BIT and 24BIT savers implemented. - COLOR-RAW and COLOR-IFF loaders implemented. - First public release with a keyfile for registered users. - Color-Bias included. - Ask Mask-Color crashed sometimes. Fixed. - User prompt for customized control-word calculation included to the sprite output settings. (Registered users only.) - various minor bugs fixed. @{b}V0.77 ... V0.70@{ub} (several internal releases) - Screenmode lock implemented. (Registered users only) - ArtPRO crashed when saving an 8bit copperlist as binary. This has been fixed. - Source-generator completed. ArtPRO now supports Assembler, C, Basic, E, and Pascal. @{b}V0.641@{ub} 12.11.1994 (quick update) - ArtPRO crashed on 68000 based machines - now fixed - ArtPRO did strange nosense when having no directory name in the file requester! Oops... @{b}V0.64@{ub} 05.11.1994 (Coma Party Köln) - removed a major bug - ArtPRO crashed on exit if a screenmode wasn't available/supported - now fixed - bug in AutoCut fixed - left box edge not set correctly sometimes - added a text field at the control screen and inside the main window, displaying a brush's width in words - ArtPRO now saves the selected loader/saver modules to its default prefs path on exit - now a busy-pointer appears when needed - some minor bugfixes @{b}V0.62@{ub} 21.10.1994 - added link-object - ArtPRO now saves its load/save paths to its default prefs paths on exit - some bugfixes @{b}V0.60@{ub} 08.10.1994 First puplic release for the tool competition at the Doomsday Party. @endnode @node "Main_Acks" "Acknowledgements" @{b}Acknowledgements@{ub} - Thanks to @{u}Timm S. Müller@{uu} alias Captain Bifat / TEK neoscientists for suggestions, testing, designing the graphical user interface, drawing the logo, writing parts of the documentation and the fantastic render.library. - Thanks to @{u}Jörg "M.U.D.U." Krempien@{uu} / Defect Softworks for the nice Mona Lisa icon, moral support and continuing care about the documentation. - Thanks to @{u}Henryk "Buggs" Richter@{uu} / Defect Softworks for suggestions, additional help, and testing. - Greets fly to: - Gerd Frank (the 1st registered user) - Tim Favro ,Kirster Simon Skrtic and Uwe Schröder for suggestion and testing - Stefan Sommerfeld for find my stupid bug, that ArtPRO don't work with the MCP NewGadtools function - TIK/Retire (thanx for help with HAM8 and the Spritecontrolwords) - all registered user - and of course all members of Defect and TEK neoscientists @endnode @node "Main_Todo" "To Do" @{b}ToDo@{ub} There are still some features not finished yet... - total rewrite of the Gif Anim saver - AREXX Port - new Operators - new Loaders & Savers - german documentation - LZW support for TIFF loader/saver - better graphics card handling - ... @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 ArtPRO'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), 'Chip' and 'Fast'.  @{"About" link "About" 0}    @{"Settings" link "Settings_Window" 0}    @{"Iconify" link "Iconify" 0}    @{"Exit" link "Exit" 0}  @endnode @node "Main_ToolTypes" "Tooltype Settings" @{b}Tooltypes@{ub} ArtPRO can be customized with a few tooltype settings. @{u}APPICON@{uu}=filename the appicon to be used when ArtPRO gets iconified. Specify without '.info'. @{u}LOADLIST@{uu}=filename list and configuration of loaders to be loaded at startup. Default: ENV:ArtPRO/loaderdefault.cfg @{u}SAVELIST@{uu}=filename list and configuration of savers to be loaded at startup. Default: ENV:ArtPRO/saverdefault.cfg @endnode @node "About" "About" @{b} About@{ub} This one opens a stunning requester with some information about the ArtPRO revision running, the author's address and stuff like that. If you're a registered user, you can activate the 'key' button for further information on your registration key. @endnode @node "Iconify" "Iconify" @{b} Iconify@{ub} As the name suggests, this leads to iconification of ArtPRO and frees as much memory as possible. ArtPRO 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 section" link "Settings_Window" 0}). You may also use a custom appicon. Refer to the @{"tooltypes section" link "Main_ToolTypes" 0}. @endnode @node "Exit" "Exit" @{b}Exit@{ub} Press this button to quit ArtPRO. On exit, ArtPRO saves the current load/savepath, window positions, the screen-lock setting and the current loader/saver to ENV:ArtPRO/. Hold down the SHIFT key while exiting, and ArtPRO will exit without saving anything of its configuration. By default, you must confirm to exit ArtPRO. This behavior may be changed in the @{"global settings section" link "GlobalSettings" 0}. @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 and they reflect which @{"loaders" link "Loaders" 0} and @{"savers" link "Savers" 0} are currently selected. @{" Load " link "Load" 0} @{" 1 " link "Module_Selection" 0} @{" Save " link "Save" 0} @{" 2 " link "Module_Selection" 0} To enter the @{"loaders or savers section" link "Module_Selection" 0}, activate either of the tiny buttons at the right, labelled with '1' and '2'. @endnode @node "Load" "Load" @{b}Load@{ub} Press this button to open a file requester for loading an image. You find the current loader displayed in the text field on the right. Read the @{"loaders" link "Loaders" 0} section for details and the available file formats. Click the tiny button at the right labelled with '1' to enter the @{"loader selection" link "Module_Selection" 0}. ArtPRO's main window is an appwindow, i.e. you can also drag & drop image icons on it in order to load a file. @endnode @node "Save" "Save" @{b}Save@{ub} Click on this button to open a file requester for saving. You find the selected saver displayed in the text field on the right. Refer to the @{"savers" link "Savers" 0} section for details and the available formats. Click the tiny button at the right labelled with '2' to activate the @{"saver selection" link "Module_Selection" 0}. By default, you will be prompted to confirm overwriting files which already exist. This behaviour can be changed in the @{"settings section" link "Settings_Window" 0}. @endnode @node "Image_Control" "Image Control" @{b} Image Control@{ub} There are four buttons and four 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 image.  @{"               Screenmode              " link "Screen_Mode_Selector" 0}   @{" Render/Display " link "Render_\_Redisplay" 0} @{" Render Ctrl " link "Image_Ctrl_RenderControl" 0} @{" Lock " link "Image_Ctrl_Lock" 0} @endnode @node "Screen_Mode_Selector" "Selecting a Screen Mode" @{b} Screen Mode Selection@{ub} This is the button labelled with '3' - it is located right to the text field displaying the current 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. Some screen mode modifications require rendering, e.g. a 256-color image cannot be displayed on OCS/ECS PAL-Hires. @endnode @node "Render_\_Redisplay" "Render / Redisplay" @{b}Render/Display@{ub} Press this button to display the current picture. If you modified the settings in the @{"render-control" link "Image_Ctrl_RenderControl" 0} section, the image will be rendered first. @endnode @node "Brush_Operation" "Brush Operation" @{b}Brush Operation@{ub} This section is for selecting an area inside the image. When such an area (or 'brush') is selected, most of ArtPRO's operations apply to this area rather than to the complete image. click on @{" Select Brush " link "Selecting_a_Frame" 0} to mark a new brush Clear to clear the current selection. @endnode @node "Control_Screen" "Control Screen" @{b}Control Screen@{ub} There are three buttons and four text fields located on the brush control screen. They're labelled as follows: @{u}X@{uu} - displays the horizontal position of the cursor, relative to the left screen border @{u}Y@{uu} - displays the vertical position of the cursor, relative to the upper screen border @{u}BW@{uu} - the frame's current width @{u}BH@{uu} - the frame's current height @{u}Wrd@{uu} - counts the frame's width in words (multiples of 16) @{u}(box)@{uu} - indicates whether the brush width is extactly a multiple of 16. If so, the box gets highlighted. @{" AutoCut " link "AutoCut" 0} - to automatically enclosure the brush at its outmost edges @{u}Accept@{uu} - to accept a brush selection @{u}Cancel@{uu} - to leave this section without a new brush When the control screen annoys you: you can turn it off and on by pressing the space bar. This is also an intermediate solution for CybergraphX / Picasso 96 users. @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. There's no need to keep the left mouse button pressed. Press the left mouse button once again to use the frame. To redo that operation, press the right mouse button and select another frame. If you're satisfied with your brush selection, leave this section by clicking the 'Accept' button. You don't need to cut your brush at its exact borders, try the @{"AutoCut" link "AutoCut" 0} feature after you've selected a rough frame. After you've selected a frame, you can modify it in various ways: - @{u}Click@{uu} with the left mouse button into the frame to drag it around - @{u}Cursor@{uu} to move the frame - @{u}SHIFT-Cursor@{uu} to resize the frame at the lower-right - @{u}ALT-Cursor@{uu} to resize the frame at the upper-left @endnode @node "Grid" "Grid" @{b} Grid@{ub} The grid's width amounts to 16 pixels. Toggle it on or off by pressing the 'g' key. By default, a grid is drawn. This behavior can be changed in the @{"settings section" link "Settings_Window" 0}. @endnode @node "AutoCut" "AutoCut" @{b}AutoCut@{ub} This feature is very handy when you have to cut a brush at its exact borders. The rubber frame will automatically enclosure your brush at its outmost edges. This does not work with a noisy background around the object you want to select. @endnode @node "Loaders" "Loaders" @{b}Loaders@{ub} In this version, ArtPRO supports the following loaders: internal loaders: @{"DATATYPE       " link "Loader_Datatype" 0}      @{"IFF ILBM       " link "Loader_IFF-ILBM" 0} @{"PALETTE        " link "Loader_Palette" 0} @{"SCREEN         " link "Loader_Screen" 0}   @{"RAW            " link "Loader_RAW" 0}       @{"RAW INTERLEAVED" link "Loader_RAW_Inter" 0} @{"UNIVERSAL      " link "Loader_Universal" 0} external loaders: @{"BMP            " link "Loader_BMP" 0} @{"CHUNKY         " link "Loader_CHUNKY" 0} @{"GIF            " link "Loader_GIF" 0} @{"PCX            " link "Loader_PCX" 0} @{"RGB CHUNKY     " link "Loader_RGBChunky" 0} @{"TIFF           " link "Loader_TIFF" 0} @{"JPEG           " link "Loader_JPEG" 0} If you want to develop other loaders please contact the @{"author" link "Main_Author" 0}. @endnode @node "Loader_BMP" "BMP" @{b}BMP@{ub} Loads Windows Bitmaps and OS/2 Bitmaps. Supports RLE4 and RLE8 compression. RLE8 is not fully tested yet. 24bit pictures are supported. @endnode @node "Loader_CHUNKY" "CHUNKY" @{b}CHUNKY@{ub} Loads RAW chunky images, with one byte representing one pixel. Chunky maps may either be left- or right-oriented. Left-oriented: Bit %76543210 Plane %12345678 the most significant bit represents the lowest bitplane Right-oriented: Bit %76543210 Plane %87654321 the most significant bit represents the highest bitplane @endnode @node "Loader_Datatype" "DATATYPE" @{b}DATATYPE@{ub} This loader is ArtPRO's interface to the operating system's datatypes. This loader isn't available under OS2.x. Datatypes provide a general technique for the access to different data formats, especially to formats that are unknown to a specific application. Many datatypes (stored in SYS:Classes/Datatypes and DEVS:Datatypes) are available. Use this loader whenever you want to load an image format that is not supported by ArtPRO. ArtPRO does not support 24 bit datatypes. @endnode @node "Loader_GIF" "GIF" @{b}GIF@{ub} Loads a GIF (graphics interchange file format) picture. The formats GIF 87a and 89a are supported from 1 to 8 bit. Multipic is not available yet. @endnode @node "Loader_IFF-ILBM" "IFF ILBM" @{b}IFF ILBM@{ub} Loads IFF ILBM (Interchange File Format / Interleaved BitMap) pictures. The first frame of IFF ANIMs is read as well. 24bit is also supported. @endnode @node "Loader_Palette" "PALETTE" @{b}PALETTE @{ub} This loader allows you to load a raw or IFF palette over a previously loaded image. This depends on the @{"palette loader's configuration" link "LoadPrefs_Palette" 0}, as well as how raw color data is interpreted. @endnode @node "Loader_PCX" "PCX" @{b}PCX@{ub} Loads PCX pictures from 1 to 24 bit. This fileformat is used by PaintBrush. @endnode @node "Loader_RGBChunky" "RGB CHUNKY" @{b}RGB CHUNKY@{ub} This loader loads raw RGB chunky data in either 12bit or 24bit. @endnode @node "Loader_Screen" "SCREEN" @{b}SCREEN@{ub} This loader is a screen grabber that allows you to fetch any screen being open on your system. Choose a screen when the requester pops up. @endnode @node "Loader_RAW" "RAW" @{b} RAW@{ub} This loader allows you to load standard (i.e. non-interleaved) raw bitplane data. 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. Select 'Do it' to load the raw image file. You will then be prompted to select a screen mode, and finally, the raw picture will be loaded. @endnode @node "Loader_RAW_Inter" "RAW INTERLEAVED" @{b}RAW INTERLEAVED@{ub} This loader allows you to load raw interleaved bitmap data. 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. Select 'Do it' to load the raw image file. You will then be prompted to select a screen mode, and finally, the raw picture will be loaded. @endnode @node "Loader_TIFF" "TIFF" @{b}TIFF@{ub} Loads TIFF (Tag Image File Format) images from 1bit up to 24bit. Only packbit compression is supported yet. @endnode @node "Loader_Universal" "UNIVERSAL" @{b}UNIVERSAL@{ub} This loader tries to determine the image format automatically. ArtPRO tries to use its own loaders first, then picture class datatype. Raw formats cannot be detected automatically. @endnode @node "LoadPrefs_Palette" "LoaderPrefs Palette " @{b}Palette Loader Configuration@{ub} @{u}IFF@{uu} - Fetch a palette from an IFF CMAP chunk. @{u}LoadRGB@{uu} - The raw color data are interpreted as for the LoadRGB32() or LoadRGB4() functions in graphics.library. This depends on the depth setting. Use '4bit' for the LoadRGB4() format and '8bit' for the LoadRGB32() format. @{u}Pure@{uu} - The raw color data are interpreted as 12bit or 24bit, right-justified R/G/B inside a word or a longword. Use the depth settings '4bit' for 0x0rgb, or '8bit' for 0x00rrggbb. @endnode @node "Savers" "Savers" @{b}Savers@{ub} In this version, ArtPRO supports these savers: internal: @{"IFF ILBM" link "Saver_IFF ILBM" 0} @{"PALETTE " link "Saver_Palette" 0} @{"RAW     " link "Saver_RAW" 0}   @{"SPRITE  " link "Saver_Sprite" 0} @{"CHUNKY  " link "Saver_Chunky" 0} external: @{"BMP     " link "Saver_BMP" 0} @{"GIF     " link "Saver_GIF" 0} @{"GIFANIM " link "Saver_GIFANIM" 0} @{"JPEG    " link "Saver_JPEG" 0} @{"PCX     " link "Saver_PCX" 0} @{"TIFF    " link "Saver_TIFF" 0} @endnode @node "Saver_IFF ILBM" "IFF ILBM" @{b}IFF ILBM@{ub} This saver allows you to save your current picture or brush as IFF-ILBM. Refer to the @{" IFF Saver Prefs " link "SavePrefs_IFF ILBM" 0} section for the available settings. 24bit is not supported yet. @endnode @node "Saver_Palette" "PALETTE" @{b}PALETTE@{ub} This one saves the current picture's palette. Please refer to the @{" PALETTE Saver Prefs " link "SavePrefs_Palette" 0} section for the available options. @endnode @node "Saver_RAW" "RAW" @{b}RAW@{ub} This one saves an image or brush in raw-bitplane format. Please refer @{"RAW-Saver Prefs" link "SavePrefs_RAW" 0} section for the available options. The width is always aligned to words (multiples of 16 pixels). @endnode @node "Saver_Sprite" "SPRITE" @{b}SPRITE@{ub} This will save your current brush as one or multiple hardware sprite(s). Please refer to the @{"SPRITE-Saver Prefs" link "SavePrefs_Sprite" 0} section for the available options. @endnode @node "Saver_Chunky" "CHUNKY" @{b}CHUNKY@{ub} This saver will generate raw chunky output from your current picture or brush. The following types are supported: - 8bit left-justified chunky (bytes) - 8bit right-justified chunky (bytes) - 12bit truecolor chunky (words) - 24bit truecolor chunky (longwords) Please refer to the @{"CHUNKY-Saver Prefs" link "SavePrefs_Chunky" 0} section for further details. @endnode @node "Saver_BMP" "BMP" @{b}BMP@{ub} Saves your current image or brush as BMP (Windows Bitmap) from 1 to 24 bit. Also refer to the @{"BMP-Saver Prefs" link "SavePrefs_BMP" 0} section. @endnode @node "Saver_GIF" "GIF" @{b} GIF@{ub} Saves an image or brush as GIF (Graphic Interchange Fileformat). The formats GIF87 and GIF89 are supported. Refer to the @{"GIF-Saver Prefs" link "SavePrefs_GIF" 0} section for the available options. @endnode @node "Saver_GIFANIM" "GIFANIM" @{b}GIFANIM@{ub} GIFANIM converts single frames to a GIF animation. Warning: This saver is a preliminary beta version. First of all, you have to provide the single frames with file names that end with a number, e.g. 'Frame_0034'. 1) Load the first frame (with any loader). If you're a registered user, you can load 24bit frames. In that case, enter the @{"render-control section" link "Image_Ctrl_RenderControl" 0} now and render the first frame to another depth. Note: Only 24bit frames can be rendered. 2) Execute the GIFANIM saver. Specify a file name. 3) A requester pops up. Specify the number of frames to process. 4) Another requester pops up. Specify the delay between the frames. After all, the GIFANIM will be generated, according to the @{"GIFANIM-Saver settings" link "SavePrefs_GIFANIM" 0}. @endnode @node "Saver_PCX" "" @{b}PCX@{ub} This will save the current image or brush as PCX from 1 bit up to 24 bit. Refer to the @{" PCX-Saver Prefs " link "SavePrefs_PCX" 0} section for the available settings. @endnode @node "Saver_TIFF" "TIFF" @{b}TIFF@{ub} This saver saves an image or brush as TIFF from 1 to 24 bit. Refer to the @{" TIFF-Saver Prefs " link "SavePrefs_TIFF" 0} section for the available options. @endnode @node "SavePrefs_TIFF" "TIFF" @{b}TIFF-Saver Prefs@{ub} @{u}Rendered@{uu} - save the rendered image as TIFF. @{u}24 bit@{uu} - save the image as 24 bit TIFF. HAM and HAM8 will be saved as 24 bit automatically. @endnode @node "SavePrefs_PCX" "PCX" @{b}PCX-Saver Prefs@{ub} @{u}Rendered@{uu} - saves the rendered image. @{u}24 bit@{uu} - saves the image as 24bit TIFF. HAM and HAM8 will be saved as 24bit automatically. @{u}VGA@{uu} - will save as VGA PCX with up to 8bit. Only available if 'Rendered' is selected. selected. @{u}EGA@{uu} - will save as EGA PCX with up to 4bit. Only available if 'Rendered' is selected. @endnode @node "SavePrefs_GIF" "GIF" @{b}GIF-Saver Prefs@{ub} @{u}Save Format@{uu} - GIF87a - An older GIF standard. Handles interlaced mode. GIF89a - The newer GIF standard. Handles interlaced and transparancy. @{u}Interlaced@{uu} - Select for interlaced mode. @{u}Transparency@{uu} - Select for transparent mode. Available only with the GIF89a format. @{u}Trans. color@{uu} - Index of the transparency color. @endnode @node "SavePrefs_GIFANIM" "GIFANIM" @{b}GIFANIM-Saver Prefs@{ub} @{u}Interlaced@{uu} - Toggle between interlaced and non-interlaced GIFANIM mode. @{u}Trancparency@{uu} - Select for transparency mode. @{u}Trans. color@{uu} - Color index of the transparent color. @endnode @node "SavePrefs_BMP" "BMP" @{b}BMP-Saver Prefs@{ub} @{u}Rendered@{uu} - Saves the redered picture. @{u}24 bit@{uu} - Will save the current picture in 24bit. HAM and HAM8 pictures will saved as 24bit automatically. @endnode @node "SavePrefs_Chunky" "CHUNKY" @{b}CHUNKY-Saver Prefs@{ub} Save Format Source Format @{" Output    " link "SaveFormat_Output" 0} @{" Type     " link "SavePrefs_Chunky_Type" 0} @{" Language " link "SourceFormat_Language" 0} @{"  Width " link "SourceFormat_Width" 0} @{" Byte Type " link "SavePrefs_Chunky_ByteType" 0} @{" RGB Type " link "SavePrefs_Chunky_RGBType" 0} @{" Indent " link "SourceFormat_Indent" 0} @{" Line Entries " link "SourceFormat_Line Entries" 0} @endnode @node "SavePrefs_Chunky_Type" "CHUNKY" @{b}Chunky Type@{ub} @{u}Byte@{uu} - This will save chunky bytes, with one pixel representing one pixel, either left or right justified. This can be specified with the @{"Byte Type" link "SavePrefs_Chunky_ByteType" 0} cycle gadget. @{u}RGB@{uu} - This will generate 12bit or 24bit trucolor output, with one pixel represented by either a word or a longword. This can be specified with the @{"RGB Type" link "SavePrefs_Chunky_RGBType" 0} cycle gadget. @endnode @node "SavePrefs_Chunky_ByteType" "CHUNKY" @{b}Byte Type@{ub} Here you can select the chunky byte's bit justification. left: %12345678 right: %87654321 Each digit represents its corresponding bitplane. Left justification is rather unconventional, it is mainly used for fast assembler chunky-to-bitplane conversions via cascades of ADD/ADDX opcodes. With this format there's no need to shift the chunkies to the left when converting less than 8 bitplanes. @endnode @node "SavePrefs_Chunky_RGBType" "CHUNKY" @{b}RGB Type@{ub} Specify the RGB chunky type here. 12bit: 0x0RGB words 2 bytes per pixel 24bit: 0x00RRGGBB longwords 4 bytes per pixel @endnode @node "SavePrefs_Sprite" "Sprite" @{b}SPRITE-Saver Prefs@{ub} Save Format Source Format @{" Output " link "SaveFormat_Output" 0} @{" Ctrl. Words " link "SavePrefs_Sprite_CtrlWords" 0} @{" Language " link "SourceFormat_Language" 0} @{"  Width " link "SourceFormat_Width" 0} @{" Colors " link "SavePrefs_Sprite_Colors" 0} @{" Width       " link "SavePrefs_Sprite_Width" 0} @{" Indent " link "SourceFormat_Indent" 0} @{" Labels " link "SavePrefs_Sprite_Labels" 0} @{" Line Entries " link "SourceFormat_Line Entries" 0} @endnode @node "SavePrefs_Sprite_Colors" "Sprite Colors" @{b}Number of Colors@{ub} Here you can adjust the number of colors for the sprite conversion. Choose between 4 or 16 colors. The Amiga customchip hardware supports sprites in either 4 or 16 colors. For using 16 colors, a sprite pair of two 4colored sprites has to be 'attached'. Attaching means, the positions of the attached sprite-pair have to be identical, and the attach-bit of at least the second (odd) sprite has to be set. Using ArtPRO, there's no need to bother. Just select 16 colors, and your brush selection is interpreted accordingly. If you select the @{"control word calculation" link "SavePrefs_Sprite_CtrlWords" 0}, even the attach-bit will be set automatically. @endnode @node "SavePrefs_Sprite_CtrlWords" "Sprite Control Words" @{b}Control Words@{ub} Hardware sprites require so-called 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 section" link "SavePrefs_Sprite_Colors" 0}. ArtPRO supports sprite control words in four ways: None, Empty, Auto, or Prompt. Use the cycle gadget to adjust one of these. @{u}None@{uu} ArtPRO doesn't care about control words. They will be omitted. @{u}Empty@{uu} ArtPRO includes control words at the beginning of the sprite datalists, but they're empty, i.e. set to zero. @{u}Auto@{uu} ArtPRO includes sprite control words containing ALL the information needed for proper display. The control word calculation will be performed as follows: VerticalStart = raster line $2c + brush's top edge inside your picture VerticalStop = raster line $2c + brush's top edge + brush's height HorizontalStart = DMA start $80 + brush's left edge inside your picture @{u}Prompt@{uu} ArtPRO will bring up a requester for a customized control word calculation when saving one or multiple sprites. Here you can adjust the VerticalStart and HorizontalStart values as well as the image-relative brush coordinates. The latter two settings can be extremely useful for you, if you're one of those hardware programmers who use static sprites for complex screen layouts. Experienced programmers will have noticed that the values used with the 'Auto' setting apply to standard non-overscan screens. Use the 'Prompt' setting if these don't fulfill your needs. @endnode @node "SavePrefs_Sprite_Labels" "Labels" @{b}Labels@{ub} Labels are implemented for assembly-language source code generation only. Adjust this switch to either 'Auto' or 'Prompt' for automatic or semi-automatic label generation. When a brush is wider than 16/32/64 pixels, it has to be divided into multiple data segments. If you select 'Auto', each segment will be labelled 'Sprite:'. If you select 'Prompt', a requester shows up before saving. You can enter the label name and the starting index there. Use 'Create' to use this definition for a single sprite, or 'Create all' to use it for all sprites with the index increasing automatically. @endnode @node "SavePrefs_Sprite_Width" "Sprite Width" @{b}Width@{ub} Adjust the sprite width here. Choose between 16, 32, or 64 pixels. Note: The OCS/ECS hardware does not support sprites wider than 16 pixels. @endnode @node "SavePrefs_RAW" "RAW" @{b}RAW-Saver Prefs@{ub} Save Format Source Format @{" Output    " link "SaveFormat_Output" 0} @{" BlitWord " link "SavePrefs_RAW_Blitword" 0} @{" Language " link "SourceFormat_Language" 0} @{" Width " link "SourceFormat_Width" 0}     @{" Indent " link "SourceFormat_Indent" 0} @{" Line Entries " link "SourceFormat_Line Entries" 0} Options: @{u}Interleaved@{uu} - generate interleaved bitplanes. @{u}Mask@{uu} - create a mask. If you save in non-interleaved mode, this mask consists of one bitplane. In interleaved mode, the masking bits appear in all bitplanes. @{u}Ask@{uu} - Normally, all colors different from color zero are taken into account when a mask is generated. With this option enabled, you will be prompted to enter a single, specific mask color instead. @{u}Image Structure@{uu} - In source mode, saves the image or brush as an image structure (struct Image, intuition.library). @endnode @node "SavePrefs_RAW_Blitword" "Blitword" @{b}Blitword@{ub} You can adjust this cycle gadget to 'None', 'Left', or 'Right'. 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 "SavePrefs_IFF ILBM" "IFF ILBM" @{b}IFF ILBM-Saver Prefs@{ub} Options: @{u}not packed@{uu} - uncompressed ILBM @{u}RLE packed@{uu} - RunLength (CmpByteRun1) compression @endnode @node "SavePrefs_Palette" "PALETTE" @{b}PALETTE-Saver Prefs@{ub} Save Format Source Format @{" Output " link "SavePrefs_Palette_Output" 0}   @{" Type " link "SavePrefs_Palette_Type" 0} @{" Language " link "SourceFormat_Language" 0} @{" Width " link "SourceFormat_Width" 0}      @{" Indent " link "SourceFormat_Indent" 0} @{" Line entries " link "SourceFormat_Line Entries" 0} Depth - use this cycle to set the palette's resolution. This can be either 4bit or 8bit. @endnode @node "SavePrefs_Palette_Type" "Type" @{b}Palette Type@{ub} @{u}Copper@{uu} - generates a hardware copperlist. If the depth setting is adjusted to 4bit, the copperlist will be of the OCS/ECS type. With depth set to 8bit, an AGA copperlist will be created. @{u}LoadRGB@{uu} - generates a palette in LoadRGB4() or LoadRGB32() format (graphics.library). This depends on the setting of the depth gadget. 4bit generates the LoadRGB4() format, 8bit generates a LoadRGB32() palette. @{u}Pure@{uu} - generates a raw palette in either 4bit (0x0rgb) or 8bit (0x00rrggbb), depending on the depth setting. @endnode @node "SaveFormat_Output" "Output" @{b} Output@{ub} Specify the output type with this cycle gadget: @{u}Source@{uu} - generates source code. @{u}Binary@{uu} - generates binary (raw, pure) data. @{u}Link@{uu} - generates a linkable object. Before saving, a requester shows up. Specify an external label definition and the type of memory there. @endnode @node "SourceFormat_Language" "Sourceformat" @{b}Language@{ub} Here you can select the programming language you want to generate source code for. Available languages are Assembler, C, Pascal, E, and Basic. @endnode @node "SourceFormat_Width" "Width" @{b}Width@{ub} Adjust the desired data width for the source code generation here. @{u}Bytes@{uu} - save as bytes (8bit) @{u}Words@{uu} - save as words (16bit) @{u}Longs@{uu} - save as longwords (32 bit) @endnode @node "SourceFormat_Indent" "Indent" @{b}Width@{ub} Adjust the desired data width for the source code generation here. @{u}Bytes@{uu} - save as bytes (8bit) @{u}Words@{uu} - save as words (16bit) @{u}Longs@{uu} - save as longwords (32 bit) @endnode @node "SavePrefs_Palette_Output" "Output" @{b} Output@{ub} Specify the palette output type with this cycle gadget: @{u}Source@{uu} - generates source code. @{u}Binary@{uu} - generates binary (raw, pure) data. @{u}Link@{uu} - generates a linkable objects. A requester will show up before saving. Specify a label and the type of memory there. @{u}IFF@{uu} - generates an IFF file with a CMAP chunk. @endnode @node "SourceFormat_Line Entries" "Line Entries" @{b}Line Entries@{ub} Enter the number of entries to appear in a single line of source code. If you enter 0 here, a line will be filled up completely. Note: Not all editors can handle lines with extreme lengths. @endnode @node "Show_Pic_after_Load" "Display Picture" @{b}Display Picture@{ub} With this switch enabled, any picture will be displayed right after loading. @endnode @node "Draw_Grid" "Draw Grid" @{b}Draw Grid@{ub} Activate this switch if you want a grid to be drawn when you select a frame for cutting a brush. @endnode @node "Overwrite" "Overwrite" @{b}Confirm Overwrite@{ub} Activate this switch if you want to confirm overwriting files. @endnode @node "ImagePalOp" "Image Operation" @{b}Image Operation@{ub} Image operators currently available: @{" Pack Colors      " link "Pack Colors" 0} @{" Count Colors     " link "Op_CountColors" 0} @{" List Render      " link "Op_ListRender" 0} @{" Make Button      " link "Op_MakeButton" 0} @{" FlipX            " link "Op_FlipX" 0} @{" FlipY            " link "Op_FlipY" 0} @endnode @node "Settings_Window" "Settings Window" @{b}Settings Window@{ub} @{" Global Settings " link "GlobalSettings" 0} @{" System " link "System" 0} @{" Operator Screen Settings   " link "OpScreenSettings" 0} @endnode @node "GlobalSettings" "Global Settings" @{b}Global settings@{ub} @{" Display Picture     " link "Show_Pic_after_Load" 0} @{" Draw Grid           " link "Draw_Grid" 0} @{" Confirm Exit        " link "Confirm_Exit" 0} @{" Confirm Overwrite   " link "Overwrite" 0} @{" Show Preview        " link "ShowPreview" 0} @{" Autosave Palette    " link "Auto_save_Colors" 0} @endnode @node "Auto_save_Colors" "Autosave Palette" @{b}Autosave Palette@{ub} Activate this switch if you want to automatically save a picture's palette along with the image. The file name will be the same as for the image, with an appropriate extension added, such as .asm for assembler source code. @endnode @node "Iconify_Mode" "Iconify Mode" @{b}Iconify Mode@{ub} ArtPRO offers three different ways of iconification - AppItem, AppIcon, and Window. You can adjust your preferred mode here. An AppItem named 'ArtPRO' 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 ArtPRO, select the menu item, double-click the appicon or click the zip gadget in the tiny window's title bar. You can use a custom AppIcon. Refer to the @{"iconify section" link "Iconify" 0} for details. @endnode @node "Screen_Palette" "Adjust Palette" @{b}Adjust Palette@{ub} This button is available for custom screens only. A palette requester will pop up for you to adjust the screen colors. @endnode @node "PalOp" "Palette Operation" @{b}Palette Operation@{ub} Palette operators implemented to ArtPRO so far: @{" Color-Bias " link "ColorBias" 0} @{"  Palette   " link "Palette" 0} @endnode @node "ColorBias" "Color Bias" @{b}Color Bias@{ub} Color-Bias is a great tool for global palette adjustments. Select the color-bias palette operator to enter your current picture with a tiny control screen at its bottom. Press the right mouse button to switch the control screen on and off. This control screen contains six sliders, entitled 'Color', 'Bright', 'Contrast', and 'R'/'G'/'B'. In addition to these, you find three buttons at the right, labelled 'Use', 'Keep', and 'Cancel'. Moving a slider to the left will reduce a value, moving it to the right will increase it. The color bias palette modification will be performed real-time. Press the 'Use' button to leave this section with the new palette. If you select 'Cancel', you abort the Color-Bias operator and undo all changes. Select 'Keep' to re-adjust the slider knobs to zero with the current settings. Press the 'Color', 'Bright', 'R'/'G'/'B' etc. buttons to re-adjust the associated value to zero. @endnode @node "Confirm_Exit" "Confirm Exit" @{b}Confirm exit@{ub} Activate this switch if you want to confirm exiting ArtPRO. @endnode @node "Indx" "Quick Reference" @{b}Quick Reference@{ub} @{u}Global Settings@{uu} @{u}System Settings@{uu} @{" Autosave Palette  " link "Auto_save_Colors" 0} @{" Adjust Palette " link "Screen_Palette" 0} @{" Confirm Exit      " link "Confirm_Exit" 0} @{" Font           " link "Font" 0} @{" Confirm Overwrite " link "Overwrite" 0} @{" Iconify        " link "Iconify" 0} @{" Display Picture   " link "Show_Pic_after_Load" 0} @{" Screen / Set   " link "ScreenMod" 0} @{" Draw Grid         " link "Draw_Grid" 0} @{" Tooltype Settings " link "Main_ToolTypes" 0} @{u}Loaders@{uu} @{u}Savers@{uu} @{" BMP             " link "Loader_BMP" 0} @{" BMP      " link "Saver_BMP" 0} @{" CHUNKY          " link "Loader_CHUNKY" 0} @{" CHUNKY   " link "Saver_Chunky" 0} @{" DATATYPE        " link "Loader_Datatype" 0} @{" GIF      " link "Saver_GIF" 0} @{" GIF             " link "Loader_GIF" 0} @{" GIFANIM  " link "Saver_GIFANIM" 0} @{" IFF ILBM        " link "Loader_IFF-ILBM" 0} @{" IFF ILBM " link "Saver_IFF ILBM" 0} @{" JPEG            " link "Loader_JPEG" 0} @{" JPEG     " link "Saver_JPEG" 0} @{" PALETTE         " link "Loader_Palette" 0} @{" PALETTE  " link "Saver_Palette" 0} @{" PCX             " link "Loader_PCX" 0} @{" PCX      " link "Saver_PCX" 0} @{" RAW             " link "Loader_RAW" 0} @{" RAW      " link "Saver_RAW" 0} @{" RAW INTERLEAVED " link "Loader_RAW_Inter" 0} @{" SPRITE   " link "Saver_Sprite" 0} @{" RGB CHUNKY      " link "Loader_RGBChunky" 0} @{" TIFF     " link "Saver_TIFF" 0} @{" SCREEN          " link "Loader_Screen" 0} @{" TIFF            " link "Loader_TIFF" 0} @{" UNIVERSAL       " link "Loader_Universal" 0} @{u}Operators@{uu} @{" Count Colors " link "Op_CountColors" 0} @{" List Render  " link "Op_ListRender" 0} @{" Pack Colors  " link "Pack Colors" 0} @{" Make Button  " link "Op_MakeButton" 0} @endnode @node "Font" "Font" @{b}Font@{ub} Select your favourite Font here. @endnode @node "Pack Colors" "Pack Colors" @{b}Pack Colors@{ub} This image operator will find and eliminate double and unused colors from an image's palette. A requester will pop up and inform you about how many double and unused entries have been found. If your image contains redundant palette entries, ArtPRO asks if you wish to compress the palette. The 'Pack Colors' feature won't work with HAM and EHB pictures. @endnode @node "Palette" "Palette Editor" @{b}Palette editor@{ub} Enter the Palette operator for modifications of an image's palette. ArtPRO will open a screen with the image and two control areas at the bottom. One of these contains the image's palette, the other several buttons. The image screen will autoscroll if the image is larger than the visible area. (The image has to be activated, i.e. clicked somewhere.) You can toggle the control area on and off by clicking the right mouse button. There are max. 28 palette entries visible at the same time. Move the slider to scroll inside the image's palette. The range (from - to) is displayed on the right side of the slider. To activate a palette entry for modification, just click on it so that it appears recessed. The selected entry will be once again displayed at the bottom of the control screen in a larger field. @{" RGB " link "Palette_ColorModel" 0} @{" Copy " link "Palette_Copy" 0} @{" Spread " link "Palette_Spread" 0} @{" Swap " link "Palette_Swap" 0} R ------------------- @{" Remap " link "Palette_Remap" 0} @{" Sort " link "Palette_Sort" 0} @{" Pick " link "Palette_Pick" 0} G ----- sliders ----- B ------------------- Okay Undo Reset @{u}Okay@{uu} To leave the palette editor with the new palette. @{u}Undo@{uu} To undo the last change @{u}Reset@{uu} To reset the palette completely @endnode @node "Palette_Pick" "Pick " @{b}Pick@{ub} Use this button to pick a color from the image. The pointer changes to a syringe. Press the left mouse button when the needle points to the color to pick. @endnode @node "Palette_Copy" "Copy " Copy Use 'copy' for duplicating a color entry. After pressing the button, select a destination color entry. @endnode @node "Palette_Swap" "Swap " Swap Use the swap button for swapping two color entries. After pressing the button, select a second entry. @endnode @node "Palette_Remap" " Remap" @{b}Remap@{ub} Use this button to adapt your image to the new palette. This implies a complete rerendering. @endnode @node "Palette_Spread" "Spread" @{b}Spread@{ub} Use the 'spread' button for creating a smooth color range. First, select the initial color. After pressing the button, select a destination color entry. @endnode @node "Palette_Sort" "Sort" @{b}Sort@{ub} After pressing the 'sort' button a selector pops up. Choose the sort direction, either from dark to light or light to dark. @endnode @node "Palette_ColorModel" "Color Model" @{b}RGB@{ub} Use the cycle button to choose either of these color systems: @{u}RGB@{uu} R - Red @{u}CMY@{uu} C - Cyan G - Green M - Mangenta B - Blue Y - Yellow @{u}HSV@{uu} H - Hue @{u}YUV@{uu} Y - Luminance S - Sateration U - Colorvalue V - Value V - Colorvalue @{u}YIQ@{uu} Y - Luminance I - Colorvalue Q - Colorvalue @endnode @node "ScreenMod" "Screen / Set" @{b}Screen / Set@{ub} Use the cycle gadget to select either of these screen modes: @{u}Workbench@{uu} For ArtPRO to open its windows on the Workbench. The 'Set' gadget is disabled in Workbench mode. @{u}PublicScreen@{uu} For ArtPRO to open its windows on a public screen that is currently open on the system. Select a screen with the 'Set' gadget. @{u}CustomScreen@{uu} For ArtPRO to open an own public screen for its windows. Select a screen mode with the 'Set' gadget. @endnode @node "System" "System Settings" @{b}System settings@{ub} These settings apply to ArtPRO's system interface. @{" Iconify        " link "Iconify_Mode" 0} @{" Font           " link "Font" 0} @{" Screen / Set   " link "ScreenMod" 0} @{" Adjust Palette " link "Screen_Palette" 0} @endnode @node "Image_Ctrl_Lock" "Lock" @{b}Lock@{ub} Use this checkmark to lock the selected screen mode. When you load another image, ArtPRO will try to keep the screen mode that you've adjusted before. This feature is reserved for registered users. Refer to @{"registration" link "Main_Registration" 0}. @endnode @node "Image_Ctrl_RenderControl" "Render Control" @{b}Render Control@{ub} Rendering means: an image gets converted to another screen mode, depth, color-system, or resolution. A consequence may also be that an image has to be reduced to less colors. ArtPRO offers blazingly fast and effective color reduction and rendering. @{"                 Mode                 " link "RCtrl_Mode" 0} @{"                Colors                " link "RCtrl_Mode" 0} @{"   " link "RCtrl_Custom" 0} Custom Palette @{"             Colors Used              " link "RCtrl_Custom" 0} @{"             First Color              " link "RCtrl_Custom" 0} @{"                Sort                  " link "RCtrl_Sort" 0} @{"               Dither                 " link "RCtrl_Dither" 0} @{"               Amount                 " link "RCtrl_Dither" 0} @{"   Use   " link "RCtrl_Use" 0} @{"   Render   " link "RCtrl_Render" 0} @{"   Cancel   " link "RCtrl_Cancel" 0} @endnode @node "RCtrl_Use" "Use" @{b}Use@{ub} Press this button to confirm your render-control settings and to leave this section. The image is not (yet) rendered. @endnode @node "RCtrl_Render" "Render" @{b}Render@{ub} The image will be rendered with the options and settings you made in the render-control section. After all, the rendered image will be (re)displayed. @endnode @node "RCtrl_Cancel" "Cancel" @{b}Cancel@{ub} Press this button to forget the changes you made to the render-control settings, and to leave this section. @endnode @node "RCtrl_Dither" "Dither Type" @{b}Dither Type@{ub} Here you can adjust the dither type and amount you want the image to be rendered with. Dithering helps to preserve the color information of an image. @{u}none@{uu} - The image will be rendered without dithering. @{u}Floyd-Steinberg@{uu} - The image will be rendered with the Floyd-Steinberg algorythm. A dither amount is not required. @{u}Dither amount@{uu} - This gadget is not available yet. @endnode @node "RCtrl_Mode" "Render Mode / Colors" @{b}Render Mode / Colors@{ub} Use the cycle gadget to choose the color model: @{u}Palette@{uu} - Normal color-table lookup mode @{u}HAM8@{uu} - Amiga-specific color mode: HAM8 (Hold-and-Modify) with (virtually) 18bit truecolor resolution. This mode requires a native AGA screen mode. @{u}HAM6@{uu} - Amiga-specific color mode: HAM6 (Hold-and-Modify) with (virtually) 12bit truecolor resolution. This mode requires a native OCS/ECS/AGA screen mode. @{u}EHB@{uu} - Amiga-specific color mode: 32 colors normal palette lookup, 32 colors with half the brightness of the first 32 colors. (Extra Half-Brite) This mode requires a native OCS/ECS/AGA screen mode. Use the slider to adjust the number of colors. It is only available with the 'Palette' color mode. @endnode @node "RCtrl_Custom" "Custom Palette" @{b}Custom Palette@{ub} Activate this checkmark in order to create a 'custom' palette with extended flexibility. @{u}Colors Used@{uu} This slider determines how many colors are actually used. Notes: In HAM6 and HAM8 mode, this number determines how many 'base colors' will be created. In EHB mode this value applies to the first 32 colors of the palette. Their half-bright equivalents will be used, too. @{u}First Color@{uu} This slider determines the first color index to appear in the rendered image. @endnode @node "RCtrl_Sort" "Sort Mode / Order" @{b}Sort Mode / Sort Order@{ub} A palette may be sorted by a specfic criteria and in a specific direction. - Sort Mode: @{u}None@{uu} - do not sort at all. @{u}Brightness@{uu} - sort palette entries by brightness. @{u}Saturation@{uu} - sort palette entries by color intensity. @{u}Popularity@{uu} - sort palette entries by the number of pixels that they represent. @{u}Representation@{uu} - sort palette entries by the number of histogram entries that they represent. @{u}Significance@{uu} - sort palette entries by their optical significance for the human eye. The last three modes do not only apply to the palette, but also to the image itself. Especially the 'Significance' mode might be of highest interest for programmers. If you ObtainBestPen() a palette in that order, you get excellent results, even with low OBP_Precision - you avoid wasting valuable palette entries for less significant colors! - Sort Order: Choose between 'high to low' and 'low to high'. In this context, high means 'more of the given effect'. @endnode @node "Module_Selection" "Loader / Saver Selection" @{b}Loader / Saver selection@{ub} This section consists of a window containing a list with either the available @{"loaders" link "Loaders" 0} or @{"savers" link "Savers" 0}. @{u}Accept and Operate@{uu} - leave this section with the selected loader / saver, and use it immediately. The same effect has a double-click on a loader / saver. @{u}Okay@{uu} - just leave this section. The selected loader / saver won't be used immediately. @{u}Cancel@{uu} - just leave this section. Forget the selected loader / saver. @{u}Load@{uu} - Load another list of loaders / savers. @{u}Save@{uu} - Save the current list of loaders / savers. If you want to customize the list, refer to the loaders / savers @{"configuration section" link "Module_Configuration" 0}. @endnode @node "Module_Configuration" "Loader / Saver Configuration" @{b}Loader / Saver configuration@{ub} @{u}Config@{uu} - enter a loader's or saver's configuration window. @{u}Clone@{uu} - create a duplicate of the selected loader / saver. @{u}Add@{uu} - add a new basic loader / saver type. @{u}Erase@{uu} - remove the selected entry from the list. @{u}Up@{uu} - move the selected entry up one line. @{u}Down@{uu} - move the selected entry down one line. Each loader / saver may have an individual name. It can be entered in the text gadget under the list. This name should somehow reflect the configuration of your loader / saver, e.g. 'Palette 8bit Asm', or 'RAW Intl. Mask', 'GIFANIM transp.' or maybe 'MainSprite', 'TextureMapping2', etc. If you're engaged in different projects (image processing, programming the OS, games, or demos), create seperate lists for your different tasks. You can tell ArtPRO which list to load at startup. Please refer to the @{"tooltypes section" link "Main_ToolTypes" 0}. @endnode @node "Main_Probs" "Known Problems" @{b}Known Problems@{ub} According to some bug-reports reqtools.library might be a troublemaker. Try another version if you encounter any problems, and please contact me immediately. One user reported problems with the drag & drop feature. Please contact me if this occurs with your configuration. The CybergraphX graphics card driver is not fully compatible to the native Amiga screenmodes. Overlapping screens cannot use different palettes simultaneously, and the Picasso96 driver system doesn't even support overlapping screens. ArtPRO wasn't originally intended to handle this. This problem has been widely solved, only the palette editor is still using overlapping screens. a new palette editor is under development. @endnode @node "OpScreenSettings" "Operator Screen Settings" @{b}Operator Screen Settings@{ub} In this section you can configure the appearance of operator screens. Currently, these settings affect screens for selecting a frame, and for the colorbias operator.¹ @{u}ScreenMode@{uu} select a screenmode here. graphics cards (including hi- and truecolor) are supported. @{u}ColorMode@{uu} - grey the image will be rendered to grayscales. this is significantly faster than colored. - color render the image to colors. note: the colorbias operator is always driven in color mode. @{u}Dither Image@{uu} render the image with Floyd-Steinberg dithering. @{u}Don't Scale Image@{uu} by default, the image is scaled to the screen's size. if you activate this checkmark, ArtPRO will open an oversized screen that fits the size of the image. ¹ the palette operator is not yet affected. a new palette operator for graphics card screens (without overlapping screens) is under development. @endnode @node "ShowPreview" "Show Preview" @{b}Show Preview@{ub} Activate this checkmark if you want to see the current picture as a small preview. The prevew will be displayed instead of ArtPRO's logo. @endnode @node "Op_CountColors" "Count Colors" @{b}Count Colors@{ub} This operator evaluates the real number of different colors in a picture. Many programs tell you nonsense about it. ArtPRO uses a dynamic 24bit histogram to determine the exact number. @endnode @node "Op_ListRender" "List Render" @{b}List Render@{ub} This operator processes a series of pictures. It allows to convert the file format, to reduce the number of colors, and to create a global palette for the series. Usage is simple. First select the frames to process, then specify a destination directory. If you select the same directory again, make sure you have configured the operator to use a suffix for the processed files, otherwise the original files will be overwritten. Configuration: @{u}Palette Type@{uu} Local - create an own palette for each picture processed. Global - create a global palette for all pictures. @{u}Histo Type@{uu} Here you can specify the histogram type for the operation. 15bit histograms suffice when a local palettes is generated. If you create a global palette for a huge series of pictures, it's highly advised to use a higher histogram resolution to obtain the best palette possible. the more bit, the better the quality. Notes: as the names suggest, the TURBO types are much faster than the normal histograms. quality will not suffer, but the turbo types are limited to 18bit. their memory consumption is predictable. a 18bit turbo histogram requires exactly 1MB of memory, the other types require less. the memory consumption of the other histogram types is not predictable, and it is possible that you are running out of memory with 18-24bit histograms. try the next lower resolution successively if you encounter problems. another note: a 24bit histogram may theoretically grow to 335MB. @{u}Add Suffix@{uu} Activate the checkmark and enter a suffix to be added to the picture's filenames. use this feature if you don't want your pictures to be overwritten accidentally. @{u}Frame Offset@{uu} Specify a number of frames to skip when creating the histogram for a global palette. This feature can be used to speed up palette creation when you have got a huge number of similar frames to render. @endnode @node "Op_MakeButton" "Make Button" @{b}Make Button@{ub} This operator creates a button-like appearance. It allows you to create graphical buttons for WWW pages, for instance. The operator is applied to the current picture, or to the currently selected frame. Configuration: @{u}Frame Width@{uu} with this slider you can specify the thickness of the button frame. @{u}Intensity@{uu} Top/Left/Right/Bottom These sliders define the brightnesses (or darknesses) for the upper, lower, left and right side of the button frame. Activate the checkmarks at the left for bright edges, and deactivate them for dark edges. @{u}Gradient@{uu} with this checkmark enabled, the edges will be created using a gradient. The preview is updated in realtime. Those who don't like too much theory simply play around with the sliders and checkmarks and see what happens :) @endnode @node "Loader_JPEG" "JPEG Loader" @{b}JPEG@{ub} Loads JPEG with the Tower JPEG Codec Class. Progressive JPEG is currently not supported by the Codec. @endnode @node "Saver_JPEG" "JPEG Saver" @{b}JPEG@{ub} This saver saves an image or brush as JPEG via the Tower JPEG Codec Class. Refer to the @{"JPEG saver configuration" link "saveprefs_JPEG" 0} section for the available options. @endnode @node "saveprefs_JPEG" "JPEG Saver Settings" @{b}JPEG Saver Configuration@{ub} @{u}Quality@{uu} or compression ratio. JPEG is a lossy compression algorithm. The higher, the better the output. @endnode @node "Op_FlipX" "FlipX" @{b}FlipX@{ub} This operator horizontally flips or mirrors the current image or the selected frame. This can be determined in the configuration window. @endnode @node "Op_FlipY" "FlipY" @{b}FlipY@{ub} This operator vertically flips or mirrors the current image or the selected frame. This can be determined in the configuration window. @endnode