/[auctex]/auctex/preview/latex/preview.dtx
ViewVC logotype

Diff of /auctex/preview/latex/preview.dtx

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.98 by dak, Sun Apr 3 02:27:38 2005 UTC revision 1.99 by angeli, Sun Apr 10 16:28:58 2005 UTC
# Line 41  Line 41 
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,
# Line 69  Line 69 
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
# Line 78  Line 78 
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}
# Line 203  Line 203 
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.
# Line 228  Line 228 
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.
# Line 244  Line 244 
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
# Line 1467  Please complain to your document class a Line 1467  Please complain to your document class a
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

Legend:
Removed from v.1.98  
changed lines
  Added in v.1.99

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26