dvifb(1)


NAME

   tmview,  dvisvga,  dvifb,  dvilx  - view DVI files on SVGA, framebuffer
   devices or X Window displays

SYNOPSIS

   dvi[svga|fb|lx]  [-?]    [-h<marg>]   [-v<marg>]   [-p<width>x<height>]
   [-r<xres>x<yres>]    [-f<path>]    [-n<name>]   [-t<path>]   [-q<path>]
   [-d<width>x<height>]                                          [-m<mag>]
   [-k<leftmarg>,<rightmarg>,<uppermarg>,<lowermarg>]   [-s<startup-file>]
   [file[.[dvi]]

DESCRIPTION

   tmview is a screen-previewer for .dvi-files generated by TeX.  It  lets
   you  see  what  your  printed  output  will  look like.  You can choose
   between a  black-and-white  representation  and  greyscaling.  You  can
   choose   an  arbitrary  zoomfactor.   You  can  set  marks  to  measure
   distances.  You can search for textstrings.  tmview  does  not  support
   pxl-files since I think they are prehistoric. tmview ignores almost all
   special-commands, sorry lads.  There is basic  support  for  .vf-files.
   If  there  occur  any problems with this, use dvicopy to get a .vf-free
   .dvi-file.  tmview tries its best with included .eps-figures.   dvisvga
   is  a version of tmview based on svgalib for use with (s)vga equipment.
   dvifb is a version of tmview  writing  on  the  "/dev/fb0"  framebuffer
   devive.  dvilx goes with the X Window System.

   Try  dvisvga/dvifb/dvilx  -?  to  get  a  complete list of command-line
   options and their default-values.

   ONLINEHELP
   Pressing <?> twice shows the onlinehelp and gives a list  of  available
   commands.  However, you may check the cursor-keys and <+>/<-> first ...
   or use <q> to quit.

   IMPORTANT
   All options have to be followed  IMMEDIATELY  by  their  arguments,  NO
   spaces must be inserted !!!

   OPTIONS
   -h (horizontal-offset)
          A  lot  of  printer drivers do a horizontal offset of 1 inch. If
          yours does as well, you should use -h25.4. The length  following
          -h must be given in mm. Default: "25.4"

   -v (vertical-offset)
          A  lot  of  printer  drivers  do a vertival offset of 1 inch. If
          yours does as well, you should use -v25.4. The length  following
          -v must be given in mm. Default: "25.4"

   -p (Paper-size)
          Tells  tmview  width  and height of the paper you are using. The
          width is given first and both width and height are given in  mm.
          Width and height are seperated by an "x". Default: "210.0x297.0"
          (german DIN A4)

   -r (Resolution)
          Tells tmview what  kind  of  pk-files  to  use.  The  horizontal
          resolution  is  given  first  and  both  horizontal and vertical
          resolution are given in dpi (dots per inch). The two values  are
          seperated  by  an  "x".  Saying  -r600x600 means tmview will use
          fonts which were generated  for  a  600-dpi-printer.  As  tmview
          assumes  that  pixels on the screen are square, different values
          for  horizontal  and  vertical  resolution  will  result  in   a
          distorted  image.  Always  make  sure  the  desired pk-files are
          available.  The chosen resolution determines the (maximum)  size
          of the representation.  Default: "300x300"

   -f (Font-path)
          A  list  of paths telling tmview where to look for the pk-files.
          The items in this list have to be seperated by  :'s.  The  given
          list is executed from left to right. If an item ends with // all
          subdirectories will be scanned too. This is programed in a  very
          odd  way,  so it takes lots of time. You should place such items
          at the end of the list.  Defaults: "./:/usr/lib/texmf/fonts//".

   -n (Name-of-the-font-file)
          If  your  dvi-file  tells  tmview   to   use   a   font   called
          "thisnthatfont" and tmview was told to use a resolution of "123"
          dpi, tmview has to know how the desired file is  named.  In  the
          string following "-n" the following replacements are made:

             xx   replaced by
             @N   thisnthatfont
             @K   thisntha
                  (this is @N reduced to 8 char. (MS-DOG !))
             @M   123
                  (the resolution)
             @R   615
                  (this is @M*5, intended for magnified 200
                   dpi fonts used instead of 300 dpi fonts)

          Defaults: "@N.@Mpk"

   -t (tfm-path)
          A  list of paths telling tmview where to look for the tfm-files.
          The items in this list have to be separated by  :'s.  The  given
          list  is  executed  from  left  to right. tfm-files are used, to
          figure out  the  encoding.  Therefore  they  are  essential  for
          searching text to work.  Defaults: "./:usr/lib/texmf/fonts//".

   -q (vf-path)
          A   list   of  paths  where  to  look  for  vf-files.  Defaults:
          "./:usr/lib/texmf/fonts//".

   -d (Display)
          Size desired resolution of your display (dvisvga). The width  is
          given first and both width and height are given in pixels. Width
          and height are seperated  by  an  "x".  Using  svgalib  you  may
          choose  a  resulution  supported by your version with respect to
          your hardware.  dvisvga prefers 256-color-modes. Hence,  to  get
          more  than  320x200 an super vga chipset supported by svgalib is
          required, standard vga wont do.  If the  desired  resolution  is
          not available, dvisvga falls back to 640x480 at 256 colors, then
          to 640x480 at 16 colors.  The framebuffer version dvifb  ignores
          this  option.  Use  the  program fbset to set up the framebuffer
          device before  starting  tmview.   Using  the  X  Window  System
          (dvisvga)  \verb+-d+ will suggest the size of the tmview window.
          However,   you    may    alternatively    use    the    resource
          \verb+DviLX.geometry+    or   the   standard   geometry   option
          \verb*-geometry    widthxheigth+x+y*.     Defaults:    (dvisvga)
          "640x480"

   -m (magnification)
          If  you want to magnify by a factor n you have to specify n*1000
          as an argument to -m, e.g. -m2000  means  all  lengths  will  be
          doubled.   NOTE: tmview magnifies according to the origin of the
          dvi-coordinates, which is -in most cases-  NOT  the  upper  left
          corner  of  the paper. Always make sure the desired pk-files are
          available. -m doesn't magnify the paper, so if you wish a larger
          image  use  the  +  and  -  keys  or the -r option. Default: get
          magnification from dvi-file.

   -k (kannot-print-any-further)
          Most printers stop printing if they are too close at the  papers
          edge  (some  might  even  do  strange  things).  The  -k  option
          describes the  printable  area,  e.g.  saying  -k1.0,2.0,3.0,4.0
          means that your printer can print as close as 1 mm to the left 2
          mm to the right 3 mm to the upper 4 mm to the lower edge of  the
          paper.  These  values  are  used  to draw a frame indicating the
          printable area. All four values have to be given and  they  have
          to  be  seperated  by ",". All lengths are given in mm. Default:
          "4.0,4.0,4.0,12.0"

   -s (startup-file)
          tmview reads default values for the commandline-options, a  list
          of  visited  dvi-files  and  lots of other interna from a system
          startup-file,   typically   "/etc/dvisvga",   "/etc/dvifb"    or
          "/etc/dvilx".   After this a user startup-file is read. The name
          of the latter can be  specified directly  after  the  -s.   When
          quitting  tmview,  the current options etc. will be saved in the
          user startup-file.  If this is not desired,  the  user  startup-
          file  has  to  be  set  read-only !!  However, tmview will never
          write to the system startup-file.  The default the  user  start-
          upfile is "~/.dvisvga", "~/.dvifb" or "~/.dvilx".

COPYING

   The  code of tmview uses some rather basic ideas stolen from xdvi. This
   includes some few lines of code just copied. The author of xdvi is Eric
   Cooper.  In  a  similar  kind,  tmview's  code depends on some lines of
   dvidjc, written by Wolfgang R.Mueller.  The hyper-TeX related parts are
   taken  from  xhdvi,  written by Arthur Smith.  The sources of the above
   can be found on the CTAN. So by having mentioned the authors here,  and
   giving  a reference how to get the original sources, this should not be
   a violation of their copyrights.

   As far as I am concerned, tmview may be modified or distributed without
   any  restrictions.  tmview  is  distributed in the hope that it will be
   useful, but without any warranty.

AUTHOR

   (C)opyright 1995 Thomas Moor (QElis@aol.com)

                             1 March 2001                        TMVIEW(1)





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.