scopaint(XC)

scopaint -- creates and edits icons and pictures; edits xbm- and xpm-formatted files

Command Syntax

scopaint [Xt_options] [-height] [-width] [-zoomLevel] [file]

Desktop syntax

Double-click on the Paint icon in the Accessories window.

Description

scopaint is a paint program for creating icons and pictures, and editing xbm- and xpm- formatted files.

If you are running an R4, R5, or R6 X server that supports 256 colors, you see two windows when you invoke scopaint: the drawing window and the color palette window. If you are running any other type of server, scopaint is working in monochrome mode, and you see only the drawing window. The main part of the drawing window is blank; this is the drawing area. Along the top of the drawing area is a menu bar that contains File, Edit, View, and Tools menus. Under the menu bar is a pattern palette that contains eight stipple patterns. In monochrome mode, the stipple patterns are composed of black-and-white bits; in color mode, the stipple patterns are composed of two colors from your color palette. Along the left side of the drawing area is the tool palette. From top to bottom the tools are: Select Area, Line, Pencil, Fill, Eraser, Type, Rectangle, Oval, Hot spot, and Line Width.

The color palette window holds the colors that are currently in your painting or colors that you select from the Color Picker. Button 1 and Button 3 at the top of the color palette hold the colors currently assigned to mouse button 1 and mouse button 3, respectively; the small boxes in the middle of the palette hold all colors that you select from the Color Picker. From the color palette, you can invoke the Color Picker window by clicking on the Edit button or double-clicking on a color box in the color palette. The Color Picker window contains an HSV (hue, saturation, value) color wheel, a Grab Color button, and color mapper buttons.

Command options

scopaint supports all Xt_options(XC) as well as:

-height: specifies the height of the drawing area in pixels
-width: specifies the width of the drawing area in pixels
-zoomLevel: specifies the magnification ratio of the actual painting size to drawing area display: where 0 = 1:1 magnification; 1 = 1:2 magnification; 2 = 1:4 magnification; 3 = 1:8 magnification, and the maximum ratio is 4 = 1:16.
file: specifies a scopaint file

Desktop options

This section describes the Paint menus and palettes:

File menu

The File menu contains the following menu items:

New: creates a new drawing area in a separate window. It brings up a dialog box that asks for a title and size. The maximum size is 512 pixels in width by 720 pixels in height.
Open: opens a pre-existing drawing. It brings up a Selection dialog box that contains a list of filenames to select from.
Save: saves the current file. If you have not previously saved the file, or if you are editing a read-only file, the Save option is the same as the Save as option.
Save As: saves the file to another filename. It brings up a Selection dialog box that lets you rename the file. If the filename you enter already exists, you are warned and asked to select another name.
Save As Monochrome: saves the current drawing as a monochrome file (xbm formatted). This option only displays on 256-color systems.
Set Root Window: copies your painting to the root window. Note that the root window is not visible if you are running the Desktop.
Exit: exits scopaint and closes the current drawing only. If you have multiple drawings open, scopaint continues running until you close all of them. It also checks for ``dirty'' files and warns you if it finds any before it exits the current drawing.

Edit menu

The Edit menu contains the following menu items:

Undo: undoes the last drawing operation
Cut: cuts the selected area and copies it to the clipboard. This option is stippled until you select an area.
Copy: copies the selected area to the clipboard. This option is stippled until you select an area.
Paste: pastes a selection from the clipboard. If you paste a color image from a drawing other than the one you are currently editing, Paste allocates all of the image's new colors to the color palette. You cannot paste a black and white drawing into a color drawing, or a color drawing into a black and white drawing.
Delete: deletes the selected area. This option is stippled until you select an area.
Select All: makes the entire drawing a selected area

View menu

The View menu contains the following menu items:

Zoom In: magnifies the drawing area window
Zoom Out: shrinks the drawing area window
Actual Size: displays the drawing in a separate window in its actual size with a 1:1 magnification with the drawing area
Monochrome: displays the drawing in a separate window with the colors mapped to black and white. This option only displays on 256-color systems.

