korge/korlibs.korge.view.filter/ColorMatrixFilter

ColorMatrixFilter

class ColorMatrixFilter(colorMatrix: Matrix4, blendRatio: Double = 1.0) : ShaderFilter

A Filter applying a complex color transformation to the view.

colorMatrix is a 4x4 Matrix used to multiply each color as floating points by this matrix. blendRatio is the ratio that will be used to interpolate the original color with the transformed color.

ColorMatrixFilter provides a few pre-baked matrices:

ColorMatrixFilter.GRAYSCALE_MATRIX - Used to make the colors grey
ColorMatrixFilter.IDENTITY_MATRIX - Doesn't modify the colors at all

Constructors

ColorMatrixFilter

constructor(colorMatrix: Matrix4, blendRatio: Double = 1.0)

Types

ColorMatrixUB

object ColorMatrixUB : UniformBlock

Companion

object Companion : ShaderFilter.BaseProgramProvider

Properties

allFilters

open val allFilters: List<Filter>

blendRatio

var blendRatio: Double

Ratio for blending the original color with the transformed color.

colorMatrix

var colorMatrix: Matrix4

The 4x4 MMatrix3D that will be used for transforming each pixel components r, g, b, a

filtering

open override var filtering: Boolean

isIdentity

open val isIdentity: Boolean

namedColorMatrix

var namedColorMatrix: String

programProvider

open override val programProvider: ShaderFilter.ProgramProvider

recommendedFilterScale

open val recommendedFilterScale: Double

Functions

computeBorder

open override fun computeBorder(texWidth: Int, texHeight: Int): MarginInt

The number of pixels the passed texture should be bigger at each direction: left, right, top, left.

expandedBorderRectangle

fun Filter.expandedBorderRectangle(inp: Rectangle): Rectangle

getBorder

fun Filter.getBorder(texWidth: Int, texHeight: Int): MarginInt

render

open override fun render(ctx: RenderContext, matrix: Matrix, texture: Texture, texWidth: Int, texHeight: Int, renderColorMul: RGBA, blendMode: BlendMode, filterScale: Double)

The method in charge of rendering the texture transformed using ctx and matrix. The method receives a texture that should be the original image with computeBorder additional pixels on each side.

renderToTextureWithBorder

fun Filter.~~renderToTextureWithBorder~~(ctx: RenderContext, matrix: Matrix, texture: Texture, texWidth: Int, texHeight: Int, filterScale: Double, block: (Texture, matrix: Matrix) -> Unit)

renderToTextureWithBorderUnsafe

fun Filter.renderToTextureWithBorderUnsafe(ctx: RenderContext, matrix: Matrix, texture: Texture, texWidth: Int, texHeight: Int, filterScale: Double, result: RenderToTextureResult = RenderToTextureResult()): RenderToTextureResult