eqn2graph - man pages section 1: User Commands

Language:

eqn2graph (1)

Name

eqn2graph - convert an EQN equation into a cropped image

Synopsis

eqn2graph [ -unsafe ] [ -format fmt ]

Description




User Commands                                        EQN2GRAPH(1)



NAME
     eqn2graph - convert an EQN equation into a cropped image

SYNOPSIS
     eqn2graph [ -unsafe ] [ -format fmt ]

DESCRIPTION
     Reads an EQN equation (one line) as input; produces an image
     file (by default in Portable Network Graphics format)  suit-
     able for the Web as output.

     Your  input  EQN  code  should not have the .EQ/.EN preamble
     that that normally precedes it within groff(1)  macros;  nor
     do  you  need to have dollar-sign or other delimiters around
     the equation.

     The output image will be a black-on-white graphic clipped to
     the  smallest  possible  bounding  box that contains all the
     black pixels.  By  specifying  command-line  options  to  be
     passed to convert(1) you can give it a border, set the back-
     ground transparent, set the image's pixel density,  or  per-
     form other useful transformations.

     This  program  uses  geqn(1),  groff(1), and the ImageMagick
     convert(1) program.  These programs  must  be  installed  on
     your  system  and  accessible on your $PATH for eqn2graph to
     work.

OPTIONS
     -unsafe
          Run groff(1) in the  `unsafe'  mode  enabling  the  PIC
          macro sh to execute arbitrary commands.  The default is
          to forbid this.

     -format fmt
          Specify an output format; the default is PNG  (Portable
          Network Graphics).  Any format that convert(1) can emit
          is supported.

     Command-line switches and arguments  not  listed  above  are
     passed to convert(1).

FILES
     /usr/share/groff/1.19.2/tmac/eqnrc
          The geqn(1) initialization file.

ENVIRONMENT
     GROFF_TMPDIR
          The directory in which temporary files will be created.
          If this is not set eqn2graph searches  the  environment
          variables  TMPDIR, TMP, and TEMP (in that order).  Oth-
          erwise, temporary files will be created in /tmp.



Groff Version 1.19.Last change: 27 October 2003                 1






User Commands                                        EQN2GRAPH(1)



ATTRIBUTES
     See  attributes(5)  for  descriptions   of   the   following
     attributes:

     +---------------+------------------+
     |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
     +---------------+------------------+
     |Availability   | text/groff       |
     +---------------+------------------+
     |Stability      | Uncommitted      |
     +---------------+------------------+
SEE ALSO
     pic2graph(1),  grap2graph(1), geqn(1), groff(1), gs(1), con-
     vert(1).

AUTHOR
     Eric S. Raymond <esr@thyrsus.com>.



NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community       source       was       downloaded       from
     http://ftp.gnu.org/gnu/groff/groff-1.19.2.tar.gz

     Further  information about this software can be found on the
     open source community  website  at  http://www.gnu.org/soft-
     ware/groff/.


























Groff Version 1.19.Last change: 27 October 2003                 2