Skip to content

PaletteImage

This module converts possibly non-square pixels of an image to palette indices.

LogicalImage module-attribute

A logical image, either a PaletteImage or a Window into one.

PixelSize module-attribute

Size of logical pixels.

ATTRIBUTE DESCRIPTION
x

Width of logical pixels.

y

Height of logical pixels.

PaletteImage(palette, filename=None, image=None, pixel_size=PixelSize(1, 1))

Convert image to palette indices.

PARAMETER DESCRIPTION
palette

Palette to use.

TYPE: Palette

filename

Name of file to load image from.

TYPE: str | None DEFAULT: None

image

Image to use.

TYPE: Image | None DEFAULT: None

pixel_size

Size of logical pixels.

TYPE: PixelSize DEFAULT: PixelSize(1, 1)

get(x, y)

Get palette index of logical pixel at (x, y).

PARAMETER DESCRIPTION
x

X coordinate of logical pixel.

TYPE: int

y

Y coordinate of logical pixel.

TYPE: int

RETURNS DESCRIPTION
int | None

Palette index of logical pixel at (x, y).

RAISES DESCRIPTION
ValueError

If (x, y) is outside image.

FilePositionException

If pixel color is not in palette or logical pixel is non-uniform.

Window(image, x_offset, y_offset, width, height)

A window into a PaletteImage.

PARAMETER DESCRIPTION
image

Image or window to create window into.

TYPE: PaletteImage | Window

x_offset

X offset of window into image.

TYPE: int

y_offset

Y offset of window into image.

TYPE: int

width

Width of window.

TYPE: int

height

Height of window.

TYPE: int

RAISES DESCRIPTION
ValueError

If window is larger than image.

get(x, y)

Get palette index of logical pixel at (x, y) in window.

PARAMETER DESCRIPTION
x

X coordinate of logical pixel in window.

TYPE: int

y

Y coordinate of logical pixel in window.

TYPE: int

RETURNS DESCRIPTION
int | None

Palette index of logical pixel at (x, y) in window.

RAISES DESCRIPTION
ValueError

If (x, y) is outside window.

FilePositionException

If pixel color is not in palette or logical pixel is non-uniform.