Pixel Array

Apply a box blur effect to a pixel array.

Box blur creates a uniform blur effect by averaging pixels within a square kernel. It's faster than Gaussian blur but produces a more uniform, less natural look.

Args

• pixel_array : The pixel array to blur.
• radius : The blur radius in pixels. Larger values create stronger blur.
• repeat_edge_pixels : Whether to repeat edge pixels when sampling outside the pixel array bounds. Defaults to True.

Returns

PixelArray : A new pixel array with the box blur effect applied.

Raises

• RuntimeError : If pixel array creation fails during the blur process.

Flip a pixel array horizontally, vertically, or both.

Args

• pixel_array : The pixel array to flip.
• flip_x : Whether to flip horizontally (mirror left-right).
• flip_y : Whether to flip vertically (mirror top-bottom).

Returns

PixelArray : A new pixel array with the flipped image.

Raises

• RuntimeError : If pixel array creation fails.

Apply a Gaussian blur effect to a pixel array.

Gaussian blur creates a natural, smooth blur effect using a Gaussian distribution for pixel weighting. It produces higher quality results than box blur but is computationally more expensive.

Args

• pixel_array : The pixel array to blur.
• radius : The blur radius in pixels. Larger values create stronger blur.
• repeat_edge_pixels : Whether to repeat edge pixels when sampling outside the pixel array bounds. Defaults to True.

Returns

PixelArray : A new pixel array with the Gaussian blur effect applied.

Raises

• RuntimeError : If pixel array creation fails during the blur process.

Convert a pixel array to grayscale.

Converts the pixel array to grayscale using the standard luminance formula: gray = 0.299 * red + 0.587 * green + 0.114 * blue

This formula accounts for human perception of brightness across different colors. The alpha channel is preserved unchanged.

Args

• pixel_array : The pixel array to convert to grayscale.

Returns

PixelArray : A new pixel array converted to grayscale.

Raises

• RuntimeError : If pixel array creation fails.

Invert the colors of a pixel array.

Creates a negative image effect by inverting each color channel (RGB). The alpha channel is preserved unchanged.

Args

• pixel_array : The pixel array to invert.

Returns

PixelArray : A new pixel array with inverted colors.

Raises

• RuntimeError : If pixel array creation fails.

Rotate a pixel array by a given angle.

Args

• pixel_array : The pixel array to rotate.
• angle : The rotation angle in degrees. Positive values rotate clockwise.

Returns

PixelArray : A new pixel array containing the rotated image. The output pixel array may be larger than the input to accommodate the rotated image.

Raises

• RuntimeError : If pixel array rotation fails.

Scale a pixel array by a given factor.

Args

• pixel_array : The pixel array to scale.
• factor : The scaling factor (must be > 0). Values > 1.0 enlarge, values < 1.0 shrink the pixel array.

Returns

PixelArray : A new pixel array scaled by the specified factor.

Raises

• ValueError : If factor is <= 0.
• RuntimeError : If pixel array creation or scaling fails.

Scale a pixel array to a new exact size.

Args

• pixel_array : The pixel array to scale.
• size : The target size as (width, height).

Returns

PixelArray : A new pixel array scaled to the specified size.

Raises

• RuntimeError : If pixel array creation or scaling fails.