home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / lout2.lzh / LOUT2 / DOC / TR.LOUT / ch3.24 < prev    next >
Text File  |  1994-01-25  |  1KB  |  31 lines

  1. @Section
  2.    @Title { "@IncludeGraphic" and "@SysIncludeGraphic" }
  3.    @Tag { includegraphic }
  4. @Begin
  5. @PP
  6. includegraphic.sym @Index { @@IncludeGraphic symbol }
  7. sysincludegraphic.sym @Index { @@SysIncludeGraphic symbol }
  8. postscript.includegraphic @SubIndex { used by @@IncludeGraphic }
  9. These symbols instruct Lout to incorporate a separately created
  10. illustration:
  11. @ID @Code "@IncludeGraphic  \"myportrait.eps\""
  12. The parameter is implementation-dependent; in Basser Lout it is an
  13. object whose value is a simple word denoting the name of a file.  This
  14. file should ideally be a PostScript EPS Version 3.0 file [{@Ref adobe90}],
  15. since then Lout will keep careful track of what resources are required
  16. for printing that file.  However, any PostScript file containing the
  17. @Code "%%BoundingBox:" comment and not requiring unusual resources is
  18. likely to work.
  19. @PP
  20. The result of @@IncludeGraphic is an ordinary Lout object with marks
  21. through its centre.  It may be rotated, scaled, and generally
  22. treated like any other object.  Basser Lout determines its size by
  23. consulting the bounding box information in the file.  If this cannot be
  24. found, a warning message is printed and the result object has zero size.
  25. @PP
  26. @@IncludeGraphic searches the same directories that @@Include does
  27. (Section {@NumberOf include}).  @@SysIncludeGraphic is the same as
  28. @@IncludeGraphic, except that it searches only the directories searched
  29. by @@SysInclude.
  30. @End @Section
  31.