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, width=None, height=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

width

Width of image in logical pixels.

TYPE: int | None DEFAULT: None

height

Height of image in logical pixels.

TYPE: int | 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.

set(x, y, color)

Set logical pixel at (x, y) to color.

PARAMETER DESCRIPTION
x

X coordinate of logical pixel.

TYPE: int

y

Y coordinate of logical pixel.

TYPE: int

color

Palette index to set logical pixel to.

TYPE: int

RAISES DESCRIPTION
ValueError

If (x, y) is outside image or color is not in palette.

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.

set(x, y, color)

Set logical pixel at (x, y) to color.

PARAMETER DESCRIPTION
x

X coordinate of logical pixel in window.

TYPE: int

y

Y coordinate of logical pixel in window.

TYPE: int

color

Palette index to set logical pixel to.

TYPE: int

RAISES DESCRIPTION
ValueError

If (x, y) is outside window or color is not in palette.