Instance Method

fillWithBlendMode:alpha:

Paints the region enclosed by the receiver’s path using the specified blend mode and transparency values.

Declaration

- (void)fillWithBlendMode:(CGBlendMode)blendMode alpha:(CGFloat)alpha;

Parameters

blendMode

The blend mode determines how the filled path is composited with any existing rendered content.

alpha

The amount of transparency to apply to the filled path. Values can range between 0.0 (transparent) and 1.0 (opaque). Values outside this range are clamped to 0.0 or 1.0.

Discussion

This method fills the path using the current fill color and drawing properties (plus the specified blend mode and transparency value). If the path contains any open subpaths, this method implicitly closes them before painting the fill region.

The painted region includes the pixels right up to, but not including, the path line itself. For paths with large line widths, this can result in overlap between the fill region and the stroked path (which is itself centered on the path line).

This method automatically saves the current graphics state prior to drawing and restores that state when it is done, so you do not have to save the graphics state yourself.

See Also

Drawing Paths

- fill

Paints the region enclosed by the receiver’s path using the current drawing properties.

- stroke

Draws a line along the receiver’s path using the current drawing properties.

- strokeWithBlendMode:alpha:

Draws a line along the receiver’s path using the specified blend mode and transparency values.