man tgif Command

Man page for apt-get tgif Command

Man Page for tgif in Linux

Ubuntu Man Command : man tgif

Man Tgif  Command

This tutorial shows the man page for man tgif in linux.

Open terminal with 'su' access and type the command as shown below:
man tgif

Result of the Command Execution shown below:

tgif(1)                                                                tgif(1)



NAME
tgif Xlib based interactive 2 D drawing facility under X11. Supports
hierarchical construction of drawings and easy navigation between sets
of drawings. It's also a hyper graphics (or hyper structured graphics)
browser on the World Wide Web.

SYNOPSIS
tgif [ display displayname] [ fg ] [ bg ] [ bd ]
[ rv] [ nv] [ bw] [ reqcolor] [ cwo[+sbwarp]] [ hyper] [ exec ]
[ dbim {xcin|chinput|xim|kinput2|tgtwb5[,font]}] [ sbim xim] [ usexlib]
[ a4] [ listdontreencode] [ version] [ pdfspd | pdfspd=true | pdf
spd=false ] [ pssetup "" ] [ nomode] [ geometry ]
[=] [{file[.obj]| merge file1[.obj] file2[.obj] ...}]

or

tgif print [ eps] [ p] [ ps] [ f] [ text] [ epsi] [ tiffepsi] [ gif]
[ png] [ jpeg] [ ppm] [ pbm] [ xpm] [ xbm] [ html] [ pdf] [ netlist]
[ display displayname] [ stdout] [ raw[+h[eaderonly]]] [ dosepsfilter
[ previewonly]] [ status] [ gray] [ color | reqcolor] [ adobe |
adobe=/ | adobe=false ] [ dontreencode= |
listdontreencode] [ version | justversion] [ producedby=]
[ page ] [ print_cmd ""] [ one_file_per_page] [ pepsc]
[ pdfspd | pdfspd=true | pdfspd=false ] [ pssetup "" ]
[ j2p6_cmd "" ] [ dontcondense | condensed] [ a4] [ noshow
pageineps] [ quiet] [ bop_hook ""] [ eop_hook ""]
[ tmp_file_mode ""] [ o] [ exec ] [file1[.obj]
file2[.obj] ...]

DESCRIPTION
Tgif is an interactive drawing tool that allows the user to draw and
manipulate objects in the X Window System. Tgif runs interactively in
the first form. In the second form shown in the SYNOPSIS section, tgif
just prints file1.obj, file2.obj, etc. (generated by tgif) into Post
Script(TM) page description files (without opening windows or fonts)
and pipes them to lpr(1) if none of the eps, p, epsi, tiffepsi,
gif, png, jpeg, ppm, pbm, xpm, xbm, html, pdf, ps, f, text,
or netlist options are specified. This form of printing is tgif's way
of exporting a tgif file to another format. In this case, any other
unrecognized command line options are sent to lpr(1). In this mode,
tgif is compatible with the obsoleted prtgif. A symbol file (see
descriptions below) can also be printed by specifying the .sym exten
sion explicitly.

The command line argument file specifies a file or an Uniform Resource
Locator (URL) of objects to be initially edited by tgif. Only HTTP or
FTP URL's are supported. (For a more detailed description of URL and
the World Wide Web, the reader is referred to [1].)

Tgif is purely based on Xlib. It is tested under X11R6, and it
requires a 3 button mouse.

OPTIONS
In the first form shown in the SYNOPSIS section, the command line argu
ments can be:

fg Foreground color specified in .

bg Background color specified in .

bd Border color specified in .

rv Start tgif in reversed video mode.

nv Start tgif in normal video mode.

bw Start tgif in black and white mode.

reqcolor
Same effect as setting the Tgif.PrintUsingRequestedColor X
default to true (see the X DEFAULTS section below).

cwo Canvas Window Only. Only the canvas window (see TGIF SUBWINDOWS
section below) will be displayed. This has the same effect as
setting the Tgif.CanvasWindowOnly X default to true.

cwo+sbwarp
If cwo+sbwarp is used, single button warp (clicking the left
mouse button to warp) is used to activate teleporting (see TELE
PORT/HYPERJUMP section below).

hyper Start tgif in the hyperspace mode (see HYPERSPACE section
below).

exec
After tgif starts, execute the internal command in (see
INTERNAL COMMANDS section below). If is the string " ",
tgif executes internal commands from the standard input.

dbim method
Use method as the input method for double byte fonts (see SQUARE
DOUBLE BYTE FONTS section below). This cannot be used in con
junction with sbim.

sbim method
Use method as the input method for single byte fonts. This is
useful if the X Keyboard Extension is used in inputing interna
tional characters (with dead keys). This cannot be used in con
junction with dbim.

