Styling API

Colors, gradients, and patterns.

Classes

struct BLGradientStop

struct BLLinearGradientValues

struct BLRadialGradientValues

struct BLConicGradientValues

struct BLGradientCore

class BLGradient

struct BLPatternCore

class BLPattern

struct BLRgba32

struct BLRgba64

struct BLRgba

Enumerations

enum BLExtendMode : uint32_t

Functions

static constexpr BLRgba32 blMin(const BLRgba32& a, const BLRgba32& b)

static constexpr BLRgba32 blMax(const BLRgba32& a, const BLRgba32& b)

static constexpr BLRgba64 blMin(const BLRgba64& a, const BLRgba64& b)

static constexpr BLRgba64 blMax(const BLRgba64& a, const BLRgba64& b)

static constexpr BLRgba blMin(const BLRgba& a, const BLRgba& b)

static constexpr BLRgba blMax(const BLRgba& a, const BLRgba& b)

BLGradient - Constants

enum BLGradientType : uint32_t

enum BLGradientValue : uint32_t

enum BLGradientQuality : uint32_t

BLPattern - Constants

enum BLPatternQuality : uint32_t

BLGradient - C API

BLResult blGradientInit(BLGradientCore* self)

BLResult blGradientInitMove(BLGradientCore* self, BLGradientCore* other)

BLResult blGradientInitWeak(BLGradientCore* self, const BLGradientCore* other)

BLResult blGradientInitAs(BLGradientCore* self, BLGradientType type, const void* values, BLExtendMode extendMode, const BLGradientStop* stops, size_t n, const BLMatrix2D* transform)

BLResult blGradientDestroy(BLGradientCore* self)

BLResult blGradientReset(BLGradientCore* self)

BLResult blGradientAssignMove(BLGradientCore* self, BLGradientCore* other)

BLResult blGradientAssignWeak(BLGradientCore* self, const BLGradientCore* other)

BLResult blGradientCreate(BLGradientCore* self, BLGradientType type, const void* values, BLExtendMode extendMode, const BLGradientStop* stops, size_t n, const BLMatrix2D* transform)

BLResult blGradientShrink(BLGradientCore* self)

BLResult blGradientReserve(BLGradientCore* self, size_t n)

BLGradientType blGradientGetType(const BLGradientCore* self)

BLResult blGradientSetType(BLGradientCore* self, BLGradientType type)

BLExtendMode blGradientGetExtendMode(const BLGradientCore* self)

BLResult blGradientSetExtendMode(BLGradientCore* self, BLExtendMode extendMode)

double blGradientGetValue(const BLGradientCore* self, size_t index)

BLResult blGradientSetValue(BLGradientCore* self, size_t index, double value)

BLResult blGradientSetValues(BLGradientCore* self, size_t index, const double* values, size_t n)

size_t blGradientGetSize(const BLGradientCore* self)

size_t blGradientGetCapacity(const BLGradientCore* self)

const BLGradientStop* blGradientGetStops(const BLGradientCore* self)

BLResult blGradientResetStops(BLGradientCore* self)

BLResult blGradientAssignStops(BLGradientCore* self, const BLGradientStop* stops, size_t n)

BLResult blGradientAddStopRgba32(BLGradientCore* self, double offset, uint32_t argb32)

BLResult blGradientAddStopRgba64(BLGradientCore* self, double offset, uint64_t argb64)

BLResult blGradientRemoveStop(BLGradientCore* self, size_t index)

BLResult blGradientRemoveStopByOffset(BLGradientCore* self, double offset, uint32_t all)

BLResult blGradientRemoveStopsByIndex(BLGradientCore* self, size_t rStart, size_t rEnd)

BLResult blGradientRemoveStopsByOffset(BLGradientCore* self, double offsetMin, double offsetMax)

BLResult blGradientReplaceStopRgba32(BLGradientCore* self, size_t index, double offset, uint32_t rgba32)

BLResult blGradientReplaceStopRgba64(BLGradientCore* self, size_t index, double offset, uint64_t rgba64)

size_t blGradientIndexOfStop(const BLGradientCore* self, double offset)

BLResult blGradientGetTransform(const BLGradientCore* self, BLMatrix2D* transformOut)

BLTransformType blGradientGetTransformType(const BLGradientCore* self)

BLResult blGradientApplyTransformOp(BLGradientCore* self, BLTransformOp opType, const void* opData)

bool blGradientEquals(const BLGradientCore* a, const BLGradientCore* b)

BLPattern - C API

BLResult blPatternInit(BLPatternCore* self)

BLResult blPatternInitMove(BLPatternCore* self, BLPatternCore* other)

BLResult blPatternInitWeak(BLPatternCore* self, const BLPatternCore* other)

BLResult blPatternInitAs(BLPatternCore* self, const BLImageCore* image, const BLRectI* area, BLExtendMode extendMode, const BLMatrix2D* transform)

BLResult blPatternDestroy(BLPatternCore* self)

BLResult blPatternReset(BLPatternCore* self)

BLResult blPatternAssignMove(BLPatternCore* self, BLPatternCore* other)

BLResult blPatternAssignWeak(BLPatternCore* self, const BLPatternCore* other)

BLResult blPatternAssignDeep(BLPatternCore* self, const BLPatternCore* other)