Tools menu

The Tools menu contains the following menu items:

Draw Filled: fills the oval and rectangle tools with colors and patterns as they are being drawn
Fonts: displays a list of fonts to use with the Type tool. It brings up a Font dialog box that lets you change and see examples of fonts, styles and size of type.
Invert: inverts the selected area. This option only works with black and white drawings.
Rotate: rotates the selected area by 90-degree increments
Flip Horizontal: flips the selected area by horizontal axis
Flip Vertical: flips the selected area by vertical axis
Nudge Up: moves the selected area up in 1 pixel increments
Nudge Right: moves the selected area right in 1 pixel increments
Nudge Down: moves the selected area down in 1 pixel increments
Nudge Left: moves the selected area left in 1 pixel increments

Tool palette

The Tool palette provides the following drawing tools, all of which affect the drawing area beyond the drawing window while you are using them:

Select Area: selects part of your drawing for copying, cutting, deleting, duplicating, or moving
Line: draws straight line. Depress the <Shift> key to draw lines angled at 45 degrees
Pencil: draws like a pencil
Fill: fills area with color specified in Button 3 of the color palette
Eraser: erases area by filling with the background color
Type: types keyboard characters on the drawing area
Rectangle: draws filled rectangles or rectangle borders. Depress the <Shift> key to draw squares.
Oval: draws filled ovals or oval borders. Depress the <Shift> key to draw circles.
Hotspot: determines the hot spot of the pointer in xbm files
Line width: determines the line width

Color palette

The Color palette holds colors that are currently in your painting or colors that you select from the Color Picker, as follows:

Button 1: holds color currently assigned to mouse button 1 (foreground color)
Button 3: holds color currently assigned to mouse button 3 (background color)
New: adds color boxes to the color palette
Edit: invokes the Color Picker

Color Picker

The Color Picker controls the color scheme of your painting, as follows:

Color wheel: lets you select colors for your color palette and painting. The color wheel controls the hue and saturation of the colors; the slider bar on the left of the color wheel controls the hue of the colors in the wheel
Grab Color: lets you copy colors from anywhere on the Desktop
Maps to: lets you map colors in your painting to black and white for viewing or saving to a black and white format
Undo: voids the color changes you have made to a color slot in the color palette

Hardware support

scopaint requires an R4, R5, or R6 X server that supports 256 colors to run in color mode. scopaint runs in monochrome mode with all other servers. The color palette and the Color Picker do not run in monochrome mode. scopaint only works on pseudo-color servers; it does not work on true-color servers.

Resources

You can customize the characteristics of scopaint using your personal X resource file, $HOME/.Xdefaults-hostname, where hostname is the name of the machine on which the client is running. If this file does not exist in your home directory, you will need to create it. Changes made to this file take effect the next time you run scopaint. In addition to recognizing the core resource names and classes, scopaint defines the following application-specific resources:

dbl_click_bar.maximum: specifies the maximum time between clicks in a double click. The default is 100.
drawAreaWidth: specifies width of the drawing area in pixels. The default is 64; the maximum is 512.
drawAreaHeight: specifies height of the drawing area in pixels. The default is 64; the maximum is 720.
movingSelection: Set to true or false. This resource ``marches'' the dashed lines around the perimeter of a selected area. The default is ``FALSE''.
zoomLevel: specifies the magnification ratio of the actual painting size to the drawing area display. The default is 3: where 0 = 1:1 magnification; 1 = 1:2 magnification; 2 = 1:4 magnification; 3 = 1:8 magnification, and the maximum ratio is 4 = 1:16.

Files

$HOME/.odtpref/ScoPaint
/usr/bin/X11/scopaint
usr/lib/X11/[LANG]/app-defaults/ScoPaint
/usr/lib/X11/[LANG]/sco/startup/ScoPaint
$HOME/.Xdefaults-hostname