Gradient.addColorStopRGBA

Adds a translucent color stop to a gradient pattern. The offset specifies the location along the gradient's control vector. For example, a linear gradient's control vector is from (x0,y0) to (x1,y1) while a radial gradient's control vector is from any point on the start circle to the corresponding point on the end circle.

The color is specified in the same way as in context.setSourceRGBA().

If two (or more) stops are specified with identical offset values, they will be sorted according to the order in which the stops are added, (stops added earlier will compare less than stops added later). This can be useful for reliably making sharp color transitions instead of the typical blend.

  1. void addColorStopRGBA(double offset, RGBA color)
    class Gradient
    void
    addColorStopRGBA
    (
    double offset
    ,)
  2. void addColorStopRGBA(double offset, double red, double green, double blue, double alpha)

Parameters

offset double

an offset in the range [0.0 .. 1.0]

Note: If the pattern is not a gradient pattern, (eg. a linear or radial pattern), then the pattern will be put into an error status with a status of CAIRO_STATUS_PATTERN_TYPE_MISMATCH.

Meta