Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PHO(l)									PHO(l)

NAME
       pho - View and annotate multiple	images

SYNTAX
       pho [options] [filename[filename...]]

DESCRIPTION
       pho  displays images, in	the formats handled by the gdk-pixbuf package,
       to an X display.	 It is intended	as a lightweight and fast viewer,  op-
       timized for rapidly going through large numbers of uploaded images.

       pho  is	entirely  keyboard driven, and allows for interactive rotation
       and taking of notes on each image.  It resizes after rotations and will
       always attempt to show the image	as large as possible.  The final rota-
       tion reached for	each image will	be remembered  and  printed  when  the
       program exits (for use with a batch image rotation script).

       pho  can	 also  remember	up to ten lists	of images (numbered 0-9) which
       can correspond to anything the user wishes. The	image  lists  will  be
       printed	to  standard  output when pho exits. Use this to keep notes on
       which images you	want to	save to	the web, which images  contain	images
       of your dog, etc.

COMMAND-LINE OPTIONS
       -p     "Presentation  mode":  display  in full screen mode with a black
	      background (if the window	manager	allows	it).  In  presentation
	      mode,  if	 you zoom in and need to move (pan) in the image, drag
	      with the middle mouse button.

       -P     Force non-presentation mode (e.g.	if you set PHO_ARGS=-p).

       -n     Replace each image with a	new window (slower,  but  helpful  for
	      some broken window managers).

       -k     Keywords	mode:  display images scaled down, and show a Keywords
	      dialog for classifying images. (Keywords mode will  cancel  Pre-
	      sentation	mode.)

       -sN    Automatic	 Slideshow mode, where N is the	delay in seconds.  For
	      example, -s5 will	show pause  5  seconds	between	 images.   -s0
	      means no delay.

       -d     Debug  mode: may print a few debugging messages to standard out-
	      put.

       -h     Help: print a usage statement.  -v Verbose help: print a summary
	      of key bindings.

ENVIRONMENT VARIABLES
       PHO_ARGS: default flag settings
	      (e.g.  set  it  to -p to use presentation	mode by	default).  Any
	      flags given on the command line will override these settings.

       PHO_CMD:	the command to call when you press the 'g' key.
	      Include a	%s to represent	the filename  of  the  current	image.
	      (Defaults	to gimp	%s).

KEY BINDINGS
       When pho	is running, it obeys the following keys:

       [space],	[Page Down]
	      Go to next image.	Or cancel slideshow mode, if active.

       [backspace], [Page Up]
	      Go to previous image

       r, t, [right-arrow]
	      Rotate right (clockwise)

       R, T, l,	L, [left-arrow]
	      Rotate left (counter-clockwise)

       [up-arrow], [down-arrow]
	      Rotate 180 degrees.

       Home   Go back to the first image.

       d      Delete (will bring up a confirmation dialog; clicking OK or typ-
	      ing another d deletes the	file).

       i      Show a dialog with information about the image,  including  EXIF
	      tags.

       0 through 9
	      Add the image to the appropriate notes list

       f      Toggle  in/out  of  "full	 size  mode".  Images will be shown at
	      their native size, even if it's bigger  than  the	 screen	 size.
	      (Hint:  Many window managers let you move	oversized windows with
	      alt-drag.)

       F      Toggle in/out of "full screen mode" (or "fit to  window").   Im-
	      ages  will  be  scaled up	or down	to fill	the screen in at least
	      one dimension.

       p      Toggle in/out of "presentation mode".   If  the  window  manager
	      permits,	pho  will  take	 up the	full screen with the image (if
	      smaller) centered.

       +, = Magnify: show the image at twice the current size.

       /, - Unmagnify: show the	image at half the current size.

       q      Quit

ENVIRONMENT
       Pho checks for the environment variable	PHO_ARGS,  which  can  contain
       flags to	use as default arguments.  For example,	PHO_ARGS=p will	always
       run pho in presentation mode (unless you	 pass  -P  to  turn  off  that
       mode).

AUTHOR
       Akkana Peck

COPYRIGHT
       Copyright (C) 2002 - 2007 Akkana	Peck
       Pho is free software, licensed under the	GNU Public License.

SEE ALSO
       The  most  recent version of pho, and more information about it,	is at:
       http://shallowsky.com/software/pho/

PHO				 March 5 2007				PHO(l)

NAME | SYNTAX | DESCRIPTION | COMMAND-LINE OPTIONS | ENVIRONMENT VARIABLES | KEY BINDINGS | ENVIRONMENT | AUTHOR | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pho&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help