Request: Creating an example with SDL3

[ajitid]

Hi! I'm having trouble understanding how I can use skia-python with pysdl3. Could you please add an example on how Skia can use its GPU backend with SDL3?

[ajitid]

Update: I was able to get an example by asking LLMs but it would be helpful if you could confirm if this is the correct code and doesn't contain any unnecessary code.

Code link

[HinTak]

Your code runs as is except with a warning that SDL_SetRelativeMouseTransform is not found in my SDL3.so - don't know why, as it is the latest release.

I don't think there is anything obviously "unnecessary", although it is perhaps a bit too verbose and have too much error checking code to be considered a good intro / tutorial to pysdl3.

Btw, sdl2 and sdl3 (and their python bindings) can co-exist, and in fact with sdl1 too...

The beginning of porting from pysdl2 to pysdl3 is simply replacing

from sdl2 import *
from sdl2.video import *

with

from sdl3 import *

near the top. Some of the APIs has small renamings and the event structure seems to have changed slightly.

It would be interesting to see how much further work needs to be done to convert
https://github.com/HinTak/skia-python-examples/blob/main/SkiaSDLExample.py to its pysdl3 equivalent. I had a quick look at getting its C original https://github.com/HinTak/skia-c-examples/blob/main/SkiaSDLExample.cpp adapted first. It looks like it might be about 7 lines of code changes after running the replace symbol migration script. Running https://github.com/libsdl-org/SDL/blob/main/build-scripts/SDL_migration.cocci could perhaps deal with a few of the 7.

[HinTak]

You do know that the context manager stuff is not strictly needed, right? You could replace all the with statement by inserting the top half into the beginning of the body, and the finally part near the end, right? You can see the sdl2 example does not use context manager at all.

[HinTak]

If you don't mind, I'd like to include your example as is, if you add some copyright info, and whether you took any existing code from elsewhere, near the top as a comment.

[HinTak]

It might be easier to read as a basic tutorial if you remove most of the error checks, but isn't good as a full example... so it is a matter of opinion / purpose.

[HinTak]

I have ported the sdl2 example to sdl3 in https://github.com/HinTak/skia-python-examples/blob/main/SkiaSDL3Example.py but the old mouse positioning problem seems to be back (#7 see #3 for old fixed issue with sdl2). Your code is committed as Skia-SDL3-example which is perhaps a bit confusing - a better name (and some updated comments and copyrights)?

If you want to look into the mouse offset problem (before I get round to it) with sdl3, I'd appreciate. Also please feel free to click sponsor under my profile to buy me a coffee and/or otherwise sponsor the development.

[HinTak]

I have renamed yours to https://github.com/HinTak/skia-python-examples/blob/main/Another-SkiaSDLExample.py and added some basic info at the top for credits. Please feel free to do a pull to update it.

I have also fixed #7 and updated the code
https://github.com/HinTak/skia-python-examples/blob/main/SkiaSDL3Example.py - While working on it, I have also worked out that one line in the original sdl2 c example was redundant - the canvas.scale() line, as it is merely doing scale(1,1). I am just adding a comment in the python sdl3 example for it, as I am trying to stay close to the original sdl2 c/python code for comparison. You can choose to remove / comment out that line. The original c code was a bit buggy / careless in terms of co-ordinate calculations and actually doing the right thing on mouse clicks having a effect exactly under the mouse pointer!

Please click the sponsor button if you appreciate the work.

[HinTak]

I found and fixed a bunch of small bugs in yours a4bb322 . https://github.com/HinTak/skia-python-examples/blob/main/SkiaSDL3Example.py is probably a more interesting example at this point, as it does something interesting with drawing with mouse as well as windows resizing.

And as I said earlier, those context manager stuff isn't strictly-speaking needed in API examples - they allow for object re-uses and resource tidying up, but pretty much everything (surface, glcontext, windows etc) in those examples are one-off and dangling resources of singular objects are cleaned up when the program exits. The examples don't try to continue and re-use objects on failures, so all the try: finally: are just extras.

[ajitid]

Thanks for adding the example. I'm seeing an error when I run SkiaSDL3Example.py though. Here's the stack trace:

Log

PS C:\Users\ajits\ghq\github.com\ajitid\skia-python-check> uv run .\sdl3_gpu_app.py
Warning: Function 'SDL_SetRelativeMouseTransform' not found in binary: 'SDL3.dll'.
Traceback (most recent call last):
  File "C:\Users\ajits\ghq\github.com\ajitid\skia-python-check\sdl3_gpu_app.py", line 23, in <module>
    from OpenGL.GLES2.EXT.texture_storage import GL_BGRA8_EXT
  File "C:\Users\ajits\ghq\github.com\ajitid\skia-python-check\.venv\Lib\site-packages\OpenGL\GLES2\__init__.py", line 2, in <module>
    from OpenGL.raw.GLES2._types import *
  File "C:\Users\ajits\ghq\github.com\ajitid\skia-python-check\.venv\Lib\site-packages\OpenGL\raw\GLES2\_types.py", line 5, in <module>
    _error_checker = _ErrorChecker( _p, _p.GLES2.glGetError )
                                        ^^^^^^^^
AttributeError: 'Win32Platform' object has no attribute 'GLES2'

[ajitid]

Another-SkiaSDLExample_v2.py works as expected, except that we have specified to clear canvas with white color, but I still see black background. Removing the code GL.glClearColor(0.0, 0.0, 0.0, 1.0) fixes it, but I'm unsure why I was seeing black color even though we have specified GL.glClearColor(0.0, 0.0, 0.0, 1.0) above canvas.clear(skia.ColorWHITE).

Are you able to reproduce this in your machine as well?

[HinTak]

I am afraid I am on Linux, and mostly on mesa (which is likely more opengl compliant than either windows or mac's). In general this sort of things depends a lot on the graphic card you have, as well as what graphic card driver you have. Microsoft generally wants their own thing (Direct X...).

Mesa is reportedly opengl 4.5 / 4.7 compliant so setting it to 4.x probably will help on Linux. On windows you might need to play with that to get best results. Unfortunately skia actually have graphic card driver and driver version detection code... are you using skia python 87 or 1xx? See
kyamagu/skia-python#214 , about mac os being picky on the opengl profile version settings. Maybe windows too.

As for the erase - I get things on a black background - I am not entirely sure about the alpha channel being 1 means fully opaque or fully transparent? Try 0,0,0,0 perhaps also.

Clear and paint has different meanings.... Read the doc. There is usually the concept of a foreground and a background colour, and paint means using the foreground colour, clear means flooding with the background colour (which might be implicit).

And it may not necessarily be black - it could be transparent (on a "nothing" background, which defaults to black). I think things are drawn on a transparent background, btw. You can check this by outputting to png and then open the png in a image editor - it will likely tell you the background is transparent, instead of solid (opaque) black.

I made some SDL2 runtime effect examples - basically fractal animations - you'd need skia-pythoh 132+ to run them.

Anyway, this is about as much time as I want to right now. SDL3 was only out a few months ago.

[HinTak]

For your GLES2 error, try inserting these reporting lines kyamagu/skia-python#214 (comment) after your successful GL initialization program to see what opengl version etc your graphic card driver reports.

[HinTak]

For opengl functionality on windows, it might be a good idea to look into enabling ANGLE - kyamagu/skia-python#218 - this is a skia build option we haven't enabled.