ADVI(1)

📦
version 2.0.0 · 2 versions
, in debian trixie, nixos 26.05, nixpkgs unstable, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ NAME ✨

Hiii bestie 🦋 welcome to the Active DVI man page, aka ADVI(1)! 💖 Here's the vibe: advi is a DVI previewer and presenter 🎀

[http://caml.inria.fr/advi/]

It comes with some eye candy effects for presentations ✨💅

🌸 VERSION 🌸

We're on Active-DVI version 2.0.0 🔥

🧚 SYNOPSIS 🧚

advi [*options] primaryfile secondaryfile

💜 DESCRIPTION 💜

okay so advi is a viewer for DVI files, and it's giving main character energy because it also understands a whole new class of specials made for presentations on laptops 💻 You can slide visual effects right into your presentation using the companion advi.sty LaTeX package 🫶 And if your input dvifile has been squished with gzip(1) or bzip2(1), don't worry, advi will unzip it automatically 🙈

advi is also a full-fledged graphical presenter that's literally loaded with effects through embedded applications 😭 Embedded applications are just regular Unix programs that get launched on demand during your presentation. An embedded app can show its stuff in a dedicated area of the slide, so you can do live and/or interactive demos mid-presentation. Iconic behavior, honestly 👑

advi can also take a secondary file and display both of them in alternation 🦋

🌈 CURRENTLY SUPPORTED FEATURES 🌈

Here's everything advi can do right now, bestie 💅

  • Encapsulated Postscript File inclusion (using graphics package) 🎀
  • Effects for presentation (pause, delay, text color change) ✨
  • Embedded applications for interactive demonstration 🔥
  • Pictures visualization via gpic(1) specials 🌸
  • Display of inlined Postscript using gs(1) 🧚
  • Font antialiasing that takes background colors into account 💖
  • Page display is interrupted on user input ⭐
  • Resizing the page adjusts the magnification 🦋
  • Start displaying at a given page or at a given link reference 👑
  • The file is reloading on signal SIGUSR1 😭
  • Hyperlinks to other pages or slides 🫶
  • Active areas (execute an action when the mouse is over) 💅
  • Background colors and images 🌈
  • Alpha blending for images 💜
  • Bubbles, active anchors, annotations 🍓
  • Init files to set up options 🎀
  • Safety policy for embedded application 🙈
  • Scratching (interactive drawing and writing on slides during presentation) ✏️
  • Floating table of contents (either as hyperlinks on a regular LaTeX table of contents or as small images set up on a page) 🌸
  • Transitions (slide animations when changing pages) ✨
  • Text movements 🧚
  • Integrated "Laser pointer" feature to point to the slide 🔥
Heads up! advi needs the kpsewhich(1) tool to find and recompile PK fonts. (It's part of the kpathsea library, which lots of TeX distributions ship with 💅)

🎀 OPTIONS 🎀

Here's the options lineup, bestie 💖

  • --debug — General debug 🔍
  • --debug_pages — Debug page motion 🦋
  • --ignore_background — Ignore background for antialiasing 🌸
  • --showps — Print a copy of Postscript sent to gs(1) to stdout 🧚
  • --verbose-image-access — Change the cursor while loading images 🫶
  • --version — Print the current Active-DVI version, sub-version and release date 👑
  • -A — Set Postscript antialiasing (default is unset) ✨
  • -ask — Ask mode: launching an external application requires confirmation (this is the default) 🙈
  • -bbox — Show the bounding box 💜
  • -bgcolor STRING — Set default background color (Named or RGB) 🌈
  • -browser STRING — Command to call the browser (default netscape-communicator) 💅
  • -cache-dir STRING — Set the cache directory (default /tmp) 🍓

⌨️ KEYSTROKES ⌨️

okay so advi understands a bunch of keystrokes when you type in its window 💖 some of them can take a number in front, called ARG below, and what that number does totally depends on the key 🧚 if ARG is unset, it's just 1 ✨

advi keeps a history of the pages you've visited, stacked up like a pile of pancakes 🥞 and marked pages are extra special, they count for more than regular unmarked ones 👑

  • ? — quick info and key bindings help, your cheat sheet bestie 📖
  • q — quits the program 👋
  • ^X-^C (Control-X Control-C) — also quits the program 👋
  • ^X-^F (Control-X Control-F) — turns on full screen mode 🖥️
  • ^F (Control-F) — toggles you from full screen back to normal mode so you can chat again 💬
  • ^<button> (Control + left mouse button) — lets you move the page around inside the window, super useful in full screen mode 🫶
  • return — if ARG is non zero, pushes the current page onto the history stack, then moves forward ARG physical pages 🚀
  • n — moves ARG physical pages forward and leaves the history alone 🌸
  • p — moves ARG physical pages backward, history untouched 🍓
  • <tab> — pushes the current page onto the history as a marked page, but doesn't actually move 🔖
  • <space> — goes to the next pause if there is one, otherwise it acts like return ✨
  • <backspace> — moves ARG pages backward according to the history, and the history stack gets popped to match 🔙
  • <escape> — moves ARG marked pages backward through the history. does nothing if there aren't any marked pages in there 🙈
  • g — if ARG is unset, goes to the last page. if ARG is the current page, does nothing. otherwise it pushes the current page onto the history as a marked page and moves to physical page ARG 🎯
  • , — moves to the first page 🏠
  • . — moves to the last page 🏁
  • c — centers the page in the window and resets the default resolution 💅
  • < — scales the resolution by 1/scalestep (default 1/sqrt (sqrt (sqrt 2.0))) 🔍
  • > — scales the resolution by scalestep (default sqrt (sqrt (sqrt 2.0))) 🔎
  • f — loads all the fonts used in the documents. by default fonts only load when they're needed 🔤
  • F — does the same as f, and also precomputes the glyphs of all characters used in the document. it takes more time than just loading fonts, but the pages draw faster afterwards 🏎️
  • r — redraws the current page 🔄
  • R — reloads the file and redraws the current page 🔁
  • C — erases the image cache 🧹
  • T — processes thumbnails (a graphical table of contents for the show) 🖼️
  • t — displays thumbnails if they've been processed, or the floating table of contents, or does nothing at all 📚
  • ^X-l (Control-X l) — toggles the laser pointer on or off 🔴
  • s — turns on write scratching mode so you can write on the slide interactively. press ? in that mode for help ✍️
  • S — turns on draw scratching mode so you can draw on the slide interactively. press ? in that mode for help 🎨
  • ^X-^S (Control-X Control-S) — saves an image of the current state of the slide 📸 the default file name is shot <n>, where n is the next available integer so no previously saved slide image gets overwritten. the default format is PNG, which is also the file extension

A click on a hyperlink pushes the current page onto the history as a marked page (unless the target is the current page) and then moves to the target page 🔗. if the target is visible, it gets highlighted ✨

Moreover, you can drag the currently displayed page around the window to change its relative position 🦋 this is super handy when the page is displayed at a resolution that's too big to fit in the window.

🎬 EYE CANDY MACROS 🎬

okay this part is the glow-up 🌈 using the LaTeX style advi.sty that comes with the package, you can embed some Active-DVI specials into your TeX documents. advi reads those and turns them into eye candy for your presentation 💫 for the casual user, the advi-slides.sty package gives you a truly simple way to write a show for advi (see the examples directory or the documentation inside the advi-slides.sty file for more info) 🎀

  • \adviwait — Active-DVI stops rendering at that point in the document and waits for a user keystroke ⏸️
  • \adviwait{sec} — delays the rendering at that point in the document for sec seconds ⏱️
  • \advirecord[play]{this}{material} — defines an "advi tag" named "this" that refers to the text enclosed in the following brackets. the tag can be used to change the color of that text later 🎨
  • \advirecord{this}{material} — same as \advirecord[play]{this}{material}, but it doesn't render the text at this point. you can display the text later with the \adviplay macro 🫣
  • \adviplay{this} — displays the texts associated with the tag "this" 👀
  • \adviplay[col]{this} — displays the texts associated with the tag "this", using the color "col" 💜

the directory examples is stuffed with presentations 🍓 also look at test/demo*.{tex|dvi} and test/macros.{tex|dvi} for a pretty comprehensive demo of what Active-DVI can do. main character energy 👑

this program is distributed under the GNU LGPL 📜

🔗 SEE ALSO 🔗

and the

(the reference just trails off there in the original, so I'm leaving it exactly as is 🙈)

👩‍💻 AUTHORS 👩‍💻

the whole crew who made this happen 🫶

  • Jun Furuse <Jun.Furuse@inria.fr> 💖
  • Pierre Weis <Pierre.Weis@inria.fr> 💖
  • Didier Remy <Didier.Remy@inria.fr> — inlined Postscript, hyperlinks ✨
  • Roberto Di Cosmo <dicosmo@pauillac.inria.fr> 💖
  • Xavier Leroy <Xavier.Leroy@inria.fr> — gpic(1) specials ✨
  • Didier Le Botlan <Didier.Le_Botlan@inria.fr> 💖
  • Alan Schmitt <Alan.Schmitt@inria.fr> 💖
  • Alexandre Miquel <Alexandre.Miquel@inria.fr> 💖

the original version of this manual page was written by Sven LUTHER <luther@debian.org>, for the Debian GNU/Linux system port of advi version 1.2. it was then enhanced and updated for later versions of Active-DVI, and finally rewritten for version 1.6 by Pierre Weis 🌸

And that's the ADVI(1) page, bestie! 🦋💅✨ there's no date or version in the footer, so I'm not making one up 💀 go show your slides off, you literally deserve it 👑🫶

📦 where this page comes from