kiteimage/io.github.yuroyami.kiteimage/KiteBitmap

KiteBitmap

class KiteBitmap(val width: Int, val height: Int, val argb: IntArray)

A decoded raster image: width × height pixels, packed as non-premultiplied ARGB_8888 in a row-major argb array (argb[y * width + x], alpha in the top byte). One layout for every source format: decoders normalise grayscale, palette, BGR and 16-bit inputs into this on the way out, so consumers and the Compose interop never branch on the source format.

argb is exposed directly (not copied) so a full-screen photo doesn't pay a second multi-megabyte allocation on the way to ImageBitmap. Treat it as read-only; mutate it only if you own the instance.

Constructors

KiteBitmap

constructor(width: Int, height: Int, argb: IntArray)

Properties

argb

val argb: IntArray

height

val height: Int

width

val width: Int

Functions

cropped

fun KiteBitmap.cropped(x: Int, y: Int, width: Int, height: Int): KiteBitmap

Copy the width×height region whose top-left corner is (x, y).

flippedHorizontal

fun KiteBitmap.flippedHorizontal(): KiteBitmap

Mirror left-to-right.

flippedVertical

fun KiteBitmap.flippedVertical(): KiteBitmap

Mirror top-to-bottom.

get

operator fun get(x: Int, y: Int): Int

The packed ARGB pixel at (x, y).

hasTransparency

fun hasTransparency(): Boolean

True if any pixel has alpha < 255. O(n) scan, not cached.

oriented

fun KiteBitmap.oriented(orientation: Orientation): KiteBitmap

Apply an EXIF orientation so the result is oriented the way the camera meant it to be seen. Orientation.Normal returns the same instance.

rotated180

fun KiteBitmap.rotated180(): KiteBitmap

Rotate a half turn. Dimensions are unchanged.

rotated270

fun KiteBitmap.rotated270(): KiteBitmap

Rotate a quarter turn counter-clockwise. Width and height swap.

rotated90

fun KiteBitmap.rotated90(): KiteBitmap

Rotate a quarter turn clockwise. Width and height swap.

scaled

fun KiteBitmap.scaled(maxWidth: Int, maxHeight: Int): KiteBitmap

Downscale to fit inside maxWidth×maxHeight, preserving aspect ratio, using box (area-average) filtering: each destination pixel averages every source pixel that maps into its bin, so thumbnails don't shimmer the way nearest-neighbor ones do.

toString

open override fun toString(): String

transposed

fun KiteBitmap.transposed(): KiteBitmap

Mirror across the main diagonal: dst(x, y) = src(y, x). Axes swap.

transversed

fun KiteBitmap.transversed(): KiteBitmap

Mirror across the anti-diagonal. Axes swap.