BLResult blPatternCreate(BLPatternCore* self, const BLImageCore* image, const BLRectI* area, BLExtendMode extendMode, const BLMatrix2D* transform)

BLResult blPatternGetImage(const BLPatternCore* self, BLImageCore* image)

BLResult blPatternSetImage(BLPatternCore* self, const BLImageCore* image, const BLRectI* area)

BLResult blPatternResetImage(BLPatternCore* self)

BLResult blPatternGetArea(const BLPatternCore* self, BLRectI* areaOut)

BLResult blPatternSetArea(BLPatternCore* self, const BLRectI* area)

BLResult blPatternResetArea(BLPatternCore* self)

BLExtendMode blPatternGetExtendMode(const BLPatternCore* self)

BLResult blPatternSetExtendMode(BLPatternCore* self, BLExtendMode extendMode)

BLResult blPatternGetTransform(const BLPatternCore* self, BLMatrix2D* transformOut)

BLTransformType blPatternGetTransformType(const BLPatternCore* self)

BLResult blPatternApplyTransformOp(BLPatternCore* self, BLTransformOp opType, const void* opData)

bool blPatternEquals(const BLPatternCore* a, const BLPatternCore* b)

Common Functionality

void BLRgba32::reset(const BLRgba64& rgba64)

Enumeration Type Documentation

BLExtendMode : uint32_tenum

Extend mode.

Constant	Description
BL_EXTEND_MODE_PAD	Pad extend [default].
BL_EXTEND_MODE_REPEAT	Repeat extend.
BL_EXTEND_MODE_REFLECT	Reflect extend.
BL_EXTEND_MODE_PAD_X_PAD_Y	Alias to BL_EXTEND_MODE_PAD.
BL_EXTEND_MODE_PAD_X_REPEAT_Y	Pad X and repeat Y.
BL_EXTEND_MODE_PAD_X_REFLECT_Y	Pad X and reflect Y.
BL_EXTEND_MODE_REPEAT_X_REPEAT_Y	Alias to BL_EXTEND_MODE_REPEAT.
BL_EXTEND_MODE_REPEAT_X_PAD_Y	Repeat X and pad Y.
BL_EXTEND_MODE_REPEAT_X_REFLECT_Y	Repeat X and reflect Y.
BL_EXTEND_MODE_REFLECT_X_REFLECT_Y	Alias to BL_EXTEND_MODE_REFLECT.
BL_EXTEND_MODE_REFLECT_X_PAD_Y	Reflect X and pad Y.
BL_EXTEND_MODE_REFLECT_X_REPEAT_Y	Reflect X and repeat Y.
BL_EXTEND_MODE_SIMPLE_MAX_VALUE	Count of simple extend modes (that use the same value for X and Y).
BL_EXTEND_MODE_COMPLEX_MAX_VALUE	Count of complex extend modes (that can use independent values for X and Y).
BL_EXTEND_MODE_MAX_VALUE	Maximum value of BLExtendMode.

BLGradientType : uint32_tenum

Gradient type.

Constant	Description
BL_GRADIENT_TYPE_LINEAR	Linear gradient type.
BL_GRADIENT_TYPE_RADIAL	Radial gradient type.
BL_GRADIENT_TYPE_CONIC	Conic gradient type.
BL_GRADIENT_TYPE_MAX_VALUE	Maximum value of BLGradientType.

BLGradientValue : uint32_tenum

Gradient data index.

Constant	Description
BL_GRADIENT_VALUE_COMMON_X0	x0 - start 'x' for a Linear gradient and x center for both Radial and Conic gradients.
BL_GRADIENT_VALUE_COMMON_Y0	y0 - start 'y' for a Linear gradient and y center for both Radial and Conic gradients.
BL_GRADIENT_VALUE_COMMON_X1	x1 - end 'x' for a Linear gradient and focal point x for a Radial gradient.
BL_GRADIENT_VALUE_COMMON_Y1	y1 - end 'y' for a Linear/gradient and focal point y for a Radial gradient.
BL_GRADIENT_VALUE_RADIAL_R0	Radial gradient center radius.
BL_GRADIENT_VALUE_RADIAL_R1	Radial gradient focal radius.
BL_GRADIENT_VALUE_CONIC_ANGLE	Conic gradient angle.
BL_GRADIENT_VALUE_CONIC_REPEAT	Conic gradient angle.
BL_GRADIENT_VALUE_MAX_VALUE	Maximum value of BLGradientValue.

BLGradientQuality : uint32_tenum

Gradient rendering quality.

Constant	Description
BL_GRADIENT_QUALITY_NEAREST	Nearest neighbor.
BL_GRADIENT_QUALITY_SMOOTH	Use smoothing, if available (currently never available).
BL_GRADIENT_QUALITY_DITHER	The renderer will use an implementation-specific dithering algorithm to prevent banding.
BL_GRADIENT_QUALITY_MAX_VALUE	Maximum value of BLGradientQuality.

BLPatternQuality : uint32_tenum

Pattern quality.

Constant	Description
BL_PATTERN_QUALITY_NEAREST	Nearest neighbor interpolation.
BL_PATTERN_QUALITY_BILINEAR	Bilinear interpolation.
BL_PATTERN_QUALITY_MAX_VALUE	Maximum value of BLPatternQuality.