MrImage Documentation

Support This Project Please note that this documentation is under continual development.

Contents

Installation

There is not an installer currently available for MrImage. Nor is one needed. Simply download the latest binary release from sourceforge and unzip it to a folder of your choice. If you'd like the sourcecode, you can download it there too. toc

Supported File Formats

MrImage supports the following file formats:

toc

Draw Tools

Pointer Pointer

Used to manipulate selections. toc

Rectangular Selection Rectangular Selection

Creates rectangular selections. toc

Elliptical Selection Elliptical Selection

Creates elliptical selections. toc

Freeform Selection Freeform Selection

Creates free-form selections. toc

pencil Pencil

Draws with the currently selected color. If the left mouse button is depressed, it uses the foreground color. If the right mouse button is depressed, it uses the background color. toc

eraser Eraser

Same as pencil, but it's sorta reversed. This "erases" previous drawing if you have the background set to a background color. Same as pencil but it does the opposite. If the left mouse button is depressed, it uses the background color. If the right mouse button is depressed, it uses the foreground color. toc

brush Brush

Draws with the currently selected brush style. If you click the dropdown arrow next to the brush toolbar button, you can select/change the current brush style. If the left mouse button is depressed, it uses the foreground color. If the right mouse button is depressed, it uses the background color. toc

floodfill Flood Fill

Fills an area of one color with another. The point clicked-on specifies the color to be replaced. If the left mouse button is depressed, the fill color is the foreground color. If the right mouse button is depressed, the fill color is the background color. toc

dropper Dropper (Color Selector)

Selects a color. The point clicked-on specifies the color to select. If the left mouse button is depressed, the selected color becomes the foreground color. If the right mouse button is depressed, the selected color becomes the background color. toc

line Line

Draws a line. If the left mouse button is depressed, it uses the foreground color. If the right mouse button is depressed, it uses the background color. toc

ellipse Ellipse

Draws an ellipse. If the left mouse button is depressed, it uses the foreground color. If the right mouse button is depressed, it uses the background color. toc

Filled Ellipse Filled Ellipse

Draws an ellipse and fills it with either the foreground or background color. If the left mouse button is depressed, it uses the foreground color for the border and the background color for the fill. If the right mouse button is depressed, it uses the background color for the border and the foreground color for the fill. toc

Filled Rectangle Rectangle

Draws a rectangle. If the left mouse button is depressed, it uses the foreground color. If the right mouse button is depressed, it uses the background color. toc

Filled Rectangle Filled Rectangle

Draws a rectangle and fills it with either the foreground or background color. If the left mouse button is depressed, it uses the foreground color for the border and the background color for the fill. If the right mouse button is depressed, it uses the background color for the border and the foreground color for the fill. toc

Text Text

Draws a rectangle that defines the area in which text will be added. Text may then be typed within the rectangle using the current font and font styling.

The format toolbar is used to set/modify the current font styling. Font Format Toolbar toc

Transparency Transparency

Selects a transparent color. The point clicked-on specifies the color to select. toc

Transform/Filter Tools

Resize Resize

Presents a dialog that allows you to specify the new size of the image. toc

Resize Canvas Resize Canvas

Presents a dialog that allows you to specify the new size of the image's canvas. The canvas is the area bordering the image. toc

Crop Crop

Removes any area outside the current selection. This reduces the overall size of the image to the rectangle bounding the current selection. toc

Flip Flip

Flips the image top to bottom. If a selection exists and Apply to Selection is enabled, the current selection is flipped. toc

Mirror Mirror

Flips the image left to right. This creates a mirror effect. If a selection exists and Apply to Selection is enabled, the current selection is mirrored. toc

Grayscale Convert to Grayscale

Converts the image to grayscale. If a selection exists and Apply to Selection is enabled, the current selection is converted to grayscale. toc

NegativeNegative

Converts the image to a negative. If a selection exists and Apply to Selection is enabled, the current selection is converted to a negative. toc

