Content-type: text/html Man page of MOTIFPS


Section: User Commands (1)
Updated: 1 February 1999
Index Return to Main Contents


motifps - display utility for Mathematica under the X Window System  


motifps [-toolkitoption ...] [-option ...] filename  


motifps is used under the X Window System to display PostScript files generated by Mathematica to describe graphics, sound, or animation. motifps conforms to the Motif interface.

The program opens a window to display the image or images associated with the Mathematica output in the named file. The window has a menu bar with File, View, and Sound menus.

The View menu contains the entry ``Rendering Options'', which may be used to activate a pop-up control panel for varying line width and other parameters of the image. The File menu contains a ``Quit'' button for quitting the program. Other menu options are available for descriptions of sound or animation.

When the file contains sampled sound, two plots are displayed: a time-domain plot of the samples and below it a plot of the first differences of the samples. If the host running the program has sound support, the Sound pull-down menu is active. It contains a ``PlaySound'' button, used to play the sound once, a ``CycleSound'' button, used to play the sound repeatedly, and a ``StopSound'' button, used to stop playing the sound.

When the file contains a sequence of images (an animation), the ``Animation'' entry under the View pull-down menu is active. This button activates a pop-up control panel to control the animation.



motifps accepts all of the standard X Toolkit command-line options as well as the following (if the option begins with a `+' instead of a `-', the option is restored to its default value):
Keeps the program from doing a fork and exec to detach from the parent process. Default is to detach.
-timeout number
Causes the program to exit after number seconds.
Causes the program to allocate a private colormap rather than the default colormap.

The following standard X Toolkit command-line arguments are commonly used with these programs:

-bg color
Specifies the color to use for the background of the window. The default is ``white''.
-name name
Specifies the application name under which resources are to be obtained, rather than the default executable filename. name should not contain ``.'' or ``*'' characters.
-title string
Specifies the window title string, which may be displayed by window managers if the user so chooses.
-geometry geometry
Specifies the preferred size and position of the main window; see X(1).
-display display
Specifies the X server to contact; see X(1).
-xrm resourcestring
Specifies a resource string to be used. This is especially useful for setting resources that do not have separate command-line options.
Indicates that the program should ask the window manager to start it as an icon rather than as the normal window.


motifps understand all of the core X Toolkit resource names and classes.

The following resources are useful when specified for the PostScript widget:

background (class Background)
Specifies the color to use for the background of the PostScript widget. Default: ``white''.
busyCursor (class BusyCursor)
Specifies the cursor to use in the PostScript window when rendering is taking place. Default: ``watch''.
cursor (class Cursor)
Specifies the cursor to use in the PostScript window while not rendering. Default: system-specific.
defaultFont (class DefaultFont)
Specifies the default X font for PostScript rendering. Default: system-specific.
maxColors (class MaxColors)
Specifies the maximum size of the color cube to be allocated for PostScript rendering if running in a PseudoColor visual. If 0, allocate as many entries as possible. Default: ``0''.
preserveAspectRatio (class PreserveAspectRatio)
If True, preserve the aspect ratio of the image, and distribute excess space by centering in the window; otherwise distort the image to fill the window. Default: ``True''.
privateColormap (class PrivateColormap)
If True, allocate and use a private colormap for the window. Otherwise use the default colormap. This resource has no effect if the window is using a visual other than the default; a private colormap is always used in that case. Default: ``False''.
renderChunkSize (class RenderChunkSize)
The number of PostScript tokens to render at one time. Increasing this number will increase efficiency but also decrease the program's responsiveness to user events like menu handling and resizes. Default: ``10''.
syncAnimation (class SyncAnimation)
This specifies whether to synchronize with the X server before changing frames in an animation. The correct setting for this resource is highly dependent on many system factors; some X servers will appear to lock up when an animation is running with this resource set to False because many frame changes have queued up to the server, and the bit-blit operations that the server must do to execute them are expensive. Setting the resource to True should help in this case. Default: ``True''.
useDPS (class UseDPS)
Whether or not to use the Display PostScript server extension for PostScript rendering. Default: ``True''.
visibleRendering (class VisibleRendering)
Specifies whether partially rendered PostScript should be visible. Watching the PostScript render is more visually interesting, but also considerably more resource-intensive. Setting this resource to False will increase performance. Default: ``True''.


To display plot in a Motif environment with the font ``helvr14'' used for axis labels, use

motifps -xrm "*PostScript.defaultFont:helvr14" plot


motifps has menus named mFile, mView, and mSound.  


Available actions:
This action exits the program.


Mathematica is a registered trademark of Wolfram Research, Inc. Copyright (c) 1988-1999 Wolfram Research, Inc. All rights reserved.




This document was created by man2html, using the manual pages.
Time: 02:42:58 GMT, October 02, 2010