# Command Reference

TODO: put in intro paragraph to commands

## The File Menu

&Ctrl;N File New New Icon

  Allows you to create a new &krayon; image.

&Ctrl;O File Open Open Icon

  Opens an existing &krayon; image.

File Open Recent

  Opens a recently used &krayon; image. A submenu will open displaying recent &krayon; images that you have used.

&Ctrl;S File Save Save Icon

  Saves the current &krayon; image.

File Save As...

  Saves the &krayon; image under a new name.

&Ctrl;P File Print... Print Icon

  Prints the current &krayon; image. This will open the Setup Printer dialog, to set the printing parameters and print the image.

File Document Information... Info Icon

  This opens the Document Information dialog. This lets you enter information about current &krayon; image. This information will be saved with the image.

&Ctrl;W File Close Close Icon

  Closes the current &krayon; image.

&Ctrl;Q File Quit Quit Icon

  >Quits &krayon;. This will only quit the current &krayon; window if more than one is open.

## The Edit Menu

&Ctrl;C Edit Cut Cut Icon

  Removes the selection from the image and places it in the clipboard.

&Ctrl;X Edit Copy Copy Icon

  Copies the selection to the clipboard. This is different from the Cut in that it does not remove the selection from the image.

&Ctrl;V Edit Paste Paste Icon

  Inserts the selection from the clipboard into the image.

Edit Crop

  Crops the &krayon; image to the selection. The image will be resized to the size of the selection rectangle, and all parts of the image outside of the selection rectangle will be removed.

&Ctrl;A Edit Select All

  TODO: How will this work on an image? Find out...

Edit Unselect All

  Removes all selections from the image. This is the opposite of Select All

## The View Menu

View New View

  Open up a new view window for the current &krayon; image.

View Close All Views

  Close all open view windows.

View Split View

  Split the current view into two. This does not open a separate &krayon; window, but splits the current window into two.

View Remove View

  Closes the current &krayon; split view.

View Splitter Orientation

  Change the orientation of the split views. You may choose to split the view horizontally or vertically.

View Zoom in Zoom In Icon

  Zoom in on the current view. This magnifies your view of the image, making it easier to work on image details.

View Zoom out Zoom Out Icon

  Zoom out from the current view. This is the opposite of the Zoom in command.

## The Tools Menu

Tools Rectangular select

  Chooses the Rectangular select tool. You use this tool to select rectangular regions of the &krayon; image. These regions can then be copied, moved, or removed.

Tools Move tool

  Chooses the Move tool. You use this to move selected regions of the &krayon; image.

Tools Zoom tool

  Chooses the Zoom tool. You use this to zoom in or out of the image view. Clicking with the left mouse button magnifies the image while clicking with the right mouse button demagnifies the image. These behave identical to the Zoom in and Zoom out commands on theView menu.

Tools Color picker

  Chooses the Color picker tool. You use this to select a color from a &krayon; image. Using the Color picker is often easier than editing the color values on the Sidebar.

Tools Pen tool

  Chooses the Pen tool. You use this to draw basic lines on the &krayon; image. Lines drawn with the Pen have sharp edges.

Tools Brush tool

  Chooses the Brush tool. You use this to draw basic lines on the &krayon; image. Unlike the Pen tool, the Brush draws lines with fuzzy edges.

Tools Airbrush tool

  Chooses the Airbrush tool. This is similar to the Brush tool, but draws lines in an airbrushed style.

Tools Gradient tool

  Chooses the Gradient tool. This fills in areas of the &krayon; image with the currently selected gradient.

Tools Eraser tool

  Chooses the Eraser tool. This removes color from the image. It can be helpful to think of the Eraser as a Pen that draws in an erasing color.

Tools Filler tool

  Chooses the Filler tool. This fills in regions of the &krayon; image with a color or pattern.

## The Image Menu

Image Import Image Import Icon

  Import an image into &krayon;. Besides the default `KRA` format, &krayon; can load images stored in a variety of formats, including `PNG`, `XPM`, `BMP`, and `JPEG` formats.

Image Export Image Export Icon

  Export an image to another format. This saves the &krayon; image to another image format. See the Import Image paragraph above for the kinds of formats that &krayon; recognizes.

Image Add new image tab

  You can have more than one image open in &krayon; at a time. By selecting this item, &krayon; creates a new image, and adds a tab at the bottom of the image view. By selecting between these tabs, you can switch between the different images.

Image Remove current image tab

  Removes the current image and image tab.

