rgbpaint

RGBPAINT(1)              Mark Tyler's painting program             RGBPAINT(1)



NAME
       rgbpaint - A simple pixel-based painting program.

SYNOPSIS
       rgbpaint [options] [image-file] [-stamps file ...]

DESCRIPTION
       rgbPaint is a very basic painting program created by forking mtPaint at
       version 3.09, and then simplifying the user interface. It relies on a
       small but modifiable palette for pixel-based image editing. Images can
       be saved in ICO, JPEG and PNG formats; files in other image formats can
       be loaded, but not saved in the original format.

OPTIONS
       The program accepts the following options:

       --help
           Print usage information.

       -d dir
           Use dir as the default directory for loading and saving image
           files.

       -s
           Grab a screen shot during launch.

       -stamps
           Any file names remaining on the command line will be loaded as
           stamps.

       -svg dir
           Load program icons in SVG format from the directory dir.

       -thumb size
           Set size in pixels that stamp thumbnails should be scaled to (up or
           down depending on original size). The default is 40 pixels on a
           side; permitted values are in the range 32–256.

       -u limit
           Set the maximum size of the undo buffer to limit MB. The default is
           32 MB; permitted values are in the range 1–500.

       --version
           Print version information.

APPEARANCE
       When launched, rgbpaint will use most of its available window area to
       present a view of a large Canvas. At the top there will be a Tasks
       panel, and a Brushes/Colours panel will be at the left edge. It is also
       possible for a rather narrow Stamps panel containing iconised images to
       be inset at the bottom edge.

THE TASKS PANEL
       This panel is used for selecting actions, each of which is also
       accessible via a keyboard shortcut. The available actions can be
       classified into the following groups:

       ·   New image, Load image file, Save image file, Save image file as

       ·   Paint, Flood fill, Make selection

       ·   Cut, Copy, Paste, Paste text

       ·   Undo, Redo, Transform colour, Pan window, Scaling

       The first group deals with creating new blank images and reading from
       or writing to image files. Each action conducts its own safety check in
       order not to lose unsaved data. It is worth remembering that a fresh
       canvas is white, and that it is surrounded by greyish borders if the
       canvas is smaller than the available window area. A simple dialogue is
       also launched for selecting the size of any new, blank image.

       The second group picks the main mode that rgbpaint should enter. When
       it is in Paint mode, the cursor will become a pencil symbol, while Fill
       mode displays as a bucket being emptied.  Selection mode is more
       complicated, using more than one icon - see the section ``MAKING AND
       USING SELECTIONS''.

       The third group covers actions that operate on a selected portion of
       the canvas: Cutting out a shape from the canvas, making a Copy in
       memory of the content within the marked area, Pasting the copy back
       from memory onto the canvas, or opening a dialogue window for Text,
       which will deploy a new selection area just large enough to hold the
       snippet of text specified using the dialogue window.

       The final group lists miscellaneous actions: Undo an editing step, Redo
       an undone step, Transform the overall colour settings, Pan the window
       across the canvas (a miniature window is shown with a pane whose
       movements are controlled by the arrow keys), or finally, set the
       Scaling of the canvas.

       Some of the icons have the property of becoming dimmed if the action is
       not accessible at a particular moment, indicating that rgbpaint is in
       an inapproriate mode, that no editing steps can be undone/redone, or
       that no in-memory content exists.

MAKING AND USING SELECTIONS
       The Selection main mode is intended for grabbing and manipulating
       portions of the full canvas. It can itself be thought of as being
       divided into three further states:

       Resting
           is indicated by a cross-hairs icon and happens when no corner
           marker has been set.

       Marking
           shows one out of four corner icons. They all indicate how the next
           point selected will be used to lay down a rectangle together with
           the previously set corner. To get a feeling for this, it is best to
           experiment a little by moving the pointer around.

           A corner is set by left clicking, and two set corners show up as a
           rectangle outlined by dashed lines. A right click will cancel all
           corners, and will return to the resting state.

       Moving
           means that the pointer is hovering above a selected area, and that
           this area may be moved around. The icon consists of two crossed
           double-ended arrows, but can look similar to a diamond shape with
           four small, internal squares.

           The selected area can be moved around using the keyboard shortcuts
           (see the section ``KEYBOARD SHORTCUTS''), or by holding the left
           mouse button down and moving the pointer around.

THE BRUSHES/COLOURS PANEL
       Here the user chooses a brush and colour for painting, or colour only
       for flood filling. The upper part of the panel holds the ten different
       brushes, six solid and four thin ones. The solid brushes can give a
       square or a round outline in any of three thicknesses. Out of the four
       available thin brushes, the smallest is so thin as to paint one pixel
       at a time, making possible very accurate brush work. The other three
       are of larger sizes, but they all colour pixels in a random fashion
       within their outline, so they act somewhat like staining a surface.

       In the lower part of the panel there are twenty buttons displaying a
       palette of available colours. Clicking on any of these chooses the
       corresponding colour for painting, until it is replaced.

       An elongated button, between the upper and the lower areas, will always
       display the active colour, and has a further useful function. Clicking
       the left mouse button on it will summon a colour editor. This allows
       the user to blend a new colour, which will, once accepted, replace the
       colour that was previously active.

