kiteimage/io.github.yuroyami.kiteimage/Orientation

Orientation

How a decoded image relates to the scene it was captured from: the EXIF Orientation tag (TIFF tag 274), which phone cameras write instead of physically rotating pixels. A portrait photo is usually stored landscape with Rotate90 set, so anything that draws raw decoded pixels shows it sideways.

KiteBitmap.oriented applies one of these; ImageInfo.orientation and KiteImage.decode(applyOrientation = true) are where they come from.

The exifValues are the wire numbers 1..8. Anything else in a file is treated as Normal, which is what every renderer does with garbage here.

Entries

Normal

Stored as displayed.

FlipHorizontal

Mirrored left-to-right.

Rotate180

Upside down.

FlipVertical

Mirrored top-to-bottom.

Transpose

Mirrored across the main diagonal (transpose): rows become columns.

Rotate90

Rotate a quarter turn clockwise to display.

Transverse

Mirrored across the anti-diagonal (transverse).

Rotate270

Rotate a quarter turn counter-clockwise to display.

Types

Companion

object Companion

Properties

entries

val entries: EnumEntries<Orientation>

Returns a representation of an immutable list of all enum entries, in the order they're declared.

exifValue

val exifValue: Int

name

expect val name: String

ordinal

expect val ordinal: Int

swapsAxes

val swapsAxes: Boolean

True when applying this swaps width and height (Transpose, Rotate90, Transverse, Rotate270). Useful for laying out before you decode.

Functions

valueOf

fun valueOf(value: String): Orientation

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

values

fun values(): Array<Orientation>

Returns an array containing the constants of this enum type, in the order they're declared.