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

Activity

1. DragonMoffon

   added

   testsEverything related to testingEverything related to testing

   on Dec 17, 2024
2. DragonMoffon

   added this to the Future milestone on Dec 17, 2024
3. einarf commented on Dec 19, 2024

   

   einarf

   on Dec 19, 2024

   Member

   More actions

   I started on this a while ago ..
4. pushfoo commented on Mar 1, 2025

   

   pushfoo

   on Mar 1, 2025

   Member

   More actions

   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:
5. einarf

   self-assigned this

   on Mar 29, 2025
6. pvcraven

   added a commit that references this issue on Oct 8, 2026

   Fix rand_vec_spread_deg directions, large GL reads, and pixel test he…

   ...

   306885b
7. pvcraven commented on Oct 9, 2026

   

   pvcraven

   on Oct 9, 2026

   Member

   More actions

   Closing this, since pixel testing works in unit tests now:

   • arcade.get_pixel() and arcade.get_image() work with the test window. tests/unit/test_screenshot.py tests both, tests/unit/draw/test_drawing_primitives.py checks blended colors with get_pixel, and the reference-scene tests in tests/unit/rendering call get_image().
   • The offscreen fixture in tests/conftest.py has read_pixel, read_region, read_region_image and assert_images_almost_equal. read_pixel and read_region used to decode the bytes wrongly; Fix rand_vec_spread_deg directions, large GL reads, and pixel test helpers #2945 fixed them and added tests/unit/test_offscreen_fixture.py.

   A Window method would do the same thing as arcade.get_pixel(x, y), which already reads from the current window, so we're not adding one.
8. pvcraven

   closed this as completedon Oct 9, 2026