Active-DVI is a viewer for DVI files that also recognizes a new class of \special's targeted to presentations via laptop computers: various visual effects can easily be incorporated to the presentation, via a companion advi.sty LATEX package.
Active-DVI is copyright © 2001, 2004 INRIA and distributed under the Gnu Library General Public License ---see the LGPL file included in the distribution.
-exec # I know what I mean! -bgcolor grey16 -fgcolor grey95is a valid initialization file that sets the safety policy to -exec, then sets the background and foreground colors to obtain a nice reverse video effect.
advi [options] dvifile [dvifile]Once Active-DVI is launched, just press
?
to get help
on the keys you can use to control the presenter (type ^f
(Control-F) to get full screen, <
or >
to change
the magnification of the text).-v |
Prints the advi current version and exits |
--version |
Prints the full advi current version and exits |
-help |
Short command line options help |
-geometry geom |
Geometry of Active-DVI's window specification |
geom
is specified in pixels, using the standard format
for X-Window geometry specifications (i.e:
WIDTHxHEIGHT[+XOFFSET+YOFFSET]
).-fullwidth |
Adjust the size of the window to the width of the screen |
-nomargins |
Cancel horizontal and vertical margins |
-hmargin dimen |
Horizontal margin specification (default: 1cm) |
-vmargin dimen |
Vertical margin specification (default: 1cm) |
-crop |
Crop the window to the best size (default) |
-nocrop |
Disable cropping |
-fgcolor <color> |
Specify the color of the foreground color |
-bgcolor <color> |
Specify the color of the background color |
-rv |
Specify that reverse video should be simulated by exchanging |
the background and foreground colors | |
-gamma <float> |
Specify gamma correction (>0.0) of glyphs |
-pager |
Specify the name of the pager to launch on a txt link |
-browser |
Specify the name of the browser to a html link |
--debug |
General debug option |
--debug_pages |
Debug page motion |
--show_ps |
Print a copy of Postscript sent to gs to stdout |
--verbose_image_access |
Change the cursor while loading images |
-A |
Toggle Postscript anti-aliasing |
-passive |
Inhibit effects that are visible when redrawing the page |
(Transitions, delays, embedded applications) |
-exec |
Set safety policy to ``always execute embedded applications'' |
-ask |
Set safety policy to ``ask user before execution of embedded applications'' |
-safer |
Set safety policy to ``never execute embedded applications'' |
-option-file <filename> |
Load filename as a file containing a list of options |
as given on the command line to advi. |
-autoswitch | Set the autoswitch flag, which allows implicit switch to master |
on usr1 signal (default is off). |
line: 〈 line〉 〈 file〉where 〈 line〉 and 〈 file〉 are the current source line and current source file.
#line
〈 before〉, 〈 after〉
<<〈 prefix〉>><<〈 suffix〉>>
〈 file〉
where 〈 before〉 and 〈 after〉 are the enclosing line numbers,
〈 prefix〉〈 suffix〉 the word constituent surrounding the
mouse position, and file is the name of the current file. \edef\hyper@quote{\string"} \edef\hyper@sharp{\string#} \newcommand{\softtarget}[2]% {\special{html:<a name=\hyper@quote#1\hyper@quote>}#2% \special{html:</a>}}(If you are viewing this document with Active-DVI, you may move over this area or click on this one to see the effect.)
\newcommand{\softlink}[2]% {\special{html:<a href=\hyper@quote\hyper@sharp#1\hyper@quote>}#2% \special{html:</a>}}
t
. The first stroke on t
shows the first page
of the table of contents. Successive stokes will show the following
pages. (As usual, prefix integer argument may be used to directly
access a specific page of the table of contents.)^X-l
(Control-X then l) the laser pointer appears
on the slide; the pointer sticks to the mouse pointer and allows easy
pointing to parts of the presentation. The laser pointer size and
color can be set on the command line (options -laser-pointer-color and laser-pointer-size).^X-^S
(Control-X then Control-S). An image file is written
(by default a png file). The name of the file produced can be
set via the command line (see advi -help for details) or
directly from within the LATEX source file with commands
\advisavepageimage
and \advisavepageimagefile{filename}
).\advipushkeys
that provides
key presses to the presenter as if you had pressed it when viewing the
presentation. For instance:
\advipushkeys{"q"}ends the talk immediately.
^X
(i.e. a carret character immediately followed by an X).
Hence, the command
\advipushkeys{"^X^F"}switches to full screen mode.
examples
directory. Don't miss to play them! Then, feel free to read their
source code and copy the effects they provide.\special
command to insert into the DVI output file the
Active-DVI specific commands that implement their
semantics. Those commands are interpreted by Active-DVI afterwhile during
the DVI file previewing. Note that a \special{bla bla}
command
is equivalent to a \hbox{}
for TeX's mouth, hence it may alter
the document layout accordingly. Thus, be aware that most commands of
the advi.sty package are equivalent to a \hbox{}
command as far as the document layout is concerned.Wait for 〈 seconds〉. If no argument is provided, waits until the user requests to continue (hitting a key to move to next pause or to change page).
This command processes 〈 latex code〉 and records the corresponding DVI output, then binds it to the tag 〈 tag〉. While recording, the DVI output is not displayed, unless the option play is set.To play an Active-DVI record, the corresponding DVI must have been recorded on the current DVI page and before issuing the play command. With the proviso that these requirements are satisfied, the syntax of the command to display an Active-DVI record is as follows:
Active-DVI records may be nested. In this case, the inner record is bound to its own tag as usual; in addition, if the inner record is defined with the play option, it is also recorded as a part of the outer tag record.
If the environment syntax form of Active-DVI record definition is used, the 〈 latex code〉 may contain fragile commands.
This command plays the DVI code previously recorded and bound to 〈 tag〉.
The optional argument changes the text color to 〈 color〉 during replay.
This command defines the DVI rendering of {〈 text〉} as an Active-DVI anchor area that plays the Active-DVI record bound to 〈 tag〉 when the anchor is activated.
The argument 〈 activation〉 specifies the activation method of the anchor.
If the environment syntax form is used, 〈 text〉 may contain fragile commands.
{\setblend{burn} {\setalpha{0.5} {\includegraphics[width = 0.7\textwidth]{bar.eps}}}}difference 0.5
\color{blue} \color[named]{Yellow} \color[rgb]{0.7,0.3,0.8}
\color[named]{White}
specifies the
white color. Hence, \color[named]{Red}{some
text} writes some text in red.where 〈 decl〉 is a list of settings of the following from:
color=〈 color〉 (default value is none)Set the background color to 〈 color〉. If 〈 color〉 is none this unsets the background color. Otherwise, 〈 color〉 must follow the notation above to designate colors.image=〈 file〉 (default value is none)Use the image found in 〈 file〉 as background (none means unset).fit=〈 fit style〉 (default value is auto)Fit the background image according to 〈 style〉, which may be one of the following keywords:alpha=〈 float〉 (default value is none)auto orThe auto fit style means scaling the image as desired in both directions so that it fits the entire page. Other styles only force the same scaling factor in both directions:
topleft top topright left center right bottomleft bottom bottomright
- Corner-styles means set the image in the corresponding corner and scale it to cover the entire page.
- center means set the image in the center of the page and scale it to cover the entire page.
- Segment-styles means adjust the image and the page on the segment (in which case, the image may not completely cover the page on the opposite side).
Set the alpha channel factor for the background image to 〈 float〉 (none means unset). An alpha factor of 0 means that the image is not visible at all; conversely, an alpha factor of 1 means that the image covers the background.blend=〈 blend mode〉 (default value is none)Set the blend mode to 〈 blend mode〉, which are reminiscent of Ghostscript blending options. The blend mode should be one of the following: normal, multiply, screen, overlay, dodge, burn, darken, lighten, difference, exclusion, (none means unset).gradient=〈 function〉 (default value is none)Set the gradient function to 〈 function〉, one of the predefined functions that convert the plain background color into a color gradient from the chosen colorcolorstart=〈 color〉 (default value is white)colorstart
to the colorcolorstop
(which is white by default). Available gradients are:
hgradient
horizontal gradient (the gradient is a serie of vertical lines),vgradient
vertical gradient (the gradient is a serie of horizontal lines),d1gradient
first bissector gradient (the gradient is a serie of lines which are parallel to the first bissector),d2gradient
second bissector gradient (the gradient is a serie of lines which are parallel to the second bissector),cgradient
centered gradient (the gradient is a serie of concentric squares),circgradient
circular gradient (the gradient is a serie of concentric circles).Set the starting color of the gradient. When left unspecified defaults to white.colorstop=〈 color〉 (default value is background)Set the end color of the gradient. When left unspecified defaults to the background color.xstart=〈 int〉 (default value is 0)Set the abscissa of the lower left point of the area where the gradient is drawn.ystart=〈 int〉 (default value is 0)Set the ordinate of the lower left point of the area where the gradient is drawn.width=〈 float〉 (default value is 1.0)Set the width of the area where the gradient is drawn. The width is a number in the rangeheight=〈 float〉 (default value is 1.0)[0 .. 1]
that gives the ratio of the area width with respect to the page width (hence 0.0 means a null width and 1.0 means the entire page width).Set the height of the area where the gradient is drawn. The width is a number in the rangexcenter=〈 float〉 (default value is 0.5)[0 .. 1]
that gives the ratio of the area height with respect to the page height (hence 0.0 means a null height and 1.0 means the entire page height).For a centered or circular gradient, set the abscissa of the center point of the gradient into the gradient area. xcenter is a ratio of the gradient area's width. It defaults to 0.5, meaning the middle of the gradient area width.ycenter=〈 float〉 (default value is 0.5)For a centered or circular gradient, set the ordinate of the center point of the gradient into the gradient area. ycenter is a ratio of the gradient area's height. It defaults to 0.5, meaning the middle of the gradient area height.noneUnset all background parameters. This key must appear on its own, no arguments or keys are allowed.The optional parameter global indicates that the definition is global and will affect the following pages, as well as the current page.
By default, the background settings only affect the current page.
where 〈 decl〉 is a list of settings of the following from:
none or slide or block or wipeSet the transition mode to the corresponding key. One of this key is mandatory (if several are provided the last one is selected).from=〈 direction〉Make the transition come from 〈 direction〉. Directions should be one of the following:The default direction, to be used when no local or global direction has been specified, is determined dynamically:
topleft top topright left center right bottomleft bottom bottomright right
when coming from previous page,left
when coming from next page, andtop
otherwise.
steps=〈 n〉Make the transition in 〈 n〉 steps.As for \advibg, the optional parameter global indicates that the definition is global and will affect the following pages, as well as the current page.
By default, the transition definitions affect the current page only.
where 〈 key=val list〉 is as above and {〈 hbox material〉} is whatever can follow an \hbox command. In particular, the material may contain verbatim commands, since as for the \hbox it is parsed incrementally.The optional parameter global indicates that the definition is global and will affect the following pages, as well as the current page.
where 〈 key=value list〉 is a list of bindings of the following kind:
name=〈 name〉Allows to refer to the embedded application as 〈 name〉. Anonymous applications have actually the default name anonymous.ephemeral=〈 name〉This is the default case: the application is specific to a given page. An ephemeral application is automatically launched whenever the page is displayed, and automatically killed when the page is turned.persistent=〈 name〉A persistent application is launched only once and keeps running in the background; however, Active-DVI automatically hides and shows the window where the application runs, so that the application is visible only on the page where it has been launched.sticky=〈 name〉A stiky application is launched only once, keeps running, and remains visible when turning pages. It is also resized and moved as necessary to fit the page size.raw=〈 name〉A raw application is launched each time its embedding command is encountered. A raw application is not managed automatically by Active-DVI, except for the initial launching and the final clean-up that occurs when Active-DVI exits; hence, you can completely monitor the raw applications graphical behavior, using the advikillembed command and the window mapping facilities for raw applications described below.width=〈 dim〉
height=〈 dim〉The application takes 〈 dim〉 width (respectively height) space in LATEX. Both values default to 0pt.
These dimensions are also substituted for all occurrences of@g
in the command string.
Kill the embedded application named 〈 name〉. An optional signal value or symbolic name can be given to send to the designed process: for instance, \advikillembed[SIGUSR1]{clock} will send the SIGUSR1 signal to the embedded application named clock.
Signal value defaults to -9.
Map the window of the (raw) embedded application named 〈 name〉.
Un-map the window of the (raw) embedded application named 〈 name〉.
Similar to advikillembed but kill all the embedded applications named 〈 name〉.
Map the windows of all the (raw) embedded applications named 〈 name〉.
Un-map the windows of all the (raw) embedded applications named 〈 name〉.
The text is first displayed as usual, then the anchor is drawn according to the style given by 〈 decl〉, and made active. Its activation, which depends on the mode given by 〈 decl〉, will play the record named 〈 tag〉.
The declarations 〈 decl〉 are of the following form:In the environment form, 〈 text〉 may contain fragile commands.
- over or click
this defines the mode of activation, which is either by moving mouse over or clicking on the anchor. The default mode is over.- box, invisible, or underline
this defines the style in which the anchor should be drawn. The default style is box.
This makes an invisible anchor around 〈 text〉, which when activated will redraw text in a box colored with 〈 color〉, which defaults to yellow.
\overlay@loop
macro inhibits all layers, but the first
page).\psframe
, \ovalnode
, ....\Aput
, Bput
, etc.\usepackage{superpose}The package defines a single environment:
The 〈 alignment〉 can be one the letters c (default value), l, or r.
Items of the list are separated by\\
as in tabular environments. Each item should be a horizontal material.
\usepackage{bubble} \usepackage[ps]{bubble}By default bubbles are produced using the epic and eepic packages, for portability. However, for better rendering and easier parameterization, bubbles can also be drawn using the pst-node package of the PStricks collection. This is what the ps option is designed for.
The 〈 key=value list〉 is a list of bindings of the following kind:Parameters (color and tabular columns specifications) can also be set globally using the command:
bg=〈 color〉 (default value is yellow)The background color for annotations.unit=〈 dim〉 (default value is yellow)Set the package unit to 〈 dim〉.col=〈 colspec〉 (default value is c)Where 〈 colspec〉 is a column specification for the tabular environment. Moreover, the following abbreviations are recognized:〈 pos〉 is the optional relative position of the annotation, it defaults to 1,1, and is counted in the package units.
key expands to c col=c l col=l r col=r p=〈 w〉 col=p{〈 w〉}
key expands to C col={>{$}c<{$}} L col={>{$}l<{$}} R col={>{$}r<{$}} P〈 w〉 col={>{$}p{〈 w〉}<{$}}
〈 ps options〉 are passed to the command \psset) in ps mode and ignored otherwise.
whose options are identical to those of the \bubble macro; however the bubble appears within an active anchor.
? | info | -- | This quick info and key bindings help. |
q | quit | -- | End of show. |
space | continue | -- | Move forward (arg pauses forward if any, or do as return otherwise). |
^X-^C | quit | -- | End of show. |
n | next | -- | Move arg physical pages forward, leaving the history unchanged. |
p | previous | -- | Move arg physical pages backward, leaving the history unchanged. |
, | begin | -- | Move to the first page. |
. | end | -- | Move to the last page. |
g | go | -- | If arg is unset move to the last page. If arg is the current page do nothing. Otherwise, push the current page on the history as marked, and move to physical page arg . |
N | next pause | -- | Move arg pauses forward (equivalent to continue). |
P | previous pause | -- | Move arg pauses backward. |
^X-^F | set fullscreen | -- | Adjust the size of the page to fit the entire screen. |
^F | toggle fullscreen | -- | Adjust the size of the page to fit the entire screen or reset the page to the default size (this is a toggle). |
< | smaller | -- | Scale down the resolution by scalestep (default (((2)1/2)1/2)1/2). |
> | bigger | -- | Scale up the resolution by scalestep (default (((2)1/2)1/2)1/2). |
# | fullpage | -- | Remove margins around the page and change the resolution accordingly. |
c | center | -- | Center the page in the window, and resets the default resolution. |
^left button | move page | -- | A black line draws the page borders; moving the mouse then moves the page in the window. |
h | page left | -- | Moves one screen width toward the left of the page. Does nothing if the left part of the page is already displayed |
l | page right | -- | Moves one screen width toward the right of the page. Does nothing if the right part of the page is already displayed |
j | page down | -- | Moves one screen height toward the bottom of the page. Jumps to the top of next page, if there is one, and if the bottom of the page is already displayed. |
k | page up | -- | Moves one screen height toward the top of the page. Jumps to the bottom previous page, if there is one, and if the top of the page is already displayed. |
w | switch | -- | Switch view between master and client (if any). |
W | sync | -- | Goto page of client view corresponding to page of master view. |
^W | autoswitch | -- | Toggle autoswitch flag. |
r | redraw | -- | Redraw the current page to the current pause. |
R | reload | -- | Reload the file and redraw the current page. |
^L | redisplay | -- | Redisplay the current page to the first pause of the page. |
a | active/passive | -- | toggle advi effects (so that reloading is silent). |
return | forward | -- | Push the current page on the history stack, and move forward n physical pages. |
tab | mark and next | -- | Push the current page on the history as marked, and move forward n physical pages. |
backspace | back | -- | Move arg pages backward according to the history. The history stack is poped, accordingly. |
escape | find mark | -- | Move arg marked pages backward according to the history. Do nothing if the history does no contain any marked page. |
T | Thumbnails | -- | Process thumbnails. |
t | toc | -- | Display thumbnails if processed, or floating table of contents if available, or else do nothing. |
s | write | -- | Give a pencil to scratch, typing characters on the page. |
S | draw | -- | Give a spray can to scratch, drawing on the page. |
? | info | -- | While in scratch mode, press ? for more info. |
^X-l | toggle laser | -- | Toggle the laser beam to point on the page. |
^G | laser off | -- | When laser is on turn it off. |
^X-^S | save page | -- | Save the current page as an image file. |
f | load fonts | -- | Load all the fonts used in the document. By default, fonts are loaded only when needed. |
F | make fonts | -- | Does the same as f, and precomputes the glyphs of all the characters used in the document. This takes more time than loading the fonts, but the pages are drawn faster. |
C | clear | -- | Erase the image cache. |
^G | quit | -- | End of scratch writing. |
Esc | settings | -- | Enter the scratch writing settings mode. |
> | greater | -- | Increments the scratch font size. |
< | smaller | -- | Decrements the scratch font size. |
b | blue | -- | Set the color of the font to blue. |
c | cyan | -- | Set the color of the font to cyan. |
g | green | -- | Set the color of the font to green. |
k | black | -- | Set the color of the font to black. |
m | magenta | -- | Set the color of the font to magenta. |
r | red | -- | Set the color of the font to red. |
w | white | -- | Set the color of the font to white. |
y | yellow | -- | Set the color of the font to yellow. |
B | more blue | -- | Increment the blue component of the color. |
G | more green | -- | Increment the green component of the current color. |
R | more red | -- | Increment the red component of the current color. |
+ | positive increment | -- | Set the color increment to positive. |
- | negative increment | -- | Set the color increment to negative. |
? | help | -- | Give the list of settings available. |
Esc | quit | -- | Quit the sratch writing settings mode. |
^G | quit | -- | End of scratch drawing. |
Esc | settings | -- | Enter the scratch drawing settings mode. |
b | blue | -- | Set the color of the font to blue. |
c | cyan | -- | Set the color of the font to cyan. |
g | green | -- | Set the color of the font to green. |
k | black | -- | Set the color of the font to black. |
m | magenta | -- | Set the color of the font to magenta. |
r | red | -- | Set the color of the font to red. |
w | white | -- | Set the color of the font to white. |
y | yellow | -- | Set the color of the font to yellow. |
B | more blue | -- | Increment the blue component of the current color. |
G | more green | -- | Increment the green component of the current color. |
R | more red | -- | Increment the red component of the current color. |
+ | positive increment | -- | Set the color increment to positive. |
- | negative increment | -- | Set the color increment to negative. |
> | increment | -- | Increment by one the size of the line. |
< | decrement | -- | Decrement by one the size of the line. |
V | vertical line | -- | Draw a vertical line. |
H | horizontal line | -- | Draw a horizontal line. |
S | segment | -- | Draw a segment. |
C | circle | -- | Draw a circle. |
p | point | -- | Draw a point. |
P | polygone | -- | Draw a polygone. |
e | endpoly | -- | Close the polygone that is beeing drawn. |
F | free hand | -- | Draw a line following the pointer. |
' ' | cancel | -- | Cancel the figure setting. |
|
This document was translated from LATEX by HEVEA.