usexlib
If tgif is compiled with DUSE_XT_INITIALIZE, X Toolkit initial
ization routines will be used to setup tgif. Using this command
line option will force tgif to ignore the DUSE_XT_INITIALIZE
compiler option and use Xlib only. This is useful when the sys
tem resource file for tgif is not installed properly or messed
up and needs to be bypassed.

a4 Using this option has the same effect as setting the
Tgif.PSA4PaperSize X default to true.

noshowpageineps
Using this option has the same effect as setting the Tgif.Show
PageInEPS X default to false.

quiet If this option is used, tgif will surpress standard messages.

listdontreencode=
If this option is used, tgif will print out the list of Post
Script font names specified in the D_DONT_REENCODE compiler
option used in compiling tgif.

In the second form shown in the SYNOPSIS section, the command line
arguments can be:

version
If this option is used, tgif will print out its version number
and copyright on the command line.

justversion
If this option is used, tgif will print out its version number
and copyright on the command line and exits immediately.

nomode
Using this option has the same effect as setting the Tgif.NoMod
eWindow X default to true.

eps (or p)
Generates an Encapsulated PostScript(TM) file in file.eps; this
file can be included in a LaTeX file through the \psfig, psf,
or \psfile construct (see the LATEX FIGURE FORMATS section
below).

ps (or f)
Generates a PostScript file in file.ps; this file can be printed
to a PostScript printer with lpr(1).

text Generates a text file in file.txt; the text file contains all
visible text and can be fed to a spell checker.

epsi Generates an Encapsulated PostScript (EPS) file with a preview
bitmap in file.eps. Tgif aborts if a valid display is not
accessible.

tiffepsi
Generates an EPS file with a DOS EPS Binary File Header and a
trailing TIFF image in file.eps. See the GENERATING MICROSOFT
WINDOWS EPSI FILES section for more details. Tgif aborts if a
valid display is not accessible.

gif Generates a GIF file in file.gif. Please see the notes for
Tgif.GifToXpm in the X DEFAULTS section below. Tgif aborts if a
valid display is not accessible.

png Generates a PNG file in file.png. Tgif aborts if a valid dis
play is not accessible.

jpeg Generates a JPEG file in file.jpg. Tgif aborts if a valid dis
play is not accessible.

ppm Generates a PPM file in file.ppm. Tgif aborts if a valid dis
play is not accessible.

pbm Generates a PBM file in file.pbm. Tgif aborts if a valid dis
play is not accessible.

xpm Generates an X11 pixmap (XPM) file in file.xpm. Tgif aborts if
a valid display is not accessible.

xbm Generates an X11 bitmap (XBM) file in file.xbm. Tgif aborts if
a valid display is not accessible.

html Generates a GIF file in file.gif and an HTML file in file.html.
Tgif aborts if a valid display is not accessible.

pdf Generates a GIF file in file.gif and an PDF file in file.pdf.
Please see the notes for Tgif.PsToPdf in the X DEFAULTS section
below.

netlist
Generates a text file in file.net and a text file in file.cmp.
file.net contains netlist information stored in a table. The
first line in it contains column names and each line in it is a
port name (surrounded by double quotes), followed by a comma and
a character, followed by a signal name (also surrounded by
double quotes). file.cmp contains information about components
in the file. Each component begins with its name followed by
its type. The attributes of a component are printed afterwards
(indented by characters).

stdout
Sends the output to the standard output instead of generating
the output in a file.

raw Causes the content of the files to be dumped to stdout.

raw+h If raw+h is used and if the file is an HTTP URL, the HTTP
header is also dumped to stdout.

raw+headeronly
If raw+headeronly is used and if the file is an HTTP URL, the
HTTP header is dumped to stdout.

dosepsfilter
Makes tgif act as a filter for getting rid of the DOS EPS Binary
File Header and the trailing TIFF image in a DOS/Windows EPS
file.

previewonly
If dosepsfilter is specified, previewonly makes tgif act as a
filter for extracting the preview bitmap from the trailing TIFF
image in a DOS/Windows EPS file.

status
If this option is used in conjunction with either raw, raw+h,
or raw+headeronly causes a status line to be displayed in
stderr.

gray Using this option has the same effect as setting the Tgif.UseG
rayScale X default to true (see the X DEFAULTS section below).

color (or reqcolor)
To print in color, one can use either the color or the req
color option. The only difference between the two is that using
reqcolor has the same effect as setting the Tgif.PrintUsingRe
questedColor X default to true (see the X DEFAULTS section
below).

adobe (or adobe=/ adobe=false)
Using this option has the same effect as specifying the
Tgif.UsePsAdobeString X default.

dontreencode=
Using this option has the same effect as specifying the
Tgif.DontReencode X default.

producedby=
Using this option has the same effect as specifying the
Tgif.ProducedBy X default.

page Causes a specified page (specified by ) to be printed.

print_cmd
Using this option has the same effect as specifying the
Tgif.PrintCommand X default.

