PDFlib 8 Windows COM/.NET Tutorial

Fig. 7.3 Fitting an image into a box subject to various fit methods
Generated output Option list for fit_image( )
a) boxsize={70 45} position=center
b) boxsize={35 45} position=center
c) boxsize={70 45} position=center fitmethod=meet
d) boxsize={35 45} position=center fitmethod=meet
e) boxsize={70 45} position=center fitmethod=entire
f) boxsize={30 30} position=center fitmethod=clip
g) boxsize={30 30} position={right top} fitmethod=clip
Adjusting an object to the page. Adjusting an object to a given page size can easily be
accomplished by choosing the page as target box for placing the object. The following
statement uses an A4-sized page with dimensions 595 x 842:
p.fit_image(image, 0, 0, "boxsize={595 842} position={left bottom} fitmethod=slice");
In this code fragment a box is placed at the lower left corner of the page. The size of the
box equals the size of an A4 page. The object is placed in the lower left corner of the box
and scaled proportionally until it fully covers the box and therefore the page. If the object
exceeds the box it will be cropped. Note that fitmethod=slice results in the object being
scaled (as opposed to fitmethod=clip which doesn’t scale the object). Of course the
position and fitmethod options could also be varied in this example.
7.3.3 Orientating an Object
Placing an image with orientation. In our next example we orientate an image towards
western direction (orientate=west). This means that the image is rotated by 90˚
counterclockwise and then the lower left corner of the rotated object is translated to the
reference point (0, 0). The object will be rotated in itself (see Figure 7.6a). Since we have
194 Chapter 7: Importing Images and PDF Pages (Edition for COM, .NET, and REALbasic)