RotateLeft Rotate Left

Rotates 90 degrees to the left. If a selection exists and Apply to Selection is enabled, the current selection is rotated. toc

RotateRight Rotate Right

Rotates 90 degrees to the right. If a selection exists and Apply to Selection is enabled, the current selection is rotated. toc

Rotate Rotate to any angle

Rotates to a specified angle. If a selection exists and Apply to Selection is enabled, the current selection is rotated. toc

Skew Skew

Presents a dialog that allows you to specify the amount to skew an image horizontally and vertically and from which pivot point. If a selection exists and Apply to Selection is enabled, the current selection's brightness is increased. toc

More Brightness More Brightness

Increases brightness. If a selection exists and Apply to Selection is enabled, the current selection's brightness is increased. toc

Less Brightness Less Brightness

Decreases brightness. If a selection exists and Apply to Selection is enabled, the current selection's brightness is decreased. toc

More Contrast More Contrast

Increases contrast. If a selection exists and Apply to Selection is enabled, the current selection's contrast is increased. toc

Less Contrast Less Contrast

Decreases contrast. If a selection exists and Apply to Selection is enabled, the current selection's contrast is decreased. toc

Blur Blur

Blurs the image. If a selection exists and Apply to Selection is enabled, the current selections is affected. toc

Emboss Emboss

Creates an embossed effect. If a selection exists and Apply to Selection is enabled, the current selection is affected. toc

Soften Soften

Softens the image. If a selection exists and Apply to Selection is enabled, the current selection is affected. toc

Sharpen Sharpen

Sharpen the image. If a selection exists and Apply to Selection is enabled, the current selection is affected. toc

Red-eye Remove Red-eye Remove

Removes the red-eye effect that often occurs in photographs. The selected area is affected. toc

Feather Feather

Feathering softens the edges of an image by blending the foreground and the background pixels at the edges. If a selection exists and Apply to Selection is enabled, the current selection is feathered with what is behind the selection. If a selection does not exist, then image is feathered with an assumed white background. toc

Jitter Jitter

Adds a random offset to each pixel. This results in a jittered effect. If a selection exists and Apply to Selection is enabled, the current selection is jittered. If a selection does not exist, then the entire image is jittered. toc

Contour Contour

Enhances the variation between adjacent pixels. If a selection exists and Apply to Selection is enabled, the current selection is contoured. If a selection does not exist, then the entire image is contoured. toc

Apply To Selection

When this is enabled (see Image menu), filter/transformations are applied to the current selection. Otherwise, the main image is affected. toc

Image Attributes

Displays information about the current image. toc

Show Selection Border

Toggling this either displays or hides the drawing of a border around selections. This can make it easier to see the edges of a selection, but it does obscure the boundaries of any selection. toc

The Color Picker

The Color Picker is a dockable bar that contains several tabs of color and the "Foreground/Background Switcher".

Foreground/Background Switcher

This displays the selected foreground and background colors. Selecting any color from any of the color tabs updates either the foreground or the background color. Additionally, the selected colors RGB value is displayed. The "Swap" button swaps the foreground color to the background and vice-versa. toc

Common Colors Tab

This displays 48 common colors. Additionally, all color tabs share 16 custom colors that are displayed after each tab's unique colors. Custom colors may be defined by double-clicking on any color. toc

Web Colors Tab

This displays 141 web colors. Additionally, all color tabs share 16 custom colors that are displayed after each tab's unique colors. Custom colors may be defined by double-clicking on any color. toc

System Colors Tab

This displays 31 system colors. Additionally, all color tabs share 16 custom colors that are displayed after each tab's unique colors. Custom colors may be defined by double-clicking on any color. toc

Palette Colors Tab

This displays an 8-bit quantization of the current image palette. Additionally, all color tabs share 16 custom colors that are displayed after each tab's unique colors. Custom colors may be defined by double-clicking on any color. toc