The following list details the MGv application resources. Each resource name is followed by its type and the resource class name in parentheses.
Anti-aliasing graphic images (which seems to be what most EPS files contain) will often produce a poorer quality display and significantly increase the rendering time. If you find yourself disabling anti-aliasing by hand whenever you open an EPS file, then this resource is for you. If you disable anti-aliasing globally, then this resource is irrelevant. If you enable anti-aliasing globally, then this resource is only relevant if its value is False; in this case, anti-aliasing will automatically be disabled when you load an EPS file and, of course, reset to the previous state when you load a non-EPS file. The default value is True which means that EPS files will be treated like any other PostScript file so that anti-aliasing of EPS files will be controlled by the antialias resource of the Ghostview widget.
This resource holds the application version number. MGv uses the value of this resource to check the version of the application defaults files that gets used. If the incorrect version is found, MGv will warn you to expect strange behavior. If this occurs, then you have the wrong version of the application defaults installed somewhere and you should remove or replace it.
You should never alter the value of this resource.
If the this resource is True then MGv will attempt to make the main window tall enough to display an entire page; your window manager may refuse the request but MGv will try anyway. This resource is False by default.
If the this resource is True then MGv will attempt to make the main window wide enough to display an entire page; your window manager may refuse the request but MGv will try anyway. This resource is True by default.
If this resource is True and you have multiple top level viewing windows when you issue an exit request (through the Exit entry in the File menu), you will be prompted to confirm that you really meant it; note that this resource only has an effect when you have more than one viewing window. The default is True.
This resource contains the command (including arguments) that will be used to decompress compressed files; the command must read from the standard input and write to the standard output. By default this resource is set to "gzip --stdout --decompress".
This resource sets the media for documents that do not specify
one with a %%BoundingBox
or
%%PageMedia
comment.
All of the values in the
Media Menu
are valid values for this resource and the values are case
insensitive. The default is Letter.
If this resource is True then the Ghostscript message log will be hidden by default. Any errors from Ghostscript will force the log to be displayed. Messages from Ghostscript will be logged even if the log is hidden. The default value is True. Note that the log does not exist until there is something to put in it.
This resource controls the initial state of the menu bar; if set to True, the menu bar will be hidden at start up and the menu bar will be visible at start up if this resource is False. The default value is False.
When this resource is False, the page list will be visible at start up and the page list will be hidden if this resource is set to True. The default value is False.
If this resource is True, the status line will be hidden at start up; if this resource is False, the status line will be visible at start up. The default value is False.
When this resource is True, all child processes (which for now are just the HTML browsers) will be killed, using SIGTERM, when MGv exits; if this resource is False, then the children will be left alone. Note that Ghostscript children will always be killed. By default this resource is True.
This resource specifies the number of consecutive attempts to scroll beyond the page boundaries that are needed before magic scrolling takes effect. This resource has no effect if magic scrolling is not enabled. The absolute value of this resource is used. If you want no resistance at all (i.e. magic happens as soon as you try to exceed the page boundary), use a value of zero. The default value is 2 (i.e. the second attempt succeeds).
The documentation for the mgvScroll contains some more notes about scrolling in general.
When this resource is True, MGv will move to the next page if you try and scroll down at the bottom of a page and move to the previous page if you try and scroll up at the top of a page. You can change this behavior at run-time via the Option menu. The default value is True.
This resource specifies the initial magstep. The default value is zero.
The command for your printer spooler.
If you don't specify this resource, MGv will attempt to determine
it automatically by looking for lp in your PATH environment
variable and if lp cannot be found, it will search for lpr.
The printer command should contain a %s
where the actual
printer name should go.
The
print dialog allows you to change
the print command.
This resource specifies the name of the printer to use. If you don't specify this resource, MGv will attempt to read the contents of the LPDEST environment variable and then the PRINTER environment variable. If neither of these variables is set, the default value will be ps. The print dialog allows you to change the printer name.
If this resource is True, then the scrollbars on the viewing window will be moved back to their home positions (i.e. the upper left corner of the page will be visible) whenever you change pages, otherwise, the visible region will be unchanged when you change pages. Note that changing the orientation or media type will always reset the scrollbars. The default value is True.
This resource specifies the foreground color for the zoom selection reticule; the reticule is drawn in xor mode so it should always be visible. The default value is red.
This resource specifies the width of the lines used to draw the zoom selection reticule. The default value is 2.
This resource controls how far the page will move when you scroll with the mgvScroll action (i.e. the keyboard but not the little buttons on the scrollbars). A value of 100% will scroll a whole window height/width while a value of 90% (the default) will leave a little bit of overlap for context. If the value you specify has a trailing percent sign ("%"), then it will be interpreted as a percentage (i.e. the value will be divided by 100), otherwise, the value will be considered a raw floating point value. For example: 75%, .75, and 7.5e-1 all represent the same value.
This resource controls how smart the automatic sizing will be. If this resource is True, then MGv will attempt to keep the window smaller than the screen during automatic resizing; if False, MGv will leave this task to your window manager. The default is False since this stuff is really your window manager's problem.
You should only need to use the smartSizing resource if your window manager allows windows to exceed the screen size. If you need to use this resource, you should set the wmWidth and wmHeight resources since there is no sane way to get determine how large the window manager decorations are.
If this resource is True then the page labels, if any, will be displayed in the page list; if showPageNumbers is also True then both will be displayed. The default value is False.
If this resource is True then the page numbers, if any, will be displayed in the pagelist; if showLabels is also True then both will be displayed. The default value is True.
This resource controls the smooth scrolling in the main viewing window. When smooth scrolling is enabled, scrolling with the mgvScroll action (i.e. with the arrow keys but not the little buttons on the scrollbars) will scroll the screen a couple pixels at a time with an update after each movement; this will give the scrolling a smoother appearance than the normal scrolling. When smooth scrolling is disabled, the normal scrolling is performed. Smooth scrolling makes it much easier to keep track of where you are on the page but it is slower: caveat emptor. Smooth scrolling can be turned on and off at run time from the Options menu. Smooth scrolling is enabled by default.
This resource controls how smooth smooth scrolling will be; the normal increment (see the scrollPercentage resource) is divided by the value of this resource to determine how many pixels to scroll between screen updates. Larger values will yield smoother scrolling but will take more time. Values between 20 and 30 tend give fairly good results (this is dependent on how fast your machine and X server are). The default value is 25.
This resource specifies where temporary files should be stored. If this resource is not specified, MGv will use the directory specified in first available source from the following list:
stdio.h
)./tmp/
.This resource specifies the width (both sides combined) of the
window manager decorations. You will only need to care about
this resource if you need to use the
smartSizing resource. The default value of
12 is most likely incorrect for your system; the easiest
way of finding the correct value is to run
"xwininfo
" and
" xwininfo -frame
" and use the difference between
the reported Width values.
This resource specifies the height (top and bottom combined) of the
window manager decorations. You will only need to care about
this resource if you need to use the
smartSizing resource. The default value of
30 is most likely incorrect for your system; the easiest
way of finding the correct value is to run
"xwininfo
" and
"xwininfo -frame
" and use the difference between
the reported Height values.
The following resources affect the Ghostview widget in MGv:
If this resource is true then PostScript files will be anti-aliased to improve image quality (at the expense of performance). Your Ghostscript must support the x11alpha device or anti-aliasing won't work. If anti-aliasing is enable, then the x11alpha device is used and Ghostscript will be run with the -dNOPLATFONTS switch; if anti-aliasing is disabled, then the x11 device will be used. The default value is true.
This resource is used to supply extra command-line switches to Ghostscript. This resource is useful for passing -I switches to Ghostscript when your library files are not where Ghostscript thinks they are. The default value is empty.
This resource supplies the locale used when writing the GHOSTVIEW window property. In order to support multiple locales, MGv calls XtSetLanguageProc() and this might put you into a non POSIX locale; using a non-POSIX locale can alter the decimal separator so that commas are used where Ghostscript expects periods. By default, MGv temporarily forces a POSIX locale while building the the property string but your copy of Ghostscript may be expecting something else. If Ghostscript is having problems parsing the GHOSTVIEW property, then you should try adjusting this resource.
Specify where your Ghostscript lives. If you don't specify a particular Ghostscript, MGv will use the first one that shows up in your PATH.
MGv*Ghostview.
".
The WlAppShell widget (which is used instead of the standard applicationShell widget for non-default visual support) defines the following resources:
Specify a non-default color depth.
Install a private colormap if true, otherwise use the default colormap. If you specify a non-default visual or depth, you will get a private colormap whether you ask for one or not.
Specify a non-default visual by visual class. The value of this resource can be any of the following strings (case insensitive):
This visual yields a hardware defined read-only grayscale palette, the colors cannot be changed to suit the application's needs.
This visual yields a hardware defined read-only color palette, the colors cannot be changed to suit the application's needs.
This visual yields an indexed read/write palette, the colors may be modified to suit an application's needs. This is the most common visual on eight bit color displays.
This visual yields an indexed read/write palette where the red, green, and blue components of each color are equal.
This visual yields a hardware defined, non-indexed, read-only palette.
This visual is a high-performance visual where the red, green, and blue color components are separately indexed. The palette is read/write.
mu@echo-on.net
) to clarify the documentation. If you aren't
having any problems with your colormaps, then you should probably
just use the defaults and leave these resources alone.
You might want to set the wlDepth resource as well.
Specify a non-default visual by visual id. This resource takes precedence over the wlDepth and wlVisualClass resources. This resource is available in case the visual chosen by the wlDepth and wlVisualClass resources is not the one you want--you should only use this resource if wlDepth and wlVisualClass are not giving the visual you want.
The wlib library (which is used to help create and maintain the widget trees and for the help system) defines the following resources:
This resource specifies the HTML browser to use for on-line help. The HTML files used by wlib are quite generic so any HTML browser should work. Note that the browser will be given a -display display argument before the actual URL so the browser that you use should understand this standard X option.
The helpType resource should agree with your chosen browser.
This resource contains the port number to use with the Mosaic/CCI protocol. The default value is "getpid() % 1024 + 2048". This resource is only relevant if your helpType is html-cci.
The help prefix serves as the root of the HTML documentation tree. If the help files are installed locally, then this will be the full path (including the trailing slash) to the directory containing the help files. If you are accessing the help files through an HTTP server, then this resource should have the form http://hostname/path/to/help/files/. If you are using a helpType of libhelp, then the help files must be accessible from the file system.
This resource specifies your preferred on-line help format. The following types are known:
Plain old HTML with no communication with the browser. This help method will launch a separate browser for each help request.
HTML with Mosaic's CCI protocol. If you choose this help type, you should set the helpBrowser resource to Mosaic.
HTML with Netscape's -remote protocol.
The Common Desktop Environment help system (NOT IMPLEMENTED). Implementing this will require adding another back-end to sgml-tools and sgml-tools is currently being reworked so I'll probably wait until the next major release of sgml-tools before trying to make this work.
SGI's help system (NOT IMPLEMENTED). Implementing this will require adding another back-end to sgml-tools and sgml-tools is currently being reworked so I'll probably wait until the next major release of sgml-tools before trying to make this work.
The Xnt help system (NOT IMPLEMENTED). See http://www.xs4all.nl/~ripley for more information on XntHelp. Once the whole Xnt help system (including libraries) is released I will make a real effort to make this work. This will also require some sgml-tools work.
The libhelp help system. If you wish to use libhelp for online help then you should make sure that your LIBHELPPATH environment variable contains a path to the libhelp images; the application will add its own entries to LIBHELPPATH based on the helpPrefix resource so you should make sure that helpPrefix is correctly set. See http://www.informatik.uni-stuttgart.de/ipvr/bv/personen/mache/libhelp for more information about libhelp. This is the lightest weight help system currently supported so I recommend that you use it if possible.
The helpBrowser resource should agree with your chosen help type.
Use or don't use a color icon. If the color icon is not available (due to a lack of Xpm support), then the monochrome icon will be used. The default value for this resource is true.
The following resources specify the various error, warning, and message strings used throughout MGv; only the default values are listed.
"%s: unknown argument %s to action."
"backing pixmap could not be allocated."
"Cannot decompress"
"Menu bar won't let itself be hidden."
"Could not open"
"Print command failed:"
"Error"
"File exists, overwrite?"
"Interpreter done."
"GhostScript interpreter failure."
"Message"
"(?, ?)"
"No Date"
"No File"
"No print command given."
"Page finished."
"Unknown message."
The following strings are used by wlib:
"Incorrect application defaults version found: found '%s' but wanted '%s'. The "applicationVersion" documentation should help you fix this problem."
"Could not launch browser %s: %s"
"could not get file name from file selector."
"This log has nothing to save."
"%s help not supported, using %s."
By default the MGv application defaults file is installed in the MGv
library directory for future reference--the application defaults is not
needed since the entire application defaults file is compiled into MGv
as fallback resources. However, you may, if you wish, install the
application defaults file in the normal location (probably
/usr/lib/X11/app-defaults
or /usr/X11/lib/X11/app-defaults
)
and everything should work just fine.
I stopped installing the application defaults file in the app-defaults directory to avoid version conflicts: an incorrect application defaults file can seriously break MGv.