From 32d0671418a3cc6ad0465b06539ed54d96f77784 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Thu, 13 Jul 2017 09:30:28 +0900 Subject: add artthreads cntdwn ecards fc-arith fldigigal --- texmf-dist/doc/latex/fldigigal/README | 24 ++ .../doc/latex/fldigigal/digis/Chrysanthemum.jpg | Bin 0 -> 879394 bytes texmf-dist/doc/latex/fldigigal/digis/Desert.jpg | Bin 0 -> 845941 bytes .../doc/latex/fldigigal/digis/Hydrangeas.jpg | Bin 0 -> 595284 bytes texmf-dist/doc/latex/fldigigal/digis/Jellyfish.jpg | Bin 0 -> 775702 bytes texmf-dist/doc/latex/fldigigal/digis/Koala.jpg | Bin 0 -> 780831 bytes .../doc/latex/fldigigal/digis/Lighthouse.jpg | Bin 0 -> 561276 bytes texmf-dist/doc/latex/fldigigal/digis/Penguins.jpg | Bin 0 -> 777835 bytes texmf-dist/doc/latex/fldigigal/digis/Tulips.jpg | Bin 0 -> 620888 bytes texmf-dist/doc/latex/fldigigal/fdg_demo.tex | 59 +++ texmf-dist/doc/latex/fldigigal/fdg_demo_fit.tex | 60 +++ texmf-dist/doc/latex/fldigigal/fdg_man.pdf | Bin 0 -> 205291 bytes texmf-dist/doc/latex/fldigigal/fdg_man.tex | 407 +++++++++++++++++++++ texmf-dist/doc/latex/fldigigal/fldigigal.dvi | Bin 0 -> 28376 bytes 14 files changed, 550 insertions(+) create mode 100644 texmf-dist/doc/latex/fldigigal/README create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Chrysanthemum.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Desert.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Hydrangeas.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Jellyfish.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Koala.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Lighthouse.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Penguins.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/digis/Tulips.jpg create mode 100644 texmf-dist/doc/latex/fldigigal/fdg_demo.tex create mode 100644 texmf-dist/doc/latex/fldigigal/fdg_demo_fit.tex create mode 100644 texmf-dist/doc/latex/fldigigal/fdg_man.pdf create mode 100644 texmf-dist/doc/latex/fldigigal/fdg_man.tex create mode 100644 texmf-dist/doc/latex/fldigigal/fldigigal.dvi (limited to 'texmf-dist/doc/latex/fldigigal') diff --git a/texmf-dist/doc/latex/fldigigal/README b/texmf-dist/doc/latex/fldigigal/README new file mode 100644 index 00000000..6e2ebb7d --- /dev/null +++ b/texmf-dist/doc/latex/fldigigal/README @@ -0,0 +1,24 @@ +The fldigigal package +Dated: 12/28/10 + +The fldigigal package uses the rmannot package (Adobe Distiller workflow +required) to create, what I am calling, an AcroTeX Flash Digital Gallery; +that is, a Flash slide show that displays a series of digitals (PNG, JPG, +GIF). The document author describes the digitals (path and caption) from +the LaTeX source, on compilation, fldigigal write an XML file, which +Distiller embeds in the PDF. The digitals may be embedded in the PDF, or +reside on the Internet (reducing filesize). Three layouts of are offered +at this time: vertical thumbnails, horizontal thumbnails, or no +thumbnails. + +The home page for this package is + +http://www.math.uakron.edu/~dpstory/fldigigal.html + +Now, I simply must get back to my retirement. + +Dr. D. P. Story +www.acrotex.net +dpstory@uakron.edu +dpstory@acrotex.net +12/28/10 diff --git a/texmf-dist/doc/latex/fldigigal/digis/Chrysanthemum.jpg b/texmf-dist/doc/latex/fldigigal/digis/Chrysanthemum.jpg new file mode 100644 index 00000000..757c2a62 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Chrysanthemum.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Desert.jpg b/texmf-dist/doc/latex/fldigigal/digis/Desert.jpg new file mode 100644 index 00000000..0b88c913 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Desert.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Hydrangeas.jpg b/texmf-dist/doc/latex/fldigigal/digis/Hydrangeas.jpg new file mode 100644 index 00000000..a587c965 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Hydrangeas.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Jellyfish.jpg b/texmf-dist/doc/latex/fldigigal/digis/Jellyfish.jpg new file mode 100644 index 00000000..fa4fd411 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Jellyfish.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Koala.jpg b/texmf-dist/doc/latex/fldigigal/digis/Koala.jpg new file mode 100644 index 00000000..78704a09 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Koala.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Lighthouse.jpg b/texmf-dist/doc/latex/fldigigal/digis/Lighthouse.jpg new file mode 100644 index 00000000..494be09b Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Lighthouse.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Penguins.jpg b/texmf-dist/doc/latex/fldigigal/digis/Penguins.jpg new file mode 100644 index 00000000..030ab8a6 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Penguins.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/digis/Tulips.jpg b/texmf-dist/doc/latex/fldigigal/digis/Tulips.jpg new file mode 100644 index 00000000..54c51eb6 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/digis/Tulips.jpg differ diff --git a/texmf-dist/doc/latex/fldigigal/fdg_demo.tex b/texmf-dist/doc/latex/fldigigal/fdg_demo.tex new file mode 100644 index 00000000..6b2251f1 --- /dev/null +++ b/texmf-dist/doc/latex/fldigigal/fdg_demo.tex @@ -0,0 +1,59 @@ +\documentclass{article} +\usepackage[% + web={pro,tight,usesf,designiv},eforms, + graphicxsp={showembeds} +]{aeb_pro} +\usepackage{rmannot} +\usepackage{fldigigal} + +\DeclareDocInfo +{ + title={An \texorpdfstring{\AcroTeX}{AcroTeX} Flash Digital Gallery}, + author=D. P. Story, + university=From the Desktop of One D. P. Story, + email=dpstory@acrotex.net, + subject={An example of the AcroTeX Flash Digital Gallery}, + keywords={AcroTeX, Adobe Flash, rmannot, fldigigal package}, + talksite=\url{http://www.acrotex.net}, + talkdate={\today}, + copyrightStatus=True, + copyrightNotice={Copyright (C) 2010, D. P. Story}, + copyrightInfoURL=http://www.acrotex.net +} +\talkdateLabel{Published:} + +\def\AcroTeX{Acro\!\TeX} + +\definePath{\pathToSource}{% + C:/Users/Public/Documents/My TeX Files/tex/% + latex/aeb/aebpro/fldigigal/examples} +\definePath{\digisOnline}{% + http://www.math.uakron.edu/~dpstory/photos/pa_demo} +\definePath{\digisLocal}{\pathToSource/digis} + +\fdgXmlList[showcount]{myDigis} +{% + \image{path=\digisOnline/Chrysanthemum.jpg, + caption=Jürgen\'s Chrysanthemum,online} + \image{path=\digisOnline/Desert.jpg,caption=Desert,online} + \image{path=\digisOnline/Hydrangeas.jpg,caption=Hydrangeas,online} + \image{path=\digisOnline/Jellyfish.jpg,caption=Jellyfish,online} + \image{path=\digisOnline/Koala.jpg,caption=Koala,online} + \image{path=\digisOnline/Lighthouse.jpg,caption=Lighthouse,online} + \image{path=\digisOnline/Penguins.jpg,caption=Penguins,online} + \image{path=\digisOnline/Tulips.jpg,caption=Tulips,online} +} + +\parindent=0pt\parskip6pt\pagestyle{empty} + +\begin{document} + +\begin{center} +\resizebox{.9\linewidth}{!} +{% + \fgRmAnnot[galleryopts={gallery=vthumbs1,captionalign=center}, + posternote={Flash Digital Gallery},enabled=pageopen + ]{myDigis} +} +\end{center} +\end{document} diff --git a/texmf-dist/doc/latex/fldigigal/fdg_demo_fit.tex b/texmf-dist/doc/latex/fldigigal/fdg_demo_fit.tex new file mode 100644 index 00000000..48e417c8 --- /dev/null +++ b/texmf-dist/doc/latex/fldigigal/fdg_demo_fit.tex @@ -0,0 +1,60 @@ +\documentclass{article} +\usepackage[% + web={pro,tight,usesf}, + eforms,graphicxsp={showembeds} +]{aeb_pro} +\usepackage{rmannot} +\usepackage{fldigigal} + +\margins{0in}{0in}{0in}{0in} % left,right,top, bottom +\screensize{240bp}{320bp} % height, width + + +\DeclareDocInfo +{ + title={An \texorpdfstring{\AcroTeX}{AcroTeX} Flash Digital Gallery}, + author=D. P. Story, + university=From the Desktop of One D. P. Story, + email=dpstory@acrotex.net, + subject={An example of the AcroTeX Flash Digital Gallery}, + keywords={AcroTeX, Adobe Flash, rmannot, fldigigal package}, + talksite=\url{http://www.acrotex.net}, + talkdate={\today}, + copyrightStatus=True, + copyrightNotice={Copyright (C) 2010, D. P. Story}, + copyrightInfoURL=http://www.acrotex.net +} +\talkdateLabel{Published:} + +\def\AcroTeX{Acro\!\TeX} + +\definePath{\pathToSource}{% + C:/Users/Public/Documents/My TeX Files/tex/% + latex/aeb/aebpro/fldigigal/examples} +\definePath{\digisOnline}{% + http://www.math.uakron.edu/~dpstory/photos/pa_demo} +\definePath{\digisLocal}{\pathToSource/digis} + +\fdgXmlList{myDigis} +{% + \image{path=\digisOnline/Chrysanthemum.jpg, + caption=J\iso{252}rgen\'s Chrysanthemum,online} + \image{path=\digisOnline/Desert.jpg,caption=Desert,online} + \image{path=\digisOnline/Hydrangeas.jpg,caption=Hydrangeas,online} + \image{path=\digisOnline/Jellyfish.jpg,caption=Jellyfish,online} + \image{path=\digisOnline/Koala.jpg,caption=Koala,online} + \image{path=\digisOnline/Lighthouse.jpg,caption=Lighthouse,online} + \image{path=\digisOnline/Penguins.jpg,caption=Penguins,online} + \image{path=\digisOnline/Tulips.jpg,caption=Tulips,online} +} + +\parindent=0pt\parskip0pt\pagestyle{empty} + +\begin{document} + +\fgRmAnnot[% + galleryopts={gallery=vthumbs1,auto=false}, + posternote={Flash Digital Gallery},enabled=pageopen +]{myDigis} + +\end{document} diff --git a/texmf-dist/doc/latex/fldigigal/fdg_man.pdf b/texmf-dist/doc/latex/fldigigal/fdg_man.pdf new file mode 100644 index 00000000..e99b1d9d Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/fdg_man.pdf differ diff --git a/texmf-dist/doc/latex/fldigigal/fdg_man.tex b/texmf-dist/doc/latex/fldigigal/fdg_man.tex new file mode 100644 index 00000000..2665aef5 --- /dev/null +++ b/texmf-dist/doc/latex/fldigigal/fdg_man.tex @@ -0,0 +1,407 @@ +% makeindex < aebpro_man.idx > aebpro_man.ind +\documentclass{article} +\usepackage[fleqn]{amsmath} +\usepackage[ + web={centertitlepage,designv,tight,usetemplates,%usesf, + forcolorpaper,latextoc,pro}, + eforms,aebxmp,graphicxsp={showembeds} +]{aeb_pro} +\usepackage{rmannot} +\usepackage{fldigigal} + +%\usepackage{multicol} +\usepackage{aeb_mlink} +\usepackage{array} +\usepackage[altbullet]{lucidbry} +%\usepackage{myriadpro} + +\usepackage{makeidx} +\makeindex +\usepackage{acroman} + +\usepackage[inactive]{srcltx} + +\def\expath{../examples} + +\urlstyle{tt} + +\makeatletter +\renewcommand{\paragraph} + {\@startsection{paragraph}{4}{0pt}{6pt}{-3pt}{\bfseries}} +\makeatother + +\DeclareDocInfo +{ + university={\AcroTeX.Net}, + title={The \texorpdfstring{\textsf{fldigigal} Package\\[1em]}{: } + Creating Flash Digital Galleries}, + author={D. P. Story}, + email={dpstory@acrotex.net}, + subject={Creating Flash Digital Galleries}, + talksite={\url{www.acrotex.net}}, + version={1.0}, + keywords={AcroTeX, PDF, Flash Photo Gallery, rmannot}, + copyrightStatus=True, + copyrightNotice={Copyright (C) \the\year, D. P. Story}, + copyrightInfoURL={http://www.acrotex.net} +} + +\def\dps{$\hbox{$\mathfrak D$\kern-.3em\hbox{$\mathfrak P$}% + \kern-.6em \hbox{$\mathcal S$}}$} + +\universityLayout{fontsize=Large} +\titleLayout{fontsize=LARGE} +\authorLayout{fontsize=Large} +\tocLayout{fontsize=Large,color=aeb} +\sectionLayout{indent=-40pt,fontsize=large,color=aeb,afterskip=1sp} +\subsectionLayout{indent=-20pt,color=aeb,afterskip=1sp} +\subsubsectionLayout{indent=0pt,color=aeb,afterskip=1sp} +\subsubDefaultDing{\texorpdfstring{$\bullet$}{\textrm\textbullet}} + +\newenvironment{eqComments}[1][\strut]{\smallskip\leftskip-\labelwidth +\item[]\textbf{\textcolor{blue}{#1}}}{\par\smallskip} + +%----------fldigigal-------------- +\definePath{\pathToSource}{% + C:/Users/Public/Documents/My TeX Files/tex/% + latex/aeb/aebpro/fldigigal/examples} +\definePath{\digisOnline}{% + http://www.math.uakron.edu/~dpstory/photos/pa_demo} +\definePath{\digisLocal}{\pathToSource/digis} + +\fdgXmlList{myDigis} +{% + \image{path=\digisOnline/Chrysanthemum.jpg,caption=Jürgen\'s Chrysanthemum,online} %\iso{252} + \image{path=\digisOnline/Desert.jpg,caption=Desert,online} + \image{path=\digisOnline/Hydrangeas.jpg,caption=Hydrangeas,online} + \image{path=\digisOnline/Jellyfish.jpg,caption=Jellyfish,online} + \image{path=\digisOnline/Koala.jpg,caption=Koala,online} + \image{path=\digisOnline/Lighthouse.jpg,caption=Lighthouse,online} + \image{path=\digisOnline/Penguins.jpg,caption=Penguins,online} + \image{path=\digisOnline/Tulips.jpg,caption=Tulips,online} +} +%---------fldigigal--------------------- + +%\pagestyle{empty} +\parindent0pt\parskip\medskipamount + +\definePath\bgPath{"C:/Users/Public/Documents/ManualBGs/Manual_BG_Print_AeB.pdf"} +\begin{docassembly} +\addWatermarkFromFile({ + bOnTop:false, + cDIPath:\bgPath +}); +\executeSave(); +\end{docassembly} + +\begin{document} + +\maketitle + +\selectColors{linkColor=black} +\tableofcontents +\selectColors{linkColor=webgreen} + +\section{Introduction}\label{s:intro} + +The \textsf{fldigigal} package is the third application of \textsf{rmannot}; +the others are the {\AcroFLeX} and \textsf{yt4pdf} packages. + +The \emph{Flash Digital Gallery} distribution consists of a {\LaTeX} +package, \textsf{fldigigal}, several \textsf{SWF} files, a small collection +of digital photos, and sample files. The purpose of this distribution is +to provide a convenient way to create a Flash slideshow. The distribution +offers several design layouts of the slideshow, called \emph{galleries}. +Below is an example of a slideshow created by \textsf{fldigigal} using +source code from this document. +\begin{center}%\previewtrue +\resizebox{.9\linewidth}{!} +{% + \fgRmAnnot[galleryopts={gallery=vthumbs1,auto=false,captionalign=center}, + posternote={Flash Digital Gallery},enabled=pageopen + ]{myDigis} +} +\end{center} +The photos themselves may be embedded in the PDF file (increasing the +file size), or may be referenced with an URL. The gallery can be manually +operated, or set to change photos at a regular interval. + +There are steps for creating a flash digital gallery: +\begin{enumerate} + \item In the preamble of your document, specify the digitals (PNG, + JPG, GIF) you want displayed in you gallery. This is entered by + using the \cs{fdgXmlList} command. See the section + \Nameref{fdgXmlList} for details. + \item In the body of the document, create a Rich Media Annotation (RMA) + using the command \cs{fgRmAnnot}, defined in \textsf{fldigigal}. For + details of this command, see the section + \Nameref{fgRmAnnot}. +\end{enumerate} + + + +\section{Requirements} + +This package is part of \textsf{AeB Pro}, which means Acrobat Distiller is +used to create the PDF; the package requires \textsf{rmannot}, which +creates rich media annotations. Therefore, we require +\begin{equation*} + \boxed{\text{\large\bfseries Adobe Acrobat, version 9.0 or later}} +\end{equation*} +To use this package, the document author must have AeB and AeB Pro +installed, as well as \textsf{rmannot}. The manual for \textsf{rmannot} +needs to be read closely to install it properly and for it to function correctly. + +\section{Configuring your installation} + +In addition to configuring the \textsf{rmannot} package correctly, the +\textsf{fldigigal} package needs configuring as well. The \textsf{fldigigal} +comes with a configuration file \texttt{fldigigal.cfg}. Open this file in +your favorite editor to see +\begin{Verbatim}[fontsize=\small] +% fldigigal config file. Delete the \endinput below and replace the path +% provided with the path to the swf folder of your fldigigal installation. +% This path is used to locate the fldigigal SWF files. +\endinput +\renewcommand{\fdgFolder}{C:/Users/Public/Documents/My TeX Files/% + tex/latex/aeb/aebpro/fldigigal/swf} +\end{Verbatim} +Edit this file so that \cs{fdgFolder} points to the \texttt{swf} folder on +your computer. + +\section{In the Preamble: Populating the +\texorpdfstring{\protect\cs{fdgXmlList}}{\CMD{fdgXmlList}} +Command}\label{fdgXmlList} + +The {\AcroTeX} Flash Gallery SWF files take several arguments that are +passed to it using \texttt{FlashVars}; one such variable is a reference to +an XML file that contains the paths and captions to the digital files. +When I began developing the package, the XML file was just hand-written in +an editor; when I started to write the package, I included the +\cs{fdgXmlList} command which writes the XML file as the source file is +compiled. + +At the bare minimum, the preamble must include a definition for +\cs{pathToSource} and the \cs{fdgXmlList} command. + +The definition of \cs{pathToSource} should be made using the +\cs{definePath} command, defined in the \textsf{eforms} package. +Here is one such definition to a sample file in this distribution. +\begin{Verbatim}[xleftmargin=20pt,fontsize=\small] +\definePath{\pathToSource}{% + C:/Users/Public/Documents/My TeX Files/tex/% + latex/aeb/aebpro/fldigigal/examples} +\end{Verbatim} +The \textsf{fldigigal} uses the Adobe Distiller to create the PDF file. +Distiller only works with absolute file references; so, Distiller needs to +know the location of XML file that is to be written by the \cs{fdgXmlList} +command. \emph{This definition is required}. + +Another (optional, but recommended) definition is the path to the digital +files. The photos may reside on your local hard drive, or on the Internet. +In the example that follows, we illustrate the method of defining the +paths; one for a local hard drive, the other for photos found online. +\begin{Verbatim}[xleftmargin=20pt,fontsize=\small] +\definePath{\digisOnline}{% + http://www.math.uakron.edu/~dpstory/photos/pa_demo} +\definePath{\digisLocal}{\pathToSource/digis} +\end{Verbatim} +These paths may then be conveniently included in the \texttt{path} key +of the \cs{image} command, see below. + +\begin{dCmd*}{.67\linewidth} +\fdgXmlList[]{}{% + \image{...} + \image{...} + ... + \image{...} +} +\end{dCmd*} +\CmdDescription When the source document compiles, this command writes an +XML file to the source file's folder. The XML is later embedded in the PDF +file when the file is distilled. +\PD The command has three arguments, the first is optional. +\begin{itemize} + \item[\texttt{[\#1]}] The optional argument labeled above as + \texttt{[]} may include only two (Boolean) key-value + pairs: \texttt{showcounts} and \texttt{nowrite}. + \begin{itemize} + \item \texttt{showcounts} When this key appears as \texttt{showcount} or as + \texttt{showcount=true}, a count and a total count of the number of + photos appearing in the gallery is displayed in the title bar. + The count appears as (1 of 8), for example, but this can be + redefined by the command \cs{fdgcntOf}. The default definition + is\medskip +\begin{Verbatim}[xleftmargin=20pt,fontsize=\small] +\newcommand{\fdgcntOf}[1]{\space(#1 of \fdg@numDigis)} +\end{Verbatim} +\par\medskip The default is that no count is written to the title bar of the gallery. + \item \texttt{nowrite} You optionally include this key in the list + if the XML has already been written to your source folder; however, if + you change options, or change the key-value pairs of the \cs{image} + commands, you will need to re-write the XML by removing the \texttt{nowrite} + option. + \end{itemize} + \item[\texttt{\#2}] The second parameter, \texttt{}, is a + unique name for the gallery being created with the photos; for + example \texttt{myVacation2010}. The name should follow the + rules of a JavaScript variable. + \item[\texttt{\#3}] The third argument consists of a series of + \cs{image} commands, each command takes three key-value pairs. + \begin{itemize} + \item \texttt{path}: The path to the digital file, the path may be + that to a digital file on your hard drive, or on the Internet. + A digital file may be a \textsf{JPG}, \textsf{PNG}, or \textsf{GIF} file. + \emph{This key is required}. + \item \texttt{caption}: The (short) descriptive string to be + displayed along with the associated photo. This key is optional, + if not present, the filename of the digital file is displayed. See + the optional key-values \texttt{nocaptions} and \texttt{nocaptionstext} of + \cs{fgRmAnnot}. + \item \texttt{online}: Use this key to indicate that the + \texttt{path} key is an \textsf{URL}, and refers to a resource on the + Internet. If this key is not present, it is assumed that path + points to a file on the local hard drive, and Distiller will get + that file and embed it in the PDF. If Distiller does not find the + file, distillation is aborted and a message is written to the + distiller long which suggests that it cannot find the file. + \end{itemize} +\end{itemize} +Below is an example of the \cs{fdgXmlList} used for this document, I've +modified the first two entries by removing the \texttt{online} key, and +replacing \cs{digiOnline} with \cs{digisLocal} to demonstrate how you +reference each type. (The definitions of \cs{digiOnline} and +\cs{digisLocal} appeared earlier.) For this definition below, two files +will be embedded (the first two), all others are online and the gallery +will get them from the Internet. +\begin{Verbatim}[numbers=left,xleftmargin=20pt,fontsize=\small] +\fdgXmlList{myDigis} +{% + \image{path=\digisLocal/Chrysanthemum.jpg, + caption=Jürgen\'s Chrysanthemum} + \image{path=\digisLocal/Desert.jpg,caption=Desert} + \image{path=\digisOnline/Hydrangeas.jpg,caption=Hydrangeas,online} + \image{path=\digisOnline/Jellyfish.jpg,caption=Jellyfish,online} + \image{path=\digisOnline/Koala.jpg,caption=Koala,online} + \image{path=\digisOnline/Lighthouse.jpg,caption=Lighthouse,online} + \image{path=\digisOnline/Penguins.jpg,caption=Penguins,online} + \image{path=\digisOnline/Tulips.jpg,caption=Tulips,online} +} +\end{Verbatim} +One comment is needed, refer to line~(3). I've included my friend, +J\"{u}rgen, name value of the \texttt{caption} key to demonstrate how to +use special latin-1 characters. The u-umlaut (ü) may be entered by your +keyboard, as I have, or by special command \verb!\iso{252}!, +which expands to `\makeatletter\texttt{\fdg@iso{252}}\makeatother'. The +interested user is referred to these two online documents. +\begin{align*} +&\text{\footnotesize\url{http://en.wikipedia.org/wiki/List_of_XML_and_HTML_character_entity_references}}\\ +&\text{\footnotesize\url{http://www.html-entities.com/}} +\end{align*} +The \verb!\iso{}! command expands to \verb!&#;!, see above +\textsf{URLs} to determine the correct value of the \texttt{} to get +the desired glyph. + +The second comment concerns the single apostrophe (\texttt{'}). The +captions are enclosed in single quotes, so if you want an apostrophe, you +must use the the character entity `\verb!'!', or you can use +\verb!\'!, as I did above. This special command, redefined within a group, +expands to `\verb!'!'. Thus, we can write \verb!Jürgen\'s!, or +\verb!Jürgen's!, or \verb!J\iso{252}rgen's!, etc. If you want to +use an ampersand, use `\verb!&!'. + +OK, that's it for the preamble; on to \cs{fgRmAnnot}! + +\section{In the Body: Create a Gallery with +\texorpdfstring{\protect\cs{fgRmAnnot}}{\CMD{fgRmAnnot}}}\label{fgRmAnnot} + +To create a flash gallery of photos, use the command \cs{fgRmAnnot}, its definition +uses the command \cs{rmAnnot}, which is defined in the \textsf{rmannot} package. +\begin{dCmd*}{.5\linewidth} +\fgRmAnnot[]{} +\end{dCmd*} +\PD +\begin{enumerate} + \item The first (optional) parameter is used to pass the key-value pairs of the + \cs{rmAnnot} command. Additionally, the \texttt{galleryopts} key is + recognized by the \cs{fgRmAnnot} command. The value of the \texttt{galleryopts} key + consists of key-value pairs that customize the gallery. + \begin{itemize} + \item \texttt{gallery}: The value of this key determines the layout of the gallery. + Permissible choices are \texttt{vthumbs1} (vertical thumbnails on the left), + \texttt{hthumbs1} (horizontal thumbnails below digital), and + \texttt{nothumbs1} (no thumbnails, the caption bar is a multiline + text field so longer captions may be displayed). More designs are + possible, as my skill in + Flash Professional Pro CS5 increases. The default is + \texttt{vthumbs1}. + \item \texttt{trans}: This key determines the transition effects. + Possible values are \texttt{Blinds}, \texttt{Fade}, + \texttt{Fly}, \texttt{Iris}, \texttt{Photo}, + \texttt{PixelDissolve}, \texttt{Rotate}, \texttt{Squeeze}, + \texttt{Wipe}, \texttt{Zoom}, \texttt{Random}. The default is + \texttt{Random}. + \item \texttt{auto}: If true, the gallery will automatically + display the list of photos at a regular interval. The user can + stop the automatic display by pressing the pause button. The + default is \texttt{auto=true}. + \item \texttt{delay}: The delay, in seconds, between the automatic display of + photos. The default is 6 (seconds). + \item \texttt{captionalign} The alignment of the text in the caption bar. Possible choces + are \texttt{left} (the default), \texttt{right}, and + \texttt{center}. This key-value pair is ignored for + \texttt{gallery=nothumbs1}. + \item \texttt{nocaptions}: A Boolean key, which if \texttt{true}, + the caption strings are not displayed in the caption bar. + \item \texttt{nocaptionstext}: If the \texttt{nocaptions} key is + passed, you can populate the caption bar with a static string. + Thus, \texttt{nocaptionstext=Hi Mom!} displays the string `Hi Mom' in + the caption bar for each and every photo. + \end{itemize} + + \item[] See the manual for the \textsf{rmannot} package for more details on the + key-value pairs that can be passed through the optional first + parameter. + + \item The \texttt{} argument matches the \texttt{} + argument of a \cs{fdgXmlList} declared in the preamble. +\end{enumerate} + +The example that appeared earlier in this manual has code + +\begin{Verbatim}[numbers=left,xleftmargin=20pt,fontsize=\small] +\resizebox{.9\linewidth}{!} +{% + \fgRmAnnot[% + galleryopts={gallery=vthumbs1,auto=false,captionalign=center}, + posternote={Flash Digital Gallery},enabled=pageopen + ]{myDigis} +} +\end{Verbatim} +Line~(1) shows how the gallery may be resized used using \cs{resizebox} +(or by using \cs{scalebox}). In line~(3) we have the \cs{fgRmAnnot} +command that creates the digital gallery. In line~(4), we specify some of the +\texttt{galleryopts} key-value pairs. The other key-value pairs (outside +the scope of \texttt{galleryopts} are \cs{rmAnnot} key-value pairs. +The second argument, the \texttt{} argument is shown in line~(6). +This name matches the name declared earlier in the preamble in an +\cs{fdgXmlList} command. + +\section{Sample files} + +The following are the sample files shipped with \textsf{fldigigal}: +\begin{itemize} + \item \texttt{fdg\_demo.tex} lays out the basic structure for creating + a \emph{{\AcroTeX} Flash Digital Gallery}. You can experiment with + this file by changing the options. + \item \texttt{fdg\_demo\_fit.tex} demonstrates how to have a one-page + gallery whose size matches the size of the page. +\end{itemize} +Advanced examples \href{http://www.math.uakron.edu/~dpstory/aebblog.html}{AeB Blog site}. + + +\bigskip + +That's all for now, I simply must get back to my retirement. {\dps} + +\end{document} diff --git a/texmf-dist/doc/latex/fldigigal/fldigigal.dvi b/texmf-dist/doc/latex/fldigigal/fldigigal.dvi new file mode 100644 index 00000000..4aa66bc1 Binary files /dev/null and b/texmf-dist/doc/latex/fldigigal/fldigigal.dvi differ -- cgit v1.2.3