Table of Contents

NAME

SYNOPSIS

DESCRIPTION

is an X11 based presentation tool. It is designed to make simple presentations easy while to make complicated presentations possible. Its presentation file is just text so that you can create presentation files quickly with your favorite editor (such as Emacs). The file consists of text and control commands (such as pagebreak, centering, and/or inline image). Control commands are specified on the beginning of lines started with one sign. You can include numerous kinds of image format files onto the presentation file. uses Japanese/English fonts in various sizes. uses X11 scalable fonts provided by X11 servers. can also utilize the Japanese outline font library, "VFlib", if configured to do so at compilation time. The following options are available: Set background color to (The default value is black) Specify a VFlib configuration file. Demonstration mode. Browse all page automatically, spending secounds on each page and terminate. If is not specified, it will be set to 0. Specify the font name to be used by VFlib. (The default value is minsl) Set the size and location of the window. Please note that implies will not override the window manager if you specify the geometry. Display the usage and exit without performing a presentation. There are two kind of fonts available by VFlib; They are outline font and bitmap font. By specifying you can disable the use of outline fonts. accepts any key inputs from invoked terminal as KEY OPERATION described below. disables this feature. (This option may be removed in the future release) Do not override window manager. (By default, overrides window manager and occupies the whole display) Start presentation from rather than the first page. Do not beep on errors. Specify the timeslot assigned to the presentation in minute. The timer is invoked when the second page is displayed and the remaining presentation time is indicated by the length of bar shown at the bottom of the display. The timebar is updated when some X11 event is raised, for instance some keypress. Timebar will be green if you have more than 50% of the timeslot, yellow while you have more than 30% of the timeslot, and red for the other cases. When the assigned timeslot is expired, exceeding time is also shown as a timebar growing from left to right. Current page is indicated by the position of a small vertical bar; the vertical bar is drawn at the leftend when the first page is displayed while the bar is drawn at the rightend when the last page is displayed. Display the MagicPoint version and exit without performing a presentation. specifies the working directory used for store embedded images if any. To generate an embedded MGP file, use Do not use rendering engine, specified by can be or Omit background image. Use private colormap. Generate html pages of the presentation into You will need (included in mgp kit), and and included in and Independent Jpeg Group package Specifies html image type. Now "jpg" and "png" are supported. default value is "jpg". It works when -D option is set. Specifies forward page cache options. and are numbers. specifies caching mode. 0 means caching is executed after 2 seconds idle. 1 means caching is executed immediately. specifies 'special effect' for the forward page cache. Currently, two special effects are supported. 1 means that the next page will come in from the left side. 2 means that the current page will go out to the left side. 0 means no special effect. specifies speed of special effect. 1 means the highest speed. A higher value for decreases effect speed. Specifies to turn on page guide function. At the bottom of the screen, the titles of next page and previous page are displayed to assist the presentation. Page guide can be turned on and off by keyboard too. Obey to the window manager, but with less decoration around the window. The behavior of this option is affected by how the window manager is implemented; this option may have no effect on some of the window managers. Set background image quality(0-100). will usually reload the presentation file if it gets updated, based on the file modification time taken by disables this auto-reloading feature. Be secure. Skip directives that fork/exec the child process. It is suggested to use this option if you got some presentation file from others. This is enabled by default. Be unsecure. Enable directives that fork/exec the child process. If the option is specified, will modify the content of every time it updates the presentation window. This option is useful for external process to understand when modifies the window. Be verbose. Generate debugging output to standard output. sometimes invokes to render postscript images. enables you to specify the device to be used by with a trailing '+', and will be invoked for anti-aliasing. The default is "pnmraw+".

KEY OPERATION

The keyboard/mouse commands are: Go forward a page. Space key, downward cursor key, scroll down key, "f" key, "j" key, and "n" key have the same effect. If <number> is specified, go forward <number> pages. Go to the previous page. "b" key, "k" key, "p" key, backspace key, scroll up key and upward cursor key have the same effect. If <number> is specified, go back <number> pages. Set prefix number in decimal. i.e. <number> = <number> * 10 + <keyN> - <key0>. For example, by typing in "10g" you can jump to page 10. Go to the <number> page. If number of 0 is specified, go to the last page. Display the page listing menu. See below for details. Enable/disable page guide. See description for option for details. Enable/disable rakugaki (jotting) mode. You can make an annotation (by mouse) on the presentation. Mouse button 2 (middle) has the same effect. Change the pen color for rakugaki (jotting) mode. Enable/disable the timebar if -t timeslot option is specified. Enable/disable forward page cache. Repaint the current page. Use this if you messed up the page by jotting too much. Reload the current presentation file. If the current page becomes unavailable, page pointer will be moved back to 1. Quit the currently running "q" key also has the same effect. During the presentation, you can see the page list at the bottom of the window when you press a Control Key. Choosing a page with the mouse and clicking it with the leftmost mouse button, you can go to corresponding page directly. Releasing the Control Key, the page list disappears and you can continue with the current page. This function is useful during the Q-and-A period after your presentation completes.

CONFIGURATION FILES

will look at a file named in your home directory. The content of the file must be a limited set of magicpoint directives, one directive per line, without sign. Lines start with or empty lines, will be silently ignored. See for eligible directives. imports various image draw functions from This means that the location of image files can be specified by file. If you specify the presentation file with its directory, that directory is searched first and then the path specified in the is searched.

SECURITY ISSUES

The presentation file can include directives to call the external process, just like shell process. Therefore, the presentation file should be treated just like shell script or perl script. This is STRONGLY recommended to review the content of the presentation file before invoking if you got the file from others. By adding the option to the command line argument, directives that call external processes will be skipped.

SEE ALSO

AUTHOR CONTACT

Yoshifumi Nishida <nishida@csl.sony.co.jp>

CONTRIBUTION

Jun-ichiro Hagino <itojun@itojun.org>, Akira Kato <kato@wide.ad.jp>, Atsushi Onoe <onoe@sm.sony.co.jp>, Kazu Yamamoto <Kazu@Mew.org>, Youjiro Uo <yuo@nui.org>, and Masaki Minami <Masaki@Minami.org> extensively contributed improvements, bug fixes, and documents. Special thanks to Chaki Kusakari <chaki@sfc.wide.ad.jp>.

HISTORY

was created shortly after the autumn camp of WIDE Project in 1997, which was originally called


Table of Contents