one_file_per_page
Causes each page to be printed into a separate file.

pepsc Preserve EPS Comment. This command line option is obsoleted
since EPS comments are always preserved starting from
tgif 4.0.11.

nolandpdfspd
This commandline option became obsolete in tgif 4.1.42. It is
interpreted as nopdfspd.

pdfspd (or pdfspd=true pdfspd=false)
If pdfspd or pdfspd=true is specified, "setpagedevice" is gen
erated in the interim PostScript file when exporting PDF files
or in the final PostScript file when exporting PS files. If
pdfspd=false is specified, no "setpagedevice" will be generated
in the interim PostScript file when exporting PDF files or in
the final PostScript file when exporting PS files. This option
overrides the Tgif.PdfSetPageDevice X default.

pssetup
Using these options have the same effect as specifying the
Tgif.AdditionalPSSetup X default.

j2p6_cmd
Using this option has the same effect as specifying the
Tgif.JpegToPpm6 X default.

dontcondense
Using this option has the same effect as setting the Tgif.Dont
CondensePSFile X default to true.

condensed
Using this option has the same effect as setting the Tgif.Dont
CondensePSFile X default to false.

bop_hook and eop_hook
Using these options have the same effect as specifying the
Tgif.PSBopHook and Tgif.PSEpsHook X defaults.

tmp_file_mode
Using this option have the same effect as specifying the
Tgif.TmpFileMode X defaults.

o If this option is not specified, the output file (eps, ps, etc.)
goes into the same directory as the input file. If odir is
specified, the output file goes into the directory specified by
.

merge file1 file2 ...
Using this option merges file1.obj, file2.obj, etc. into a mul
tipage file.

BASIC FUNCTIONALITIES
Primitive objects supported by tgif are rectangles, ovals, rounded cor
ner rectangles, arcs, polylines, polygons, open splines, closed
splines, text, X11 bitmaps, some specific forms of X11 pixmaps, and
Encapsulated PostScript. (Please note that the splines tgif draw are
not Bezier curves.) Objects can be grouped together to form a grouped
object. A primitive or a grouped object can be made into an icon
object or a symbol object through user commands.

Tgif objects are stored in two types of files. A file with a .obj
extension (referred to as an object file) is a file of objects, and a
file with a .sym extension (referred to as a symbol file) specifies a
``building block'' object. A teleport mechanism is provided to travel
(or hyperjump) among the .obj files. A building block object consists
of the representation part and the definition part (which can be empty)
of the object. Tgif supports the ``bottom up'' construction of hierar
chical drawings by providing the capability to ``instantiate'' a build
ing block object in a drawing. Tgif also supports the ``top down''
specification of drawings by allowing the user to make any object a
representation of an un specified subsystem. Both types of files are
stored in the form of Prolog facts. Prolog code can be written to
interpret the drawings! (It is left to the user to produce the code.
See the PROLOG/C TESTDRIVE section for more details.) Prolog engines
are referred to as drivers in the sections to follow. (Other types of
drivers are also allowed, e.g., written in C.)

Text based attributes can be attached to any non text object.
Attributes specified in the representation part of a building block
object are non detachable when such an object is instantiated. See the
ATTRIBUTES section for details.

Tgif can generate output in a few different formats. By default, the
output is in the PostScript format (color PostScript is supported), and
it is generated into a file named /tmp/Tgifa* (produced by mktemp()
calls) where * is a number; this file is piped to lpr(1). This takes
place when the laser printer icon is displayed in the Choice Window
(see the TGIF SUBWINDOWS section for the naming of tgif windows). This
output can be redirected to a file with a .ps extension. This takes
place when the PS icon is displayed in the Choice Window. When the PDF
icon is displayed in the Choice Window, the output is generated into a
file with a .pdf extension. By default, tgif calls ps2pdf(1) from the
ghostscript(1) package to convert a PS file to a PDF file. When the
LaTeX (or EPSI) icon is displayed in the Choice Window, the output is
generated into a file with a .eps extension. This file is in the
Encapsulated PostScript (or Encapsulated PostScript Interchange) for
mat; it can be included in a LaTeX document with the \psfig or the
psf construct; this will be discussed later. The only difference
between the EPS and EPSI formats is that an EPSI file contains a pre
view bitmap. However, it takes time to generate the preview bitmap.
If the EPS/EPSI file is to be incorporated into some tool that does not
know how to use the preview bitmap, time can be saved by not using the
EPSI format. When the T icon is displayed in the Choice Window, the
output generated into a file with a .txt extension. This is a text
file containing all visible text; it can be fed to a spell checker.
When the x11bm (X11 bitmap) icon is displayed in the Choice Window and
color output is not selected, tgif generates the output with the .xbm
extension; the output is in the X11 bitmap format. However, if the
x11bm icon is displayed in the Choice Window and color output is
selected (through the ^


Related Topics

Apt Get Commands