kitepdf-core/io.github.yuroyami.kitepdf.core.render/KiteShading/Radial

Radial

data class Radial(val colorSpace: KiteColorSpace, val background: RgbColor?, val bbox: KiteRectangle?, val coords: DoubleArray, val domain: DoubleArray, val function: KiteFunction, val extendStart: Boolean, val extendEnd: Boolean) : KiteShading

Type 3 radial shading. Gradient between two circles: (x0, y0, r0) and (x1, y1, r1) with t running across domain.

Constructors

Radial

constructor(colorSpace: KiteColorSpace, background: RgbColor?, bbox: KiteRectangle?, coords: DoubleArray, domain: DoubleArray, function: KiteFunction, extendStart: Boolean, extendEnd: Boolean)

Properties

background

open override val background: RgbColor?

Optional /Background colour, used for regions outside the shading domain when Extend is false on the relevant side. Per spec the background is in colorSpace; we eager-convert to RGB.

bbox

open override val bbox: KiteRectangle?

Optional clipping rectangle (/BBox) in shading-space.

colorSpace

open override val colorSpace: KiteColorSpace

The shading's colour space (DeviceGray / DeviceRGB / DeviceCMYK / Indexed).

coords

val coords: DoubleArray

x0, y0, r0, x1, y1, r1 in shading-space.

domain

val domain: DoubleArray

extendEnd

val extendEnd: Boolean

extendStart

val extendStart: Boolean

function

val function: KiteFunction

Functions

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

sampleStops

fun KiteShading.sampleStops(count: Int = 256): GradientStops?

Sample a KiteShading.Axial or KiteShading.Radial at evenly-spaced stops between domain[0] and domain[1]. Returns parallel t and RGB arrays the backend uses to build a gradient brush. The default of 256 matches MuPDF, so a function with many narrow bands keeps them all (#153).

spreadOver

fun KiteShading.spreadOver(spread: KiteGradientSpread, region: KiteRectangle): KiteShading

This axial or radial shading continued past its ends by spread, over a region whose bounds in shading space are region. The result is an ordinary shading that every canvas paints: its geometry grows to cover the region, and a stitching function (ISO 32000-1, 7.10.4) repeats or mirrors the colours once per period.