xmag(1) [xfree86 man page]

XMAG(1) 						      General Commands Manual							   XMAG(1)

NAME

       xmag - magnify parts of the screen

SYNOPSIS

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

DESCRIPTION

       The xmag 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 desired size by pressing Button 2.  Once a
       region  has been selected, a window is popped up showing a blown up version of the region in which each pixel in the source image is repre-
       sented by a small square of the same color.  Pressing Button1 in the enlargement window shows the position and 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 5 but-
       tons across its top.  Close deletes this particular magnification instance.  Replace brings up the rubber band  selector  again	to  select
       another	region	for this magnification instance.  New brings up the rubber band selector to create a new magnification instance.  Cut puts
       the magnification image into the primary selection.  Paste copies the primary selection buffer into xmag.  Note that you can cut and  paste
       between	xmag and the bitmap program.  Resizing xmag resizes the magnification area.  xmag preserves the colormap, visual, and window depth
       of the source.

WIDGETS

       xmag 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 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

OPTIONS

       -source geom   This option specifies the size and/or location of the source region on the screen.  By default, a 64x64 square  is  provided
		      for the user to select an area of the screen.

       -mag integer   This option indicates the magnification to be used.  5 is the default.

AUTHORS

       Dave Sternlicht and Davor Matic, MIT X Consortium.

XFree86 							   Version 4.7.0							   XMAG(1)

XZOOM(1x)																 XZOOM(1x)

NAME

       xzoom - magnify part of the screen, with fast updates

SYNOPSIS

       xzoom [ -display displayname ] [ -mag mag [ mag ] ] [ -x ] [ -y ] [ -xy ] [ -geometry geometry ] [ -source geometry ]

OPTIONS

       -display displayname | -d displayname
	    The name of the display to use (not very useful).

       -mag mag [ mag ]
	    What  magnification  to  use. If two number arguments are supplied the first is used for X magnifications and the second is used for Y
	    magnification.  Magnification should be greater than 0.

       -x   Mirror horizontally.

       -y   Mirror vertically.

       -xy | -z
	    Exchange X and Y axes before any magnification is performed.

       -geometry geometry | =geometry
	    Size and position xzoom's window.

       -source geometry
	    Size and position the initial source area which is magnified.  The dimensions of this area are multiplied by the magnification to  get
	    the size of xzoom's window. If these dimensions are given separately (by use of -geometry ) then an error is reported.

DESCRIPTION

       Xzoom displays in its window a magnified area of the X11 display.  The user can interactively change the zoomed area, the window size, mag-
       nification (optionally different magnification for X and Y axes) or rotate or mirror the image.

COMMANDS

       Once xzoom has started the user can enter simple commands using the keyboard.

       q    quit.

       +    increase magnification value by 1.

       -    decrease magnification value by 1.

       w    next + or - command only affect X magnification.

       h    next + or - command only affect Y magnification.

       x    mirror the display image horizontally.

       y    mirror the display image vertically.

       z    rotate the displayed image 90 degrees counter-clockwise.

       arrow keys
	    scroll the zoomed area 1 pixel in the direction of the arrow.  if the control key is pressed the zoomed area will scroll 10 pixels.

       d    sets the delay between frame updates.  Built-in delays are 200, 100, 50, 10 and 0 ms.

       g    toggle grid on and off.

       Mouse buttons
	    To set the location of the magnified are click the left mouse button inside xzoom's window and then move it (keep the button  pressed)
	    to the place which you want to see magnified.

	    Xzoom allow you to resize it's window at any time.

	    When xzoom is iconified it simply waits to get deiconified.

DISPLAYS

       Xzoom  uses  the  window's  title bar to inform the user about it's status. Normally the title says something like xzoom x2 which means the
       magnification is 2 both in X and Y axes.  If the image is stretched differently on the X and Y axes the title will say  xzoom  X  2;  Y	4.
       Negative numbers mean reflection.  If the image is rotated by 90 or 270 degrees the title will show <=> between the X and Y values.

       When d is depressed the title will display the new delay value for approximately 2 seconds and then revert to the default display of magni-
       fication values.

PERFORMANCE

       Xzoom is fast enough to display enlarged or mirrored animations in small windows. On my 486 DX2-66 and Cirrus Logic CL-GD5428 display  card
       (attached  to  Vesa  local bus) update of a 256x256 window magnified by 2 (ie, source rect is 128x128) takes approximately 30 ms. This time
       varies, off course when a different size window or different magnification is used.  If we chose 50 ms between updates  we  can	get  about
       12.5  frames  per second and still let an animation program do it's work.  It is possible to compile xzoom without X shared memory support.
       In that case window update may be about 3 times slower (if we are using a local display, using LAN is a different story).

SEE ALSO

       xmag.1x.
       I got the motivation for writing xzoom after I saw a similar WindowsNT program, zoomin working. It started just as a test for  X11  perfor-
       mance. I don't have the fancy menus and scrollbar like zoomin but I do have all their features (and more) accessible from the keyboard.

BUGS

       -  The  maximum internal built in delay (see command d above) was set to 200 ms. Xzoom completes the delay before polling the X event queue
       for the next command. Larger delays would feel like poor response to user commands.

       - For best performance the shared memory extension for X11 is used. Xzoom will fail if it is compiled to use XSHM and its display is not on
       the local host.

       - Xzoom is given with no warranty. It was tested only under Linux with Xfree86 release 3.1.2 (X11R6).

       - Some strange behavior may occur if the requested magnified area falls beyond the borders of the screen. Example is when you have magnifi-
       cation of 1 and a window whose width is greater than the height of the screen and you want 90 degrees rotation. In that case  part  of  the
       window will not get updated.

       -  The frame used to mark the zoomed area may corrupt the contents of other windows if they are modified when the frame is visible.  If you
       don't like it disable the -DFRAME option when compiling xzoom.

AUTHOR

       Itai Nahshon

																	 XZOOM(1x)