patternCreateRgba

fncairo.pattern.Pattern patternCreateRgba(double red, double green, double blue, double alpha)

Creates a new #cairo_pattern_t corresponding to a translucent color. The color components are floating point numbers in the range 0 to

  1. If the values passed in are outside that range, they will be

clamped.

The color is specified in the same way as in [cairo.context.Context.setSourceRgb].

Parameters

redred component of the color
greengreen component of the color
blueblue component of the color
alphaalpha component of the color

Returns

the newly created #cairo_pattern_t if successful, or

an error pattern in case of no memory. The caller owns the returned object and should call [cairo.pattern.Pattern.destroy] when finished with it.

This function will always return a valid pointer, but if an error occurred the pattern status will be set to an error. To inspect the status of a pattern use [cairo.pattern.Pattern.status].