xmag - magnify parts of the screen


xmag [-mag magfactor] [-source geom] [-toolkitoption ...]


The xmag(1) program allows you to magnify portions of an X screen. If no explicit region is specified, a square with the pointer in the upper-left corner is displayed indicating the area to be enlarged. The area can be dragged out to the size you want by pressing Button 2. After a region has been selected, a window pops up showing a blown-up version of the region in which each pixel in the source image is represented by a small square of the same color. Pressing Button 1 in the enlargement window shows the position and red-green-blue (RGB) value of the pixel under the pointer until the button is released. Typing Q or ^C in the enlargement window exits the program.

The application has the following five buttons across the top:

Delete this particular magnification instance.
Bring up the rubber-band selector again to select another region for this magnification instance.
Bring up the rubber-band selector to create a new magnification instance.
Put the magnification image into the primary selection.
Copy the primary selection buffer into xmag(1).

You can cut and paste between xmag(1) and the bitmap(1) program. Resizing xmag(1) resizes the magnification area. The xmag(1) utility preserves the colormap, visual, and window depth of the source.


The xmag(1) utility uses the X Toolkit and the Athena Widget Set. The magnified image is displayed in the Scale widget. For more information, see the Athena Widget Set documentation.

Below is the widget structure of the xmag(1) application. Indentation indicates hierarchical structure. The widget class name is given first, followed by the widget instance name.

Xmag xmag
  RootWindow root
  TopLevelShell xmag
	 Paned pane1
	 Paned pane2
		Command close
		Command replace
		Command new
		Command select
		Command paste
		Label xmag label
	 Paned pane2
		Scale scale
  OverrideShell pixShell
	 Label pixLabel


-mag integer
Use specified magnification. The default is 5.
-source geom
Magnify the size or location specified by geom. By default, a 64X64 square is provided for the user to select an area of the screen.


Copyright 1991, Massachusetts Institute of Technology.

See X(5) for a full statement of rights and permissions.


Dave Sternlicht and Davor Matic, MIT X Consortium.