DragonFly On-Line Manual Pages
eps(n) BLT Built-In Commands eps(n)
______________________________________________________________________________
NAME
eps - Encapsulated PostScript canvas item.
SYNOPSIS
canvas create eps x y ?option value?...
______________________________________________________________________________
DESCRIPTION
The eps canvas item lets you place encapulated PostScript (EPS) on a
canvas, controlling its size and placement. The EPS item is displayed
either as a solid rectangle or a preview image. The preview image is
designated in one of two ways: 1) the EPS file contains an ASCII
hexidecimal preview, or 2) a Tk photo image. When the canvas generates
PostScript output, the EPS will be inserted with the proper translation
and scaling to match that of the EPS item. So can use the canvas widget
as a page layout tool.
EXAMPLE
Let's say you have for PostScript files of four graphs which you want
to tile two-by-two on a single page. Maybe you'd like to annotate the
graphs by putting a caption at the bottom of each graph.
Normally, you would have to resort to an external tool or write your
own PostScript program. The eps canvas item lets you do this through
Tk's canvas widget. An eps item displays an image (or rectangle)
representing the encapsulated PostScript file. It also scales and
translates the EPS file when the canvas is printed.
SYNTAX
canvas create eps x y ?option value?...
The eps item creates a new canvas item. Canvas is the name of a canvas
widget. You must supply the X-Y coordinate of the new eps item. How
the coordinate is exactly interpretered is controlled by the -anchor
option (see below).
Additional options may be specified on the command line to configure
aspects of the eps item such as its color, stipple, and font. The
following option and value pairs are valid.
-anchor anchor
Tells how to position the EPS item relative to its X-Y
coordinate. The default is center.
-background color
Sets the background color of the EPS rectangle.
-borderwidth pixels
Sets the width of the 3-D border around the outside edge of the
item. The -relief option determines if the border is to be
drawn. The default is 0.
-file fileName
Specifies the name of the EPS file. The first line of an EPS
file must start with "%!PS" and contain a "EPS" version
specification. The other requirement is that there be a
"%%BoundingBox:" entry which contains four integers representing
the lower-left and upper-right coordinates of the area bounding
the EPS. The default is "".
-font fontName
Specifies the font of the title. The default is *-Helvetica-
Bold-R-Normal-*-18-180-*.
-foreground color
Specifies the foreground color of the EPS rectangle. The option
matters only when the -stipple option is set. The default is
white.
-height pixels
Specifies the height EPS item. If pixels is 0, then the height
is determined from the PostScript "BoundingBox:" entry in the
EPS file. The default is 0.
-image photo
Specifies the name of a Tk photo image to be displayed as in the
item as a preview image. This option overrides any preview
specification found in the EPS file. The default is "".
-justify justify
Specifies how the title should be justified. This matters only
when the title contains more than one line of text. Justify must
be left, right, or center. The default is center.
-relief relief
Specifies the 3-D effect for the EPS item. Relief specifies how
the item should appear relative to canvas; for example, raised
means the item should appear to protrude. The default is flat.
-shadowcolor color
Specifies the color of the drop shadow used for the title. The
option with the -shadowoffset option control how the title's
drop shadow appears. The default is grey.
-shadowoffset pixels
Specifies the offset of the drop shadow from the title's text.
If pixels is 0, no shadow will be seen. The default is 0.
-showimage boolean
Indicates whether to display the image preview (if one exists),
or a simple rectangle. The default is yes.
-stipple bitmap
Specifies a bitmap to used to stipple the rectangle representing
the EPS item. The default is "".
-title string
Sets the title of the EPS item. If string is "", then the title
specified by the PostScript "Title:" entry is used. You can set
the string a single space to display no title. The default is
"".
-titleanchor anchor
Tells how to position the title within EPS item. The default is
n.
-titlecolor color
Specifies the color of the title. The default is white.
-titlerotate degrees
Sets the rotation of the title. Degrees is a real number
representing the angle of rotation. The title is first rotated
in space and then placed according to the -titleanchor position.
The default rotation is 0.0.
-width pixels
Specifies the width EPS item. If pixels is 0, then the width is
determined from the PostScript "BoundingBox:" entry in the EPS
file. The default is 0. 5i.
BLT 2.5 eps(n)