diff options
| author | Jeffrey H. Kingston <jeff@it.usyd.edu.au> | 2010-09-14 19:21:41 +0000 |
|---|---|---|
| committer | Jeffrey H. Kingston <jeff@it.usyd.edu.au> | 2010-09-14 19:21:41 +0000 |
| commit | 71bdb35d52747e6d7d9f55df4524d57c2966be94 (patch) | |
| tree | 480ee5eefccc40d5f3331cc52d66f722fd19bfb9 /doc/expert/pre_incg | |
| parent | b41263ea7578fa9742486135c762803b52794105 (diff) | |
| download | lout-71bdb35d52747e6d7d9f55df4524d57c2966be94.tar.gz | |
Lout 3.17.
git-svn-id: http://svn.savannah.nongnu.org/svn/lout/trunk@2 9365b830-b601-4143-9ba8-b4a8e2c3339c
Diffstat (limited to 'doc/expert/pre_incg')
| -rw-r--r-- | doc/expert/pre_incg | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/expert/pre_incg b/doc/expert/pre_incg new file mode 100644 index 0000000..a370c5c --- /dev/null +++ b/doc/expert/pre_incg @@ -0,0 +1,36 @@ +@Section + @Title { "@IncludeGraphic" and "@SysIncludeGraphic" } + @Tag { includegraphic } +@Begin +@PP +includegraphic.sym @Index { @@IncludeGraphic symbol } +sysincludegraphic.sym @Index { @@SysIncludeGraphic symbol } +postscript.includegraphic @SubIndex { used by @@IncludeGraphic } +These symbols instruct Lout to incorporate a separately created +illustration: +@ID @Code "@IncludeGraphic \"myportrait.eps\"" +The parameter is implementation-dependent; in Basser Lout it is an +object whose value is a simple word denoting the name of a file. This +file should ideally be a PostScript EPS Version 3.0 file +@Cite { $adobe1990ps }, since then Lout will keep careful track of what +resources are required for printing that file. However, any PostScript +file containing the @Code "%%BoundingBox:" comment and not requiring +unusual resources is likely to work. +@PP +The result of @@IncludeGraphic is an ordinary Lout object with marks +through its centre. It may be rotated, scaled, and generally +treated like any other object. Basser Lout determines its size by +consulting the bounding box information in the file. If this cannot be +found, a warning message is printed and the result object has zero size. +@PP +@@IncludeGraphic searches the same directories that @@Include does +(Section {@NumberOf include}). @@SysIncludeGraphic is the same as +@@IncludeGraphic, except that it searches only the directories searched +by @@SysInclude. +@PP +If the file name ends in any of {@Code ".gz"}, {@Code "-gz"}, {@Code ".z"}, +{@Code "-z"}, {@Code "_z"}, or {@Code ".Z"}, the file will first be +uncompressed using the @Code "gunzip" command into a temporary file +called @Code "lout.eps" in the current directory. This file is removed +immediately after it is copied into the output file. +@End @Section |