From af69feffd5d70a729a1abac22d7341a488bca7af Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 23 Nov 2009 18:08:37 +0000 Subject: new latex package combinedgraphics (~1nov09) git-svn-id: svn://tug.org/texlive/trunk@16144 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/latex/combinedgraphics/Makefile | 65 ++ .../latex/combinedgraphics/combinedgraphics.dtx | 784 +++++++++++++++++++++ .../latex/combinedgraphics/combinedgraphics.ins | 78 ++ 3 files changed, 927 insertions(+) create mode 100644 Master/texmf-dist/source/latex/combinedgraphics/Makefile create mode 100644 Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.dtx create mode 100644 Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.ins (limited to 'Master/texmf-dist/source/latex/combinedgraphics') diff --git a/Master/texmf-dist/source/latex/combinedgraphics/Makefile b/Master/texmf-dist/source/latex/combinedgraphics/Makefile new file mode 100644 index 00000000000..ae99f280867 --- /dev/null +++ b/Master/texmf-dist/source/latex/combinedgraphics/Makefile @@ -0,0 +1,65 @@ +# +# Makefile for combinedgraphics package +# +# Copyright 2009 Christian Schneider +# +# This file is part of combinedgraphics. +# +# combinedgraphics is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License version 3 as +# published by the Free Software Foundation, not any later version. +# +# combinedgraphics is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. +# +# You should have received a copy of the GNU General Public License +# along with combinedgraphics. If not, see . +# +# WARNING: THIS IS ALPHA SOFTWARE AND MAY CONTAIN SERIOUS BUGS! +# + +PACKAGE := combinedgraphics + +PDFLATEX := pdflatex +MAKEINDEX := makeindex + +.PHONY: all pkg doc test clean distclean force + +all: pkg doc test + +%.sty: %.ins %.dtx + $(RM) $@ + $(PDFLATEX) -interaction=nonstopmode $< + +%.idx %.glo: %.dtx %.sty + $(PDFLATEX) -interaction=nonstopmode $< + +%.ind: %.idx + $(MAKEINDEX) -s gind.ist -o $@ $< + +%.gls: %.glo + $(MAKEINDEX) -s gglo.ist -o $@ $< + +$(PACKAGE).pdf: %.pdf: %.dtx %.sty %.ind %.gls + $(PDFLATEX) -interaction=nonstopmode $< + $(PDFLATEX) -interaction=nonstopmode $< + $(PDFLATEX) -interaction=nonstopmode $< + +pkg: $(PACKAGE).sty + +test: $(PACKAGE).sty force + $(MAKE) -C test + +doc: $(PACKAGE).pdf + +clean: force + $(RM) *.aux *.glo *.gls *.idx *.ilg *.ind *.log *.toc *~ + $(MAKE) -C test clean + +distclean: clean force + $(RM) $(PACKAGE).sty $(PACKAGE).pdf $(TESTFILE).pdf + $(MAKE) -C test distclean + +force: ; diff --git a/Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.dtx b/Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.dtx new file mode 100644 index 00000000000..fa02298f216 --- /dev/null +++ b/Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.dtx @@ -0,0 +1,784 @@ +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% \iffalse meta-comment +% +% DocStrip file for combinedgraphics package +% +% Copyright 2009 Christian Schneider +% +% cgr@addto@macro: identical to l@addto@macro from koma-script +% bundle v2.9t +% Copyright 1994-2004 Markus Kohm and Frank Neukam +% +% Thanks to Markus Kohm for permitting to use his code in this package. +% Please do not bother Markus with questions or bugs concering this package! +% +% This file is part of combinedgraphics. +% +% combinedgraphics is free software: you can redistribute it and/or modify +% it under the terms of the GNU General Public License version 3 as +% published by the Free Software Foundation, not any later version. +% +% combinedgraphics is distributed in the hope that it will be useful, +% but WITHOUT ANY WARRANTY; without even the implied warranty of +% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +% GNU General Public License for more details. +% +% You should have received a copy of the GNU General Public License +% along with combinedgraphics. If not, see . +% +% WARNING: THIS IS ALPHA SOFTWARE AND MAY CONTAIN SERIOUS BUGS! +% +% \fi +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \iffalse +%\NeedsTeXFormat{LaTeX2e}[1999/12/01] +%\ProvidesPackage{combinedgraphics} +% [2009/11/01 v0.0.2-alpha inclusion of combined EPS/LaTeX graphics] +%<*driver> +\documentclass[a4paper]{ltxdoc} +\usepackage{combinedgraphics} +\EnableCrossrefs +\CodelineIndex +\RecordChanges +% +% modified description environment +\newcommand{\listmark}{$\bullet$} +\newcommand{\listlengths}{% + \setlength{\parsep}{0pt}% + \setlength{\itemsep}{0pt}% + \setlength{\leftmargin}{10.5em}% + \setlength{\rightmargin}{0pt}% + \setlength{\labelsep}{1em}% + \setlength{\labelwidth}{9.5em}} +\newenvironment{mydescription}{% + \begin{list}{\listmark}{\listlengths}% +}{% + \end{list}% +} +% +\begin{document} + \DocInput{combinedgraphics.dtx} +\end{document} +% +% \fi +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \changes{v0.0.1-alpha}{2009/10/04}{initial .dtx version} +% \changes{v0.0.2-alpha}{2009/11/01}{initial release} +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% %\CheckSum{0} +% \CheckSum{528} +% +% \CharacterTable +% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z +% Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z +% Digits \0\1\2\3\4\5\6\7\8\9 +% Exclamation \! Double quote \" Hash (number) \# +% Dollar \$ Percent \% Ampersand \& +% Acute accent \' Left paren \( Right paren \) +% Asterisk \* Plus \+ Comma \, +% Minus \- Point \. Solidus \/ +% Colon \: Semicolon \; Less than \< +% Equals \= Greater than \> Question mark \? +% Commercial at \@ Left bracket \[ Backslash \\ +% Right bracket \] Circumflex \^ Underscore \_ +% Grave accent \` Left brace \{ Vertical bar \| +% Right brace \} Tilde \~} +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \GetFileInfo{combinedgraphics.sty} +% +% \DoNotIndex{\#,\$,\%,\&,\@,\\,\{,\},\^,\_,\~,\ } +% \DoNotIndex{\@ne} +% \DoNotIndex{\advance,\begingroup,\catcode,\closein} +% \DoNotIndex{\closeout,\day,\def,\edef,\else,\empty,\endgroup} +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \title{The \textsf{combinedgraphics} package\thanks{This document corresponds +% to \textsf{combinedgraphics}~\fileversion, dated~\filedate. Copyright +% 2009 Christian Schneider \texttt{}.}} +% \author{Christian Schneider\\ \texttt{}} +% +% \maketitle +% +% \begin{center} +% \large\textbf{\textsf{Warning: This is alpha software and may +% contain serious bugs! Use with caution and on your own risk! Check output!}} +% \end{center} +% +% \tableofcontents +% \clearpage +% +% \begin{abstract} +% This package provides a macro (|\includecombinedgraphics|) for the +% inclusion of combined EPS/\LaTeX{} and PDF/\LaTeX{} graphics (an export +% format of Gnuplot, Xfig, and maybe other programs). Instead of including +% the graphics with a simple |\input|, the |\includecombinedgraphics| macro +% has some benefits: +% +% \begin{itemize} +% \item changing the font and color of the text of the \LaTeX{} parts +% \item rescaling the graphics without affecting the font of the \LaTeX{} +% parts +% \item automatic inclusion of the vector graphics parts, as far as \LaTeX{} +% parts do not do it (e.\,g., for files exported from Gnuplot before +% version 4.2 or Xfig) +% \item rescaling and rotating of complete graphics (similar to +% |\includegraphics| from \textsf{graphicx} package) +% \end{itemize} +% \end{abstract} +% +% \section{The Combined EPS/\LaTeX{} format} +% +% Graphics in combined EPS/\LaTeX{} or PDF/\LaTeX{} format consist of two files: +% \begin{enumerate} +% \item an EPS or PDF file containing the vector graphics part +% \item an \LaTeX{} file containing the text part +% \end{enumerate} +% +% This format has the advantage that it is possible to generate a high-quality +% vector graphics with text containing all symbols, macros and other stuff +% provided by \LaTeX{}. The text is formatted by \LaTeX{} itsself when including +% the graphics (\emph{not} during creation of the graphics!) and thus it is +% possible to use everything provided by \LaTeX{} up to the font of the +% document for text inside the graphics. +% +% Typically, the \LaTeX{} part of the graphics is included by |\input|. +% The vector graphics part is either included automatically by the \LaTeX{} +% part with an |\includegraphics| command (or something similar) and overlayed +% by the text or the user will have to combine both parts manually like this +% (e.\,g., for gnuplot before version 4.2 or Xfig) for a pair of files +% |foobar.tex|/|foobar.eps|: +% +% \begin{verbatim} +% \begin{picture}(0,0)% +% \includegraphics{foobar}% +% \end{picture}% +% \input{foobar} +% \end{verbatim} +% +% Although the format has some nice advantages compared to other formats, the +% user has to know whether to include the vector graphics part for (some of) +% his graphics or not, font changes sometimes require some knowledge of the +% internal commands of the \LaTeX{} part (depending on the tool that generated +% the graphics), and the user is not intended to change the scaling of just +% the vector graphics part without affecting the text format. Furthermore, +% rotating, scaling and resizing the whole graphics requires extra-macros, +% e.\,g. |\rotatebox|, |\scalebox|, or |\resizebox| from the +% \textsf{graphics}/\textsf{graphicx} package. +% +% The intention of this package is to provide a macro for easier handling of +% combined EPS/\LaTeX{} or PDF/\LaTeX{} graphics, just as easy as +% |\includegraphics|, and removing the limitations mentioned above. +% +% \section{Usage} +% +% \subsection{The macro} +% +% \DescribeMacro{\includecombinedgraphics} +% The macro |\includecombinedgraphics|\oarg{option list}\marg{graphics file} +% is used to include a combined EPS/\LaTeX{} or PDF/\LaTeX{} file, where +% \meta{graphics file} is the name of the \LaTeX{} part of the graphics +% (\emph{without} |.tex| extension) and \meta{option list} is an optional list +% of \meta{key}|=|\meta{value} pairs (see below). +% +% \subsection{Basic macro options} +% \label{sec:basic} +% +% The following options are processed first. If an option is specified +% several times, the last appearance will overwrite the previous ones. +% +% \begin{mydescription} +% \item[\texttt{textfont}=\meta{value}] one or more commands for reformatting +% the text in \LaTeX{} part (e.\,g., |textfont=\Large\bfseries| for large +% bold-face font or |textfont={}| for default font of graphics overwriting +% package option) +% \item[\texttt{textcolor}=\meta{value}] one or more commands for recoloring +% the text in \LaTeX{} part (e.\,g., |textcolor=\color{red}| for red text +% or |textcolor={}| for default text color of graphics overwriting +% package option) +% \item[\texttt{vecscale}=\meta{value}] scaling factor for rescaling the +% graphics without affecting the font of the \LaTeX{} part +% \item[\texttt{vecinclude}=\meta{value}] generate code to include the vector +% graphics part; \meta{value}s are: |auto| to automatically determine if +% code is required (default), |true|/|false| to always/never generate +% that code, or |overwrite| to disable any inclusion of a vector graphics +% part in the \LaTeX{} part and generate new code +% \item[\texttt{vecfile}=\meta{value}] filename of vector graphics part, if +% different from filename of \LaTeX{} part (except for extension); implies +% |vecinclude=overwrite| +% \end{mydescription} +% +% Note: If the vector graphics part is already included by the \LaTeX{} part, +% |vecinclude| and |vecscale| will require the vector graphics part to be +% included by an |\includegraphics| command for proper functioning. Furthermore, +% |vecscale| also requires that the \LaTeX{} part puts its text inside a +% |picture| environment whose scaling is set with +% |\setlength{\unitlength}|\marg{some length}. These two prerequisites are +% fulfilled by graphics exported from Gnuplot and Xfig. +% +% \subsection{Extended macro options} +% +% The following options are processed \emph{after} the basic options \emph{in +% the order} of their appearances and affect the \emph{whole} graphics +% (\LaTeX{} and vector graphics part). They may be specified several times. +% +% \subsubsection*{Rotating} +% +% Rotating is basically performed with the means of |\rotatebox| from the +% \textsf{graphics}/\textsf{graphicx} package. +% +% \begin{mydescription} +% \item[\texttt{angle}=\meta{value}] angle of rotation +% \end{mydescription} +% +% The following options can be used to fine adjust the effect of a rotation and +% apply to only the next |angle| value specified in the options list. +% +% \begin{mydescription} +% \item[\texttt{origin}=\meta{value}] up to two of |lrctbB| (|B| stands for +% the baseline) +% \item[\texttt{x}=\meta{value}] the |x| coordinate of the center of rotation +% \item[\texttt{y}=\meta{value}] the |y| coordinate of the center of rotation +% \item[\texttt{units}=\meta{value}] units of rotation angle (e.\,g., |-360| +% denotes clockwise rotation) +% \end{mydescription} +% +% \subsubsection*{Rescaling} +% +% Rescaling is performed with the means of |\scalebox| from the +% \textsf{graphics} package. +% +% \begin{mydescription} +% \item[\texttt{scale}=\meta{value}] scaling factor +% \item[\texttt{hscale}=\meta{value}] horizontal scaling factor +% \item[\texttt{vscale}=\meta{value}] vertical scaling factor +% \end{mydescription} +% +% Note: A scaling via |hscale| and |vscale| will only be performed, if a pair +% of both values is specified. +% +% \subsubsection*{Resizing} +% +% Resizing is performed with the means of |\resizebox| from the +% \textsf{graphics} package. +% +% \begin{mydescription} +% \item[\texttt{height}=\meta{value}] height of graphics +% \item[\texttt{totalheight}=\meta{value}] height + depth of graphics +% \item[\texttt{width}=\meta{value}] width of graphics +% \item[\texttt{keepaspectratio}] if only one of the values +% for |height|/|totalheight| or |width| is specified, the other one will +% be calculated to keep the aspect ratio +% \end{mydescription} +% +% Note: Resizing will only be performed, if a pair of |height|/|totalheight| +% and |width| is specified or one of them is specified followed by +% |keepaspectratio|. +% +% \subsection{Package options} +% +% The following options can be passed to the package as defaults for the +% macro options. If an option is specified several times, the last appearance +% will overwrite the previous ones. +% +% \begin{mydescription} +% \item[\texttt{textfontcmd}=\meta{value}] name of a command (\emph{without} +% leading backslash) for reformatting text in \LaTeX{} part +% \item[\texttt{textcolorcmd}=\meta{value}] name of a command (\emph{without} +% leading backslash) for recoloring text in \LaTeX{} part +% \item[\texttt{vecscale}=\meta{value}] see section~\ref{sec:basic} +% \item[\texttt{vecinclude}=\meta{value}] see section~\ref{sec:basic} +% \end{mydescription} +% +% \section{Bugs, problems, and suggestions} +% +% Please report bugs and problems or send suggestions for this package to +% Christian Schneider. Check for updates before reporting bugs at the website +% mentioned above. Do \emph{not} bother Markus Kohm or Frank Neukam with bugs, +% problems or suggestions concerning this package! +% +% \StopEventually{\PrintChanges\PrintIndex} +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \section{Implementation} +% +% Load required packages for graphics, color and \meta{key}|=|\meta{value} +% pairs: +% \begin{macrocode} +\RequirePackage{keyval} +\RequirePackage{graphicx} +\RequirePackage{color} +% \end{macrocode} +% +% \subsection{Package options} +% +% Definitions of package options as \meta{key}|=|\meta{value} pairs. The +% \meta{value}s are saved in the specified macros that are undefined by default. +% \begin{macrocode} +\newcommand*\cgr@defopts{\define@key{cgr}} +\newcommand*\cgr@setopts{\setkeys{cgr}} +\cgr@defopts{textfontcmd}{\gdef\cgr@textfont@default{\@nameuse{#1}}} +\cgr@defopts{textcolorcmd}{\gdef\cgr@textcolor@default{\@nameuse{#1}}} +\cgr@defopts{vecscale}{\gdef\cgr@vecscale@default{#1}} +\cgr@defopts{vecinclude}{\gdef\cgr@vecinclude@default{#1}} +% \end{macrocode} +% +% Next the package options are processed. +% \begin{macrocode} +\DeclareOption*{% + \expandafter\cgr@setopts\expandafter{\CurrentOption}% +} +\ProcessOptions\relax +% \end{macrocode} +% +% \subsection{Basic macro options} +% +% Now the \meta{key}|=|\meta{value} pairs for the optional argument of +% |\includecombinedgraphics| are defined. The following two macro are just +% shortcuts for this purpose. +% \begin{macrocode} +\newcommand*\cgr@defopts@combgrphcs{\define@key{cgr@combgrphcs}} +\newcommand*\cgr@setopts@combgrphcs{\setkeys{cgr@combgrphcs}} +% \end{macrocode} +% +% The basic macro options set some macros that are executed while tinkering the +% graphics from its two parts. +% +% |textfont| and |textcolor| set |\cgr@textfont| and |\cgr@textcolor| macro, +% respectively, that will be applied to the text in the \LaTeX{} part of +% graphics \emph{and} disable further formatting of fonts and colors inside the +% \LaTeX{} part by overwriting some macros afterwards (if not empty). +% \begin{macrocode} +\cgr@defopts@combgrphcs{textfont}{% + \def\@tempa{#1}% + \ifx\@tempa\@empty% + \def\cgr@textfont{}% + \else% + \def\cgr@textfont{% + #1% + \def\SetFigFont{\cgr@gobblefive}% %% Xfig <= 3.2.4 + \def\SetFigFontNFSS{\cgr@gobblefive}% %% Xfig >= 3.2.5-alpha + }% + \fi% +} +\cgr@defopts@combgrphcs{textcolor}{% + \def\@tempa{#1}% + \ifx\@tempa\@empty% + \def\cgr@textcolor{}% + \else% + \def\cgr@textcolor{% + #1% + \def\color{\cgr@gobble@optone}% + }% + \fi% +} +% \end{macrocode} +% +% |vecscale| sets the macro |\cgr@vecscale| to the scaling factor. Furthermore, +% it overwrites |\setlength| and |\includegraphics| in order to apply the +% scaling factor to the |picture| environment inside the \LaTeX{} part (via +% |\setlength{\unitlength}...|) and to the |\includegraphics| command for +% inclusion of the vector graphics part, respectively. +% \begin{macrocode} +\cgr@defopts@combgrphcs{vecscale}{% + \def\cgr@vecscale{#1}% + \def\setlength{\cgr@setlength}% + \def\includegraphics{\cgr@includegraphics}% +} +% \end{macrocode} +% +% |vecinclude| switches between the different \meta{keys} by setting +% |\cgr@vecinclude| to one of the for macros |\cgr@requires@graphics|\meta{key}. +% \begin{macrocode} +\cgr@defopts@combgrphcs{vecinclude}{% + \def\cgr@vecinclude{\@nameuse{cgr@requires@graphics#1}}% +} +% \end{macrocode} +% +% |vecfile| resets |\cgr@vecfile| that defaults to the mandatory argument of +% |\includecombinedgraphics| to something else \emph{and} sets |vecinclude| to +% |overwrite|. +% \begin{macrocode} +\cgr@defopts@combgrphcs{vecfile}{% + \def\cgr@vecfile{#1}% + \cgr@setopts@combgrphcs{vecinclude=overwrite}% +} +% \end{macrocode} +% +% \subsection{Extended macro options} +% +% |\includecombinedgraphics| first tinkers the graphics applying the basic macro +% options and saves the result in |\cgr@curr@pic|. The extended macro options +% will redefine |\cgr@curr@pic| in the order of their occurance and put a +% |\rotatebox|, |\scalebox| or |\resizebox| around it, if all information is +% already available to do so: |\cgr@curr@pic| +% $\rightarrow$ |\...box{\cgr@curr@pic}|. Otherwise the \meta{value} will be +% saved in a macro for later processing (e.\,g., if |hscale| is set without +% |vscale| being set before). +% +% \begin{macrocode} +\cgr@defopts@combgrphcs{angle}{% + \ifx\cgr@curr@scaleopts\@empty% + \cgr@raddto@macro[groupfirst]{\cgr@curr@pic}{\rotatebox{#1}}% + \else% + \cgr@raddto@macro[groupfirst]{\cgr@curr@pic}{]}% + \cgr@raddto@macro[expand]{\cgr@curr@pic}{\cgr@curr@scaleopts}% + \cgr@raddto@macro{\cgr@curr@pic}{\rotatebox[}% + \def\cgr@curr@scaleopts{}% + \fi% +} +\cgr@defopts@combgrphcs{origin}{\cgr@addto@macro{\cgr@curr@scaleopts}{% + origin=#1,}% +} +\cgr@defopts@combgrphcs{x}{\cgr@addto@macro{\cgr@curr@scaleopts}{x=#1,}} +\cgr@defopts@combgrphcs{y}{\cgr@addto@macro{\cgr@curr@scaleopts}{y=#1,}} +\cgr@defopts@combgrphcs{units}{\cgr@addto@macro{\cgr@curr@scaleopts}{units=#1,}} +\cgr@defopts@combgrphcs{scale}{% + \cgr@raddto@macro[groupfirst]{\cgr@curr@pic}{\scalebox{#1}}% +} +\cgr@defopts@combgrphcs{hscale}{% + \def\cgr@curr@hscale{#1}% + \ifx\cgr@curr@vscale\@empty% + \else% + \cgr@raddto@macro[groupfirst]{\cgr@curr@pic}{]}% + \cgr@raddto@macro[expand]{\cgr@curr@pic}{\cgr@curr@vscale}% + \cgr@raddto@macro{\cgr@curr@pic}{[}% + \cgr@raddto@macro[expand,groupsecond]{\cgr@curr@pic}{\cgr@curr@hscale}% + \cgr@raddto@macro{\cgr@curr@pic}{\scalebox}% + \def\cgr@curr@hscale{}% + \def\cgr@curr@vscale{}% + \fi% +} +\cgr@defopts@combgrphcs{vscale}{% + \def\cgr@curr@vscale{#1}% + \ifx\cgr@curr@hscale\@empty% + \else% + \cgr@raddto@macro[groupfirst]{\cgr@curr@pic}{]}% + \cgr@raddto@macro[expand]{\cgr@curr@pic}{\cgr@curr@vscale}% + \cgr@raddto@macro{\cgr@curr@pic}{[}% + \cgr@raddto@macro[expand,groupsecond]{\cgr@curr@pic}{\cgr@curr@hscale}% + \cgr@raddto@macro{\cgr@curr@pic}{\scalebox}% + \def\cgr@curr@hscale{}% + \def\cgr@curr@vscale{}% + \fi% +} +\cgr@defopts@combgrphcs{height}{% + \def\cgr@curr@height{#1}% + \ifx\cgr@curr@width\@empty% + \else% + \cgr@raddto@macro[groupfirst,groupsecond,expand]{\cgr@curr@pic}{% + \cgr@curr@height% + }% + \cgr@raddto@macro[groupsecond,expand]{\cgr@curr@pic}{\cgr@curr@width}% + \cgr@raddto@macro{\cgr@curr@pic}{\resizebox}% + \def\cgr@curr@height{}% + \def\cgr@curr@width{}% + \fi% +} +\cgr@defopts@combgrphcs{totalheight}{% + \def\cgr@curr@totalheight{#1}% + \ifx\cgr@curr@width\@empty% + \else% + \cgr@raddto@macro[groupfirst,groupsecond,expand]{\cgr@curr@pic}{% + \cgr@curr@totalheight% + }% + \cgr@raddto@macro[groupsecond,expand]{\cgr@curr@pic}{\cgr@curr@width}% + \cgr@raddto@macro{\cgr@curr@pic}{\resizebox*}% + \def\cgr@curr@totalheight{}% + \def\cgr@curr@width{}% + \fi% +} +\cgr@defopts@combgrphcs{width}{% + \def\cgr@curr@width{#1}% + \ifx\cgr@curr@height\@empty% + \ifx\cgr@curr@totalheight\@empty% + \else% + \cgr@raddto@macro[groupfirst,groupsecond,expand]{\cgr@curr@pic}{% + \cgr@curr@totalheight% + }% + \cgr@raddto@macro[groupsecond,expand]{\cgr@curr@pic}{\cgr@curr@width}% + \cgr@raddto@macro{\cgr@curr@pic}{\resizebox*}% + \def\cgr@curr@totalheight{}% + \def\cgr@curr@width{}% + \fi% + \else% + \cgr@raddto@macro[groupfirst,groupsecond,expand]{\cgr@curr@pic}{% + \cgr@curr@height% + }% + \cgr@raddto@macro[groupsecond,expand]{\cgr@curr@pic}{\cgr@curr@width}% + \cgr@raddto@macro{\cgr@curr@pic}{\resizebox}% + \def\cgr@curr@height{}% + \def\cgr@curr@totalheight{}% + \def\cgr@curr@width{}% + \fi% +} +\cgr@defopts@combgrphcs{keepaspectratio}[]{% + \ifx\cgr@curr@height\@empty% + \ifx\cgr@curr@totalheight\@empty% + \ifx\cgr@curr@width\@empty% + \else% + \cgr@setopts@combgrphcs{height=!}% + \fi% + \else% + \cgr@setopts@combgrphcs{width=!}% + \fi% + \else% + \cgr@setopts@combgrphcs{width=!}% + \def\cgr@curr@totalheight{}% + \fi% +} +% \end{macrocode} +% +% \subsection{The macro} +% +% First of all, |\cgr@curr@pic| and the |\cgr@requires@graphics...| macros are +% initialized. +% \begin{macrocode} +\long\def\cgr@curr@pic{} +\newif\ifcgr@requires@graphics\cgr@requires@graphicstrue +\def\cgr@requires@graphicsauto{} +\def\cgr@requires@graphicsoverwrite{% + \cgr@requires@graphicstrue% + \def\includegraphics{\cgr@gobble@optone}% +} +% \end{macrocode} +% +% Now the macros for the basic macro options and for temporarily saving +% \meta{value}s of the extended macro options are initialized. +% \begin{macrocode} +\def\cgr@textfont{} +\def\cgr@textcolor{} +\def\cgr@vecscale{1} +\def\cgr@vecinclude{\cgr@requires@graphicsauto} +\def\cgr@vecfile{} +\def\cgr@curr@hscale{} +\def\cgr@curr@vscale{} +\def\cgr@curr@scaleopts{} +\def\cgr@curr@height{} +\def\cgr@curr@width{} +\def\cgr@curr@totalheight{} +% \end{macrocode} +% +% At this point the macro itself is defined. +% \begin{macrocode} +\newcommand{\includecombinedgraphics}[2][]{% + \begingroup% +% \end{macrocode} +% +% To get to know, whether the vector graphics are already included in the +% \LaTeX{} parts or not, a check for an appearance of |\includegraphics| in the +% \LaTeX{} part is performed: the \LaTeX{} parts are expanded inside a box with +% |\includegraphics| being redefined to set an appropriate conditional (and eat +% the arguments of |\includegraphics|). +% \begin{macrocode} + \global\cgr@requires@graphicstrue% + \setbox\@tempboxa\hbox{% + \def\includegraphics{% + \global\cgr@requires@graphicsfalse\cgr@gobble@optone% + }% + \input{#2}% + }% +% \end{macrocode} +% +% Now the the macros resulting from the basic macro options, a |picture| +% environment with the vector graphics part and the \LaTeX{} part are added to +% the (empty) |\cgr@curr@pic| macro. +% \begin{macrocode} + \cgr@addto@macro{\cgr@curr@pic}{% + \cgr@vecinclude\cgr@textfont\cgr@textcolor% + \ifcgr@requires@graphics% + \begin{picture}(0,0)% + \cgr@includegraphics@orig[scale=\cgr@vecscale]{\cgr@vecfile}% + \end{picture}% + \fi% + \input{#2}% + }% +% \end{macrocode} +% +% If set, the package options will be processed. (Suggestions for easier +% handling of package options are welcome.) +% \begin{macrocode} + \@ifundefined{cgr@vecscale@default}{}{% + \cgr@setopts@combgrphcs{vecscale=\cgr@vecscale@default}% + }% + \@ifundefined{cgr@textfont@default}{}{% + \cgr@setopts@combgrphcs{textfont=\cgr@textfont@default}% + }% + \@ifundefined{cgr@textcolor@default}{}{% + \cgr@setopts@combgrphcs{textcolor=\cgr@textcolor@default}% + }% + \@ifundefined{cgr@vecinclude@default}{}{% + \cgr@setopts@combgrphcs{vecinclude=\cgr@vecinclude@default}% + }% +% \end{macrocode} +% +% Afterwards, the macro containing the name of the vector graphics part is +% initialized and the options passed the the macro are processed. +% \begin{macrocode} + \def\cgr@vecfile{#2}% + \cgr@setopts@combgrphcs{#1}% +% \end{macrocode} +% +% Finally, the macro |\cgr@curr@pic| is complete and can be output. +% \begin{macrocode} + \cgr@curr@pic% + \endgroup% +} +% \end{macrocode} +% +% \subsection{Helper macros} +% +% This macro eats five arguments (analogous to |\@gobble| or |\@gobbletwo| from +% the \LaTeX{} kernel). +% \begin{macrocode} +\long\def\cgr@gobblefive#1#2#3#4#5{} +% \end{macrocode} +% +% This macro eats all stars (if any), all arguments in square brackets (if any) +% and one mandatory argument. +% \begin{macrocode} +\long\def\cgr@gobble@optone{\@ifstar{\cgr@gobble@optone}{\cgr@gobble@optone@}} +\long\def\cgr@gobble@optone@{\@ifnextchar [{\cgr@gobble@optone@@}{\@gobble}} +\long\def\cgr@gobble@optone@@[#1]{\cgr@gobble@optone@} +% \end{macrocode} +% +% In order to rescale the |picture| environment inside the \LaTeX{} part, the +% |\setlength{\unitlength}{|\meta{some dimen}|}| must be changed to scale +% \meta{some dimen} by |\cgr@vecscale| at its first appearance in the \LaTeX{} +% part. This is the |\setlength| substitute to do so. +% \begin{macrocode} +\let\cgr@setlength@orig=\setlength +\def\cgr@setlength#1#2{% + \ifx#1\unitlength% + \@tempdima=#2% + \cgr@setlength@orig{#1}{\cgr@vecscale\@tempdima}% + \def\setlength{\cgr@setlength@orig}% + \else% + \cgr@setlength@orig{#1}{#2}% + \fi% +} +% \end{macrocode} +% +% Additionally, a |scale=\cgr@vecscale| option must be passed to the +% |\includegraphics| macro inside the \LaTeX{} part. This is the substitute of +% |\includegraphics| for this purpose. +% \begin{macrocode} +\let\cgr@includegraphics@orig=\includegraphics +\def\cgr@includegraphics{% + \@ifstar{% + \cgr@includegraphics@s@% + }{% + \cgr@includegraphics@% + }% +} +\def\cgr@includegraphics@{% + \@ifnextchar [{% + \cgr@includegraphics@@% + }{% + \cgr@includegraphics@orig[scale=\cgr@vecscale]% + }% +} +\def\cgr@includegraphics@@[#1]{% + \@ifnextchar [{% + \cgr@includegraphics@@@[#1]% + }{% + \cgr@includegraphics@orig[#1,scale=\cgr@vecscale]% + }% +} +\def\cgr@includegraphics@@@[#1][#2]{% + \cgr@includegraphics@orig[#1][#2,scale=\cgr@vecscale]% +} +\def\cgr@includegraphics@s@{% + \@ifnextchar [{% + \cgr@includegraphics@s@@% + }{% + \cgr@includegraphics@orig*[scale=\cgr@vecscale]% + }% +} +\def\cgr@includegraphics@s@@[#1]{% + \@ifnextchar [{% + \cgr@includegraphics@s@@@[#1]% + }{% + \cgr@includegraphics@orig*[#1,scale=\cgr@vecscale]% + }% +} +\def\cgr@includegraphics@s@@@[#1][#2]{% + \cgr@includegraphics@orig*[#1][#2,scale=\cgr@vecscale]% +} +% \end{macrocode} +% +% This macro is identical to |\l@addto@macro| from \textsf{koma-script bundle}. +% It adds the stuff passed to its second argument to the end of the macro from +% its first argument. +% \begin{macrocode} +\newcommand{\cgr@addto@macro}[2]{% + \begingroup\toks@\expandafter{#1#2}% + \edef\@tempa{\endgroup\def\noexpand#1{\the\toks@}}% + \@tempa% +} +% \end{macrocode} +% +% The next macro is similar, but adds the stuff passed to its second argument +% to the \emph{beginning} of the macro from its first argument. An optional +% argument allows for fine tuning: A comma-separated list containing |expand| +% (expands the stuff from the second argument before adding it), |groupfirst|, +% and/or |groupsecond| (puts the stuff from the first/second argument in +% braces before adding) may be passed. +% \begin{macrocode} +\newcommand*\cgr@defopts@raddto{\define@key{cgr@raddto}} +\newcommand*\cgr@setopts@raddto{\setkeys{cgr@raddto}} +\newif\ifcgr@raddto@expand\cgr@raddto@expandfalse +\newif\ifcgr@raddto@groupfirst\cgr@raddto@groupfirstfalse +\newif\ifcgr@raddto@groupsecond\cgr@raddto@groupsecondfalse +\cgr@defopts@raddto{expand}[true]{\@nameuse{cgr@raddto@expand#1}} +\cgr@defopts@raddto{groupfirst}[true]{\@nameuse{cgr@raddto@groupfirst#1}} +\cgr@defopts@raddto{groupsecond}[true]{\@nameuse{cgr@raddto@groupsecond#1}} +\newtoks\cgr@token@a +\newtoks\cgr@token@b +\newcommand{\cgr@raddto@macro}[3][]{% + \begingroup% + \cgr@setopts@raddto{#1}% + \cgr@token@a\expandafter{#2}% + \ifcgr@raddto@expand% + \cgr@token@b\expandafter{#3}% + \else% + \cgr@token@b{#3}% + \fi% + \ifcgr@raddto@groupfirst% + \ifcgr@raddto@groupsecond% + \edef\@tempa{\endgroup% + \def\noexpand#2{{\the\cgr@token@b}{\the\cgr@token@a}}% + }% + \else% + \edef\@tempa{\endgroup% + \def\noexpand#2{\the\cgr@token@b{\the\cgr@token@a}}% + }% + \fi% + \else% + \ifcgr@raddto@groupsecond% + \edef\@tempa{\endgroup% + \def\noexpand#2{{\the\cgr@token@b}\the\cgr@token@a}% + }% + \else% + \edef\@tempa{\endgroup% + \def\noexpand#2{\the\cgr@token@b\the\cgr@token@a}% + }% + \fi% + \fi% + \@tempa% +} +% \end{macrocode} +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% \Finale +% +\endinput diff --git a/Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.ins b/Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.ins new file mode 100644 index 00000000000..09dde658b8f --- /dev/null +++ b/Master/texmf-dist/source/latex/combinedgraphics/combinedgraphics.ins @@ -0,0 +1,78 @@ +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +% +% installation file for combinedgraphics package +% +% Copyright 2009 Christian Schneider +% +% This file is part of combinedgraphics. +% +% combinedgraphics is free software: you can redistribute it and/or modify +% it under the terms of the GNU General Public License version 3 as +% published by the Free Software Foundation, not any later version. +% +% combinedgraphics is distributed in the hope that it will be useful, +% but WITHOUT ANY WARRANTY; without even the implied warranty of +% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +% GNU General Public License for more details. +% +% You should have received a copy of the GNU General Public License +% along with combinedgraphics. If not, see . +% +% WARNING: THIS IS ALPHA SOFTWARE AND MAY CONTAIN SERIOUS BUGS! +% +% %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% + +\input docstrip.tex +%\keepsilent + +\usedir{tex/latex/combinedgraphics} + +\preamble + +This is a generated file. + +Copyright 2009 Christian Schneider + +ion@addto@macro: identical to l@addto@macro from koma-script + bundle v2.9t +Copyright 1994-2004 Markus Kohm and Frank Neukam + +Thanks to Markus Kohm for permitting to use his code in this package. +Please do not bother Markus with questions or bugs concering this package! + +This file is part of combinedgraphics. + +combinedgraphics is free software: you can redistribute it and/or modify +it under the terms of the GNU General Public License version 3 as +published by the Free Software Foundation, not any later version. + +combinedgraphics is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with combinedgraphics. If not, see . + +WARNING: THIS IS ALPHA SOFTWARE AND MAY CONTAIN SERIOUS BUGS! + +\endpreamble + +\generate{\file{combinedgraphics.sty}{\from{combinedgraphics.dtx}{package}}} + +\obeyspaces +\Msg{****************************************************} +\Msg{* *} +\Msg{* To finish the installation you have to move the *} +\Msg{* following file into a directory searched by TeX: *} +\Msg{* *} +\Msg{* combinedgraphics.sty *} +\Msg{* *} +\Msg{* To produce the documentation run the file *} +\Msg{* combinedgraphics.dtx through LaTeX. *} +\Msg{* *} +\Msg{* Happy TeXing! *} +\Msg{* *} +\Msg{****************************************************} + +\endbatchfile -- cgit v1.2.3