Function

Summary

Displays an image on a graphics port at a given position.

Package

graphics-ports

Signature

draw-image port image to-x to-y &rest args &key from-x from-y to-width to-height from-width from-height global-alpha

Arguments

port

A graphics port.

image

An image.

to-x

A real number.

to-y

A real number.

args

General graphics port drawing arguments.

from-x

A real number.

from-y

A real number.

to-width

A real number.

to-height

A real number.

from-width

A real number.

from-height

A real number.

global-alpha

A real number in the inclusive range [0,1], or nil .

Description

The draw-image function displays image on the port at to-x to-y . Graphics state translation is guaranteed to be supported. The default value of from-x and from-y is 0. The width and height arguments default to the size of the image.

Support for scaling and rotation are library dependent. Specifically, scaling is supported in the Windows and Cocoa implementations, but not on X11/Motif.

global-alpha , if non- nil , is a blending factor that applies to the whole image, in the Windows and Cocoa implementations, but not on X11/Motif. The value 0 means use only the target (that is, do not draw anything) and the value 1 means use only the source (that is, normal drawing). Intermediate real values mean use proportions of both the target and source. The value nil also means normal drawing, and this is the default value.