Paint-Window

The paint-window is the central part of the program where you create the images. It also contains a menu-bar for controlling operations such as saving the image and creating new windows. In figure 1 is a picture of a paint-window.

Figure 1: A paint-window.

The paint-window is divided into three distinct subsections: the canvas, the status-bar and the menu-bar. In figure 1 the canvas is the white area in the middle of the window. It is used for painting the image. The status-bar is at the bottom of the window. It contains information such as coordinates and selected colors and allows you to also zoom the view and select new colors. The menu-bar can be used to invoke many operations, such as opening new windows and saving the image.

The canvas

The canvas is the area where you can paint your image. When a paint-window is first opened it does not have a canvas. You should select a suitable canvas size and then press the "Create Canvas"-button to create a canvas for the paint-window. Figure 2 shows the controls that are available for settings the size of the canvas.

Figure 2: Controls for settings the canvas size.

The size can be selected by settings the numbers in the two fields or by selecting one of the recently used sizes from the pop-up-list on the right. If only an approximate size is needed, it can be quickly selected by dragging the window to the required size.

When the canvas has been created you can use any of the painting tools to paint on it. The painting tool can be used by pressing down the primary mouse-button. The secondary mouse-button brings up a pop-up-menu where you can change the active tool.

The status-bar

The status-bar is at the bottom of the window and it displays status-information about the current state of the program. Status-bar also contains tools for zooming the image and for selecting colors. Status-bar can be in several different states depending on the state of the program. The different states of the status-bar are listed here:
Canvas not created -mode

Normal-mode

Transform-mode

Add-on-mode

Busy-mode

The canvas not created -mode comes up when the window has no canvas. At this point the status-bar does not offer any functionality. This shows a message at the bottom of the bar. In most modes this place is reserved for helpful messages.

Normal-mode is the most usual, and it comes up when the canvas has been created. It has the following components (from left to right):

Coordinates-box
Displays the coordinates that the mouse is over. If the mouse is outside of the image this displays the width and height of the image instead.
Magnification-box
Displays the magnification-level of the image. When you click your mouse over this it brings up a slider with which the zooming level can be adjusted freely.
Magnification-buttons
Allow you to zoom in and out from the image in predefined steps.
Selected colors
Shows the current foreground- and background-color. Clicking on these with the primary mouse button opens up the color-window. Clicking with other mouse buttons exchanges the two colors with each other.
Color-set
Displays the current color-set. The two arrows change between different sets.

Transform-mode comes up when you start an image transformation such as rotation or translation. This mode may also come up with some add-ons. On the right side of the status-bar are two buttons for cancelling and applying the transformation. On their left side are control-views for controlling the transform.

Add-on mode is similar to normal-mode, but it does not display colors. The status-bar comes to this mode when you have started some add-on or for example when you are adjusting the transparency of the layer.

Busy-mode comes up when you have selected some operation that is going to take a substantial amount of time. Usually this goes by quite quickly, but depending on the speed of the computer and the size of the image, some operations might take a while. When the status-bar is in this mode you cannot do anything to that image (but you can edit other images if you wish).

The menu-bar

The menu-bar behaves like you would expect from a BeOS application. The following list summarizes the menu-items and describes their functionality.

File-menu

Recent Images
This has a list of recent images as a submenu. Look at the status-bar to see the path of the image your cursor is over.
Open Image
Brings up a file-panel for opening an image. The file-panel displays only directories and image-files.
Save Image As
Brings up a file-panel for saving the image. The file-panel contains a pop-up-menu for choosing the required save-format and also a button for bringing up a settings window for that format.
Save Image
Saves the image using the name and format that were used when it was last saved.
New Project
Opens a new, empty, paint-window.
Recent Projects
This has a list of recent projects as a submenu. Look at the status-bar to see the path of the project your cursor is over.
Open Project
Brings up a file-panel for opening a project from the disk.
Save Project As
Brings up a file-panel for saving the current project to the disk.
Save Project
Saves the project using the name (and path) it was last saved with.
Close
Closes the current window.
Quit
Closes all of the windows and quits the program.

