diff options
author | Karl Berry <karl@freefriends.org> | 2017-09-29 20:38:13 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-09-29 20:38:13 +0000 |
commit | 33a0cb402878424c71b1bcc8ec67eef49a0eb4dd (patch) | |
tree | 53de9080520f526b5a838d6910d0acd307b6afd8 /Master/texmf-dist/doc/latex/ocgx2 | |
parent | 7517a8cc36ffb0c06ac028f06a69251551d2c939 (diff) |
ocgx2 (29sep17)
git-svn-id: svn://tug.org/texlive/trunk@45430 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/ocgx2')
-rw-r--r-- | Master/texmf-dist/doc/latex/ocgx2/README.md | 160 |
1 files changed, 0 insertions, 160 deletions
diff --git a/Master/texmf-dist/doc/latex/ocgx2/README.md b/Master/texmf-dist/doc/latex/ocgx2/README.md deleted file mode 100644 index 07b40aecc83..00000000000 --- a/Master/texmf-dist/doc/latex/ocgx2/README.md +++ /dev/null @@ -1,160 +0,0 @@ -# The `ocgx2` LaTeX Package - -© 2015--`\today`, Alexander Grahn - -https://github.com/agrahn/ocgx2 - -## Introduction - -This package serves as a drop-in replacement for the already existing packages -**`ocgx`** by Paul Gaborit and **`ocg-p`** by Werner Moshammer for the creation of PDF -Layers. - -It re-implements the functionality of the **`ocg`**, **`ocgx`** and **`ocg-p`** packages and -adds support for all known engines and back-ends including: - -- LaTeX ⇒ dvips ⇒ ps2pdf/Distiller -- (Xe)LaTeX ⇒ (x)dvipdfmx -- pdfLaTeX, LuaLaTeX - -Also, it adds some features, improvements and bug fixes, such as package -options, remembering option settings of re-opened OCGs, correct behaviour of -layer switching links that were themselves placed on layers, correct listing -of (nested) OCGs in the "Layers" tab of PDF viewers, compatibility with the -`animate` and `media9` packages, a re-implementation of **`hyperref`**'s -**`ocgcolorlink`** option. - -To enable dvipdfmx support, pass **`dvipdfmx`** globally as a class option. - ----- - -*New features:* - -+ layers extending across **page breaks** -+ grouping layers into **Radio Button Groups** (`ocg` environment option **`radiobtngrp=...`**) -+ re-implementing **`hyperref`**'s **`ocgcolorlinks`** option - -for creating OCG coloured links, which are printed on paper in the default -text colour and which can, unlike the original `hyperref` implementation, -extend over **line** and **page breaks**. Moreover, with pdfLaTeX/LuaLaTeX, OCG -coloured links can be **nested**. - -Coloured OCG links are enabled with - -````latex -\usepackage{hyperref} % do NOT set [ocgcolorlinks] here! -\usepackage[ocgcolorlinks]{ocgx2} -```` - ----- - -`ocgx2` uses code from file `tikzlibraryocgx.code.tex` by P. Gaborit to enable -TikZ styles for creating PDF Layers and clickable layer switching links in the -`tikzpicture` context. - -Just say: -````latex -\usepackage[tikz]{ocgx2} -```` -instead of -````latex -\usepackage{tikz} -\usetikzlibrary{ocgx} -```` -to enable these TikZ styles and read the `ocgx` documentation about their usage: -```` -texdoc ocgx -```` -The `/tikz/ocg/opts=<ocg options>` parameter adds to the list in section "How to -add TikZ scopes into OCGs" in the `ocgx` manual. It allows passing `ocg` -environment options (see below) to the TikZ scope. - -## Usage - -````latex -\usepackage[<options>]{ocgx2} - -\begin{ocg}[<options>]{<layer name>}{<layer id>}{<initial visibility>} - ... material to be put on a PDF layer ... -\end{ocg} -```` -With `<initial visibility>` = `( on | true | 1 ) | ( off | false | 0 )` - -and `<options>`: -```` -viewocg = always | never | ifvisible -printocg = always | never | ifvisible -exportocg = always | never | ifvisible - -showingui= true | false -radiobtngrp = <group name> -tikz -ocgcolorlinks -```` -**not in** `ocgx`, `ocg-p`: - -* `showingui` (to be preferred over `listintoolbar` of `ocgx/ocg-p`) -* `radiobtngrp = <group name>` (string; environment-only option) -* `tikz` (package-only option, see above) -* `ocgcolorlinks` (package-only option, see above) - -Package options have global scope. Environment options override package options -locally. - -Layers can be added to one or several **Radio Button Groups** using the new option -`radiobtngrp`. From all layers within a Radio Button Group only one can be -enabled at a time. Enabling a layer, e. g. in the Layers tab of the PDF viewer, -automatically hides the previously visible layer. Option `radiobtngrp` can -be used repeatedly for the same OCG in order to add the layer to more than one -Radio Button Group. - -`ocg` environments can be nested and span multiple pages. - -See the `ocg-p` manual about the environment usage and the meaning of the -remaining options: -```` -texdoc ocg-p -```` - ----- - -Clickable links for switching PDF layer visibility are created with: -````latex -\switchocg{<layer IDs to toggle, space separated>}{<link text>} -\showocg{<layer IDs to switch ON, space separated>}{<link text>} -\hideocg{<layer IDs to switch OFF, space separated>}{<link text>} -\actionsocg{<IDs to toggle>}{<IDs to switch ON>}{<IDs to switch OFF>}{<link text>} -```` -For details about their usage, read the `ocgx` package manual: -```` -texdoc ocgx -```` -For compatibility with the `ocg-p` package, the following commands have -been provided: -````latex -\toggleocgs[triggerocg=...]{<layer IDs to toggle, space separated>}{<link text>} -\showocgs[triggerocg=...]{<layer IDs to switch ON, space separated>}{<link text>} -\hideocgs[triggerocg=...]{<layer IDs to switch OFF, space separated>}{<link text>} -\setocgs[triggerocg=...]{<IDs to toggle>}{<IDs to switch ON>}{<IDs to switch OFF>}{<link text>} -```` -See the `ocg-p` package manual for the meaning of `triggerocg=...`. - ----- - -Breakable OCG coloured links work best with normal text as link text. If the -link text is mixed with graphical content, such as from external files or -inline graphics (e. g. TikZ) and even `\fbox`-ed text, these graphical parts -must be enclosed in -````latex -\ocglinkprotect{...} -```` - -For example: -````latex -\href{http://ctan.org}{Visit me on \ocglinkprotect{\includegraphics{ctan-lion}}!} -```` - -## License - -This material is subject to the [LaTeX Project Public License](http://mirrors.ctan.org/macros/latex/base/lppl.txt). - |