NAME

DESCRIPTION

The x11 graphics filter creates a separate window for C-PLOT graphics under X Window System window managers. A special feature of the x11 filter is the ability to copy the contents of the filter window into a new window. The detached window will remain on the screen until explicitly removed.

See the xhairs help file to see how to display a cross hairs in the X11 plot window.

C-PLOT pen numbers select many options besides drawing color, as described below.

INITIALIZATION

The filter is invoked using the following command:

zi x11 [-rotate] [-title="this is the title"] [-geometry=WIDTHxHEIGHT+XOFF+YOFF]


Normally, the display name is taken from the environment variable DISPLAY. If there are multiple screens associated with the display, the screen can be specified by appending a colon and the screen number to the filter name. If the name by which the filter is invoked contains a colon, the display name is formed by concatenating the colon and the characters following to unix. For example, if the filter is named x11:1, the screen to be opened will be unix:1. The system administrator can make links to the x11 file that have the different names.

USER DEFAULTS

The x11 filter obtains user defaults for the following parameters from the user's .Xdefaults database file. The default values of the parameters are indicated.

! window position
cplot.geometry:    =512x380-0+0
! foreground color
cplot.Foreground:  black
! background color
cplot.Background:  white
! use backing store
cplot.Backstore:   on
! retain image in pixmap
cplot.Retained:    off
! window border width
cplot.BorderWidth: 4
! window border color
cplot.Border:      black
! automatic raise
cplot.AutoRaise:   on


If the -rotate flag is used, the geometry values for width and height are reversed.

BACKING STORE AND RETAINED PIXMAP

For the filter window contents to be redrawn when exposed or de-iconified, a copy must be retained in memory. The display firmware or the window manager can do this automatically with backing store enabled, or the x11 filter can retain the image in a pixmap. Which is most efficient depends on the hardware environment. The filter is fastest if neither feature is turned on. However, the filter's window contents then will not be redrawn when obscured portions of the window become visible or if an iconified window is de-iconified. Note that backing store is not always available.

AUTO RAISE

DOTS

The default C-PLOT symbol (symbol 9) is a dot that scales in size with the line width. These dots are also used with the dotted line (symbol A) and the dot-dashed line (symbol D). On some X11 systems, small dots drawn by the X11 library functions don't come out very well. You can choose fixed pixel arrangements for dots using pen numbers listed in the table below. Note, though, these dots don't change size as the line width is increased.

DETACHED WINDOWS

Pressing control-button with any of the mouse buttons when the cursor is over the filter window will make a detached copy of the window contents and place them in a new window associated with a new process. Any number of detached windows can be made. Pressing control-button when the cursor is over one of the detached windows destroys it. Detached windows always begin as icons and always retain window contents in a pixmap.

PEN ASSIGNMENTS

Pen number assignments in x11 use the following conventions.

• 0-999 drawing colors
  
• 1000-1999 white-fill fill colors
  
• 2000-2999 black-fill fill colors
  
• 3000-3999 background colors
  
• 4000-4999 line widths
  
• 5000-5999 symbol outline widths
  
• 9001 turns symbol filling on
  
• 9002 turns symbol filling off
  
• 9003 turns black-filled symbol outlines on
  
• 9004 turns black-filled symbol outlines off
  
• 9103 turns retained-pixmap on
  
• 9104 turns retained-pixmap off
  
• 9105 turns backing-store on
  
• 9106 turns backing- store off
  
• 9107 use round line caps and joins
  
• 9108 use butt line caps and beveled joins
  
• 9109 turns auto-raise on
  
• 9110 turns auto-raise off
  
• 9210 symbol 9 (dot) follows pen width
  
• 9211 symbol 9 is drawn as single pixel
  
• 9212 symbol 9 is drawn as nine-pixel square
  
• 9213 symbol 9 is drawn as five-pixel cross
  
• 9666 detaches window just as control- button

The colors for pen numbers 1000-1999, 2000-2999 and 3000-3999 correspond to pen colors 0-999. See the colors help file for color assignments.

White and black are the default colors for pens 0 and 1. The user's .Xdefaults may assign different colors. The color associated with pens 0, 1000, 2000 and 3000 track the background color assigned with pens 3002-3999. Pens 1, 1001, 2001 and 3001 track the foreground color assigned with pens 2-999.

For multiplane displays, pen numbers are taken modulus 176 to select a color. Colors in the above table that are not available on the selected display are assigned to the color associated with pen 1.

If the filter determines that the display is single-plane monochrome, only two colors, foreground and background, are available. Pen 0 selects the background color, while higher number pens select the foreground color.