Add fetch_pixel(s) method to window for unit testing.

[DragonMoffon]

We currently don't have a concrete way to do pixel testing for unit tests. get_image doesn't play nice with the spoof window. It would hopefully be performant, but it doesn't need to be as aggressively optimized as an official screenshot interface.

[einarf]

I started on this a while ago ..

[pushfoo]

I have the following questions:

• What does "spoof window" mean here? @DragonMoffon
• Are our windows always assumed to be RGBA buffers?
• Will all render targets be assumed to be RGBA buffers as well?
• @einarf When you said "I started on this", did you mean the files below?

The arcade.screenshot functions

This file has commits from einarf in June and August of 2024, and two functions:

arcade/arcade/screenshot.py

Line 15 in 8a41838

def get_pixel(x: int, y: int, components: int = 3) -> tuple[int, ...]:

arcade/arcade/screenshot.py

Line 38 in 8a41838

def get_image(

Offscreen in the top-level conftest.py

This class:

• is exposed as a top-level test fixture available in all tests via offscreen
• was created in August of 2024 by einarf before further work by Eruvanos

It has the following methods of interest

arcade/tests/conftest.py

Line 400 in 8a41838

def get_image(self) -> PIL.Image.Image:

arcade/tests/conftest.py

Line 405 in 8a41838

def read_pixel(self, x, y, components=3) -> tuple[int, int, int, int] | tuple[int, int, int]:

arcade/tests/conftest.py

Line 415 in 8a41838

def read_region(self, rect: Rect) -> list[tuple[int, int, int, int]]:

arcade/tests/conftest.py

Line 430 in 8a41838

def read_region_bytes(self, rect: Rect, components=3) -> bytes:

arcade/tests/conftest.py

Line 437 in 8a41838

def read_region_image(self, rect: Rect, components=3) -> PIL.Image.Image: