djview man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

DJVIEW4(1)			   DjVuLibre			    DJVIEW4(1)

NAME
       djview4 - Standalone DjVu viewer

SYNOPSIS
       djview4 [options] [argument]

DESCRIPTION
       Standalone  viewer  for	DjVu files.  Features include navigating docu‐
       ments, zooming and panning page images, producing and displaying thumb‐
       nails, displaying document outlines, searching documents for particular
       words in the hidden text layer, copying hidden text to  the  clipboard,
       saving pages and documents as bundled or indirect multi-page files, and
       printing page and documents.  The  viewer  can  simultaneously  display
       several pages using a side-by-side or a continuous layout.

COMMAND LINE ARGUMENT AND OPTIONS
       This  program can run as a standalone program or as a slave process for
       the DjVu browser plugin nsdejavu.  When running as  a  standalone  pro‐
       gram, the command line argument argument can be:

       *  The filename of a valid DjVu document.

       *  A local DjVu document URL of the form:

	    file:///path/name.djvu[?djvuopts&keyword=value&...]

	  The  square  brackets	 delimit  the  optional components of the URL.
	  Various options can be specified using a syntax similar to  that  of
	  CGI arguments.  Specifying options in this manner is very useful for
	  a browser plugin because there are no command	 line  arguments.   In
	  the  case  of	 a  standalone viewer, all options can be specified as
	  command line arguments.

       *  An remote DjVu document URL of the form:

	    http://host/path/name.djvu[?djvuopts&keyword=value&...]

	    https://host/path/name.djvu[?djvuopts&keyword=value&...]

	  Browsing remote DjVu documents with the standalone  viewer  is  less
	  efficient than using the browser plugin.  The standalone viewer does
	  not benefit from the browser caching strategies and proxy  settings.
	  Proxy	 settings  for	the standalone viewer can be set independently
	  with the preferences dialog.

       An extensive list of options are recognized.  Most options can be spec‐
       ified as command line argument starting with the customary dash charac‐
       ter (-) or using the syntax of CGI arguments in the document URL.  Some
       options	however	 are only meaningful as command line arguments.	 Other
       options are only recognized when running the X11 version of the djview4
       program.

COMMAND LINE OPTIONS
       The following options are only meaningful when specified on the command
       line.

       -help  Display a brief help message.

       -verbose
	      Prints informational messages on the console.   This  option  is
	      very  useful because it displays messages about the unrecognized
	      constructs in the DjVu annotation and hyperlink layers.

       -fullscreen, -fs
	      Start djview4 in full screen mode.  Use the key ESC to exit  the
	      full screen mode.

       -slideshow[=arg]
	      Start  djview4 in slide show mode.  The optional numerical argu‐
	      ment arg specifies the number of	seconds	 before	 turning  each
	      page.  Use the key ESC to exit the slide show mode.

       -style=stylename
	      Specify the graphical user interface style.  The recognized val‐
	      ues for stylename depend on the  installed  version  of  the  Qt
	      toolkit.	 Common	 style	names  include	cde, motif, plastique,
	      platinum, and windows.

X11 OPTIONS
       The following command line options are recognized by the X11 version of
       the  djview4  program.	Unlike	most djview4 options, X11 options that
       demand an argument do not use the equal character  to  introduce	 their
       argument.

       -display displayname
	      Specify  that  the djview4 windows should appear on the X11 dis‐
	      play displayname.

       -geometry WxH+X+Y
	      Specify the initial size and position of the first window	 using
	      the  traditional X11 geometry specification syntax.  The numeri‐
	      cal arguments W and H represent the  initial  window  width  and
	      height.	The  numerical	arguments  X and Y indicate the window
	      position relative to the top left corner of the screen.

       -name name
	      Set the application name.

       -title title
	      Set the title of the first window.

       -fn fontname, -font fontname
	      Specify the name of the default font used for buttons and menus.
	      The  font should be specified using a X logical font description
	      string.

       -bg color, -background color
	      Specify the default background color for graphical  user	inter‐
	      face  elements.	The  color  should  be given as a standard X11
	      color name.

       -fg color, -foreground color
	      Specify the default foreground color for graphical  user	inter‐
	      face  elements.	The  color  should  be given as a standard X11
	      color name.

       -btn color
	      Specify the default button color.	 The color should be given  as
	      a standard X11 color name.

       -ncols count
	      Limit  the  number  of colors allocated on a 8 bit display.  The
	      default color cube contains 216 distinct colors.

       -cmap  Force the allocation of a private color map on a 8-bit  display.
	      This  might  increase  the color quality but cause flashing when
	      the viewer window gets activated.

GENERAL OPTIONS
       The following options can be specified as command line options  or  can
       be passed by augmenting the document URL using a syntax similar to that
       of CGI arguments

	  http://.../file.djvu?djvuopts&key=value&key=value&...

       In order to separate real CGI arguments from these options, the	viewer
       only recognizes keywords that appear after the word djvuopts.  The key‐
       words key are derived from the option names  by	removing  the  initial
       dashes.

       -page=pagename
	      Display  a  specific document page.  The viewer first searches a
	      page whose identifier matches the argument pagename.  Otherwise,
	      if pagename is a number preceded by character + or -, the viewer
	      performs a displacement relative to the  current	page.	Other‐
	      wise,  starting  from  the  current page and wrapping around, it
	      searches for a page whose title matches the  argument  pagename.
	      Otherwise,  if  pagename	is  numerical, it is interpreted as an
	      ordinal  page  number.   Otherwise,  and	finally,  the	viewer
	      searches a page whose name matches pagename.

       -pageno=pagenumber
	      The  page searching algorithm for option page can cause ambigui‐
	      ties when page titles can be interpreted as numbers.  The	 argu‐
	      ment  of	option pageno is always interpreted as an ordinal page
	      number.  This option is less portable than page  because	it  is
	      not  recognized  by  earlier  versions of the djvu plugin.  When
	      using this option is necessary, it is advisable to use both  the
	      page and pageno options.

       -zoom=zoomfactor
	      Specify  the  initial  zoom  factor.  Unless the toolbar, pop-up
	      menu and keyboard are disabled, the user will be able to	change
	      the  zoom	 factor.  Legal values for zoomfactor are shown in the
	      below:

		  ┌───────────────────────────────────────────────────────┐
		  │number    Magnification factor in range 10% to 999%.	  │
		  │one2one   Select the "one-to-one" mode.		  │
		  │width     Select the "fit width" mode.		  │
		  │page	     Select the "fit page" mode.		  │
		  │stretch   Stretch the image to the plugin window size. │
		  └───────────────────────────────────────────────────────┘
       -showposition=px,py
	      Specify a point in the current page that should be as  close  as
	      possible to the center of the window.  The horizontal and verti‐
	      cal positions px,py in the current page are given	 as  fractions
	      in  range	 0  to 1.  For instance, 0,0 designates the upper left
	      corner of the page, 0.5,0.5 is the center, and 1,1 is the	 lower
	      right corner.

       -mode=modespec
	      Specify the initial display mode.	 Unless the toolbar and pop-up
	      menu are disabled, the user will be able to  change  it.	 Legal
	      values for modespec are shown in the below:

		  ┌──────────────────────────────────────────────────────┐
		  │color   Display the color image.			 │
		  │bw	   Display the foreground mask only.		 │
		  │fore	   Display the foreground only.			 │
		  │back	   Display the background only.			 │
		  │text	   Overlay the hidden text over the color image. │
		  └──────────────────────────────────────────────────────┘
       -hor_align=keyword, -halign=keyword
	      Specify  the  horizontal position of the page in the viewer win‐
	      dow.  (This does not specify what	 part  of  the	page  will  be
	      shown,  but  rather how margins will be laid out around the page
	      in the plugin window.)  Argument keyword must be	left,  center,
	      or right.

       -ver_align=keyword, -valign=keyword
	      Specify  the vertical position of the page in the viewer window.
	      (This does not specify what part of the page will be shown,  but
	      rather how margins will be laid out around the page in the plug‐
	      in window.)  Argument keyword must be top, center, or bottom.

       -cache=(yes|no)
	      Enable or disable the caching of fully decoded pages of the doc‐
	      ument.   Caching	is  on by default.  Caching of documents whose
	      URL does not contain an  extension  .djvu	 or  .djv  is  off  by
	      default.

       -continuous=(yes|no)
	      Enable or disable the continuous layout of multipage documents.

       -sidebyside=(yes|no), -side_by_side=(yes|no)
	      Enable  or  disable  the	side-by-side layout of multipage docu‐
	      ments.

       -coverpage=(yes|no)
	      Specify whether the cover page must be displayed alone when mul‐
	      tipage documents are shown in side-by-side layout.

       -righttoleft=(yes|no)
	      Specify whether pages should be arranged right-to-left when mul‐
	      tipage documents are shown in side-by-side layout.

       -layout=keyword{,keyword}
	      Specify the layout settings using a single list  of  comma-sepa‐
	      rated keywords.  The following keywords are recognized:

	      ┌───────────────────────────────────────────────────────────────┐
	      │single	       Disable the side-by-side and continuous modes. │
	      │double	       Enable the side-by-side mode.		      │
	      │continuous      Enable the continuous mode.		      │
	      │cover,nocover   First page treatment in side-by-side mode.     │
	      │ltor,rtol       Layout direction for side-by-side mode.	      │
	      │gap,nogap       Specify whether there is a gap between pages.  │
	      └───────────────────────────────────────────────────────────────┘

       -scrollbars=(yes|no)
	      Enable  or  disable  the	presence  of scroll bars when the full
	      image size exceeds the plugin window size.  The default is yes.

       -frame=(yes|no)
	      Enable or disable the display of a thin frame and shadow	around
	      the DjVu images.	Frames are enabled by default.

       -background=color
	      Specify  the color of the background border displayed around the
	      document. The color color must be given in hexadecimal RRGGBB or
	      #RRGGBB format.

       -toolbar=keyword{(,|+|-)keyword}
	      Controls	the  appearance	 and the contents of the toolbar.  The
	      argument of option toolbar is composed of a number  of  keywords
	      separated by characters comma, plus or minus.  The appearance of
	      the toolbar is controlled by keywords placed  before  the	 first
	      occurrence  of a character plus or minus. The following keywords
	      are recognized in this context:

		┌───────────────────────────────────────────────────────────┐
		│no	  Disable toolbar.				    │
		│always	  Displays the toolbar.				    │
		│auto	  Enable toolbar "autohide" mode (not implemented). │
		│top	  Place toolbar along the top edge.		    │
		│bottom	  Place toolbar along the bottom edge.		    │
		└───────────────────────────────────────────────────────────┘
	      The contents of the toolbar is  controlled  by  keywords	placed
	      after  the  first occurrence of a character plus or minus.  Each
	      keyword adds (after a plus) or removes (after a minus) a partic‐
	      ular toolbar button or group of buttons.	The initial content of
	      the toolbar is determined by the first occurrence of a character
	      plus  or	minus.	 When this is a plus, the toolbar is initially
	      empty.  When this is a minus, the toolbar initially contains the
	      default selection of buttons.

	      The following keywords are recognized:

		  ┌───────────────────────────────────────────────────────┐
		  │modecombo   for the display mode selection tool.	  │
		  │zoomcombo   for the zoom selection tool.		  │
		  │zoom	       for the zoom buttons.			  │
		  │select      for the selection button.		  │
		  │rotate      for the image rotation buttons.		  │
		  │find	       for the text search button.		  │
		  │new	       for the new window button.		  │
		  │open	       for the open new document button.	  │
		  │save	       for the save button.			  │
		  │print       for the print button.			  │
		  │layout      for the page layout buttons.		  │
		  │pagecombo   for the page selection tool.		  │
		  │firstlast   for the first-page and last-page buttons.  │
		  │prevnext    for the previous- and next-page buttons.	  │
		  │backforw    reserved for the back and forward buttons. │
		  │help	       for the contextual help button.		  │
		  └───────────────────────────────────────────────────────┘
       For the sake of backward compatibility, the keywords fore, fore_button,
       back, back_button, bw, bw_button, color, and  color_button  are	inter‐
       preted  like  keyword  modecombo;  the keyword rescombo is a synonym of
       zoomcombo; the keywords pan, zoomsel, and textsel are interpreted  like
       keyword	select; and the keyword doublepage is interpreted like keyword
       layout.	All other keywords are ignored.

       -menubar=(yes|no)
	      Enable or disable the presence of the menu bar located on top of
	      the window.

       -statusbar=(yes|no)
	      Enable  or disable the presence of the status bar located at the
	      bottom of the window.

       -sidebar=keyword{,keyword}
	      Control the dockable panels.  The argument is a comma  separated
	      list  of keywords.  A first group of keywords selects which pan‐
	      els are affected.	 Omitting these keywords selects  all  panels.
	      A	 second group of keywords then controls the visibility and the
	      position of the selected panels.

	      ┌──────────────────────────────────────────────────────────────┐
	      │thumbnails	   specify the thumbnail panel.		     │
	      │outline,bookmarks   specify the outline panel.		     │
	      │search,find	   specify the search panel.		     │
	      ├──────────────────────────────────────────────────────────────┤
	      │yes,true		   show the specified panels (default).	     │
	      │no,false		   hide the specified panels.		     │
	      │left		   dock specified panels on the left side.   │
	      │right		   dock specified panels on the right side.  │
	      │top		   dock specified panels on the top side.    │
	      │bottom		   dock specified panels on the bottom side. │
	      └──────────────────────────────────────────────────────────────┘
       -thumbnails=keyword{,keyword}
	      Compatibility alias for -sidebar=keyword{,keyword},thumbnails.

       -outline=keyword{,keyword}
	      Compatibility alias for -sidebar=keyword{,keyword},outline.

       -menu=(yes|no)
	      Enable or disable the pop-up menu.

       -keyboard=(yes|no)
	      Enable or disable	 the  DjVu  plugin  keyboard  shortcuts.   The
	      default is yes (enabled).	 Note that disabling the keyboard han‐
	      dling does not disable  the  shortcuts  associated  with	active
	      menus  (see  options  -menu  and -menubar), visible toolbars and
	      sidebars (see options -toolbar and -sidebar).

       -mouse=(yes|no)
	      Enable or disable mouse interaction for panning  and  selecting.
	      The default is yes (enabled).

       -links=(yes|no)
	      Enable  or  disable  hyper-links in the DjVu image.  Hyper-links
	      are enabled by default.

       -highlight=x,y,w,h[,color]
	      Display a highlighted rectangle at the specified coordinates  in
	      the  current  page and with the specified color.	Coordinates x,
	      y, w, and h are measured	in  document  image  coordinates  (not
	      screen  coordinates).  The origin is set at the bottom left cor‐
	      ner of the image.	 The color color must be given in  hexadecimal
	      RRGGBB  or  #RRGGBB  format.   Multiple  highlighted zone can be
	      specified and can be interspersed with  multiple	-page=pagename
	      options.

       -find=text
	      Highlight	 occurrences  of  the  given string text.  This option
	      works when the document contains a hidden text layer. It can  be
	      used  in	conjunction  with  -sidebar=find  to  display the text
	      searching interface.

	      String text can be terminated by slash (/) followed  by  letters
	      specifying search options.  The following letters are recognized

		   ┌────────────────────────────────────────────────────┐
		   │c	Case-sensitive search.				│
		   │C	Case-insensitive search (default).		│
		   │w	Search hits start on word boundaries (default). │
		   │W	Ignore word boundaries.				│
		   │r	Regular expression search.			│
		   │R	String search (default).			│
		   └────────────────────────────────────────────────────┘
       -rotate=(0|90|180|270)
	      Rotate  the  djvu	 image	by  the	 specified  angle expressed in
	      degrees counter-clockwise.

       -print=(yes|no)
	      Enable or disable	 printing  the	DjVu  document.	  Printing  is
	      enabled by default.

       -save=(yes|no)
	      Enable  or  disable saving the DjVu document.  Saving is enabled
	      by default.

       -passive
	      Cause the DjVu image to be displayed in a manner similar	to  an
	      ordinary web image.  The default zoom factor is changed to page.
	      The toolbar, the status bar, the scrollbars, the menus, and  the
	      keyboard shortcuts are disabled.

       -passivestretch
	      Cause  the  DjVu image to be displayed in a manner similar to an
	      ordinary web image.  The	default	 zoom  factor  is  changed  to
	      stretch.	 The  toolbar,	the  status  bar,  the scrollbars, the
	      menus, and the keyboard shortcuts are disabled.

       -nomenu, -notoolbar, -noscrollbars
	      These options were recognized by some versions of the DjVu view‐
	      ers  and	are honored for the sake of backward compatibility.  A
	      warning message is printed when option -verbose is active.

       -logo, -textsel, -search
	      These options were recognized by some versions of the DjVu view‐
	      ers  but	are  currently	not implemented by djview4.  A warning
	      message is printed when option -verbose is active.

USAGE
       Most features can be accessed using the menus, the  toolbar,  the  side
       bar  or	the pop-up menu shown when the right mouse button is depressed
       over a DjVu image.  Detailled help can be accessed by clicking the con‐
       textual help icon from the toolbar and then clicking on various section
       of the djview user interface.

       The following table lists some useful key combinations recognized  when
       the djvu document is active:

	┌────────────────────────────────────────────────────────────────────┐
	│Key			 Action					     │
	├────────────────────────────────────────────────────────────────────┤
	│SHIFT+F1		 Activate the contextual help.		     │
	│1,2, and 3		 Change zoom to to 100%, 200% and 300%.	     │
	│Up, Down, Left, Right	 Scroll the image in the given direction.    │
	│Home			 Display top left corner of the image.	     │
	│End			 Display bottom right corner of the image.   │
	│Control+Home		 Go to the beginning of the document.	     │
	│Control+End		 Go to the end of the document.		     │
	│Space, Return		 Scroll down or go to next page.	     │
	│Backspace		 Scroll up or go to previous page.	     │
	│Page Down		 Go to the next page.			     │
	│Page Up		 Go to the previous page.		     │
	│+, -			 Zoom in and out.			     │
	│[, ]			 Rotate image.				     │
	│W			 Select the "Fit Width" zooming mode.	     │
	│P			 Select the "Fit Page" zooming mode.	     │
	│CTRL+F, F3		 Search the hidden text layer.		     │
	│CTRL+G			 Go to a specific page by name or by number. │
	└────────────────────────────────────────────────────────────────────┘
       Handy effects can be achieved by holding modifier keys.	Although these
       keys are configurable from the preference dialog, the  following	 table
       lists the default assignments

	   ┌─────────────────────────────────────────────────────────────┐
	   │Key		 Action						 │
	   ├─────────────────────────────────────────────────────────────┤
	   │CTRL+SHIFT	 Hold these keys to show the magnification lens. │
	   │CTRL	 Hold this key to select an area with the mouse. │
	   │SHIFT	 Hold this key to display all hyperlinks.	 │
	   └─────────────────────────────────────────────────────────────┘
