Instance Method

drawInRect:blendMode:alpha:

Draws the entire image in the specified rectangle and using the specified compositing options.

Declaration

- (void)drawInRect:(CGRect)rect blendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha;

Parameters

rect

The rectangle (in the coordinate system of the graphics context) in which to draw the image.

blendMode

The blend mode to use when compositing the image.

alpha

The desired opacity of the image, specified as a value between 0.0 and 1.0. A value of 0.0 renders the image totally transparent while 1.0 renders it fully opaque. Values larger than 1.0 are interpreted as 1.0.

Discussion

This method scales the image as needed to make it fit in the specified rectangle. This method draws the image in the current graphics context, respecting the image’s orientation setting. In the default coordinate system, images are situated down and to the right of the origin of the specified rectangle. This method respects any transforms applied to the current graphics context, however.

See Also

Drawing Images

- drawAtPoint:

Draws the image at the specified point in the current context.

- drawAtPoint:blendMode:alpha:

Draws the entire image at the specified point using the custom compositing options.

- drawInRect:

Draws the entire image in the specified rectangle, scaling it as needed to fit.

- drawAsPatternInRect:

Draws a tiled Quartz pattern using the receiver’s contents as the tile pattern.