Edit-menu

Undo...
Undoes the previous action. The name of this item will change according to what the previous action was.
Redo...
Redoes the action that was last undone. The name of this item will change to reflect what operation is to be redone.
Cut
This item has a submenu that allows you to cut the active layer or all layers. Cutting means that the layer (or all layers) is stored on the clipboard and then cleared. If you have made a selection only the selected area will be cut.
Copy
This is almost the same as cut, but this does not clear the layer (or the image).
Paste As a New Layer
Pastes the contents of the clipboard as a new layer.
Paste As a New Project
Pastes the contents of the clipboard as a new project. Opens a new window where the pasted image goes. Pasting does not empty the clipboard.
Grow Selection
Grows the size of the selection by one pixel in each direction.
Shrink Selection
Shrinks the size of the selection by one pixel from each direction.
Invert Selection
Inverts the selection by turning selected areas into unselected and unselected areas into selected.
Clear Selection
Clears the selection. This makes everything selected and it does not clear the actual image.

Layer-menu

Rotate
Starts rotating the currently active layer.
Translate
Starts translating the currently active layer.
Flip Horizontally
Flips the active layer horizontally
Flip Vertically
Flips the active layer vertically.
Change Transparency
Brings up a window where you can adjust the overall transparency of the active layer.
Clear Layer
Clears the layer to the background-color.
Insert Text
Brings up a window which allows you to insert text into the image.
Show Layer Window
Shows the layer-window.
Add Layer
Adds a new layer to the top of the image.

Canvas-menu

Rotate
Starts rotating the whole image.
Translate
Starts translating the whole image.
Flip Horizontally
Flips the whole image horizontally
Flip Vertically
Flips the whole image vertically.
Crop
Starts cropping the image. Opens up a new window where the crop amount can be adjusted. Crop also allows the extension of the image.
Scale
Starts scaling the image. Opens up a new window for setting the scaling parameters.
Clear Canvas
Clears the image to the background-color. This is same as clearing all of the layers separately.

Window-menu

Zoom In
Zooms in on the image.
Zoom out
Zooms out from the image.
Set Zoom Level
This has a submenu that contains a set of predefined zoom-levels that can be used to set the zooming of the image. Default value is 100%.
Set Grid
Contains a submenu of items that set the grid size. The grid restricts the drawing operations to certain steps. For example 8x8 restricts the drawing operations to 8 by 8 pixel blocks. Grid is useful for drawing diagrams and such things. Default value is off.
Resize To Fit
Resizes the window so that as much of the image is visible as possible while the window still fits on the screen.
Show Palette Window
Brings up the color-palette window that can be used to adjust colors and color-sets.
Show Layer Window
Brings up the layer window.
Show Tool Window
Brings up the window that can be used to select painting tools.
Show Tool Setup Window
Brings up the window that can be used to set up the painting tools.
Show Brush Window
Brings up the window that holds previously defined brushes.
Settings
Brings up the window where settings of the program can be adjusted.

Add-Ons-menu

The contents of this menu varies depending on what add-ons have been installed.

Help-menu

User Manual
Opens the ArtPaint documentation in a web-browser.
Shortcuts
Opens a page describing ArtPaint's keyboard shortcuts in a web-browser.
About ArtPaint
Opens a window that contains scrolling text that tells you about ArtPaint.
Registration Info
Displays the documentation for the registration-process if the program has not yet been registered. Otherwise opens a new window that displays registration status.

The title-bar

Every paint-window has a title-bar like most other windows. The title-bar is shown in the following figure.

Figure 1: The title-bar.

The title-bar contains three pieces of information. The star on the left tells that the project has been changed since it was last saved. The 'Untitled - 2' is the name of the project, which in this case is still unnamed. When the project is saved to disk this will change to reflect that. The 'pic00007.jpg' is the name of the picture that this project was last saved to or loaded from.