THE STAMPS PANEL
       This extra panel, at the bottom of the program window, comes to life
       only if rgbpaint was launched using the command line switch -stamps,
       followed by the names of existing image files. The displayed size of
       any thumbnail image is determined by the switch -thumb, or set to 40
       pixels in both width and height.

       If the user left-clicks on a thumbnail image, a copy of the image will
       appear in the middle of the canvas, with the size of the original
       image, not that of the thumbnail. The copy is in fact only a marked
       area (see the section ``MAKING AND USING SELECTIONS''), and can be
       moved around at will with the left mouse button, until a final right
       click will deposit a copy on the canvas. The marked area is still
       sitting on top, so it may again be moved around to make additional
       imprints.

COPYING, CUTTING, AND PASTING
       rgbPaint handles cut-and-paste a little differently from most similar
       applications. To make it easier to avoid mistakes, here is a
       description of how to manipulate chunks of the canvas.

       When a rectangular portion of the canvas has been selected, it is
       possible to perform the action Copy. It will take the content of the
       marked area and save it in-memory for later access.

       When doing a Cut, the marked area is emptied of its content, so it will
       appear as a black rectangle, but the removed portion will be remembered
       as in-memory content which remains available for pasting back. Observe
       that copying and cutting can only be performed in Selection mode, since
       a selected area must exist for either action to be sensible.

       On the other hand, the act of Pasting is possible in Paint mode as well
       as in Fill mode. When the pasting action is triggered (by icon or by
       key stroke) the in-memory content is dropped onto the window and it
       will lie centred on the canvas. It will not yet be painted on the
       canvas, as it is only casting a shadow to display its contents, but it
       is ready to move into position before being imprinted on the canvas.
       The movement itself was described in the section ``MAKING AND USING
       SELECTIONS''

KEYBOARD SHORTCUTS
       Some handy keyboard shortcuts are available. The keys 1–9 change image
       scaling in pre-determined steps. The keys + and - give a fine-grained
       scaling up or down.

       Any Arrow key moves the mouse pointer in small steps across the canvas;
       steps which can be made larger by pressing Shift-Arrow. When instead
       using Ctrl-Arrow, the whole canvas will shift in the implied direction.

       Actions

       1–9
           Change scaling to fixed levels.

       +, -
           Scale up, scale down.

       Ins
           Summon the Transform colour dialogue.

       End
           Summon the Pan Window dialogue.

       f
           Select Flood fill mode.

       p
           Select Paint mode.

       q
           Quit the program.

       s
           Activate Make Selection mode.

       t
           Summon the Text paste dialogue.

       Ctrl-C
           Make an in-memory Copy of the marked area.

       Ctrl-N
           Prepare a New image, including a sizing dialogue.

       Ctrl-O
           Open a file dialogue for fetching an image.

       Ctrl-P
           Paste the in-memory copy onto a marked area of the canvas.

       Ctrl-S
           Save the image in a file, using the old name.

       Ctrl-Shift-S
           Save the image in a file, choosing a new name.

       Ctrl-X
           Cut the selected portion out of the canvas (keeping an in-memory
           copy).

       Ctrl-Y
           Redo the most recently undone action.

       Ctrl-Z
           Undo the most recently completed action.

       Movement

       Arrow
           Move pointer slightly.

       Shift-Arrow
           Move pointer in larger steps.

       Ctrl-Arrow
           Move canvas rather than pointer.

       Home
           Go to the top of the canvas.

       Ctrl-Home
           Go to the far left of the canvas.

       PgUp, PgDn
           Move the canvas up or down, one page at a time.

       Ctrl-PgUp, Ctrl-PgDn
           Move the canvas left or right, one page at a time.

CUSTOMISED TASK ICONS
       There is a built-in facility for customising the appearance of the task
       icons as they appear in the Tasks panel. This is mostly an issue for
       the administrators of kiosk systems or similar, not for the casual
       user. It can also make sense to use this in the command string
       registered for rgbpaint within the Debian menu subsystem, on machines
       where menu access is the only way users are expected to launch the
       program. See next section for the details.

FILES
       At launch time, rgbpaint will record the current working directory as
       the default location for fetching and storing image files. This is the
       directory suggested every time a file dialogue is brought into action.
       Using the command line option -d, it is possible to set another
       location. A reasonable choice is "-d ~" for accessing the home
       directory of the user.

       The command line switch -svg allows a directory to be specified where
       rgbpaint should look for particular vector image files in SVG format.
       Their names must all be of the form "stock-XXX.svg", where the XXX is
       one of the following key words: new, open, save, saveas, cut, copy,
       paste, undo, redo, text, paint, fill, select, sun, or zoom. Each will
       provide an icon for the corresponding function in the top panel. A
       missing icon will be replaced by a default choice, but there is no
       guarantee that the fallback icon will be unique, or be relevant for the
       intended purpose.

HOMEPAGE
       http://mtpaint.sourceforge.net/rgbpaint.html

SEE ALSO
       mtpaint(1), rgbPaint's more featureful relative.

PROGRAM AUTHORS
       Mark Tyler, Dmitry Groshev

MANUAL AUTHORS
       The original manual page stub was taken as starting point for a
       complete rewrite as Docbook source, and was substantially extended by
       Mats Erik Andersson and Justin B Rye. The new format was chosen in
       order to simplify translations, and was originally intended for use by
       the Debian project, but the text may be used by others. Permission is
       granted to copy, distribute and/or modify this document under the same
       terms as rgbPaint itself.

COPYRIGHT
       Copyright © 2010 Mats Erik Andersson



rgbPaint 0.8.7                December 17th, 2010                  RGBPAINT(1)