Short: Pro-style layered image editor RTG/AGA Author: Darko Djordjevic Uploader: darko djordjevic hotmail com (Darko Djordjevic) Type: gfx/edit Version: 0.7.3 Requires: AmigaOS 3.1+, 68020+, lots of Fast RAM; RTG (Picasso96/CGX) recommended Architecture: m68k-amigaos >= 3.1.0 a-graph - a professional image editor for the Amiga =================================================== a-graph is a raster image editor for AmigaOS 3.x, written from scratch in C. Its menus, panels, tools, dialogs, shortcuts and workflow follow today's industry-standard image editors as closely as the hardware allows - if you have used a modern professional image editor, you already know a-graph. It is still a real Amiga program: it respects the system, works with Workbench, and treats the Amiga's own formats as first-class citizens. ONE BINARY, TWO KINDS OF MACHINE -------------------------------- At startup a-graph picks its display path by itself: - RTG (Picasso96 / CyberGraphX, cybergraphics.library v41+): its own 24-bit truecolor screen. This is the main target. - AGA: without RTG it falls back to a 256-colour (8-bitplane) screen, so it also runs on a classic A1200/A4000 without a graphics card. - Workbench window: on a truecolor RTG Workbench it can also run in a window there (View > Screen Mode > Workbench Window). Two builds are included: a-graph 68020 or better, no FPU needed a-graph.060 optimised for the 68060 (with FPU) AMIGA FORMATS ------------- IFF ILBM - Loads 1-8 bitplane palette images, 24-bit ILBM, HAM6, HAM8 and EHB (the view mode from the CAMG chunk); the ACBM variant too. - PCHG palette changes per line (small and big changes, the Huffman compressed form too), so multi-palette pictures show as they do on the Amiga; SHAM/CTBL sliced HAM as well. - View > HAM8 Preview / HAM6 Preview: the picture on a native HAM screen of its own (HAM8 needs AGA), as the chipset will show it. - Saves IFF 24-bit, HAM8, HAM6, EHB, 256 colours and 16 colours, ByteRun1 (PackBits) compressed. IFF ANIM (DeluxePaint-compatible) - Saves FORM ANIM: a full ILBM first frame, then op-5 "byte vertical delta" frames (ANHD + DLTA), all frames on one median-cut 256-colour palette. - Loads ANIMs into the Timeline, or frame by frame into layers. - Modern Timeline: frame strip with thumbnails, per-frame delays, looping, Tween, Onion Skin, and layer animation (visibility, position, opacity per frame). Workbench icons (.info) - Reads PNG icons, OS3.5 colour icons (FORM ICON/IMAG), NewIcons and classic planar icons; normal and selected images open as two layers. - Saves a classic DiskObject plus an OS3.5 colour image (up to 256 colours, transparency). An edited icon keeps its Default Tool, tool types, stack, position and the rest. - Image Previews: every saved file can get an icon with a thumbnail. Clipboard (clipboard.device) - Copy/Cut publish IFF ILBM; Paste takes an ILBM from any program. Text travels as IFF FTXT. PART OF THE SYSTEM ------------------ - ARexx port. - AppWindow: drop file icons from Workbench into the window. - Amiga bitmap fonts for type layers, with previews in the font list. - Tablet pen pressure (size, opacity, flow) through the system's tablet events. - Droplets: a saved batch process as an icon to drop images on. - Settings, brushes, patterns, actions and the dictionary live in PROGDIR:. BRIDGES TO THE REST OF THE WORLD -------------------------------- - PSD: layers, masks, groups with blend modes, layer styles, editable type, adjustment layers, 8 and 16 bit. PSB (Large Document) is read too. - PNG (up to 16-bit, interlaced), JPEG, TIFF (LZW/ZIP, paths), GIF (animated too), WebP, BMP, TGA, PCX, PBM/PGM/PPM, Radiance HDR, OpenEXR, PDF and EPS. - Imports brushes (.abr), gradients (.grd), styles (.asl), custom shapes (.csh) and patterns (.pat); exports patterns (.pat). WHAT'S INSIDE, IN SHORT ----------------------- - Layers: groups with real blend modes, clipping masks, Smart Objects, Smart Filters with Blending Options. - Layer styles: Drop Shadow, Bevel & Emboss, Glows, Satin, Gradient and Pattern Overlay, Stroke. - Levels, Curves, Hue/Saturation, a Camera Raw-style window, Filter Gallery, Blur Gallery, Liquify and many more filters and adjustments. - Select and Mask, Color Range, Quick Mask, single-channel editing. - Brushes with dynamics, on-canvas HUD for brush size and colour, Vanishing Point with several planes, live gradients. - Actions (with Record Again), batch processing, Save for Web, Indexed Color (Perceptual / Selective palettes), Bitmap mode. NEW IN 0.7.3 ------------ - Right-click on the pasteboard: its colour (Custom... too); Paint Bucket Shift+click on it: the Foreground. - Guides / Grid / Smart Guides / Slices colours: Custom... (Color Picker). - Layer > New > Frame from Layers. - Layer > Vector Mask > Reveal All / Hide All: live vector masks. - File > Export > Render Video...: the frames as an image sequence. - Eraser: Angle on its bar; brush picker menu: Reset All Locked Settings. - Type > Hyphenation...: Hyphenation Zone. - Hold Alt in a dialog and Cancel becomes Reset: every filter / option dialog, Image Size, Canvas Size, Levels, Curves, Color Range, Layer Style, Gradient Editor. Color Range: hold Ctrl to see the other preview (Selection / Image). - Keys: F2 / F3 / F4 Cut / Copy / Paste, Shift+Ctrl+M Record Measurements, Alt+Shift+Ctrl+O Open As. - Tween With: First Frame / Last Frame (closes an animation's loop). - Measurement Log: Shift / Ctrl+click picks several rows; Delete and Export work on the picked ones. - Image Size > Fit To > Auto Resolution (Screen lpi, Draft / Good / Best). Image Size / Canvas Size: Up / Down in a number field (Shift: by 10). - Levels / Curves: hold Alt while dragging the black / white point to see what clips. - Count and Note markers can be dragged to a new place. - Ruler > Straighten Layer crops away the empty corners (Alt+click: no crop). - Crop: W x H x Resolution has a Resolution field. - Timeline: a frame's delay and Looping open a menu right there. - Image Size, Canvas Size, Crop (menu, Crop tool, Perspective Crop), Trim, Reveal All, Image Rotation / Flip and Fit Image can be undone: one step in History instead of History starting over (an animation still starts it over). - Brush Settings: a stroke preview strip under the settings. - Delete / Backspace on the Background or a layer with locked transparency fill with the Background colour; Del on the Background opens Fill. - Paragraph text: its box shows while you type, with eight handles to size it (the text wraps again). - Painting past the edge of the view scrolls it. - Clone Stamp, Pattern Stamp, History Brush: the airbrush button (held still, it keeps painting). - Layers: right-click a thumbnail for the thumbnail sizes and Clip to Layer / Document Bounds. - Dialog number fields take sums: 100*2, 50+25, +10 (from the value). - Preferences > Interface > Use Legacy Channel Shortcuts (Ctrl+1/2/3 R/G/B, Ctrl+~ composite, Ctrl+Alt+0 100 %). - Preferences > Tools > Animated Zoom: hold the Zoom tool still and it keeps zooming (off by default - slow on a 68020). - Image Processor: Use Open Images (as they are now, unsaved changes too) - the results go to a folder you pick. - Selection changes are History steps: Ctrl+Z brings the selection before back (Select All, Deselect, a marquee, the Magic Wand ...). - Typing text: Ctrl+C / X / V copy, cut and paste the letters picked, Ctrl+Z / Shift+Ctrl+Z undo and redo the typing. - Free Transform works on several layers at once (picked in the Layers panel or linked). - The Type tool clicked on a path's line types along the path, starting where you clicked. - Shift keeps the Pen and the Ruler at 0, 45 and 90 degrees. - Open lists answer the keys: Up / Down, Enter, the first letter. - Dragged off the picture, the Eyedropper takes the colour under the pointer anywhere on the screen (RTG screens). - A sampled brush tip shows its own outline as the cursor. - Image Size: the preview shows the result at 100 %; drag it, - / + zoom. - Your brush presets and sampled tips can be dragged to a new place in the Brush Preset picker. - Too many documents for the tab strip: a >> button lists them all. - Open PDF: the largest picture in it (JPEG or Flate images, with their alpha). Pages themselves are not drawn. - Clouds, Difference Clouds and Fibers use the Foreground and Background colours; Clouds' Stronger Contrast (on when chosen with Alt). - Histogram: drag across the graph for a range's Level, Count and Percentile. - Actions: a step's values show after its name; double-click a step to record it again. The Default Actions set has ready-made Actions (Vignette, Sepia Toning, Gradient Map, Make Clip Path, Water Reflection, ...); Reset Actions brings them back. - Channels: Load Channel as Selection takes the channel picked (Shift adds, Alt subtracts, both intersect); Delete Channel deletes the one picked and can be undone; a Quick Mask / layer mask row (its eye: the mask as a film, a click: the mask alone); Ctrl+6..9 shown. - Paths: a live Shape layer's Shape Path row (Ctrl+click: its outline as the selection); the Clipping Path's name in bold; EPS keeps the Clipping Path. - Lens Blur: Depth Map from a saved channel (Alpha 1..4); click the preview to set the Blur Focal Distance there. - Color panel: the out-of-gamut and not-web-safe warnings (click: the colour corrected). - Image > Trap: Width in Pixels, Points or Millimeters. - Edit > Purge > Undo. - Lasso: let go with Alt held for straight segments (Alt let go: closed). Polygonal and Magnetic Lasso close on a double-click or Enter; Backspace takes back the Magnetic Lasso's last stretch; [ ] change the Magnetic Lasso's Width. - Clone Stamp / Healing Brush: Alt+click sets the source (Ctrl+click too). - Painting tools: Alt held and dragged keeps sampling colours. - Liquify: Alt for the opposite (Twirl the other way, Pucker / Bloat, push right). - Move with Auto-Select: Shift+click adds the layer under the pointer. - Marquee begun with Shift (Add): Shift pressed again makes a square. - Shape tools on a Shape layer: Shift / Alt / Shift+Alt as the drag starts Combine / Subtract / Intersect. - Red Eye: drag a box round the eye. - Direct Selection: Shift+click and a dragged box pick several anchors; they move, nudge and delete together. - Convert Point: drag from an anchor to pull out its handles. - Zoom / Hand with Shift: all the windows (Window > Arrange). - File > Open Recent lists as many files as the preference says (up to 20). - Layer Comps: Apply to Selected Layers; a comp naming deleted layers shows a warning (Clear Layer Comp Warning / Clear All). - Place Embedded / Linked: several files at once. - The right button on the Channels, Paths, Swatches, Gradients, Patterns, History, Styles, Layer Comps and Actions panels opens their menu; on a layer's fx badge, the Layer Style menu (Disable / Enable Layer Style ...). - Layers: the fifth lock - Prevent auto-nesting in / out of Artboards. - Character Styles keep the scales and the baseline shift; Paragraph Styles the whole paragraph (indents, spacing, justification, hyphenation). - Apply Image: Transparency as a source channel, Invert Mask, Preserve Transparency, Scale and Offset for Add / Subtract. - Calculations: every blending mode, Scale / Offset, Invert Mask. - Variations: Show Clipping. - Image > Mode > Bitmap: an Output resolution. - BMP: 1-bit and 4-bit too. - Indexed Color: Master (one palette for all open images) and Custom... (a Color Table .act file) palettes. - Edit > Fade also after a painting stroke and after Fill / Stroke. - GIF Options: Palette (Local (Adaptive), Exact, Web), Colors, Dither, Transparency; an Indexed image keeps its own colours. - Fade shows its Mode and Opacity on the image as they change. - Blur Gallery (Field / Iris / Tilt-Shift): blur up to 250 px. Motion Blur up to 2000 px; Lens Flare Brightness 10..300 %. - Pointillize fills the gaps with the Background colour. - Oil Paint: Scale (the strokes' size). - Content-Aware Scale: a Reference Point. - Puppet Warp: Alt+click removes a pin; Remove All Pins. - Number fields take units: 2 in, 2.5cm, 30mm, 12pt, 1pc, 50% (of the value there) - pixels by the document's resolution. - Guide changes are History steps (Undo brings the guides back). - The status bar's Document Profile names the profile, mode and depth. - Info shows W / H while a marquee, crop box or shape is dragged. - The guide pointer over a guide; Shift+Ctrl+' Snap To Grid; a double-click on a ruler opens Units & Rulers. - Edit > Show All Menu Items. - Edit > Preferences: Plug-ins... and Scratch Disks... entries. - Navigator: its zoom slider can be dragged; the red view box keeps the point it was grabbed by. - New Guide Layout: Margin Top, Left & Right, Bottom each its own (-1: as the Top). - The grid and New Guide's Position count from the rulers' zero point. - Info Panel Options: Layer Count, Timing and Smart Objects too. - View > Snap To works for Crop, Perspective Crop, Slice, Polygon, Triangle, Custom Shape, Artboard, the row / column marquees, the Ruler and the Pen tools too. - Menus grey what cannot run now (Fade, Transform Again, Last Filter, Reselect, Paste Into, the mask commands, Background items) and name toggles as they act: Release Clipping Mask, Show Layers, Unlink Layers, Enable / Link mask, Show All Effects. - History names the Layers panel's steps: Opacity Change, Hide Layer, Blending Change, Layer Order, Release Clipping Mask... - F1 / Help opens the manual; Ctrl+J with no selection copies the layer at once; Del with no selection deletes the layer (asked); Esc keeps the selection (Ctrl+D deselects). - A filter or adjustment on a Type, Fill or Shape layer asks to rasterize it first. - The Layer menu has one Merge entry: Merge Layers (several picked), Merge Down, Merge Group or Merge Clipping Mask. - Surface Blur: Radius up to 100 px. - Lens Correction: Straighten - click two points on the preview along what should be level (or upright) and the Angle is set. NEW IN 0.7.2 ------------ - Clone Stamp / Healing Brush: Alt+Shift+< > turns the clone source, Alt+Shift+[ ] scales it. - Type: Ctrl+Left / Right by words, Shift+Alt+Up / Down Baseline Shift, Ctrl+Shift+X Horizontal Scale 100% (+Alt: Vertical), Ctrl+Alt+Q Tracking 0. - Path tools: Direct Selection keeps the anchor clicked selected - the arrows move it, Delete removes it; Path Selection: the arrows move the path, Delete deletes it. - The airbrush on: the digits set the Flow, Shift+digits the Opacity. - Alt+click deletes your own swatches and gradients (as the reference). - Color panel sliders: Foreground / Background chips - the sliders set the one picked. - Layers: Alt+drag a layer copies it to where it is dropped. - Move tool: a layer dragged onto another document's tab is copied there. - Layers: Alt+click a group's triangle opens / closes the groups inside it too; Alt+click an fx badge: every layer's effects. - Layers: several picked layers dragged together. - Merge Clipping Mask (Ctrl+E on a clipping group's base). - Layer names: Tab / Shift+Tab goes on to the next / previous layer's name; accented letters can be typed. - Rulers: the pointer's place marked on both. - Right-click on the pasteboard: its colour. - Select > Modify > Smooth: Sample Radius up to 500 px, Apply effect at canvas bounds; soft edges kept. - Paths panel: rows dragged - reordered, onto New (a copy), onto the bin. - History: a state dragged onto New Document, the snapshot button or the bin. - Move tool: the layer's edges and middle snap (not the pointer). - Curves: Alt+2..5 channel, Ctrl+Tab points, arrows move a point, Ctrl+D; Levels: Alt+2..5 channel. - Right-click menus for the Slice tools and the Note tool. - Swatches: your own reordered by dragging. - Smart Guides: the gap to the nearest layers shown in px while moving. - Shadows/Highlights: Radius up to 2500 px, clips up to 50 %. - Batch: Source Opened Files. - Gradient Map: your own gradients in its list. - Gradient Editor: Import... / Export... buttons. - New Style: Include Layer Effects / Include Layer Blending Options. - Replace Color: the preview switches between Selection and Image. - Layer Style dialog: Styles picks a style into the dialog. - Contact Sheet II: the captions' Font Size. - Last Filter / Fade show the filter's name; / locks transparent pixels; Shift+F: the screen modes backwards. - Info: Proof Color readout; "!" on CMYK out of gamut. - Layers: right-click on an eye - hide / show this, the others, all. - Info: W% / H% / angle in Free Transform, DX / DY while moving. - Brush presets: , . < > step through them. - View > HAM8 / HAM6 Preview opens the picture (saved as HAM in T:) in an external viewer: SYS:Utilities/MultiView by default (it must be installed), another one set in Preferences > File Handling. - Fixed: saving IFF (HAM8 especially) could crash (packing buffer). - Menus: selection commands grey with no selection, Merge Down on the bottom layer. NEW IN 0.7.1 ------------ - ARexx: DO "" [values] and PLAY "" on the A-GRAPH port; Actions panel menu > Save Action as ARexx... writes an Action as a script. - Preferences > Interface: Native Intuition Menus (right mouse button over the menu bar) and Tools with Names (the tool names beside the icons). - Brush and Tool presets keep the whole Brush Settings (Tool presets: the colour too with Include Color); Brush Settings sections can be locked. - Properties: Preset lists, Auto and Black / Gray / White eyedroppers for Levels and Curves adjustment layers; Document Properties lines clickable. - Layer Style: drag in the image to move a shadow, Satin or a Pattern Overlay; Pattern Overlay Link with Layer and Snap to Origin. - The busy pointer while a command works, and a progress bar in the status bar for long filters - Esc stops one (the picture as before). - Batch / Droplet: Suppress File Open Options Dialogs and Suppress Color Profile Warnings. - Swatches: groups of your own (New / Rename / Delete Swatch Group). - Actions: Insert Path (a Set Work Path step that brings the path back). - Live vector masks: Vector Mask > Current Path keeps the path with the layer - its row in the Paths panel edits it, the mask follows; kept in projects, moved with the layer. - Paragraph: Hyphenate (long words broken with a hyphen at the box edge). - Free Transform carries a layer's linked mask (and its vector mask) along; PSD files keep vector masks (vmsk) both ways. - Edit > Transform Rotate / Flip turns a layer's linked mask too; Image Size, Canvas Size, Crop, Trim, Reveal All and Image Rotation (also Arbitrary) move the paths and vector masks with the image. - Paths also follow History snapshots and Perspective Crop. - Healing Brush, Spot Healing Brush, Color Replacement and Background Eraser: Pen Size (a tablet's pressure for the size). - Preferences > File Handling: Save As to Original Folder. - Histogram: Source Adjustment Composite. - Pattern Fill layers: drag the pattern in the image while its dialog is open; Link with Layer and Snap to Origin. - Free Transform: Use Relative Positioning (the triangle between X and Y). - Color Balance adjustment layers keep Shadows, Midtones and Highlights at once (the Tone picks the sliders shown); PSD files keep all three. - Adjustment layers: Save Preset / Load Preset in Properties' Preset list for Levels (.alv), Hue/Saturation (.ahu), Exposure (.ahe) and Selective Color (.asv) - the reference's own preset files. - JPEG Options: File Size (the file's size at the settings shown). - Color Picker: Color Libraries - a color book (.acb) read, its colours by name; typed letters or numbers find one. - A manual: a-graph.guide (AmigaGuide) - Help > a-graph Help opens it. It has an ARexx chapter (every command, return codes, an example) and a chapter on what works only with RTG and what only with AGA. - The start page (no picture yet) runs Screen Mode, Workbench Window, a-graph Help, About Plug-ins and System Info too. - Select and Mask: Preset (Default, your own presets, Save / Delete). - Type > Hyphenation...: Words Longer Than, After First, Before Last, Hyphen Limit, Hyphenate Capitalized Words (kept with each Type layer). - Character: Kerning Optical (each pair of letters spaced by their shapes). - Channel Mixer layers kept live in PSD files; its presets (.cha) too. - Actions panel: a step picked, dragged to move it, deleted or duplicated; Play from it (Ctrl+Play: that step only); new steps go after it. The steps scroll; Action Options has a Color (Button Mode shows it); Insert Stop has Allow Continue (off: the Action halts, Play goes on). - Blur Gallery > Tilt-Shift: Distortion and Symmetric Distortion. - Blur Gallery (Iris, Tilt-Shift): Save Mask to Channels. - Path Blur: Start / End Point Speed, Taper, Strobe Strength and Flashes. - Spin Blur: Strobe Strength and Strobe Flashes. - Character > Selected Characters: Ordinals and Fractions. - Blur Gallery (Field, Iris, Tilt-Shift): Noise Amount (grain back in the blurred parts). - Keys and mouse as the reference: Alt subtracts / Shift+Alt intersects a selection; Shift while painting keeps the stroke straight; Eyedropper Alt+click = Background, Shift+click = colour sampler; samplers dragged. - File requesters open where the last one was left (kept between starts). - Help > Check for Updates... (needs a running TCP/IP stack: Roadshow, AmiTCP, Miami): a newer version on Aminet is reported, with its page; Preferences > General > Check for Updates at Start (off by default). - Move tool: Alt+arrow copies the layer and nudges the copy. History: Alt+click a state duplicates it; Alt+click the snapshot button asks. - Auto-Align Layers and Photomerge: Vignette Removal. - Color Lookup reads ICC abstract and device link profiles too. - Help: closing the guide brings a-graph's screen back to the front. - Full Screen Mode: Esc returns to Standard Screen Mode. NEW IN 0.7 ---------- - Workbench window mode (a real, resizable window on an RTG Workbench). - Many more mouse and key modifiers as in the reference: Ctrl = Move for one drag, Ctrl/Alt+Space = Zoom, Alt = a tool's opposite, arrow keys on Free Transform / crop box / selection outline, Ctrl+Z inside Free Transform, double-click to commit a transform, and more. - Channels: an eye per channel, Shift+click to target several, drag to reorder; Paths: thumbnails and all seven buttons; History: Delete. - Group / Layer from Background dialogs, Global Light Altitude, Blending Options' General Blending, Black & White and Gradient Map adjustment layer settings, Adjustment Presets, EPS and PDF (ZIP) options, PNG 8-bit in Export As, a canvas Border preference. FIXED FROM USER REPORTS ----------------------- - The drop-down menus open and follow the pointer much faster on a 68030 and on MorphOS. - The Hand (Space held) can no longer stay stuck on. - A layer lock can always be removed: click the lock badge on the layer's row, or use Lock Layer (context menu, Ctrl+/) again. - Free Transform works on big layers (the limit is free memory), on the Background (it becomes a layer) and fits the box to the layer's content; the Move tool's transform handles start it. INSTALLATION ------------ Unpack the archive anywhere and double-click a-graph (or a-graph.060 on a 68060). The program keeps its settings and presets in its own drawer (PROGDIR:), so give it a drawer you can write to. Optional: put a word list (one word a line) in PROGDIR:a-graph.dic for the spelling checker. TESTING ------- a-graph is under active development and is constantly checked by automated tests, on a PC under WinUAE and on real Amiga hardware. Please report bugs and ideas to the e-mail address above.