DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

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

See also

Xt_options(XC)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003