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

FreeBSD Manual Pages


home | help
GIST(1)			    General Commands Manual		       GIST(1)

       gist - browse binary cgm	graphics files

       gist [[ -in ] cgmfile ] [ page-number-list ] [ options ]

       Gist is a binary	CGM (Computer Graphics Metafile) browser.  It reads an
       input cgmfile and produces output to the	X  window  system,  PostScript
       files  (which can be printed using lpr(1)), or another binary CGM file.
       The cgmfile may be a family of CGMs; a family  is  recognized  whenever
       the final one or	two characters of the filenames	(excluding an optional
       trailing	 ".cgm")  are  digits  in  a  numerical	 sequence  (e.g.-  my-
       file00.cgm,  myfile01.cgm, myfile02.cgm,	etc.).	In this	case, the cgm-
       file argument should be the name	of the first file in the family;  gist
       will  automatically  hop	back and forth from file to file as necessary.
       (A single page must not be split	across files, and each file must be  a
       legal  CGM in its own right.)  When gist	opens a	CGM for	input, it must
       catalog the pages in the	file by	scanning  through  the	file  to  find
       them.   This  cataloguing operation takes place in the background while
       gist waits for your input.  Therefore, if you open a  large  family  of
       CGMs, gist will be able to display the first few	pages immediately, but
       if you ask for the last few pages, you will have	to wait	until the cat-
       alog  is	complete.  After gist has catalogued the input family, you can
       render any page without delay.

       -in cgmfile	   The -in is necessary	if and	only  if  the  cgmfile
			   name	begins with a digit or - sign.

       -ps psout	   to specify a	PostScript output file.

       -cgm cgmout	   to specify a	binary CGM output file.

       -display	host:server.screen
			   to  specify an X server connection.	If this	option
			   is not given, gist will use the DISPLAY environment

       -75		   create window(s) at 75 dpi (small window)

       -100		   create window(s) at 100 dpi (large window, default)

       -geometry WxH	   create  window(s)  with  specified width and	height
			   (in pixels)

       -gks		   create window(s) at 8x8 inches (default  6x6).   If
			   your	 cgm  file  was	NOT created by yorick(1), this
			   may be a better  guess  at  an  appropriate	window
			   size.   You	can  also resize the gist window using
			   your	window manager or -geometry.

       -nd		   to suppress the automatic display of	the first pic-
			   ture	when gist starts in interactive	mode

       -b		   to  run in batch mode (either -cgm or -ps must also
			   be specified, implies -nd)

       -f		   to run in filter mode, placing PostScript output on
			   stdout (implies -b)

       -x		   to run as a pure X window program (no keyboard)

       -fmbug		   to  compensate for a	bug in FrameMaker, reverse the
			   EPS preview top-for-bottom in  EPS  files.	But  I
			   recommend  using ghostscript(1) from	project	GNU to
			   convert gist's PostScript  output  files  into  EPS
			   files  instead  of  gist's EPS command, which makes
			   much	cruder preview images.

       -bg0fg1		   commercial packages which produce CGM files may use
			   color  index	 0 to mean background, index 1 to mean
			   foreground,	despite	 their	own  palette  --  this
			   switch compensates

       -nowarn		   suppress all	but first warning message

       is any number of	space-delimited	list elements; each element has	one of
       the following forms:

       m		   just	page m

       m-n		   pages m through n, inclusive

       m-n-s		   pages m through n in	 steps	of  s  Using  m<=0  or
			   n>=total number of pages is legal, causing the loop
			   to terminate	at the	end-of-file  (or  end-of-file-

       Thus,  pages 3, 5, 7, 9,	31, and	17 through 26 (in that order) would be
       specified as:
	3-9-2 31 17-26

       A page number list on the command line is most  useful  in  conjunction
       with the	-b or -f options.

       Unless  the  -b or -f options were specified, gist expects further com-
       mands from the keyboard,	or typed in its	X window.   Keyboard  commands

       open cgmfile	   open	a new CGM for input, closing the current input
			   CGM.	 This has no effect on any output device.

       quit		   finish and close any	output files, then exit.  Syn-
			   onyms for the quit command are exit and end.

       cgm cgmout [size]   create a new	output CGM.  If	size is	specified, the
			   file	will be	split into a family whose members  are
			   about  that size in bytes as	more frames are	added.
			   The default family member size is four megabytes.

       ps psout		   create a new	output PostScript  file.   The	lpr(1)
			   utility can print PostScript	files.

       display host:server.screen [dpi]
			   create  a  new  output X window.  The dpi (dots per
			   inch) can be	either 75 (a small window), or 100  (a
			   large window, the default).

       draw [page-number-list]
			   render the specified	pages on the "drawing" devices
			   (X windows by default).

       send [page-number-list]
			   render the specified	pages on the "sending" devices
			   (PostScript files and CGMs by default).

       info		   list	current	output devices and their states.  Also
			   prints the current input CGM	and page number.

       draw to dev1 [dev2...]
			   specify "drawing" devices; dev1,  dev2,  etc.,  are
			   device numbers printed by the info command.	By de-
			   fault, X windows are	the "drawing" devices.

       send to dev1 [dev2...]
			   specify "sending" devices; dev1,  dev2,  etc.,  are
			   device numbers printed by the info command.	By de-
			   fault, PostScript files and CGMs are	the  "sending"

       free dev1 [dev2 ...]
			   close  the  output  file  or	 X window; dev1, dev2,
			   etc., are device numbers printed by the  info  com-

       eps epsout	   create  an encapsulated PostScript file, render the
			   current page	there, then close it.  This command is
			   provided  only  for	sites  without the project GNU
			   ghostscript(1) program.  Ghostscript's ps2epsi com-
			   mand	 produces an infinitely	better preview bitmap.
			   If you are interested in this command,  get	ghost-
			   script; it's	free software.

       help [topic]	   prints  a summary of	these commands.	 If specified,
			   topic is one	of the command names;  gist  prints  a
			   more	detailed description of	that command.

       Any  of these commands may be abbreviated to the	shortest part of their
       name which is unique -- dr for draw, s for send,	etc.

       The following commands may be typed either in a gist X window or	at the
       keyboard	 prompt.  The n	is a prefix consisting of zero or more digits;
       if you do not specify n the default is always 1.

       nf    advance n pages and draw

       nb    back up n pages and draw

       ng    go	to page	n and draw

       s     send the current page to all "sending" devices

       q     quit

       If the -x option	is specified on	the command line, gist can be  run  in
       the  background	like  other X window programs.	In this	case, only the
       window commands will be recognized.

       To print	every page of a	CGM file family	myfile00.cgm:
	gist myfile00.cgm -f | lpr
       To print	only pages 3, 5, 7, 9, 31, and 17 through 26 (in that order):
	gist myfile00.cgm 3-9-2	31 17-26 -f | lpr

       To start	gist as	a pure X window	program,  with	output	to  PostScript
	gist myfile00.cgm -ps	-x &
       Type  the  f,  b	 or g commands in the gist graphics window to navigate
       through myfile00.cgm.  Use the s	command	to write the current page into; the q	command	quits.

       To use gist on foreign.cgm which	was not	generated by Yorick, try:
	gist -75 -gks -bg0fg1 foreign.cgm

       David H.	Munro, Lawrence	Livermore National Laboratory

       Y_SITE  refers  to  the	Yorick site directory; use the help command in
       yorick(1) to find its name at your site:

       Y_SITE/gist/*		graphics style	sheets,	 palettes,  and	 Post-
				Script template

       Gist  is	 designed  to  convert	yorick(1) binary CGM output files into
       PostScript perfectly.  That is, running a  yorick  binary  CGM  through
       gist  will  produce  exactly the	same PostScript	file (and X window) as
       yorick would have produced directly.

       However,	the ANSI CGM standard is not a page description	language  like
       PostScript.   Therefore,	 non-yorick  CGMs may or may not be acceptably
       rendered	by Gist.  The -gks and -bg0fg1 options may help, but  you  can
       expect  fonts, polymarkers, and line styles to look different with Gist
       than with other CGM browsers (.e.g- idt from NCAR graphics).

       If gist cannot find the PostScript  template  Y_SITE/gist/,	 Post-
       Script output will not work.

       You  can't  use multiple	X windows to compare two different pages (they
       all display the same page).  Start a second copy	of gist.

       On pseudocolor displays,	a color	image may  require  you	 to  move  the
       mouse  into  gist's  X  window to display properly.  Unless your	window
       manager allows you to set colormap focus	independently of keyboard  fo-
       cus, this can be	annoying.


4th Berkeley Distribution	1994 August 30			       GIST(1)


Want to link to this manual page? Use this URL:

home | help