Image Merge all layers

  Merges all of the current image layers into a single layer. This is useful if you have created multiple layers to work on different parts of the image, and want to combine them all.

Image Merge all visible layers

  Merge all of the visible image layers into one. This is like the Merge all layers command, but only operates on the visible layers.

Image Merge all linked layers

  Merge all ofthe linked image layers into one. This is like the Merge all layers command, but only operates on the linked layers.

## The Layer Menu

TODO: should put general discussion of layers here, and reference the concepts above.

Layer Insert layer...

  Creates and inserts a new layer in the image. A useful way to think of layers is to imagine them as sheets of glass stacked atop each other. You can see through all the layers, but any drawing you perform only changes the current layer. Some layers are opaque and others are transparent.

Layer Insert image as layer...

  Inserts an image as a new layer. &krayon; will open an image of any supported format and use it as a new drawing layer.

Layer Save layer as standard image...

  This command will save the current drawing layer as an image file. Layers can be saved in any supported image format.

Layer Rotate 90

  Rotates the current drawing layer 90 degrees clockwise.

Layer Rotate 180

  Rotates the current drawing layer 180 degrees clockwise.

Layer Rotate 270

  Rotates the current drawing layer 270 degrees clockwise.

Layer Mirror X

  Mirrors the drawing layer about the X axis. This flips the layer vertically.

Layer Mirror Y

  Mirrors the drawing layer about the Y axis. This flips the layer horizontally.

## The Color Menu

TODO: Nothing here yet...

## The Brush Menu

TODO: Nothing here yet...

## The Pattern Menu

TODO: Nothing here yet...

## The Effects Menu

TODO: Nothing here yet...

## The History Menu

&Ctrl;Z History Undo Undo Icon .

  Reverses the last action you performed. Not all actions can be reversed. If you are unable to Undo the last action, the Undo option will be replaced with No Undo Possible.

&Ctrl;Shift Z History Redo Redo Icon .

  Reverses the last Undo performed. If the Redo option is unavailable, the Redo options will be replaced with No Redo Possible.

## The Settings Menu

Settings Tool Settings

  This displays a submenu where you can configure the settings for each of the &krayon; tools.

Settings Show Menubar

  Shows the main menu, or hides it. The menubar is at the top of the &krayon; window.

Settings Show Toolbar

  Shows the main toolbar, or hides it.

Settings Show Statusbar

  Shows the statusbar, or hides it. The statusbar is at the bottom of the &krayon; window.

Settings Show Sidebar

  Shows the sidebar, or hides it. The sidebar is at the left of the &krayon; window. It contains color, brush, pattern and other controls.

Settings Krayon Preferences...

  Opens the Preferences dialog. You use this dialog to set your user and work settings for &krayon;.

Settings Save Options

  Save the current settings and options for &krayon;. This will save all settings made in the Settings menu and its dialogs.

Settings Show File Toolbar

  Shows the file toolbar or hides it. This toolbar contains icons to create, open, save or print the current image.

Settings Show Selection Toolbar

  Shows the selection toolbar, or hides it. This toolbar contains icons to copy, cut, remove or paste the image selection.

Settings Show KrayonBox Toolbar

  Shows the KrayonBox toolbar, or hides it. This toolbar contains icons to open the colors, krayons, brushes, patterns, layers and channels dialogs.

Settings Show Settings Toolbar

  Shows the Settings toolbar, or hides it. This toolbar contains icons to show or hide the sidebar, or open various settings dialogs.

Settings Show Tools Toolbar

  Shows the Tools toolbar, or hides it. This toolbar contains icons for the drawing tools.

Settings Configure key bindings...

  Opens the Configure Key Bindings dialog. This dialog is used to change what keystrokes are associated with an action.

Settings Configure Toolbars...

  Opens the Configure Toolbars dialog. This dialog is used to customize the toolbar layouts and actions.

## The Help Menu

F1 Help Contents

  Opens up the &krayon; Handbook in the &kde; Help Center.

&Ctrl;F1 Help What's This?

  Changes the cursor to a What's This? cursor. When this cursor is clicked on an item, icon or other control, a quick help panel is displayed.

Help Report Bug...

  Opens up the Submit a Bug Report dialog. If you find a defect in &krayon; use this dialog to report it to the &krayon; developers.

Help About Krayon...

  Displays copyright and other information for &krayon;.

Help About KDE...

  Displays copyright and other information for the K Desktop Environment.