new tikz package ocgx (28sep12)

git-svn-id: svn://tug.org/texlive/trunk@27845 c570f23f-e606-0410-a88d-b1316a301751

6 files changed, 723 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/ocgx/README b/Master/texmf-dist/doc/latex/ocgx/README
new file mode 100644
index 00000000000..ceaa2325e3f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ocgx/README
@@ -0,0 +1,16 @@
+ocgx
+====
+
+LaTeX package to use OCG (Optional Content Groups) within a PDF document without JavaScript.
+
+
+license
+=======
+Copyright (C) 2012 by Paul Gaborit
+
+This file may be distributed and/or modified
+
+  1. under the LaTeX Project Public License and/or
+
+  2. under the GNU Public License.
+
diff --git a/Master/texmf-dist/doc/latex/ocgx/demo-ocgx.pdf b/Master/texmf-dist/doc/latex/ocgx/demo-ocgx.pdf
new file mode 100644
index 00000000000..879b7e485b8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ocgx/demo-ocgx.pdf
diff --git a/Master/texmf-dist/doc/latex/ocgx/demo-ocgx.tex b/Master/texmf-dist/doc/latex/ocgx/demo-ocgx.tex
new file mode 100644
index 00000000000..0d82850d3b7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ocgx/demo-ocgx.tex
@@ -0,0 +1,377 @@
+% Copyright (C) 2012 by Paul Gaborit
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+
+\documentclass[11pt,hyperref={colorlinks=false,runcolor=blue}]{beamer}
+%\usetheme{Warsaw}
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{tikz}
+\usetikzlibrary{backgrounds,fit,calc,shadows,chains,ocgx}
+\usepgflibrary{shapes.geometric}
+\usepackage{microtype}
+\usepackage{url}
+\usepackage{fancyvrb}
+\usepackage{listings}
+\lstdefinestyle{TeXcode}{
+  fancyvrb=true,
+  language=[LaTeX]TeX,
+  basicstyle=\scriptsize\ttfamily,
+  keywordstyle=\color{blue}\bfseries,
+  commentstyle=\color{red!50!black}\itshape,
+  stringstyle=\ttfamily\color{green!50!black},
+  showspaces=false,
+  showstringspaces=false,
+  backgroundcolor=\color{white},
+  fontadjust=true,
+  aboveskip=1ex,
+  belowskip=1ex,
+  emphstyle=\color{blue}\bfseries,
+  keepspaces=true,
+  flexiblecolumns=true,
+  emph={switchocg,showocg,hideocg,actionsocg,usetikzlibrary}
+}
+\newcommand\TkzTileWallPaper[3]{
+  \pgfmathtruncatemacro{\nx}{\paperwidth/#1}
+  \foreach \dx in {0,...,\nx}{
+    \pgfmathtruncatemacro{\ny}{\paperheight/#2}
+    \foreach \dy in {0,...,\ny}{
+      \node[anchor=south west,inner sep=0pt]
+      at ([xshift=#1 * \dx,yshift=#2 * \dy]current page.south west)
+      {\includegraphics[width=#1,height=#2]{#3}};
+    }
+  }
+}
+
+\setbeamersize{text margin left=3mm,text margin right=3mm}
+
+\newcommand\latex{{\rmfamily\LaTeX}}
+
+\newcommand{\TikZ}{Ti\emph{k}Z}
+
+\begin{document}
+\begin{frame}[fragile]
+  \frametitle{\latex{}, OCG \& \TikZ{}  (without JavaScript): \texttt{ocgx} package}
+  \framesubtitle{by Paul \textsc{Gaborit} wiht help of Paul
+    \textsc{Isambert}}
+
+  \begin{alertblock}{PDF readers}
+    To fully enjoy this demonstration, use \emph{Adobe Reader},
+    \emph{Foxit Reader} or \emph{evince}!
+  \end{alertblock}
+
+  \begin{columns}
+
+    \column{.6\linewidth}
+
+    \begin{block}{Simple example: code}
+    \begin{lstlisting}[style=TeXcode]
+\begin{ocg}{My first OCG}{refmyfirstocg}{1}
+   Some content...
+\end{ocg}
+
+\switchocg{refmyfirstocg}%
+{\textcolor{red}{Click me!}}
+\end{lstlisting}
+    \end{block}
+
+    \column{.4\linewidth}
+    
+    \begin{block}{Simple example: result}
+      
+      \begin{ocg}{My first OCG}{refmyfirstocg}{1}
+        Some content...
+      \end{ocg}
+      
+      \switchocg{refmyfirstocg}%
+      {\textcolor{red}{Click me!}}
+      
+    \end{block}
+  \end{columns}
+
+\end{frame}
+
+\begin{frame}
+  \frametitle{First example with Ti\emph{k}Z}
+  
+  {\centering
+  \begin{tikzpicture}[font=\small]
+    \begin{scope}[ocg={ref=toto,status=visible,name=ok}]
+      \fill[orange] circle(10pt);
+      \node[draw,rounded corners,hide ocg=toto] at (0,-1) {Hide};
+      \node[draw,rounded corners,switch ocg=toto] at (2,-1) {Switch};
+    \end{scope}
+    \node[show ocg=toto,text=red] at (0,-2) {Show};
+  \end{tikzpicture}\par}
+
+  \begin{itemize}
+  \item \switchocg{toto}{\Large \textcolor{red}{A very long phrase to
+        show that a link can be on multiple lines\ldots}\par\textcolor{red}{And with two
+        paragraphs!}}
+  \item The ``Switch'' button is \textbf{always} useable!
+  \end{itemize}
+\end{frame}
+
+\tikzset{%
+  button on/.style={%
+    draw,circle,drop shadow,
+    line width=1pt,
+    fill=lime!50,
+    switch ocg with mark on={#1}{},
+  },
+}
+\begin{frame}
+  \frametitle{An ordered stack}
+  
+  \centering
+  \begin{tikzpicture}
+    \foreach \col[count=\c] in {red,orange,yellow,lime,cyan,blue,violet}{
+      \pgfmathtruncatemacro{\num}{mod(\c+1,2)+1}
+      \pgfmathsetmacro{\rad}{8-\c}
+      \begin{scope}[xshift=-.3*\c cm,ocg={name=s\num,ref=s\num}]
+        \node[ellipse,draw,line width=1pt,
+        minimum width=1.1*\rad cm,minimum height=.9*\rad cm,
+        fill=\col!70,drop shadow={fill=black}](t){};
+        \node[left=3pt of t.east,fill=white,
+        fill opacity=.5,text opacity=1,circle,inner sep=0pt]{S\num};
+      \end{scope}
+    }
+  \end{tikzpicture}
+
+  \begin{tikzpicture}
+    \node[button on=s1](but){};
+    \node[right=0 of but]{Switch S1};
+    \node[below=3pt of but,button on=s2](but){};
+    \node[right=0 of but]{Switch S2};
+  \end{tikzpicture}
+
+\end{frame}
+
+\begin{frame}
+  \frametitle{RGB and CMY color models with \texttt{xcolor}}
+
+  \def\mylist{red/0,yellow/60,green/120,cyan/180,blue/240,magenta/300}
+  \centering\begin{tikzpicture}[line width=1pt]
+    \begin{scope}
+      \node at (90:25mm) {RGB color};
+      \foreach \col/\angle in \mylist {
+        \colorlet{rgb \col}[rgb]{\col}
+        \draw  (\angle:5mm) circle [radius=10mm];
+        \begin{scope}[on background layer]
+          \begin{scope}[ocg={ref=RGB\col,name=RGB \col}]
+            \fill[fill=rgb \col,fill opacity=.5]
+            (\angle:5mm) circle [radius=10mm];
+          \end{scope}
+        \end{scope}
+        
+        \node[rounded corners=1mm,draw,line width=1pt,
+        minimum size=3mm,fill=rgb \col,fill opacity=.5,
+        drop shadow,
+        inner sep=0,inner xsep=0,
+        switch ocg with mark on={RGB\col}{}]
+        at (\angle:20mm){};
+      }
+    \end{scope}
+    \begin{scope}[xshift=70mm]
+      \node at (90:25mm) {CMY color};
+      \foreach \col/\angle in \mylist {
+        \colorlet{cmy \col}[cmyk]{\col}
+        \draw  (\angle:5mm) circle [radius=10mm];
+        \begin{scope}[on background layer]
+          \begin{scope}[ocg={ref=CMY\col,name=CMY \col}]
+            \fill[fill=cmy \col,fill opacity=.5]
+            (\angle:5mm) circle [radius=10mm];
+          \end{scope}
+        \end{scope}
+      
+        \node[rounded corners=1mm,draw,line width=1pt,
+        minimum size=3mm,fill=cmy \col,fill opacity=.5,
+        drop shadow,inner sep=0,outer sep=0,
+        switch ocg with mark on={CMY\col}{}]
+        at (\angle:20mm){};
+      }
+    \end{scope}
+    
+    \begin{scope}%
+      [xshift=35mm,start chain=going below,node distance=.5mm,font=\tiny]
+      \node[on chain] at (0,20mm) {Toogle groups};
+      \node%
+      [on chain,draw,rounded corners=1mm,fill=white,drop shadow,
+      minimum size=3mm,inner sep=1mm,
+      switch ocg={RGBred RGBblue RGBgreen CMYred CMYblue CMYgreen},
+      ]
+      {red, green, blue};
+      \node%
+      [on chain,draw,rounded corners=1mm,fill=white,drop shadow,
+      minimum size=3mm,inner sep=1mm,
+      switch ocg={RGByellow RGBcyan RGBmagenta CMYyellow CMYcyan CMYmagenta},
+      ]
+      {cyan, magenta, yellow};
+      
+      \node[on chain] {Show groups};
+      \node%
+      [on chain,draw,rounded corners=1mm,fill=white,drop shadow,
+      minimum size=3mm,inner sep=1mm,
+      show ocg={RGBred RGBblue RGBgreen CMYred CMYblue CMYgreen},
+      ]
+      {red, green, blue};
+      \node%
+      [on chain,draw,rounded corners=1mm,fill=white,drop shadow,
+      minimum size=3mm,inner sep=1mm,
+      show ocg={RGByellow RGBcyan RGBmagenta CMYyellow CMYcyan CMYmagenta},
+      ]
+      {cyan, magenta, yellow};
+
+      \node[on chain] {Hide groups};
+      \node%
+      [on chain,draw,rounded corners=1mm,fill=white,drop shadow,
+      minimum size=3mm,inner sep=1mm,
+      hide ocg={RGBred RGBblue RGBgreen CMYred CMYblue CMYgreen},
+      ]
+      {red, green, blue};
+      \node%
+      [on chain,draw,rounded corners=1mm,fill=white,drop shadow,
+      minimum size=3mm,inner sep=1mm,
+      hide ocg={RGByellow RGBcyan RGBmagenta CMYyellow CMYcyan CMYmagenta},
+      ]
+      {cyan, magenta, yellow};
+    \end{scope}
+    
+  \end{tikzpicture}\par
+
+\end{frame}
+
+\foreach \name/\link/\ltxlink/\tiles in {%
+  The Big Show/%
+  {http://designfestival.com/the-cicada-principle-and-why-it-matters-to-web-designers/}/%
+  {http://latex-community.org/know-how/433-tiled-backgrounds}/%
+  {%
+    curtain1/32.7pt/\paperheight,%
+    curtain2/90pt/\paperheight,%
+    curtain3/210.9pt/\paperheight%
+  },%
+  Mosaic/%
+  {http://designfestival.com/cicada/break-it-down/?id=95}/%
+  {http://latex-community.org/know-how/433-tiled-backgrounds}/%
+  {%
+    mosaic1/30pt/30pt,%
+    mosaic2/70pt/70pt,%
+    mosaic3/110pt/110pt,%
+    mosaic4/110pt/110pt%
+  }%
+}{
+  \begin{frame}
+    \begin{tikzpicture}[remember picture,overlay]
+      \foreach \pictname/\wid/\hei in \tiles {
+        \begin{scope}[ocg={name=\pictname,ref=\pictname}]
+          \TkzTileWallPaper{\wid}{\hei}{\pictname}
+        \end{scope}
+      }
+
+    \end{tikzpicture}
+    
+    \centering\begin{tikzpicture}[start chain=going below,node distance=1em]
+      \node[fill=white,fill opacity=.75,align=center,
+      text=black,font=\tiny\bfseries,text opacity=1,
+      on chain,
+      rounded corners=2mm]
+      {{\huge\name}\\\url{\link}\\(\latex{} \url{\ltxlink})};
+
+      \foreach \pictname/\wid/\hei in \tiles {
+
+        \node[on chain,text=white,fill=black,fill opacity=.5,text opacity=1,
+        text width=3cm,align=center,font=\bfseries]
+        (a) {\hspace{5mm}\pictname};
+
+        \node[rounded corners=1mm,draw,line width=1pt,%
+        minimum size=3mm,top color=white,bottom color=black,
+        fill opacity=.5,
+        drop shadow={fill=black},
+        switch ocg with mark on={\pictname}{}]
+        at ([xshift=3mm,yshift=.5mm]a.west) {};
+        
+      }
+    \end{tikzpicture}\par
+  \end{frame}
+}
+
+\begin{frame}
+  \frametitle{Microtype demo}
+
+  \def\sampletext{%
+    Margin kerning is the adjustments of the characters at the
+    margins of a typeset text.  A simplified employment of margin
+    kerning is hanging punctuation. Margin kerning is needed for
+    optical alignment of the margins of a typeset text, because
+    mechanical justification of the margins makes them look rather
+    ragged. Some characters can make a line appear shorter to the
+    human eye than others. Shifting such characters by an
+    appropriate amount into the margins would greatly improve the
+    appearance of a typeset text.%
+  }
+
+  \tikzset{
+    checkbox/.style={
+      draw,circle,line width=.5pt,%
+      minimum size=.5em,top color=white,bottom color=cyan,
+      fill opacity=1,
+      inner sep=0,
+      drop shadow={fill=black,shadow xshift=.5mm,shadow yshift=-.5mm},
+    },
+    sampletext/.style={
+      text width=8cm,align=justify,
+      font=\small,
+      fill=yellow!20,
+      inner xsep=1.5cm,
+      inner ysep=1cm,
+      draw=gray,
+    },
+  }
+
+  {\centering
+    \begin{tikzpicture}
+      \begin{scope}[ocg={name=With Protrusion,ref=protrusion}]
+        \microtypesetup{protrusion=true}%
+        \begin{scope}[ocg={name=With Expansion,ref=expansion}]
+          \microtypesetup{expansion=true}%
+          \node[sampletext]{\sampletext\par};%
+        \end{scope}
+        
+        \begin{scope}[ocg={name=Without Expansion,status=invisible,ref=no-expansion}]
+          \microtypesetup{expansion=false}%
+          \node[sampletext]{\sampletext\par};%
+        \end{scope}
+      \end{scope}
+      
+      \begin{scope}[ocg={name=Without Protrusion,status=invisible,ref=no-protrusion}]
+        \microtypesetup{protrusion=false}%
+        \begin{scope}[ocg={name=With Expansion,ref=expansion}]
+          \microtypesetup{expansion=true}%
+          \node[sampletext]{\sampletext\par};%
+        \end{scope}
+        
+        \begin{scope}[ocg={name=Without Expansion,status=invisible,ref=no-expansion}]
+          \microtypesetup{expansion=false}%
+          \node[sampletext]{\sampletext\par};%
+        \end{scope}
+      \end{scope}
+    \end{tikzpicture}\par
+  }
+
+  Microtype :
+  \begin{tikzpicture}
+    \node[checkbox,switch ocg with mark on={protrusion}{no-protrusion}]{};
+  \end{tikzpicture} with protrusion 
+  \begin{tikzpicture}
+    \node[checkbox,switch ocg with mark on={expansion}{no-expansion}]{};
+  \end{tikzpicture} with expansion
+  
+\end{frame}
+\end{document}
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: t
+%%% End: 
diff --git a/Master/texmf-dist/doc/latex/ocgx/ocgx-example-1.tex b/Master/texmf-dist/doc/latex/ocgx/ocgx-example-1.tex
new file mode 100644
index 00000000000..37808b74832
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ocgx/ocgx-example-1.tex
@@ -0,0 +1,9 @@
+\documentclass{article}
+\usepackage{ocgx}
+\begin{document}
+\begin{ocg}{OCG 1}{ocg1}{1}
+  first example.
+\end{ocg}
+
+\switchocg{ocg1}{Button.}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/ocgx/ocgx-manual-en.pdf b/Master/texmf-dist/doc/latex/ocgx/ocgx-manual-en.pdf
new file mode 100644
index 00000000000..7b4fabcaeb8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ocgx/ocgx-manual-en.pdf
diff --git a/Master/texmf-dist/doc/latex/ocgx/ocgx-manual-en.tex b/Master/texmf-dist/doc/latex/ocgx/ocgx-manual-en.tex
new file mode 100644
index 00000000000..e2e7571e8b0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/ocgx/ocgx-manual-en.tex
@@ -0,0 +1,321 @@
+% Copyright (C) 2012 by Paul Gaborit
+%
+% This file may be distributed and/or modified
+%
+% 1. under the LaTeX Project Public License and/or
+% 2. under the GNU Public License.
+
+\documentclass[a4paper]{ltxdoc}
+\usepackage[vmargin=2cm,hmargin=3.5cm]{geometry}
+\usepackage[latin1]{inputenc}
+\usepackage[T1]{fontenc}
+\usepackage{lmodern}
+\usepackage{xcolor}
+\usepackage{ifthen}
+\usepackage{doc}
+\usepackage{fancyvrb}
+\usepackage{newverbs}
+\usepackage{listings}
+\lstdefinestyle{TeXcode}{
+  fancyvrb=true,
+  language=[LaTeX]TeX,
+  basicstyle=\ttfamily,
+  keywordstyle=\color{blue}\bfseries,
+  commentstyle=\color{red!50!black}\itshape,
+  stringstyle=\ttfamily\color{green!50!black},
+  showspaces=false,
+  showstringspaces=false,
+  backgroundcolor=\color{cyan!10},
+  fontadjust=true,
+  aboveskip=1ex,
+  belowskip=1ex,
+  emphstyle=\color{blue}\bfseries,
+  keepspaces=true,
+  flexiblecolumns=true,
+  emph={switchOCG,showOCG,hideOCG,actionsOCG,usetikzlibrary}
+}
+\newenvironment{prog}[1]{\vspace{1ex}--- \texttt{\emph{#1}} ---}{}
+\newcommand{\TeXexample}[3][]{
+  \ifthenelse{\equal{#1}{}}{\begin{prog}{#2}}{\begin{prog}{#2 (#1)}}
+  \lstinputlisting[style=TeXcode,aboveskip=0ex,#3]{#2}
+  \end{prog}
+}
+  
+\usepackage{url}
+\usepackage[colorlinks]{hyperref}
+\usepackage[english]{babel}
+\usepackage[babel]{microtype}
+\usepackage{parskip}
+\usepackage{tikz}
+\usetikzlibrary{shadows}
+\usepackage[all]{nowidow}
+\usepackage{ocgx}
+
+\newcounter{mynotes}
+\newenvironment{note}{%
+  \tikzpicture
+  \node[%draw=black,line width=.1pt,
+  rounded corners=1em,
+  inner xsep=1.3em, inner ysep=.8em,
+  text width=\linewidth-2.6em-\pgflinewidth,
+  align=justify,
+  draw=cyan!50!black,
+  fill=white,
+  fill=yellow!20,
+  line width=1pt,
+  drop shadow={fill=cyan!50!black},
+  ] (note) \bgroup%
+}{%
+  \egroup;
+  \node[circle,overlay,
+  %fill=white,draw=cyan!50!black,
+  draw=white,fill=cyan!50!black,text=white,
+  line width=2pt,
+  drop shadow={fill=cyan!50!black},
+  font=\small\bfseries,inner sep=4pt]
+  at (note.north west){\stepcounter{mynotes}\arabic{mynotes}};
+  \endtikzpicture\par\vspace{.1em}%
+}
+
+
+\newverbcommand\code{\color{red}}{}
+\newverbcommand\style{\hspace{-2em}\color{red}}{}
+\newcommand\argument[1]{\textcolor{black}{\ttfamily #1}}
+\newcommand\TikZ{Ti\emph{k}Z}
+
+\title{The \texttt{ocgx} package (version \ocgxversion)}
+\author{%
+  Paul \textsc{Isambert}
+  \and%
+  Paul \textsc{Gaborit}\\\url{paul.gaborit@gmail.com}}
+\date{\today}
+
+\begin{document}
+\maketitle
+
+The \code+ocgx+ package extends and documents the \code+ocg+ package
+(which comes with Asymptote) which allows you to create OCGs
+(\emph{Optional Content Group}) in PDF documents.
+
+Every OCG includes \TeX{} material into a layer of the PDF file. Each of
+these layers can be displayed or not. Links can enable or disable the
+display of OCGs.
+
+The \code+ocgx+ package does not use Javascript embedded in the PDF
+document to enable or disable OCGs. Thus, it is usable with several PDF
+readers (to date, it has been successfully tested with \emph{Acrobat
+  Reader}, \emph{Foxit Reader}, and \emph{Evince}).
+
+\section{Usage}
+
+Here is a simple example.
+
+\TeXexample{ocgx-example-1.tex}{}
+
+This document creates an OCG called \emph{ocg1} containing the text
+``\emph{first example.}''  which is visible. You can show or hide this
+OCG by clicking the link ``\emph{Button.}''.
+
+\subsection{Create OCGs}
+
+\begin{note}
+  The \code+ocg+ package written by Michael \textsc{Ritzert} comes
+  without documentation. In my knowledge, the only documentation for
+  this package is offered (by Kjell Magne Fauske) on the weblog of
+  TeXample.net:
+  \url{http://www.texample.net/weblog/2008/nov/02/creating-pdf-layers/}.
+\end{note}
+
+
+\DescribeEnv{ocg}%
+The \code+ocg+ environment (provided by the package \code+ocg+) creates
+OCGs. It requires three arguments. The first argument is the name of the
+OCG as it appears in the PDF viewer. The second argument is the internal
+name used to reference this OCG. The third argument is a flag that
+indicates whether the OCG should be visible or not (1 for visible, 0 for
+invisible). The content of the environment (any \TeX material) is added
+into the OCG.
+
+The following code creates an OCG named \emph{OCG name} with
+\emph{refocg} as internal reference. The content of this OCG is
+``\emph{content...}''. This OCG is visible (the third argument is 1).
+
+\begin{lstlisting}[style=TeXcode]
+  \begin{ocg}{OCG name}{refocg}{1}
+    content...
+  \end{ocg}
+\end{lstlisting}
+
+\begin{note}
+  The same reference can be used with several \code+ocg+ environments (not
+  necessarily in the same page). All materials are grouped in the same
+  OCG. Only the first name provided will be used.
+\end{note}
+
+\begin{note}
+  A reference of an OCG consists of letters (A-Z, a-z), numbers (0-9)
+  and possibly the \code+@+ character.
+\end{note}
+
+\begin{note}
+  The content of the \code+ocg+ environment should not span across
+  multiple pages. Currently, nothing prevents you to try it but the
+  result will certainly not be the one you were expecting!
+\end{note}
+
+\begin{note}
+  It is possible to nest an OCG in another OCG. To display the internal
+  OCG, both the internal and external OCGs need to be in the visible
+  state.
+\end{note}
+
+\subsection{Manage the visibility of OCGs}
+
+\DescribeMacro{\switchocg}%
+The \code+\switchocg+ macro turns its second argument into a clickable
+link that toggles the visibility status of all listed OCGs (by their
+reference) in its first argument: if an OCG was visible, it becomes
+invisible, and conversely, if an OCG was invisible, it becomes visible.
+
+The following code creates the link \emph{toggle} that switches the
+visibility status of OCGs whose references are \emph{ocg1} and
+\emph{ocg2}:
+
+\begin{lstlisting}[style=TeXcode]
+  \switchocg{ocg1 ocg2}{toggle}
+\end{lstlisting}
+
+\DescribeMacro{\showocg}%
+The \code+\showocg+ macro turns its second argument into a clickable
+link that make visible all OCGs whose references are listed in its first
+argument: an invisible OCG becomes visible and an OCG already visible
+remains visible.
+
+The following code creates the link \emph{show} which makes visible the
+OCGs whoses references are \emph{ocg1} and \emph{ocg2}:
+
+\begin{lstlisting}[style=TeXcode]
+  \showocg{ocg1 ocg2}{show}
+\end{lstlisting}
+
+\DescribeMacro{\hideocg}%
+The \code+\hideocg+ macro turns its second argument into a clickable
+link that make invisible all OCGs whose references are listed in its
+first argument: a visible OCG becomes invisible and an OCG already
+invisible remains invisible.
+
+The following code creates the link \emph{hide} which makes invisible
+the OCGs whoses references are \emph{ocg1} and \emph{ocg2}:
+\begin{lstlisting}[style=TeXcode]
+  \hideocg{ocg1 ocg2}{hide}
+\end{lstlisting}
+
+\DescribeMacro{\actionsocg}%
+The \code+\actionsocg+ macro transforms its fourth argument in a
+clickable link. Its three first arguments are lists of references of
+OCGs. The first list contains references of OCGs which visibility status
+is to be toggled. The second list contains references of OCGs to be set
+visible. The third list contains references of OCGs to be set invisible.
+
+The following code creates the link \emph{actions} to toggle the
+visibility status of the OCG named \emph{ocg1}, to make visible the OCG
+named \emph{ocg3}, and to make invisible OCG named \emph{ocg2}:
+
+\begin{lstlisting}[style=TeXcode]
+  \actionsocg{ocg1}{ocg3}{ocg2}{actions}
+\end{lstlisting}
+
+\subsection{Usage with \TikZ{}}
+
+You can use the \code+ocgx+ package with \TikZ{}. The package provides a
+\TikZ{} library offering five specific styles to transform a path
+(\code+\path+ or \code+\node+) in a clickable link. To use it, simply
+add the following lines in your preamble:
+
+\begin{lstlisting}[style=TeXcode]
+  \usepackage{tikz}
+  \usetikzlibrary{ocgx}
+\end{lstlisting}
+
+\begin{list}{}
+\item
+\noindent\style+/tikz/switch ocg+\argument{=\{\emph{<OCGs list>}\}}
+
+This style transforms the path or the current node in a link acting as
+if it was produced by the macro \code+\switchocg+ (the visibility status
+of referenced OCGs is reversed).
+
+\noindent\style+/tikz/show ocg+\argument{=\{\emph{<OCGs list>}\}}
+
+This style transforms the path or the current node in a link acting as
+if it was produced by the macro \code+\showocg+ (the referenced OCGs are
+made visible).
+
+\noindent\style+/tikz/hide ocg+\argument{=\{\emph{<OCGs list>}\}}
+
+This style transforms the path or the current node in a link acting as
+if it was produced by the macro \code+\hideocg+ (the referenced OCGs are
+made invisible).
+
+\noindent\style+/tikz/actions ocg+\argument{=\{\emph{<OCGs
+    list>}\}\{\emph{<OCGs list>}\}\{\emph{<OCGs list>}\}}
+
+This style transforms the path or the current node in a link acting as
+if it is produced by the macro \code+\actionsocg+ (the visibility status
+of OCGs of the first list is reversed, the OCGs in the second list are
+made visible and those of the third list are made invisible).
+
+\noindent\style+/tikz/switch ocg with mark on+\argument{=\{\emph{<ocg reference>}\}\{\emph{<OCGs list>}\}}
+
+\noindent\style+/tikz/switch ocg with mark off+\argument{=\{\emph{<ocg reference>>}\}\{\emph{<OCGs list>}\}}
+
+These styles transform the path or the current node in a link acting as
+if it is produced by the macro \code+\switchocg+ (the visibility status
+of referenced OCGs in the list is reversed).
+
+A mark (currently a simple cross) is drawn over the current path or node
+in an OCG whose reference is \texttt{\emph{ocg reference}}. The
+visibility status of this OCG will be reversed as those of the entire
+list.
+
+If the OCG whose reference is \texttt{\emph{ocg reference}} does not
+exist, it is created with an empty name and its initial visibility state
+is true with \code+on+ and false with \code+off+.
+\end{list}
+
+\begin{note}
+  Whatever the shape of the current path or node is, it is its
+  \emph{bounding box} that is used to make the link (the link is always
+  \emph{rectangular} and \emph{horizontal}).
+\end{note}
+
+\section{Examples}
+
+The document \code+demo-ocgx.tex+ provides several examples of usage of
+package \code+ocgx+ with \TikZ{} (and \code+beamer+).
+
+\section{Limits and bugs}
+
+\begin{enumerate}
+\item Links are always horizontal rectangles!
+\item An \code+ocg+ environment spanning across multiple pages are not
+  detected and don't work correctly.
+\item The list of OCGs created by \code+ocg+ is seen by viewers as a
+  long flat list. Their possible hierarchy is not displayed.
+\item The packages \code+ocg+ and \code+ocgx+ are not compatible with Plain-\TeX{}.
+\end{enumerate}
+
+\section{Development}
+This package is still experimental. It is released on CTAN. You can
+recover the latest version on \url{https://github.com/polgab/ocgx}. Any
+help to participate in its development is welcome: contact the
+maintainer (\url{paul.gaborit@gmail.com}).
+
+\end{document}
+
+
+
+%%% Local Variables: 
+%%% mode: latex
+%%% TeX-master: t
+%%% End: