All Manuals > CAPI User Guide and Reference Manual > 22 GRAPHICS-PORTS Reference Entries

set-graphics-port-coordinates Function

Summary

Modifies the transform of a port such that the edges of the port correspond to the arguments given.

Package

graphics-ports

Signature

set-graphics-port-coordinates port &key left top right bottom

Arguments
port
A graphics port.
left
A real number.
top
A real number.
right
A real number.
bottom
A real number.
Description

The function set-graphics-port-coordinates modifies the transform of the graphics port port permanently such that the edges of port correspond to the rectangle (left top right bottom).

Notes

The transform is part of the port's graphics state. See graphics-state for details of how it is used.

Examples

The following code:

(set-graphics-port-coordinates port :left -1.0 
                                    :top 1.0 
                                    :right 1.0 
                                    :bottom -1.0) 

changes the coordinates of the port so that the point (0 0) is in the exact center of the port and the edges are a unit distance away, with a right-handed coordinate system.

By default, left and top are 1.

See also

graphics-state


CAPI User Guide and Reference Manual (Windows version) - 01 Dec 2021 19:34:15