manual/epsfile.tex

   1 \chapter{Module epsfile: EPS file inclusion}
   2
   3 With the help of the \verb|epsfile.epsfile| class, you can easily embed
   4 another EPS file in your canvas, thereby scaling, aligning the content
   5 at discretion. The most simple example looks like
   6 \begin{quote}
   7 \begin{verbatim}
   8 from pyx import *
   9 c = canvas.canvas()
  10 c.insert(epsfile.epsfile(0, 0, "file.eps"))
  11 c.writeEPSfile("output")
  12 \end{verbatim}
  13 \end{quote}
  14
  15 All relevant parameters are passed to the \verb|epsfile.epsfile|
  16 constructor. They are summarized in the following table:
  17
  18 \medskip
  19 \begin{tabularx}{\linewidth}{l>{\raggedright\arraybackslash}X}
  20 argument name&description\\
  21 \hline
  22 \texttt{x} & $x$-coordinate of position (measured in user
  23 units by default).\\
  24 \texttt{y} & $y$-coordinate of position (measured in user
  25 units by default).\\
  26 \texttt{filename} & Name of the EPS file (including a possible
  27 extension).\\
  28 \texttt{width=None} & Desired width of EPS graphics or \texttt{None}
  29 for original width. Cannot be combined with scale specification.\\
  30 \texttt{heigth=None} & Desired height of EPS graphics or \texttt{None}
  31 for original height. Cannot be combined with scale specification.\\
  32 \texttt{scale=None} & Scaling factor for EPS graphics or \texttt{None}
  33 for no scaling. Cannot be combined with width or height specification.\\
  34 \texttt{align="bl"} & Alignment of EPS graphics. The first character
  35 specifies the vertical alignment: \texttt{b} for bottom, \texttt{c}
  36 for center, and \texttt{t} for top. The second character fixes the
  37 horizontal alignment: \texttt{l} for left, \texttt{c} for center
  38 \texttt{r} for right.\\
  39 \texttt{clip=1} & Clip to bounding box of EPS file?\\
  40 \texttt{translatebbox=1} & Use lower left corner of bounding box of EPS
  41 file? Set to $0$ with care.\\
  42 \texttt{bbox=None} & If given, use \texttt{bbox} instance instead of
  43 bounding box of EPS file.
  44 \end{tabularx}
  45
  46
  47
  48 \label{epsfile}
  49
  50 %%% Local Variables:
  51 %%% mode: latex
  52 %%% TeX-master: "manual.tex"
  53 %%% End:
  54