next up previous 79
Next: Colourmaps
Up: The GWM Widget
Previous: Printing

WIDGET OPTIONS

Name: background
Class: Background
Command-Line Switch: -background or -bg

Specifies the background colour (colour table entry 0) of the gwm window. Defaults to Black.

Name: colours
Class: Colours
Command-Line Switch: -colours

Specifies the number of colours that the gwm window will attempt to allocate for its colour table. Setting this option after the widget has been created has no effect. Defaults to 64.

Name: crosshair
Class: Crosshair
Command-Line Switch: -crosshair

Specifies whether the cross-hair should be displayed.

Name: crossColour
Class: CrossColour
Command-Line Switch: -crosscolour

Specifies the colour of the crosshair.

Name: cursor
Class: Cursor
Command-Line Switch: -cursor

Specifies the mouse cursor to be used for the widget. The value may have any of the forms acceptable to Tk_GetCursor.

Name: foreground
Class: Foreground
Command-Line Switch: -foreground or -fg

Specifies the foreground colour (colour table entry 1) of the gwm window. Defaults to White.

Name: name
Class: Name
Command-Line Switch: -name or -gwmname

Specifies the name of the gwm window. Setting this option after the widget has been created has no effect. The gwm name is the name used by graphics programs to connect to the window. Defaults to ``xwindows''.

Name: height
Class: Height
Command-Line Switch: -height

Specifies the width of the gwm widget. The value is in any of the forms acceptable to Tk_GetPixels. Changing this option after the widget has been created has no effect. Defaults to 512 pixels.

Name: jpegQuality
Class: JpegQuality
Command-Line Switch: -jpegquality

Specifies the quality of the JPEG image in the range 0-100 where 0 is the lowest quality/highest compression and 100 is the highest quality/lowest compression. The normally useful range is 50-95, values above 95 give dramatically increased file size with practically no increase in quality while below 50 the image quality degrades the image quality without much additional compression.

Name: jpegProgressive
Class: JpegProgressive
Command-Line Switch: -jpegprogressive

Specifies a boolean value that determines whether the JPEG image is ``progressive''. Progressive images are useful for use on world wide web servers as it allows a browser to display a low quality image quickly and then improve the quality as more data arrives. However not all browsers and other image reading software can interpret progressive JPEGs.

Name: minColours
Class: MinColours
Command-Line Switch: -mincolours

Specifies the minimum number of colours that the gwm window should allocate for its colour table. If fewer than this number of colours are available, the creation of the widget will fail. Changing this option after the widget has been created has no effect. Defaults to 2.

Name: overlay
Class: Overlay
Command-Line Switch: -overlay

Specifies a boolean value that determines whether the gwm window will have an overlay plane. Changing this option after the widget has been created has no effect. Defaults to ``no''.

Name: paperWidth
Class: PaperWidth
Command-Line Switch: -paperwidth

Specifies the maximum width of the plot created by the print command. The value is in any of the forms acceptable to Tk_GetPixels. The plot will be the largest size possible that will fit on the paper (after rotation through 90 degrees if necessary) with the same aspect ratio as the gwm window. Defaults to 180mm (a little less than the width of an A4 page).

Name: paperHeight
Class: PaperHeight
Command-Line Switch: -paperheight

Specifies the maximum height of the plot in the same way as paperWidth. Defaults to 250mm (a little less than the height of an A4 page).

Name: printBackground
Class: PrintBackground
Command-Line Switch: printbackground or -printbg

Specifies the colour used for the background of a plot. Any pixel with value zero is plotted in the background colour. Defaults to White.

Name: printFormat
Class: PrintFormat
Command-Line Switch: -printformat

Specifies the format of the file produced by the print command. Valid values are:
ps postscript
Monochrome PostScript.
colour_ps colour_postscript
Colour PostScript.
eps bw_eps
Monochrome encapsulated PostScript.
colour_eps
Colour encapsulated PostScript.
HPinkjet
LJ250 Inket.
JPEG
JPEG

Name: printVariable
Class: PrintVariable
Command-Line Switch: -printvariable

Specifies the name of the global variable that is set when a print command has completed. The default is gwm_printvar.

Name: takeFocus
Class: TakeFocus
Command-Line Switch: -takefocus

See the options man page for a description of this option.

Name: width
Class: Width
Command-Line Switch: -width

Specifies the width of the gwm widget. The value is in any of the forms acceptable to Tk_GetPixels. Changing this option after the widget has been created has no effect.

Name: xOffset
Class: XOffset
Command-Line Switch: -xoffset

Specifies by how much the picture is offset from the left hand edge of the window. The value is in any of the forms acceptable to Tk_GetPixels. Positive values shift the picture to the right and negative values shift the picture to the right. The default is zero.

Name: xOvOffset
Class: XOvOffset
Command-Line Switch: -xovoffset

Specifies by how much the overlay is offset from the left hand edge of the window. The value is in any of the forms acceptable to Tk_GetPixels. Positive values shift the picture to the right and negative values shift the picture to the right. The default is zero.

Name: yOffset
Class: YOffset
Command-Line Switch: -yoffset

Specifies by how much the picture is offset from the top edge of the window. The value is in any of the forms acceptable to Tk_GetPixels. Positive values shift the picture to down the screen and negative values shift the picture to up the screen. The default is zero.

Name: yOvOffset
Class: YOvOffset
Command-Line Switch: -yovoffset

Specifies by how much the overlay is offset from the top edge of the window. The value is in any of the forms acceptable to Tk_GetPixels. Positive values shift the picture to down the screen and negative values shift the picture to up the screen. The default is zero.



next up previous 79
Next: Colourmaps
Up: The GWM Widget
Previous: Printing

STARTCL --- Starlink Extensions to Tcl & Tk
Starlink User Note 186
D. L. Terrett
3 March 1999
E-mail:ussc@star.rl.ac.uk

Copyright © 2009 Science and Technology Facilities Council