diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/fancytooltips/fancytooltips.dtx |
Initial commit
Diffstat (limited to 'macros/latex/contrib/fancytooltips/fancytooltips.dtx')
-rw-r--r-- | macros/latex/contrib/fancytooltips/fancytooltips.dtx | 1415 |
1 files changed, 1415 insertions, 0 deletions
diff --git a/macros/latex/contrib/fancytooltips/fancytooltips.dtx b/macros/latex/contrib/fancytooltips/fancytooltips.dtx new file mode 100644 index 0000000000..5685590a47 --- /dev/null +++ b/macros/latex/contrib/fancytooltips/fancytooltips.dtx @@ -0,0 +1,1415 @@ +% \iffalse meta-comment +% +% Copyright (C) 2004-2012 by Robert Marik <marik@mendelu.cz> +% ---------------------------------------------------------- +% +% This file may be distributed and/or modified under the +% conditions of the LaTeX Project Public License, either version 1.2 +% of this license or (at your option) any later version. +% The latest version of this license is in: +% +% http://www.latex-project.org/lppl.txt +% +% and version 1.2 or later is part of all distributions of LaTeX +% version 1999/12/01 or later. +% +% \fi +% +% \iffalse +%<*driver> +\ProvidesFile{fancytooltips.dtx} +%</driver> +%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01] +%<package>\ProvidesPackage{fancytooltips} +%<*package> + [2012/06/12 v1.12 fancytooltips.dtx file] +%</package> +% +%<*driver> +\documentclass{ltxdoc} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +\OnlyDescription +\usepackage{xcolor,graphicx,listings} +\usepackage[filename=tip,mouseover,movetips,fg]{fancytooltips} +\buttontipwidth=2cm +\buttontipheight=2cm +\begin{document} +\color{black} + \DocInput{fancytooltips.dtx} +\end{document} +%</driver> +% \fi +% +% \CheckSum{1186} +% +% \CharacterTable {Upper-case +% \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z Lower-case +% \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z Digits +% \0\1\2\3\4\5\6\7\8\9 Exclamation \! Double quote \" Hash (number) +% \# Dollar \$ Percent \% Ampersand \& Acute accent \' Left paren \( +% Right paren \) Asterisk \* Plus \+ Comma \, Minus \- Point \. +% Solidus \/ Colon \: Semicolon \; Less than \< Equals \= Greater than +% \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ Grave accent \` Left +% brace \{ Vertical bar \| Right brace \} Tilde \~} +% +% +% \changes{v1.0}{2007/02/15}{Initial version} +% +% \changes{v1.1}{2007/02/20}{Clener code, better documentation, fix +% for bug with delayinterval macro, support for dvips and Distiller +% users.} +% +% \changes{v1.2}{2007/03/01}{Better support for dvips users, buttons +% for icons are created automatically using eso-pic package and have +% the name "ikona.pagenumber", new option \texttt{movetips}, tooltip +% appears on the current page only and, as a consequence, animations +% are faster.} +% +% \changes{v1.3}{2007/05/08}{Fixed bug which appears in dvips route. +% Improved documentation -- added a note about the required version +% of eforms.sty} +% +% \changes{v1.4}{2009/04/29}{Added support for presentations (like +% \texttt{pause} command for texpower).} +% +% \changes{v1.5}{2009/05/05}{Handling number of pages via aux file +% (fixes some problems issued by previous modification and page +% break near tooltip).} +% +% \changes{v1.6}{2010/04/10}{Added options \texttt{debug}, +% \texttt{active} and \texttt{inactive}, added an example with +% automatic previews for equations and floats. Added handling of +% this.dirty and app.focusRect. Changed the name of the file with +% tooltips. Added starred version of \texttt{tooltip} command.} +% +% \changes{v1.7}{2010/05/20}{Added options \texttt{blur} and +% \texttt{fg}, cleaned some command names} +% +% \changes{v1.8}{2010/06/10}{Added hook do insert stuff on each page.} +% +% \changes{v1.9}{2011/12/04}{Changed expansion in the new |\ref| +% command provided by |FancyHook| macro (see |fancy-preview| +% facility).} +% +% \changes{v1.10}{2012/05/09}{New script preview-latex. New options +% |previewall| and |nosoap|.} +% +% \changes{v1.11}{2012/05/11}{Fixed bug related to bad position if +% |fg| option is used and \texttt{evensidemargin} is different from +% \texttt{oddsidemargin}.} +% +% \changes{v1.12}{2012/06/12}{Documentation updated. New option +% |tooltipmark|.} +% +% \GetFileInfo{fancytooltips.dtx} +% +% \DoNotIndex{\newcommand,\newenvironment} +% +% +% \title{The \textsf{fancytooltips} package, the \textsf{fancy-preview} script\thanks{This document +% corresponds to \textsf{fancytooltips}~\fileversion, dated +% \filedate.} \thanks{Supported by grants 18/2006, 99/2008 and 131/2010 +% of Higher +% Education Development Fund (FRV\v S) }} \author{Robert Ma\v r\'\i k \\ +% \texttt{marik@mendelu.cz}} +% +% \maketitle +% +% \setcounter{tocdepth}{2}\tableofcontents\rightskip=0em plus 0.2em\sloppy +% \section{Introduction} +% +% The \LaTeX{} package |fancytooltips| allows to insert tooltips into +% PDF documents -- a popup windows appears if the mouse hovers or +% clicks particular area. You can use plain text as well as +% mathematics, pictures and animations in your tooltips. The PDF +% viewer must interpret Javascripts to make the tooltips work. This is +% currently true only for (free) Abobe Reader and (commercial) Adobe +% Acrobat. There are two ways how to produce the PDF file. The +% simplest way is to use |pdflatex|. Another option is |latex| + +% |dvips| + AdobeDistiller\footnote{not free |ps2pdf|} + Adobe +% Acrobat\footnote{not free Adobe Reader.}. +% +% \color{black}Here you can test two tooltips: \tooltip{Einstein's +% formula}{1} and simple \tooltipanim{animation}{2}{7} (numbers from 1 +% to 6). For more examples how the presentation may look like see the +% |examples| subdirectory. We also provide a Perl script +% |fancy-preview| which allows to extract equations, theorems and +% related parts of text into separate PDF file and insert tooltips +% after each |\ref|, |\eqref| and |\cite| command automatically. For +% more information see Figure \ref{fig:1} and demos (scientific +% papers, presentations, tests) at +% \url{http://user.mendelu.cz/marik/fancy-preview}. +% +% Related \LaTeX{} packages are |cooltooltips|, |pdfcomment| (smaller +% size of the resulting PDF, but restricted to plain text), |ocgtools| +% (works with layers, only |pdflatex| is supported) and Acro\TeX{} +% (works with layers, only |latex| + |dvips| + Adobe Distiller + Adobe +% Acrobat are supported). All these ``similar'' packages allow to +% write the text for the tooltips inside the main document. In +% contrast to this approach, |fancytooltips| package makes use of an +% external file. This allow to use graphics or mathematical +% expressions in the tooltips. +% +% The package requires |eforms.sty| and |insdljs.sty| packages, which +% are part of AcroTeX bundle +% (\url{http://www.math.uakron.edu/~dpstory/webeq.html}). +% +% \section{Usage of \texttt{fancytooltips.sty}} +% \subsection{Small technical background} +% +% \begin{itemize} +% \item The pages from the external PDF file with tootlips are +% inserted as icons at hidden buttons into the resulting +% PDF. +% \item If you insert tooltip, the current page is covered by an +% invisible transparent button which spans across the whole page +% (the information about the pages with tooltips is stored in |aux| +% file and hence we have to run \LaTeX{} \textit{three times}). The +% button has an associated JavaScript action to close all tooltips +% (i.e. make itself and other related buttons hidden). +% \item Another button which reveals tooltip is created. This button +% is transparent, covers the text typeset by \TeX{} and allows to +% activate a JavaScript. This JavaScript takes the picture required, +% puts this picture as icon to the button which covers the +% corresponding page and makes this button visible. +% \item Each page has an associated action which closes all tooltips +% when the page is opened. +% \end{itemize} +% +% \subsection{The file with tooltips} +% The file with tooltips is an ordinary PDF file, one tooltip per +% page. Tooltips should be in the top right corner at the page, in a +% \textit{box with nontransparent background} and the rest of the page +% should be transparent. If you consider to use |movetips| option +% which causes the tooltip appear near the mouse cursor instead of in +% the top right corner (see below), then every page should have the +% dimensions equal to the dimensions of the colored box with +% tooltip\footnote{Look at the files \texttt{tooltipy.tex} and +% \texttt{tooltipy.pdf} from |examples| subdirectory for a simple +% example how to meet this condition under pdf\LaTeX. You may also use +% ordinary \LaTeX{} class, set \texttt{\textbackslash pagestyle\{empty\}} and crop the boundary.}. You can +% call the tooltips by their page numbers, but for better comfort we +% also provide simple cross referencing mechanism. If the pdf file is +% created by \LaTeX, \DescribeMacro{\keytip} you can define keywords +% to refer to the pages using |\keytip| command. Simply put +% |\usepackage[createtips]{fancytooltips}| into preamble and write +% \texttt{\string\keytip}\marg{foo} in document. This writes +% information about keyword \meta{foo} and the pagenumber into file +% |\jobname.tips|. See +% \url{http://user.mendelu.cz/marik/fancytooltips} for some tooltip +% templates. +% +% \subsection{The file with presentation} +% In the file with presentation, the user is responsible to +% \begin{itemize} +% \item input either |color| or |xcolor| package in the +% preamble +% \item \LaTeX{} the file two times (we write some macros into |aux| +% file) or three times (if option |fg| is used). +% \end{itemize} +% You may use the following options to set the necessary information +% and change the default behavior of the package. +% +% \def\iitem#1{\item[{\color{blue!50!black}\texttt{#1}}]} +% \begin{description}\sloppy\rightskip 0 pt plus 1 em +% \iitem{filename} To input the tooltips from file \meta{foo.pdf} +% call the package with |filename| option: +% |\usepackage[filename=foo]{fancytooltips}|. This option is +% required if compiled with |pdflatex|. +% +% \iitem{movetips} By default, tooltip appears in the +% top right corner of the page (use View--PageLayout-Single Page in +% your Adobe Reader, please). If the option |movetips| is used, then +% tooltip appears close to the mouse pointer. More precisely, tooltip +% appears with left down corner at the mouse position, if there is +% enough place. If not, tooltip appears with right down corner at the +% mouse position. Finally, the tooltip is shifted down to fit the +% page, if necessary\footnote{This option works in this way if every +% page of the file with tooltips has dimensions of the box with +% tooltip. See the \texttt{examples} subdirectory.}. +% +% +% \iitem{mouseover} If you use |mouseover| option, +% then tooltip appears if you move the mouse pointer to the active +% area (no clicking is necessary). +% +% \iitem{inactive} This option makes the package +% inactive. +% +% \iitem{active} This option forces the package +% active even if |inactive| option is loaded. +% +% \iitem{blur} The rest of the page is blurred, when showing +% tooltip. Use either |\usepackage[blur]{fancytooltips}| or +% |\usepackage[blur=number]{fancytooltips}|, where |number| is +% a number between 0 and 1. (Note that we use transparent package +% and hence this could have an influence on the colors of the +% document and could make your PDF less portable.) This option is +% allowed in pdf\LaTeX{} mode only. If this options brakes colors +% only on the page which include tooltips, you may want to use +% option |fixcolor| to fix it. +% +% \iitem{fixcolor} See |blur| option. +% +% \iitem{debug} Prints two alerts reporting success or problems when +% opening PDF file in Adobe Acrobat (Adobe Reader). Use this option +% to find possible source of problems. See also the Section +% \ref{sec:tr} in this manual. +% +% \iitem{noextratext} No mark is appended at the end of the link +% which opens tooltips (see help for |\tooltip|). +% +% \iitem{nosoap} A single space is used to occupy the space for +% button produced by |\tooltip*| command instead of blue soap. As a +% result, the button produced by |\tooltip*| works as usual, but it +% is invisible. This is sometimes convenient for the user, since the +% mark does not disturb the text. However, the author has to +% instruct the user, that the hidden buttons follow links from +% cross references. +% +% \iitem {fg} The button for displaying pictures is placed on +% background and the buttons which activate tooltips are placed +% immediately in the text by default. With |fg| option all these +% buttons are placed into foreground after the page is completed. We +% use |\pdfsavepos| command and keep track of the position for +% buttons in aux file and hence this option works in pdf\LaTeX\ only +% and the file needs more compilations. This option does not do +% anything in dvi mode now (despite the fact that pdf\LaTeX\ +% provides the feature also for dvi mode), but this could be changed +% if someone requests this feature. Use this option for example, if +% you use frame around hyperlinks or buttons and form fields in your +% PDF (like tests produced by Acro\TeX). +% +% \iitem{preview} Redefines |\ref|, |\eqref| and |\cite| commands to +% work with tooltips extracted by |fancy-preview|, see Section +% \ref{sec:fancy-preview} and demo files in |example/fancy-preview| +% directory. The tooltip is inserted only if the target of the +% reference is on different PDF page as the tooltip. This option is +% suitable for presentations where the whole PDF page is +% visible. Replaces former |\FancyHook| command. +% +% \iitem{previewall} Like |preview| but shows tooltip also if the +% target is on the same page. Suitable for enhanced versions of +% papers written on A4 page. +% +% \def\aaa#1{#1\hbox +% {\smash{\raisebox{0.4em}{\includegraphics[width=0.7em]% +% {fancytipmark#1.pdf}}}}} \iitem{tooltipmark} Allows to change the +% tooltipmark to some predefined styles, values are \aaa1, \aaa2, +% \aaa3 and \aaa4. Note that you can change the mark to whatever +% different by redefining |\TooltipExtratext| command. Work only in +% pdflatex mode. +% +% \end{description} +% +% \DescribeMacro{\tooltip} The user can put the tooltip into her or +% his presentation using the command +% \texttt{\string\tooltip}{\marg{stuff}\marg{keyword-or-pagenumber}} +% where \meta{stuff} is the printed text in \meta{tooltipcolor} color +% and \meta{keyword-or-pagenumber} is either the pagenumber of the +% tooltip in the external file or the keyword defined by |\keytip| +% command and stored in |\TooltipFilename.tips| file, where +% |\TooltipFilename| is set automatically from the |filename| option. +% \DescribeMacro{\TooltipExtratext} The printed text \meta{stuff} is +% followed by |\TooltipExtratext| command. The default value is small +% blue soap, as you have seen in the second paragraph of this +% documentation. There is a |noextratext| option which defines +% |\TooltipExtratext| to be empty. \DescribeMacro{noextratext option} +% If \marg{keyword-or-pagenumber} is not recognized as valid keyword +% for tooltips, it is supposed to be pagenumber. +% +% The text \marg{stuff} is inserted in |\hbox| by +% |\tooltip|. \DescribeMacro{\tooltip*}With starred version of the +% |\tooltip| macro the text \marg{stuff} is not inserted into the box +% and the active button dos not cover the text \marg{stuff}, but +% covers the mark produced by |\TooltipExtratext|. +% +% \DescribeMacro{\tooltipanim}\DescribeMacro{\tooltipanim*} The user +% can put a series (animation) of tooltips into the presentation by +% using \texttt{\string\tooltipanim}\marg{stuff}\marg{start}\marg{end} +% command, where \meta{start} and \meta{end} are keywords defined by +% |\keytip| command or page numbers. \DescribeMacro{\delayinterval} +% The delay between two frames is |\delayinterval| milliseconds. The +% default value is 200, you can change it by command +% |\def\delayinterval{100}|. There is also starred version which works +% similarly like |\tooltip*| command. +% +% \DescribeMacro{\TooltipRefmark} Extra text added to |\ref|, |\eqref| +% and |\cite| commands with previews, see Section +% \ref{sec:fancy-preview}. The default value is the same as for +% |\TooltipExtratext|. +% +% \subsubsection{Changes for dvips users} +% Dvips users also have to prepare tooltips into PDF file, not eps as +% usual. But we have to insert these tooltips in Adobe Acrobat Pro +% program. If you use Acrobat Pro version 8.1 and later, install the +% file \texttt{aeb.js} from AcroTeX eDucation bundle as described in +% the documentation to AcroTeX.\footnote{If you do not install +% \texttt{aeb.js} properly, you can still create your presentation, +% but you have to import the |fdf| file manually, see the section +% Troubleshooting and known problems.} +% +% Since \LaTeX{} is not capable to find the number of pages in +% external PDF file with tooltips, \DescribeMacro{dvips}dvips users have to specify option +% |dvips| in |fancytooltips| package. \DescribeMacro{pages} You have +% to use also a |pages| option with the number of pages in the PDF +% file with tooltips, if you use dvips route. You have to call the +% package by +% something like this:\\ +% |\usepackage[dvips,filename=tooltipy,pages=27]{fancytooltips}| +% +% You have to |latex| (two times) and |dvips| your file first. This +% produces |filename.ps| and |Tooltipsdljs.fdf| files. Distill the +% |filename.ps| file into |filename.pdf| and open this file by Adobe +% Acrobat Professional -- this imports macros from |Tooltipsdljs.fdf| +% file. In Acrobat's JavaScript console (open by |Crtl+J|) run (using +% |Ctrl+Enter|) the command |ImportTooltips();| which is defined for +% the document. This command inserts invisible buttons on the first +% page, imports icons (the file with icons specified as +% \meta{filename} parameter when loading fancytooltips must be in +% working directory). You should see a message ``\texttt{importing +% pictures}'' and the command returns 1 when finished. Then +% \textbf{save the file} (you can use the same name). If the command +% |ImportTooltips();| fails, you either have not the PDF file with +% tooltips in current directory, or the PDF file does not contain +% JavaScripts. In the latter case insert document level JavaScripts +% manually as described in the Section \ref{sec:tr}. +% +% \section{Tootlips at +% references: \texttt{fancy-preview}} \label{sec:fancy-preview} +% \subsection{Basic usage} +% There is a Perl script |fancy-preview| which can be used to extract +% text from bibliography items, numbered equations, numbered theorems, +% lemmas, etc, put this text into separate PDF file and add this text +% as tooltips to the corresponding |\ref|, |\eqref| and |\cite| +% commands. Reading the resulting file may look like on Figure +% \ref{fig:1}. +% \begin{figure} +% \centering +%\fbox{\includegraphics[width=0.95\textwidth]{cite.png}} +% \caption{\texttt{fancy-preview}} +% \label{fig:1} +% \end{figure} +% +% +% The script |fancy-preview| has been tested with Texlive2011 on both +% Linux and MS Windows. To run this script you need working Perl +% installation (usually present on Linux workstations, on MS Windows +% you may need to install Perl from +% \url{http://www.activestate.com/activeperl}) and |Config::IniFiles| +% module\footnote{Package |libconfig-inifiles-perl| on Ubuntu Linux, +% |cpan Config::IniFiles| or |ppm install Config::Inifiles| on MS +% Windows. Alternatively you can run |ppm| without any parameters to +% invoke the GUI.}) +% +% To compile your document |file.tex| do the following +% \begin{itemize} +% \item Put |\usepackage{hyperref}| into the preamble of your document +% (if not already loaded). +% \item If you write references in |thebibliography| environment, put +% empty line after each |\bibitem| command (including the last item +% in |thebibliography|). +% \item Run |fancy-preview file|. After several compilations you +% should get the PDF file |file.pdf|. +% \end{itemize} +% The default work-flow is the following. The file is compiled with +% |pdflatex| to get correct numbers of equations and in the first +% pass of |preview.sty| we extract displayed equations (but the +% numbers are thrown away). After this we crop the PDF file by using +% |pdfcrop| program (an alternate program can be specified as +% optional parameter). Then we extract numbered environments +% (theorem, Theorem, lemma, corollary, definition, figure, table) +% using the second pass and crop the PDF file again. After this we +% merge all equations, theorems etc which are marked with |\label| +% command. The PDF file with extracted parts of the text is the used +% as source of toltips in final compilations. +% +% Many things can be customized. The following options are +% available. +% \begin{description} +% \iitem{pdfcrop} You may specify an alternative batch file to crop +% boundary of PDF file. Default is |pdfcrop|. The command line for +% an alternative program to crop PDF file is supposed to be the +% following: |programname input.pdf output.pdf|. Using optimal +% program to PDF file may be much fasater and may produce +% significantly smaller files. \iitem{tooltips} You may combine +% the tooltips extracted by |fancy-preview| with ``ordinary hand +% made tooltips''. Simply call |fancytooltips| in the main document +% by |\usepackage[inactive]{fancytooltips}| in your document and +% specify the file with tooltips in the command line of the +% |fancy-preview| or in the |ini| file. You may also compile your +% file by |pdflatex| and get ``normal'' PDF output (the compilation +% is way faster). \iitem{fancy\underline{ }options} Options passed +% |fancytooltips| in final compilations. Default is +% |previewall,nosoap|. Options |mouseover| and |movetips| are added +% automaticaly.\iitem{ini\underline{ }file}Specifices the |ini| file +% with configuration, see the next subsection. +% \end{description} +% \subsection{Configuration from ini files} +% Other customization can be done via |ini| files. The script looks +% for customizations in the file specified by |ini_file| command line +% parameter. If this parameterer is not used, the script looks for +% customization in two default locations: |~/.fancy-preview.ini| and +% in |./fancy-preview.ini| (both files are used if both exist). You +% can use |~/.fancy-preview.ini| for customizations related to all +% your projects and |./fancy-preview.ini| for projects in the current +% directory. The options from the file +% |./fancy-preview.ini| override |~/.fancy-preview.ini| and the +% options from command line override options from +% |./fancy-preview.ini|. The format is described at +% \url{http://search.cpan.org/~shlomif/Config-IniFiles-2.75/lib/Config/IniFiles.pm}. +% +% The parameters are divided into two sections, |[main]| and |[latex]|. +% In section |[main]| of |ini| file you can set parameters |pdfcrop|, +% |tooltips| and |fancy_options|. +% +% In the section |[latex]| if the initialization file you can +% customize the compilation by \LaTeX. Here you can set parameters +% |environments| and |snarfenvironments| to set the environments which +% will be extracted. The default values are +% |environments=Theorem,theorem,lemma,corollary,definition| and +% |snarfenvironments=figure|. +% +% The material from |tex| file is extracted in three passes. These +% passes are denoted by |a|, |b| and |c|. If +% \texttt{\string\label}\marg{foo} appears in the text which is marked +% for extraction, then the corresponding +% \texttt{\string\newlabel}\marg{foo} command is written to the |aux| +% file and \meta{foo} is supposed to be the name of the keyword +% corresponding to the PDF page with the text. +% +% If a referenced material appears in more passes, then the priority +% is set in the variable |$latex{'pass_order'}| and can be customized +% in the ini file in |[latex]| section as |pass_order| parameter. The +% default value is |pass_order=acb|, i.e. |c| overrides |b| and |a| +% overrides |c|. +% +% As a typical example consider equation with label |\label{eq}| in +% numbered theorem with label |\label{th}|. The equation is extracted +% in pass |a| (displayed equation) and in pass |b| (the whole +% theorem). The corresponding |\newlabel{eq}| command appers in two +% |aux| files -- from passes |a| and |b|. The first one corresponds to +% the PDF page with equation, the latter to the PDF page with whole +% theorem. Since |a| overrides |b|, then |\ref{eq}| and |\eqref{eq}| +% commands show the number of the equation followed by the tooltip +% with equation only. Further |\ref{th}| shows number of the theorem +% followed by the tooltip with the whole theorem. If you set |pass_order=ba|, then both |\ref{eq}| and |\ref{th}| are followed by the +% same tooltip. +% +% The following options are available\footnote{These +% options are used as keywords in a hash variable \texttt{latex}, i.e. for +% default value of \texttt{param} parameter search the file \texttt{fancy-preview} +% for \texttt{\$latex\{'param'\}}.}. +%\begin{itemize} +% \iitem {a} Defines commands for the first pass. It +% inserts |preview.sty| command which extracts displayed +% mathematics. Also resets |\tagform@| and |\@eqnnum| to skip +% printing of equation numbers. +% \iitem {a\underline{ }extra} Defines material which is appended to |a| +% +% \iitem {b} Defines commands fot the second pass. In this \LaTeX{} +% run are (by default) floating figures and theorem-like environments +% extracted. Inserts |preview.sty|. At the runtime, +% |\PreviewEnvironment[{[]}]{env}| and +% |\PreviewSnarfEnvironment[{[]}]{env}| for each |env| in comma +% separated list from |environments| and |snafenvironments| is added, +% respectively. +% \iitem {b\underline{ }extra} Defines material which is appended to |b| +% +% \iitem{environments} See |b| option. +% +% \iitem{snarfenvironments} See |b| option. Default value is |figure|. +% +% \iitem {c} If empty (default value), then the third pass is +% skipped. Otherwise, you may activate |preview.sty| similarly like in +% |b| (for a template see the source code and the default setting of +% |$latex{'b'}|) and extract environments and commands according to +% your interest. A possible application is to extract |minipage| +% environments, if there are two or more figures inserted in +% |minipage| environments into one |figure| environment. +% +% \iitem{pass\underline{ }order} Sets priority, which pass is supposed +% to produce the output for a |\label| which is extracted more times +% than once, see the previous paragraphs for explanation and example. +% +% \iitem{preview\underline{ }bibitem} Redefines |\bibtem| command. The +% material between |\bibitem| and |\par| is wrapped to the width of +% |0.75\textwidth| and extracted. +% +% \iitem{preview\underline{ }biblatex} Similarly like +% |preview_bibitem| but works with |biblatex|. +% +% \iitem{ini} Inserted at the begin of each |pdflatex| run. +% +% \iitem{tooltips\underline{ }envelope\underline{ }preamble} Used in +% preamble. Defines command |\tooltipwraper|. This command wraps the +% tooltips. Default is to use |tikz| to put everything into a yellow +% box with rounded corners and shading. +% +% \iitem{biblatex} Creates temporary file +% |fancy-preview-biblatex-settings.tex|. This file contains definition +% which allow |biblatex| to work with citations and tooltips and we +% input this file in final compilations. This code comes from +% |tex.stackexchange.com|. +%\end{itemize} +% +% +% +% \subsection{Tips and tricks} +% \begin{itemize} +% \item The program |pdfcrop| from \TeX live may produces large PDF +% files. See the discussion at +% \url{http://tex.stackexchange.com}\footnote{\url{http://tex.stackexchange.com/questions/42236/pdfcrop-generates-larger-file}}. The +% smaller size can be obtained with the solution from the discussion +% below the question, which is based on |gs| and |pdftk|. The +% |python| script from the same discussion produces slightly larger +% file than |pdftk|, but still much smaller than |pdfcrop| and +% provides the fastest solution. +% \item Do not use floats in environments, which are +% extracted. Otherwise you get an error from \LaTeX. A workaround +% could be also to change temporarily definition of the floating +% environment (redefine |figure| environment, for example). +% \item If you are not interested in customization via |ini| files and +% do not want to install extra modules to your Perl installation, +% you may delete the about twenty lines from |fancy-preview| +% starting with |use Config::IniFiles;| up to the line +% |read_config("./fancy-preview.ini");| +% \end{itemize} +% +% \section{Troubleshooting and known problems}\label{sec:tr} +% The source code is in Mercurial repository at +% \url{http://bitbucket.org/robert.marik/fancytooltips/}. You can also +% report problems and issues in the forum at this site. The code on +% |bitbucket.org| is considered as development version and repository +% for older versions. The last stable version is always the version +% from CTAN. +% \begin{itemize} +% \item +% The package works with |eforms.sty| from version +% 2006/10/03 v1.0a. You can download this or newer version from +% \url{http://www.acrotex.net} site. +% \item If the graphics included by |\TooltipExtratext| and +% |\TooltipRefmark| has colors with \textbf{custom opacity}, Adobe +% Acrobat Pro sometimes renders the pictures bad. No problems of +% this type have been observed with free Adobe Reader. +% \item For \textbf{dvips} users: In some cases the file +% |Tooltipsdljs.fdf| is \textbf{not imported automatically} +% (probably some setting in Adobe Acrobat or new versions of +% |eforms.sty| and |insdljs.sty|). In this case you do not see any +% message when using |debug| option. You have troubles of this type +% if you see in the Javascript console (Ctrl+J) error messages like +% ``\texttt{aebTrustedFunctions is not defined 3:Page:Open +% CloseTooltips is not defined 1:Page:Open}''. In this case you +% have to import the file |Tooltipsdljs.fdf| \textbf{manually from +% ``Form'' menu} in Adobe Acrobat Pro. Then go to the JavaScript +% console and run |ImportTooltips();| command. +% \end{itemize} +% +% Follow the points below if you want to find the source of your +% problems. +% \begin{itemize} +% \item For dvips users it is a good idea to check that Acro\TeX{} is +% properly installed. Do the demo files from Acro\TeX{} work for you? +% \item Try to use |debug| option, prepare the PDF file and open it in +% Adobe Acrobat or Adobe Reader. +% \begin{itemize} +% \item You should see two messages when opening the file. If not, +% the Javascript do not work in your document (are not inserted +% properly). +% \item Both messages should report success for pdflatex users. For +% dvips users one of the message should report error and if you +% run |ImportTooltips();| command in Javascript console, you should +% see a message in Javascript console which confirms that the +% pictures from external PDF file have been imported. If you save +% the PDF file and open again, both messages should report +% success. +% \end{itemize} +% \end{itemize} +% +% \PrintChanges +% \StopEventually{} +% +% \section{Implementation} +% \begin{macrocode} +%<*package> +\RequirePackage{graphicx} +\RequirePackage{xkeyval} +\RequirePackage{atbegshi} + +\newif\if@fancytooltips@createtips\@fancytooltips@createtipsfalse +\DeclareOptionX{createtips}{\@fancytooltips@createtipstrue} + +\newif\ifTooltip@usepdftex\Tooltip@usepdftextrue +\DeclareOptionX{dvips}{\Tooltip@usepdftexfalse} + +\newif\if@fancytooltips@extratext\@fancytooltips@extratexttrue +\DeclareOptionX{noextratext}{\@fancytooltips@extratextfalse} + +\newif\if@fancytooltips@movetips\@fancytooltips@movetipsfalse +\DeclareOptionX{movetips}{\@fancytooltips@movetipstrue} + +\newif\if@fancytooltips@mouseover\@fancytooltips@mouseoverfalse +\DeclareOptionX{mouseover}{\@fancytooltips@mouseovertrue} + +\newif\if@fancytooltips@inactive\@fancytooltips@inactivefalse +\DeclareOptionX{inactive}{\@fancytooltips@inactivetrue} + +\newif\if@fancytooltips@active\@fancytooltips@activefalse +\DeclareOptionX{active}{\@fancytooltips@activetrue} + +\newif\if@fancytooltips@fg\@fancytooltips@fgfalse +\DeclareOptionX{fg}{\@fancytooltips@fgtrue} + +\DeclareOptionX{filename}{\xdef\TooltipFilename{#1}} +\DeclareOptionX{pages}{\xdef\TooltipPages{#1}} + +\newif\if@fancytooltips@blur\@fancytooltips@blurfalse +\DeclareOptionX{blur}[0.4]{\@fancytooltips@blurtrue + \xdef\fancytooltips@transparency{#1}} + +\newif\if@fancytooltips@fixcolor\@fancytooltips@fixcolorfalse +\DeclareOptionX{fixcolor}{\@fancytooltips@fixcolortrue} + +\newif\if@fancytooltips@preview\@fancytooltips@previewfalse +\DeclareOptionX{preview}{\@fancytooltips@previewtrue} + +\newif\if@fancytooltips@previewall\@fancytooltips@previewallfalse +\DeclareOptionX{previewall}{\@fancytooltips@previewtrue\@fancytooltips@previewalltrue} + +\newif\if@fancytooltips@nosoap\@fancytooltips@nosoapfalse +\DeclareOptionX{nosoap}{\@fancytooltips@nosoaptrue} + +\def\@@fancytipmark{} +\DeclareOptionX{tooltipmark}{\xdef\@@fancytipmark{#1}} + +\def\fancytooltipsdebugmsg{} +\DeclareOptionX{debug}{\def \fancytooltipsdebugmsg +{ +if (this.getField("ikona") == null) + {app.alert("No buttons for placing tootlips are available. Contact the author. The file may need more compilations.");} + else + {app.alert("Buttons for placing tooltips are available. Congratulations! Hope everything will work.");} +if (this.getField("animtiph") == null) + {app.alert("No hidden buttons containing tooltips available. The interactive features will not work. \n\n If you created the file by dvips, run the command ImportTooltips() in the Javascript console (Ctrl+J, write the command followed by semicolon and Ctrl+Enter).");} + else + {app.alert("Hidden buttons containing tooltips are available. Congratulations! Hope everything will work.");} +}} + +\ProcessOptionsX + +\if@fancytooltips@blur +\ifTooltip@usepdftex\else +\@fancytooltips@blurfalse +\AtEndDocument{\PackageWarning{fancytooltips} + {Blur option is incompatible with dvips. ^^J The option blur is turned off }} +\fi +\fi + +\ifTooltip@usepdftex\else +\@fancytooltips@fgfalse +\fi + +\newdimen\buttontipwidth +\newdimen\buttontipheight +\newdimen\fancy@a +\newdimen\fancy@b +\newdimen\fancy@layerHshift\fancy@layerHshift=0pt +\newdimen\fancy@layerVshift\fancy@layerVshift=0pt +\newdimen\fancy@button@Vshift \fancy@button@Vshift=0pt +\newdimen\fancy@button@Hshift \fancy@button@Hshift=0pt +\newtoks\pos@fancy@toks + +\if@fancytooltips@active\@fancytooltips@inactivefalse\fi + +\if@fancytooltips@inactive +\newcommand{\tooltip}{\@ifstar\tooltip@Star\tooltip@NoStar}% +\newcommand{\tooltip@Star}[2]{#1}% +\newcommand{\tooltip@NoStar}[2]{#1}% + +\newcommand{\tooltipanim}{\@ifstar\tooltipanim@Star\tooltipanim@NoStar}% +\newcommand{\tooltipanim@Star}[3]{#1}% +\newcommand{\tooltipanim@NoStar}[3]{#1}% +\def\keytip#1{}% +\def\TooltipPage#1#2{}% +\let\TooltipExtratext\relax +\let\TooltipRefmark\relax +\ifx\@ocg@makeknown\undefined + \def\@ocg@makeknown#1#2#3{}\fi +\def\fancy@@pushButton#1#2#3#4#5#6#7#8{} +\def\fancy@@anim@pushButton#1#2#3#4#5#6#7#8#9{} + +\PackageWarning{fancytooltips}{Fancytooltips inactive}% +\expandafter\endinput\fi + +% \end{macrocode} +% Each |\ref| command has associated a number and writes new label +% into aux file. If the target page for the ref is different from the +% page with this |\ref| command, the corresponding tooltip is inserted. +% \begin{macrocode} +\newcount\fancycheckcount\fancycheckcount=0 +\def\fancy@second#1#2#3#4{#2} + +\def\fancypreview@refhook{% +\global\let\oldref\ref +\gdef\ref##1{\oldref{##1}\global\advance\fancycheckcount by 1\relax +\edef\templabel{fancyanchorref:\the\fancycheckcount}% +\expandafter\label\expandafter{\templabel}% +\expandafter\ifx \csname FancyToolTip@##1\endcsname\relax \else\hbox to 0 pt{% +% \end{macrocode} +% Here we extract the page number for the label destination. +% \begin{macrocode} + \expandafter\ifx \csname r@##1\endcsname \relax\else + \expandafter\let\expandafter\fancytooltip@temp@a\csname r@##1\endcsname + \edef\fan@tempa{\expandafter\fancy@second\fancytooltip@temp@a}% + \fi +% \end{macrocode} +% Here we extract the page number of the |\ref| command via faked label |fancyanchorref:\the\fancycheckcount|. +% \begin{macrocode} + \expandafter\ifx \csname r@fancyanchorref:\the\fancycheckcount\endcsname \relax\else + \expandafter\let\expandafter\fan@temp@w\csname r@fancyanchorref:\the\fancycheckcount\endcsname + \edef\fan@temp@ww{\expandafter\fancy@second\fan@temp@w}% + \fi +% \end{macrocode} +% We print tooltip after |\ref| only if both |\label| and |\ref| commands are on different pages +% \begin{macrocode} +\if@fancytooltips@previewall\def\fan@tempa{not a page number}\fi +\ifx\fan@tempa\fan@temp@ww\else\smash{% + \let\TooltipExtratext\relax\tooltip{\strut\TooltipRefmark}{##1}}% +\fi +\hss}% +\fi}% +% \end{macrocode} +% We replace the cite command. We test if natbib is loaded, if not, we redefine the command from article.cls. +% \begin{macrocode} +\ifx\NAT@citea@mbox\undefined +\def\@citex[##1]##2{\leavevmode + \let\@citea\@empty + \@cite{\@for\@citeb:=##2\do + {\@citea\def\@citea{,\penalty\@m\ }% + \edef\@citeb{\expandafter\@firstofone\@citeb\@empty}% + \if@filesw\immediate\write\@auxout{\string\citation{\@citeb}}\fi + \@ifundefined{b@\@citeb}{\hbox{\reset@font\bfseries ?}% + \G@refundefinedtrue + \@latex@warning + {Citation `\@citeb' on page \thepage \space undefined}}% + {\ifx\csname r@fancy:cite:\@citeb\endcsname\undefined \@cite@ofmt{\csname b@\@citeb\endcsname}\else\tooltip*{\@cite@ofmt{\csname b@\@citeb\endcsname}}{fancy:cite:\@citeb}\fi + }}}{##1}}% +\else +\def\NAT@citea@mbox{% + \@citea\mbox{\NAT@hyper@{{\citenumfont{\NAT@num}}}}\tooltip*{}{fancy:cite:\@citeb}} +\fi +} + +\if@fancytooltips@nosoap + \def\TooltipRefmark{\hbox{\ }}% +\else + \ifTooltip@usepdftex + \def\TooltipRefmark{\hbox {\smash{\raisebox{0.4em}{\includegraphics[width=0.7em]% + {fancytipmark\@@fancytipmark.pdf}}}}}% + \else + \def\TooltipRefmark{\hbox {\smash{\raisebox{0.4em}{\includegraphics[width=0.7em]% + {fancytipmark.eps}}}}}% + \fi%\ifTooltip@usepdftex +\fi%\if@fancytooltips@nosoap + +\if@fancytooltips@preview\AtBeginDocument{\fancypreview@refhook}\fi + +\if@fancytooltips@createtips +% \end{macrocode} +% This part (three lines) is processed if the option |createtips| is +% used. In the opposite case we process the second part, up to the end +% of the package. +% \begin{macrocode} +\newwrite\tipfile +\immediate\openout\tipfile \jobname.tips +\def\keytip#1{\write\tipfile{\string\tooltipname{#1}{\arabic{page}}}} +\expandafter\endinput\fi +% \end{macrocode} +% This part is processed if the option |createtips| is not used. We +% define macros which put the hidden button with the name |ikona.n| in +% the background of the page |n|, if one of the commands |\tooltip| or +% |\tooltipanim| has been used on this page. Javascripts defined by +% |\tooltip| and |\tooltipanim| commands then unhide this button and +% show the corresponding picture. +% \begin{macrocode} + +\ifx\TooltipFilename\undefined +\PackageWarning{fancytooltips}{** The filename with tooltips is not given. **} +\fi + +\ifTooltip@usepdftex +\RequirePackage[pdftex]{eforms} +\def\TooltipExtratext{\hbox{\smash{\raisebox{0.4em}{\includegraphics[width=0.7em]% + {fancytipmark\@@fancytipmark.pdf}}}}} +\else +\RequirePackage[dvips]{eforms} +\def\TooltipExtratext{\hbox{\smash{\raisebox{0.4em}{\includegraphics[width=0.7em]% + {fancytipmark.eps}}}}} +\fi%\ifTooltip@usepdftex + +\if@fancytooltips@nosoap + \def\TooltipExtratext{\hbox{\ }}% +\fi%\if@fancytooltips@nosoap + +\if@fancytooltips@extratext\else\let\TooltipExtratext\relax\fi + +\AtBeginDocument{ +\global\buttontipwidth=\paperwidth +\global\buttontipheight=\paperheight +} + +\ifTooltip@usepdftex +\def\frametip@{% + \pdfstartlink user{% + /Subtype /Widget + /F 6 + /T (ikona.\thepage) + /FT /Btn + /Ff 65536 + /H /N + /BS << /W 1 /S /S >> + /MK << /TP 1 /IF <</A[1.0 1.0]/SW /B>> >> + }% + \vbox to \buttontipheight {\vss\hbox to \buttontipwidth{\hss}}\pdfendlink}% +\else +% \end{macrocode} +% For dvips users we use the macros from eqxerquiz.sty package. +% \begin{macrocode} +\def\everyeqIcon#1{\def\every@eqIcon{#1}} +\def\every@eqIcon{} +\newcommand\eqIconFTT[4][] +{% + \push@@Button{#1}{#2}{#3}{#4}{}{\eq@setButtonProps\eq@Button@driver}% + {\eqIconDefaults\every@ButtonField\every@eqIcon}% +} +\def\eqIconDefaults +{% + \rawPDF{}\S{}\mkIns{/TP 1 /IF<</A[1.0 1.0]/SW/B>>}\R{0} + \CA{}\RC{}\AC{}\BC{}\BG{}\H{B} + \textColor{0 g}\Ff{\FfReadOnly} +} +\def\frametip@{\eqIconFTT[\BC{}\BG{}\F{\FHidden}]% + {ikona.\thepage}{\paperwidth}{\paperheight}% +}% +\fi%\ifTooltip@usepdftex + +\def\fancytooltips@one{1} +\if@fancytooltips@blur + \RequirePackage{ocg} + \ifx\fancytooltips@one\fancytooltips@transparency + \def\transparent#1{} + \else + \RequirePackage{transparent} + \fi +\else + \ifx\@ocg@makeknown\undefined + \def\@ocg@makeknown#1#2#3{}\fi +\fi + +\if@fancytooltips@fg +\else +\RequirePackage{eso-pic} +\def\frametip{% + \expandafter\ifx \csname TooltipPage\thepage\endcsname\relax + \else + \setbox0=\hbox{\frametip@}% + \hbox{\raise \dp0 \box0} + \fi}% +\AddToShipoutPicture{\hbox to 0 pt{\frametip\hss}} +\fi + +\def\fancytooltips@save@position{\pdfsavepos% + \write\@auxout{\string\global\string \fancy@layerVshift \the\pdflastypos sp\string\relax}% + \write\@auxout{\string\global\string \fancy@layerHshift \the\pdflastxpos sp\string\relax}% + \global\let\fancytooltips@save@position\relax% +} + +\def\fancy@beginshipout@hook{} +\AtBeginShipout{% +\TooltipPageopencloseJS +\setbox\AtBeginShipoutBox=\hbox{% + \hbox to 0 pt{\TooltipHidden}\global\def\TooltipHidden{}% + \fancy@beginshipout@hook\if@fancytooltips@fixcolor\hbox to 0 pt{\resizebox{1pt}{!}{\TooltipExtratext}\hss}\fi + \hbox to 0 pt{\box\AtBeginShipoutBox\hss}% + \ifTooltip@usepdftex + \fancytooltips@save@position + \if@fancytooltips@blur + \expandafter\ifx \csname TooltipPage\thepage\endcsname\relax \else + \lower\fancy@layerVshift\hbox to 0 pt{\kern-\fancy@layerHshift\relax + \begin{ocg}{fancyOCG\thepage}{fancyOCG\thepage}{0}% + \expandafter\transparent\expandafter{\fancytooltips@transparency}% + \color{black}% + \vbox to 0 pt{\vss\hbox{\vrule width \paperwidth height \paperheight}}% + \end{ocg}\hss}% + \fi + \fi%\if@fancytooltips@blur + \if@fancytooltips@fg + \expandafter\ifx \csname TooltipPage\thepage\endcsname\relax + \else + \lower\fancy@layerVshift\vbox to 0 pt{\vss\hbox to 0 pt{\kern-\fancy@layerHshift\relax\hbox{\frametip@}\hss}}% + \fi%\ifx + \lower\fancy@layerVshift\vbox to 0 pt{\vss\hbox to 0 pt{\kern-\fancy@layerHshift\relax\hbox to 0 pt{\the\pos@fancy@toks\hss}\hss}}% + \fi%\if@fancytooltips@fg + \fi%\ifTooltip@usepdftex + \kern\hsize}% +}% + +% \end{macrocode} +% In the macros |\tooltip| and |\tooltipanim| we print the text into +% box with zero dimensions and then we build a button which covers +% this text and has an associated JavaScript action. The important +% part is the |\PushButton| macro. You can adjust these macros or +% write similar macros which do what you need. +% \begin{macrocode} +\definecolor{tooltipcolor}{rgb}{0,0,1} + +\newcount\tooltip@count +\newtoks\tooltip@toks +\newtoks\tooltip@pagetoks +\tooltip@pagetoks={\thepage} +\def\tooltippage{} + +\def\TooltipPage#1#2{% +\expandafter\gdef\csname TooltipPage#2\endcsname{#2}% +\expandafter\gdef\csname Tooltipcount2page#1\endcsname{#2}% +} +% \end{macrocode} +% We use the hack for Adobe Acrobat suggested by DPS and Jorg at +% http://www.acrotex.net/forum/showthread.php?tid=78. +% \begin{macrocode} + +\def\fancy@JS#1{\JS{var DirtyBeforeTooltip=this.dirty; #1 + this.dirty=DirtyBeforeTooltip;}} + +\newcommand{\tooltip}{\@ifstar + \tooltip@Star% + \tooltip@NoStar% +} + +\newcommand{\tooltip@Star}[2]{{\color{tooltipcolor}#1}% + {\let\SaveTooltipExtratext\TooltipExtratext + \let\TooltipExtratext\relax + \hbox to 0 pt{\tooltip@NoStar{\SaveTooltipExtratext + \vrule height 10pt depth 0 pt width 0 pt}{#2}\hss}}} + +\newcommand{\tooltip@NoStar}[2]{% + \global\advance\tooltip@count by 1% + \edef\act{\write\@auxout{\noexpand\string\noexpand\TooltipPage{\the\tooltip@count}{\the\tooltip@pagetoks}}}\act + \expandafter\ifx\csname Tooltipcount2page\the\tooltip@count \endcsname\relax + \global\edef\tooltippage{} + \else + \global\edef\tooltippage{\csname Tooltipcount2page\the\tooltip@count \endcsname}% + \fi + \checkTipNumber{#2}\edef\TipNumber{\FindTipNumber{#2}}% + \leavevmode + \setbox0=\hbox{{\color{tooltipcolor}{#1}}}\copy0\fancy@a=\dp0\advance\fancy@a by \ht0\relax\hbox to 0 pt{\smash{\TooltipExtratext}\hss}\fancy@pushButton{\TipNumber}{\tooltippage}{TooltipField}{\wd0}{\fancy@a}{\dp0}} + +\def\fancy@tooltip@options#1#2{\BC{}\BG{} + \S{}\AA{\AAMouseExit{\fancy@JS{CloseTooltips();}}% + \if@fancytooltips@mouseover + \AAMouseEnter{\fancy@JS{this.getField("ikona."+(#2)).hidden=false; + try {app.clearInterval(animace);}catch (e) {} + \if@fancytooltips@movetips nastav(#1,#2);\fi + \if@fancytooltips@blur + try{ + for(var i=0; fancytooltipsOCGs && i<fancytooltipsOCGs.length;i++) + { + if(fancytooltipsOCGs[i].name == "fancyOCG"+(#2)) + fancytooltipsOCGs[i].state = true; + else + fancytooltipsOCGs[i].state = false; + }} catch (e) {}; + \fi + zobraz(#1,#2); + }} + \fi} + \A{\fancy@JS{this.getField("ikona."+(#2)).hidden=false; + try {app.clearInterval(animace);}catch (e) {} + \if@fancytooltips@movetips nastav(#1,#2);\fi + \if@fancytooltips@blur + try { + for(var i=0; fancytooltipsOCGs && i<fancytooltipsOCGs.length;i++) + { + if(fancytooltipsOCGs[i].name == "fancyOCG"+(#2)) + fancytooltipsOCGs[i].state = true; + else + fancytooltipsOCGs[i].state = false; + }} catch (e) {}; + \fi + zobraz(#1,#2); + }}} + +\newtoks\@fxtoks\@fxtoks={\the\pdflastxpos} +\newtoks\@fytoks\@fytoks={\the\pdflastypos} + +\def\fancy@pushButton#1#2#3#4#5#6{% + \lower #6\hbox to 0 pt{\hss\expandafter\pushButton\expandafter[\fancy@tooltip@options{#1}{#2}]{#3}{#4}{#5}}} +\def\fancy@@pushButton#1#2#3#4#5#6#7#8{} + +\ifTooltip@usepdftex +\if@fancytooltips@fg +\def\fancy@pushButton#1#2#3#4#5#6{\pdfsavepos% + \edef\act{\write\@auxout{\string\fancy@@pushButton{#1}{#2}{#3}{\the#4}{\the#5}{\the\@fxtoks}{\the\@fytoks}{\the#6}}}\act% +} +\def\fancy@@pushButton#1#2#3#4#5#6#7#8{% + \expandafter\global\expandafter\pos@fancy@toks\expandafter{\the\pos@fancy@toks\fancy@onlypage{#2}{\vbox to 0 pt{\vss\hbox to 0 pt{\kern #6 sp\hbox to 0 pt{\hss\expandafter\pushButton\expandafter[\fancy@tooltip@options{#1}{#2}]{#3}{#4}{#5}}\hss}\kern #7sp\kern-#8}}}} +\fi +\fi + + +\def\fancy@onlypage#1#2{\def\ft@a{#1}\edef\ft@b{\thepage}% +\ifx\ft@a\ft@b#2\fi} + + +\def\delayinterval{200} + +\newcommand{\tooltipanim}{\@ifstar + \tooltipanim@Star% + \tooltipanim@NoStar% +} + +\newcommand{\tooltipanim@Star}[3]{{\color{tooltipcolor}#1}% + {\let\SaveTooltipExtratext\TooltipExtratext + \let\TooltipExtratext\relax + \hbox to 0 pt{\tooltipanim@NoStar{\SaveTooltipExtratext + \vrule height 10pt depth 0 pt width 0 pt}{#2}{#3}\hss}}} + +\newcommand{\tooltipanim@NoStar}[3]{% + \global\advance\tooltip@count by 1% + \edef\act{\write\@auxout{\noexpand\string\noexpand\TooltipPage{\the\tooltip@count}{\the\tooltip@pagetoks}}}\act + \expandafter\ifx\csname Tooltipcount2page\the\tooltip@count \endcsname\relax + \global\edef\tooltippage{} + \else + \global\edef\tooltippage{\csname Tooltipcount2page\the\tooltip@count \endcsname}% + \fi + \checkTipNumber{#2}\edef\TipNumberA{\FindTipNumber{#2}}% + \checkTipNumber{#3}\edef\TipNumberB{\FindTipNumber{#3}}% + \leavevmode + \setbox0=\hbox{{\color{tooltipcolor}{#1}}}\copy0\fancy@a=\dp0\advance\fancy@a by \ht0\relax\hbox to 0 pt{\smash{\TooltipExtratext}\hss}\fancy@anim@pushButton{\TipNumberA}{\tooltippage}{TooltipField}{\wd0}{\fancy@a}{\dp0}{\TipNumberB}} + + +\def\fancy@tooltipanim@options#1#2#3{ +\BC{}\BG{}\S{}\AA{\AAMouseExit{\fancy@JS{CloseTooltips();}} + \if@fancytooltips@mouseover + \AAMouseEnter{\fancy@JS{ + try {app.clearInterval(animace);}catch (e) {} + var cislo=#1; + \if@fancytooltips@movetips nastav(#1,#2);\fi + \if@fancytooltips@blur + try{ + for(var i=0; fancytooltipsOCGs && i<fancytooltipsOCGs.length;i++) + { + if(fancytooltipsOCGs[i].name == "fancyOCG"+(#2)) + fancytooltipsOCGs[i].state = true; + else + fancytooltipsOCGs[i].state = false; + }} catch (e) {}; + \fi + function animuj() + { + var DirtyBeforeTooltipanim=this.dirty; + if (cislo<#3) cislo=cislo+1; + this.getField('ikona.'+(#2)).buttonSetIcon(this.getField("animtiph."+cislo).buttonGetIcon()); + this.dirty=DirtyBeforeTooltipanim; + }; + this.getField('ikona.'+(#2)).buttonSetIcon(this.getField("animtiph."+#1).buttonGetIcon()); + this.getField("ikona."+(#2)).hidden=false; + animace=app.setInterval('animuj();', \delayinterval); + }} + \fi} + \A{\fancy@JS{ + try {app.clearInterval(animace);}catch (e) {} + var cislo=#1; + \if@fancytooltips@movetips nastav(#1,#2);\fi + \if@fancytooltips@blur + try{ + for(var i=0; fancytooltipsOCGs && i<fancytooltipsOCGs.length;i++) + { + if(fancytooltipsOCGs[i].name == "fancyOCG"+(#3)) + fancytooltipsOCGs[i].state = true; + else + fancytooltipsOCGs[i].state = false; + }} catch (e) {}; + \fi + function animuj() + { + var DirtyBeforeTooltipanim=this.dirty; + if (cislo<#3) cislo=cislo+1; + this.getField('ikona.'+(#2)).buttonSetIcon(this.getField("animtiph."+cislo).buttonGetIcon()); + this.dirty=DirtyBeforeTooltipanim; + }; + this.getField('ikona.'+(#2)).buttonSetIcon(this.getField("animtiph."+#1).buttonGetIcon()); + this.getField("ikona."+(#2)).hidden=false; + animace=app.setInterval('animuj();', \delayinterval); + }} +} + + +\def\fancy@anim@pushButton#1#2#3#4#5#6#7{% + \lower #6 \hbox to 0 pt{\hss\expandafter\pushButton\expandafter[\fancy@tooltipanim@options{#1}{#2}{#7}]{#3}{#4}{#5}}} +\def\fancy@@anim@pushButton#1#2#3#4#5#6#7#8#9{} + +\ifTooltip@usepdftex +\if@fancytooltips@fg +\def\fancy@anim@pushButton#1#2#3#4#5#6#7{\pdfsavepos% + \edef\act{\write\@auxout{\string\fancy@@anim@pushButton{#1}{#2}{#3}{\the#4}{\the#5}{\the\@fxtoks}{\the\@fytoks}{\the#6}{#7}}}\act% +} +\def\fancy@@anim@pushButton#1#2#3#4#5#6#7#8#9{% + \expandafter\global\expandafter\pos@fancy@toks\expandafter{\the\pos@fancy@toks\fancy@onlypage{#2}{\vbox to 0 pt{\vss\hbox to 0 pt{\kern #6 sp\hbox to 0 pt{\hss\expandafter\pushButton\expandafter[\fancy@tooltipanim@options{#1}{#2}{#9}]{#3}{#4}{#5}}\hss}\kern #7sp\kern-#8}}}} +\fi +\fi + + +% \end{macrocode} +% This code closes tooltip if the page is closed. +% \begin{macrocode} +\edef\fancytooltips@pdfpageattrJS{% + var DirtyBeforeCloseTooltip=this.dirty; + \if@fancytooltips@blur + try{ + var temp = fancytooltipsOCGs.length; + for(var i=0; fancytooltipsOCGs && i<fancytooltipsOCGs.length;i++) + { + fancytooltipsOCGs[i].state = false; + } + } + catch (e){} + \fi + CloseTooltips(); + this.dirty=DirtyBeforeCloseTooltip; +} +\ifTooltip@usepdftex +\edef\fancy@temp{/AA << /O << /S /JavaScript /JS ( + \fancytooltips@pdfpageattrJS) >> >>} +\expandafter\def\expandafter\TooltipPageopencloseJS\expandafter{ +\expandafter\global\expandafter\pdfpageattr\expandafter{\fancy@temp}% +} +\pdfximage{\TooltipFilename.pdf}% +\edef\TooltipPages{\the\pdflastximagepages}% +\else +\edef\fancy@temp{ [ {ThisPage} << /AA << + /O << /S /JavaScript /JS (var DirtyBeforeCloseTooltip=this.dirty; CloseTooltips(); this.dirty=DirtyBeforeCloseTooltip;) >> + >> >> /PUT pdfmark} +\expandafter\def\expandafter\TooltipPageopencloseJS\expandafter{ +\expandafter\literalps@out\expandafter{\fancy@temp}} +\edef\fancy@@temp{/S /JavaScript /JS ( \fancytooltips@pdfpageattrJS)} +\expandafter\OpenAction\expandafter{\fancy@@temp} +\fi%\ifTooltip@usepdftex + +\ifTooltip@usepdftex +\def\fancytempA{} +\ifx\FancytooltipsAfterClose\undefined\else\edef\fancytempA{\FancytooltipsAfterClose}\fi +\def\fancytempAA{} +\ifx\FancytooltipsAfterShow\undefined\else\edef\fancytempAA{\FancytooltipsAfterShow}\fi + +\if@fancytooltips@blur +\def\fancytempAAA{ +% \end{macrocode} +% OCG's have not been initialized yet, do it now. +% \begin{macrocode} + var inifancytooltipsOCGs = this.getOCGs(); + var fancytooltipsOCGs = []; + for(var i=0; inifancytooltipsOCGs && i<inifancytooltipsOCGs.length;i++) + { + if(inifancytooltipsOCGs[i].name.substr(0,5) == "fancy") + { + fancytooltipsOCGs.push(inifancytooltipsOCGs[i]); + inifancytooltipsOCGs[i].state=false; + } + } + inifancytooltipsOCGs[0].state=true; + inifancytooltipsOCGs[0].state=false; +} +\else +\def\fancytempAAA{} +\fi + +\if@fancytooltips@blur +\def\fancytempB{ + try {for(var i=0; fancytooltipsOCGs && i<fancytooltipsOCGs.length;i++) + {fancytooltipsOCGs[i].state = false;} } catch (e) {}} +\else +\def\fancytempB{} +\fi + + +\begin{insDLJS}[fancyTooltipsLoaded]{Tooltipsdljs}{DLJS for Tooltips} + \fancytooltipsdebugmsg + + var animace; + var fancyTooltipsLoaded = true; + + \fancytempAAA + + function CloseTooltips() + { + try {this.getField("ikona").hidden=true;}catch (e) {} + try {app.clearInterval(animace);}catch (e) {} + \fancytempB + \fancytempA + } + + function nastav(cislo,strana) + { + var f=this.getField("ikona."+(strana)); + var g=this.getField("animtiph."+cislo); + var sourf=f.rect; + var sourg=g.rect; + if ((mouseX+sourg[2]-sourg[0])<sourf[2]) + var percX=100*(mouseX-sourf[0])/((sourf[2]-sourf[0])-(sourg[2]-sourg[0])); + else + var percX=100*(mouseX-sourf[0]-(sourg[2]-sourg[0]))/((sourf[2]-sourf[0])-(sourg[2]-sourg[0])); + var percY=100*(mouseY-sourf[3])/((sourf[1]-sourf[3])-(sourg[1]-sourg[3])); + if (percX>100) percX=100; + if (percY>100) percY=100; + if (percX<0) percX=0; + if (percY<0) percY=0; + f.buttonAlignX=percX; + f.buttonAlignY=percY; + } + + function zobraz(cislo,strana) + { + var f=this.getField("ikona."+(strana)); + var g=this.getField("animtiph."+cislo); + f.hidden=false; + f.buttonSetIcon(g.buttonGetIcon()); + \fancytempAA + } + + this.dirty=false; + app.focusRect = false; +\end{insDLJS} +\else +\begin{insDLJS}[fancyTooltipsLoaded]{Tooltipsdljs}{DLJS for Tooltips} + var animace; + var fancyTooltipsLoaded = true; + + \fancytooltipsdebugmsg + + function CloseTooltips() + { + try {this.getField("ikona").hidden=true;}catch (e) {} + try {app.clearInterval(animace);}catch (e) {} + } + + function ImportTooltips() + { + console.println("importing pictures"); + for (var i=1;i<=\TooltipPages;i++) + { + this.insertPages(this.numPages-1,"\TooltipFilename.pdf",(i-1),(i-1)); + var rozm=this.getPageBox("Crop",this.numPages-1); + this.deletePages(this.numPages-1); + var p=this.addField("animtiph."+i,"button",0,rozm); + p.buttonPosition=position.iconOnly; + p.hidden=true; + this.getField("animtiph."+i).buttonImportIcon("\TooltipFilename.pdf",(i-1)); + } + console.println("Imported \TooltipPages pictures, save the PDF file."); + return(1); + } + + function nastav(cislo,strana) + { + var f=this.getField("ikona."+(strana)); + var g=this.getField("animtiph."+cislo); + var sourf=f.rect; + var sourg=g.rect; + if ((mouseX+sourg[2]-sourg[0])<sourf[2]) + var percX=100*(mouseX-sourf[0])/((sourf[2]-sourf[0])-(sourg[2]-sourg[0])); + else + var percX=100*(mouseX-sourf[0]-(sourg[2]-sourg[0]))/((sourf[2]-sourf[0])-(sourg[2]-sourg[0])); + var percY=100*(mouseY-sourf[3])/((sourf[1]-sourf[3])-(sourg[1]-sourg[3])); + if (percX>100) percX=100; + if (percY>100) percY=100; + if (percX<0) percX=0; + if (percY<0) percY=0; + f.buttonAlignX=percX; + f.buttonAlignY=percY; + } + + function zobraz(cislo,strana) + { + var f=this.getField("ikona."+(strana)); + var g=this.getField("animtiph."+cislo); + f.hidden=false; + f.buttonSetIcon(g.buttonGetIcon()); + } + + this.dirty=false; + app.focusRect = false; +\end{insDLJS} +\fi +% \end{macrocode} +% A cycle is used to create hidden buttons. Each button has associated a page +% from the file with tooltips as icon. These icons are invoked by JavaScripts +% defined in |\tooltip| and |\tooltipanim| macros. +% \begin{macrocode} +\newcount\tooltip@count +\ifTooltip@usepdftex +\newcommand*{\TooltipHidden}{% + \count@=0 + \@whilenum\count@<\TooltipPages \do{% + \tooltip@count=\count@ + \advance \tooltip@count by 1% + \bgroup + \immediate\pdfximage + page \the\tooltip@count{\TooltipFilename.pdf}% + \mbox{\leavevmode + \vbox to 0 pt{\vss\hbox to 0 pt{\pdfstartlink user{% + /Subtype /Widget + /F 6 + /T (animtiph.\the\tooltip@count) + /FT /Btn + /Ff 65536 + /H /N + /BS << /W 1 /S /S >> + /MK << + /TP 1 + /I \the\pdflastximage\space 0 R + /IF << /SW /A >> + >> + }% + \phantom{\pdfrefximage \pdflastximage}% + \pdfendlink\hss}}}% + \egroup + \advance\count@\@ne}% +} +\else +\let\TooltipHidden\relax +\fi +% \end{macrocode} +% The keywords for the tooltips can be stored in the file +% |\TooltipFilename.tips|. The topics in this file are created by +% |\keytip| macro (see the first part of the code). +% \begin{macrocode} +\AtBeginDocument{\IfFileExists{\TooltipFilename.tips}% + {\input{\TooltipFilename.tips} + \PackageInfo{fancytooltips}{Inputting \TooltipFilename.tips.}}% + {\PackageWarning{fancytooltips}{No file \TooltipFilename.tips! + Your keywords for tooltips will not work!}}} + +\def\tooltipname#1#2{\expandafter\xdef\csname FancyToolTip@#1\endcsname{#2}} + +\def\FindTipNumber#1{\expandafter\ifx \csname FancyToolTip@#1\endcsname\relax + #1\else\csname FancyToolTip@#1\endcsname\fi} + +\def\checkTipNumber#1{\expandafter\ifx + \csname FancyToolTip@#1\endcsname\relax \PackageInfo{fancytooltips}{No + framenumber is assigned to keyword #1. I assume that #1 is the + number of the frame.}% + \fi} + +%</package> +% \end{macrocode} +% +% \Finale +\endinput + + + |