Added GPUTextEngine

[captain0xff]

This PR extends the new text rendering api to support the gpu api. It's still not ready for merging but the reason I am creating the PR is so that the API can be reviewed.

Things that I still need to do:-

• The API needs to be documented (I will do this after the public API is finalized)
• The math_3d.h header should be removed in favor of custom math
• Shaders should be added for all the backends along with a proper workflow to load and build them
• The textgputext example should be improved to show the full capabilities of the api

I will need some help with the shaders because I don't have much idea about the workflow needed for the Metal and Direct3D backends.

[captain0xff]

Looks like stuff broke after pulling the latest changes. I am working on fixing them.

[captain0xff]

Fixed.
The SDL_gpu_textengine.c is mostly similar to the SDL_renderer_textengine.c. I have just adjusted most stuff for the gpu api.
I have added TTF_GetGPUTextDrawData to return the user the needed geometry data to draw the text and removed the Draw function. The UpdateGPUTexture method is stolen from the renderer gpu backend and can/should be improved. Apart from this I have updated the CreateDrawSequence to cache the positions along with the texcoords and indices.

[slouken]

In general, this looks good so far!

[captain0xff]

I have removed the hardcoded shader stuff and took the script from src/render/gpu/shader to build my shaders. I have only tested the workflow for spirv and vulkan since I only have access to a linux machine atm. I will appreciate if someone can help generate the shaders for other platforms or even provide some input about them. The renderer gpu backend doesn't seem to have any hlsl or msl shader present so I assume that the script generates them from spirv provided you have spirv-cross in your path.
Next, I will clean up and improve the example. It may take some time depending on how quickly I can grasp the math behind perspective and lookAt functions and implement them. I can copy them from somewhere but I like to understand the math behind stuff I do. Also, that can cause licensing issues.
After, that hopefully that the PR will be ready for a final review once I address the CI.

[captain0xff]

I have improved the example and also formatted it

[captain0xff]

I have fixed the CI.
I am marking the PR ready. It still needs the shaders for the other platforms but I don't have access to a mac and windows machine.

[madebr]

I don't think you need to commit all files in the shaders directory.
See https://github.com/libsdl-org/SDL/tree/a10578acbdd86924574c9d5863b698b90a4ae212/src/render/gpu/shaders, there are no .spv files there.

[thatcosmonaut]

Now that we have a CLI for shadercross we should be building shaders with that instead, no need for another shader frontend dependency.

[captain0xff]

I don't think you need to commit all files in the shaders directory. See https://github.com/libsdl-org/SDL/tree/a10578acbdd86924574c9d5863b698b90a4ae212/src/render/gpu/shaders, there are no .spv files there.

Yeah, pushed them by mistake. I will remove those files.

[captain0xff]

Note, the example seems to leak memory. But it's probably due to #425 and so not caused by me.

[madebr]

Note, the example seems to leak memory. But it's probably due to #425 and so not caused by me.

You can verify by linking to SDL3_test, and calling SDLTest_TrackAllocations(void); at the very beginning, and calling SDLTest_LogAllocations(void) at the very end.

[captain0xff]

Well it's show allocations and those are increasing.

[captain0xff]

Just to make sure, this PR isn't waiting for something from my end right?

[slouken]

Please don't include any fonts in the SDL_ttf project. There are plenty out there already for people to use.

[captain0xff]

Copied from discord.

I actually decided to ship the font because if the font isn't monospaced the example will look quite weird and also different fonts will change the size of the text drastically due to the 3D rotation, it will be very hard to mitigate that only by changing the point size.

[slouken]

This looks good to me!

[MirkoCovizzi]

Thanks for this contribution! I'm implementing fonts in my project and this is a very good learning material!

Just noticed a minor typo

[captain0xff]

Done. Thanks for the review.

[captain0xff]

libsdl-org/SDL#11398 was closed as not planned. So, this PR is again ready I hope?

[slouken]

@captain0xff, can you rebase and resolve conflicts?

[slouken]

Actually, never mind, I can squash this as a single commit.

[captain0xff]

Yes, that will be better. Most of the commit messages are not very sensible.