diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/asyfig/asyfig.tex')
| -rw-r--r-- | Master/texmf-dist/source/latex/asyfig/asyfig.tex | 30 |
1 files changed, 25 insertions, 5 deletions
diff --git a/Master/texmf-dist/source/latex/asyfig/asyfig.tex b/Master/texmf-dist/source/latex/asyfig/asyfig.tex index 3416c24c0ca..8710a7529ed 100644 --- a/Master/texmf-dist/source/latex/asyfig/asyfig.tex +++ b/Master/texmf-dist/source/latex/asyfig/asyfig.tex @@ -2,13 +2,17 @@ \begin{filecontents*}{README.txt} __________________ The ASYFIG package -v0.1b +v0.1c This package provides an alternative to the asymptote package for including Asymptote graphics in a LaTeX document. In this package, all Asymptote figures are defined separately from the source in their own individual ".asy" files. This package uses Asymptote's inline mode so that labels in the graphics are produced by the main typesetting run; this ensures consistent font and size selection of text within the graphics. In addition, each individual ".asy" graphic can be very quickly processed individually to facilitate easy maintenance and editing of the graphics. ______________ CHANGE HISTORY +v0.1c + - Add compilation flags to generate 2D vector output + in the case of 3D graphics + v0.1b - Now supports Asymptote v1.78 (an internal macro was changed that needed to be mirrored in this package) @@ -38,6 +42,11 @@ Developmental and historical versions: Current release version: <http://ctan.tug.org/pkg/asyfig> + +___________ +LICENCE + +The asyfig collection of packages are released under the LaTeX Project Public License. More information can be found within the PDF documentation. ______________ Will Robertson @@ -46,7 +55,7 @@ Copyright 2008-2009 %%%%%%%%%1%%%%%%%%%2%%%%%%%%%3%%%%%%%%%4%%%%%%%%%5 \begin{filecontents}{asyfig.sty} -\ProvidesPackage{asyfig}[2009/06/30 v0.1b +\ProvidesPackage{asyfig}[2010/03/20 v0.1c Commands for using asymptote figures] % This package is the main user interface for inserting external |asy| figures @@ -305,7 +314,7 @@ Copyright 2008-2009 \newcommand\ProcessAsy{% \immediate\write18{% - asy -wait -inlinetex -tex \ifpdf pdf\fi latex + asy -wait -inlinetex -noprc -render 0 -tex \ifpdf pdf\fi latex \asy@compname\space 2> \asy@status}% \CatchFileDef{\@tempb}{\asy@status}{}% \immediate\write18{\ifwindows del \else rm \fi \asy@status} @@ -455,7 +464,17 @@ Support for |asy| in a \LaTeX\ document is provided by the \pkg{asymptote} packa This package, \pkg{asyfig}, provides an alternative, whereby all |asy| figures are defined \emph{separately} from the source in their own individual |.asy| files. \pkg{asyfig} uses Asymptote's inline mode so that labels in the graphics are produced by the main typesetting run; this ensures consistent font and size selection of text within the graphics. In addition, each individual |.asy| graphic can be very quickly processed individually to facilitate easy maintenance and editing of the graphics. -This package works with Asymptote v1.78 (and later, probably). +This package sometimes lags behind the current release of Asymptote simply because I don't use Asymptote very often. The current release of this package is designed to work with Asymptote v1.91 and later. + +\section{Do you need this package?} + +After I wrote and used this package for quite some time, I realised that what it is intended to do can be done with the standard \pkg{asymptote} package. If you have an Aymptote graphic called |myfig.asy|, you can include it in your document as follows: +\begin{verbatim} +\begin{asy} +include "myfig"; +\end{asy} +\end{verbatim} +There's actually not much point using this package if this works for you. But I'll keep supporting this package for now while I continue to use it. \section{Getting started} @@ -472,7 +491,7 @@ After processing (see the next step), this graphic can be included in the docume If all of your |.asy| files take a common path prefix (such as |./figures/asy/|), this can be defined with the \cmd\asypath\marg{path} command. For example, instead of writing |\asyfig{asy/frf}| one can write |\asypath{asy/}| somewhere in the document (usually the preamble) and then later |\asyfig{frf}|. \paragraph{Processing the graphic} -But before the graphic can be placed into the document it must be processed. If the \texttt{asy} graphic has not been processed, or if the \texttt{asy} file is \emph{newer} than its processed graphic, then this package will attempt to do the processing automatically. To turn off this automatic processing, load the package with the \texttt{[process=none]} package option. Alternatively, to re-process \emph{all} \texttt{asy} graphics, use \texttt{[process=none]} instead. +But before the graphic can be placed into the document it must be processed. If the \texttt{asy} graphic has not been processed, or if the \texttt{asy} file is \emph{newer} than its processed graphic, then this package will attempt to do the processing automatically. To turn off this automatic processing, load the package with the \texttt{[process=none]} package option. Alternatively, to re-process \emph{all} \texttt{asy} graphics, use \texttt{[process=all]} instead. The primary feature of this package is that figures may be processed independently of the main document in order to be able to rapidly iterate changes to the graphic. This processing is performed by the \pkg{asyprocess} package in an auxiliary \LaTeX\ execution. Here is a basic shell script that I use to do this: \begin{lstlisting} @@ -488,6 +507,7 @@ By saving the script above into (say) |asyprocess| and making it executable, an \section{Package information} The most recent publicly released version of \pkg{asyfig} is available from \textsc{ctan}:\\ \centerline{\url{http://tug.ctan.org/pkg/asyfig/}}\\ +\newpage Historical and developmental versions are available at GitHub:\\ \centerline{\url{http://github.com/wspr/asyfig/}}\\ While general feedback at \url{wspr81@gmail.com} is welcomed, specific bugs should be reported through the issue tracker at GitHub: \url{http://github.com/wspr/asyfig/issues}. |