41 |
% The main purpose of this package is the extraction of certain |
% The main purpose of this package is the extraction of certain |
42 |
% environments (most notably displayed formulas) from \LaTeX\ sources |
% environments (most notably displayed formulas) from \LaTeX\ sources |
43 |
% as graphics. This works with DVI files postprocessed by either |
% as graphics. This works with DVI files postprocessed by either |
44 |
% Dvips and GhostScript or Dvipng, but it also works when you are |
% Dvips and Ghostscript or Dvipng, but it also works when you are |
45 |
% using PDF\TeX for generating PDF files (usually also postprocessed |
% using PDF\TeX for generating PDF files (usually also postprocessed |
46 |
% by GhostScript). |
% by Ghostscript). |
47 |
% |
% |
48 |
% Current uses of the package include the \previewlatex\ package for |
% Current uses of the package include the \previewlatex\ package for |
49 |
% WYSIWYG functionality in the AUC\TeX\ editing environment, |
% WYSIWYG functionality in the AUC\TeX\ editing environment, |
69 |
% option. This will embed the page dimensions into the PostScript or |
% option. This will embed the page dimensions into the PostScript or |
70 |
% PDF code, obliterating the need to use the |-E -i| options to Dvips. |
% PDF code, obliterating the need to use the |-E -i| options to Dvips. |
71 |
% You can then produce all image files with a single run of |
% You can then produce all image files with a single run of |
72 |
% GhostScript from a single PDF or PostScript (as opposed to EPS) |
% Ghostscript from a single PDF or PostScript (as opposed to EPS) |
73 |
% file. |
% file. |
74 |
% |
% |
75 |
% Various options exist that will pass \TeX\ dimensions and other |
% Various options exist that will pass \TeX\ dimensions and other |
78 |
% make use of it. |
% make use of it. |
79 |
% |
% |
80 |
% The possibility for generating a whole set of graphics with a single |
% The possibility for generating a whole set of graphics with a single |
81 |
% run of GhostScript (whether from \LaTeX\ or PDF\LaTeX) increases |
% run of Ghostscript (whether from \LaTeX\ or PDF\LaTeX) increases |
82 |
% both speed and robustness of applications. It is also feasible to |
% both speed and robustness of applications. It is also feasible to |
83 |
% use Dvipng on a DVI file with the options |
% use Dvipng on a DVI file with the options |
84 |
% \begin{quote} |
% \begin{quote} |
85 |
% |-picky -noghostscript| |
% |-picky -noghostscript| |
86 |
% \end{quote} |
% \end{quote} |
87 |
% to omit generating any image file that requires GhostScript, then |
% to omit generating any image file that requires Ghostscript, then |
88 |
% let a script generate all missing files using Dvips/GhostScript. |
% let a script generate all missing files using Dvips/Ghostscript. |
89 |
% This will usually speed up the process significantly. |
% This will usually speed up the process significantly. |
90 |
% |
% |
91 |
% \section{Package options} |
% \section{Package options} |
203 |
% |dvips -E -i -Pwww -o| \meta{outputfile}|.000| \meta{inputfile} |
% |dvips -E -i -Pwww -o| \meta{outputfile}|.000| \meta{inputfile} |
204 |
% \end{quote} |
% \end{quote} |
205 |
% However, in case those are to be processed further into graphic |
% However, in case those are to be processed further into graphic |
206 |
% image files by GhostScript, this process is inefficient since all |
% image files by Ghostscript, this process is inefficient since all |
207 |
% of those files need to be processed one by one. In addition, it |
% of those files need to be processed one by one. In addition, it |
208 |
% is necessary to extract the bounding box comments from the EPS |
% is necessary to extract the bounding box comments from the EPS |
209 |
% files and convert them into page dimension parameters for |
% files and convert them into page dimension parameters for |
210 |
% GhostScript in order to avoid full-page graphics. This is not |
% Ghostscript in order to avoid full-page graphics. This is not |
211 |
% even possible if you wanted to use GhostScript in a~\emph{single} |
% even possible if you wanted to use Ghostscript in a~\emph{single} |
212 |
% run for generating the files from a single PostScript file, since |
% run for generating the files from a single PostScript file, since |
213 |
% Dvips will in that case leave no bounding box information |
% Dvips will in that case leave no bounding box information |
214 |
% anywhere. |
% anywhere. |
228 |
% The |tightpage| option actually also works when using the |pdftex| |
% The |tightpage| option actually also works when using the |pdftex| |
229 |
% option and generating PDF files with PDF\TeX. The resulting PDF |
% option and generating PDF files with PDF\TeX. The resulting PDF |
230 |
% file has separate page dimensions for every page and can directly |
% file has separate page dimensions for every page and can directly |
231 |
% be converted with one run of GhostScript into image files. |
% be converted with one run of Ghostscript into image files. |
232 |
% |
% |
233 |
% If neither |dvips| or |pdftex| have been specified, the |
% If neither |dvips| or |pdftex| have been specified, the |
234 |
% corresponding option will get autodetected and invoked. |
% corresponding option will get autodetected and invoked. |
244 |
% value by using \cmd{\setlength}. The default value is |
% value by using \cmd{\setlength}. The default value is |
245 |
% |0.50001bp|, which is half of a usual PostScript point, rounded |
% |0.50001bp|, which is half of a usual PostScript point, rounded |
246 |
% up. If you go below this value, the resulting page size may drop |
% up. If you go below this value, the resulting page size may drop |
247 |
% below |1bp|, and GhostScript does not seem to like that. If you |
% below |1bp|, and Ghostscript does not seem to like that. If you |
248 |
% need finer control, you can adjust the bounding box dimensions |
% need finer control, you can adjust the bounding box dimensions |
249 |
% individually by changing the macro |\PreviewBbAdjust| with the |
% individually by changing the macro |\PreviewBbAdjust| with the |
250 |
% help of |\renewcommand|. Its default value is |
% help of |\renewcommand|. Its default value is |
1467 |
% |dvips -E -i -Ppdf -o| \meta{outputfile}|.000| \meta{inputfile} |
% |dvips -E -i -Ppdf -o| \meta{outputfile}|.000| \meta{inputfile} |
1468 |
% \end{quote} |
% \end{quote} |
1469 |
% However, in case those are to be processed further into graphic |
% However, in case those are to be processed further into graphic |
1470 |
% image files by GhostScript, this process is inefficient. One cannot |
% image files by Ghostscript, this process is inefficient. One cannot |
1471 |
% use GhostScript in a single run for generating the files, however, |
% use Ghostscript in a single run for generating the files, however, |
1472 |
% since one needs to set the page size (or full size pages will be |
% since one needs to set the page size (or full size pages will be |
1473 |
% produced). The |tightpage| option will set the page dimensions at |
% produced). The |tightpage| option will set the page dimensions at |
1474 |
% the start of each PostScript page so that the output will be sized |
% the start of each PostScript page so that the output will be sized |
1475 |
% appropriately. That way, a single pass of Dvips followed by a |
% appropriately. That way, a single pass of Dvips followed by a |
1476 |
% single pass of GhostScript will be sufficient for generating all |
% single pass of Ghostscript will be sufficient for generating all |
1477 |
% images. |
% images. |
1478 |
% |
% |
1479 |
% You will have to specify the output driver to be used, either |
% You will have to specify the output driver to be used, either |