ENVIRONMENT
       Setting	environment  variable  DJVIEW_VERBOSE  to  a  nonzero value is
       equivalent to calling djview with option -verbose.  Setting environment
       variable	 DJVIEW_OPENGL	to values 0 or 1 overrides the preference set‐
       tings regarding OpenGL rendering.

       When the user clicks on a djvu hyperlink pointing to a  web  page,  the
       program first tries to execute the web browser programs whose names are
       listed in the colon separated environment variable BROWSER, then	 tries
       sensible platform dependent defaults.

       The  user  interface  language  is determined by first trying to find a
       complete set of translation files for the  language  specified  in  the
       preference  dialog,  then  for  the  ISO 639 languages specified in the
       colon separated environment variable LANGUAGE, and finally the language
       specified  by  the system locale.  If all these searches fail, the user
       interface language reverts to the english default.

CREDITS
       This program was written by Léon	 Bottou	 <leonb@users.sf.net>  and  is
       distributed  under  the	GNU  General  Public  License.	 This  program
       includes code derived from program tiff2pdf, written by Ross  Finlayson
       and released under a BSD license.

SEE ALSO
       djvu(1), ddjvu(1), nsdejavu(1), djview3(1), tiff2pdf(1)

DjVuLibre			  10/11/2001			    DJVIEW4(1)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net