[sdl3-image] Add new port sdl3-image

[shybovycha]

Add SDL3-image port. There already is an SDL3 port, but none for the relevant components (mixer, ttf, image). Used the latest 3.x release tag (preview-3.1.0)

• Changes comply with the maintainer guide.
• The name of the port matches an existing name for this component on https://repology.org/ if possible, and/or is strongly associated with that component on search engines.
• Optional dependencies are resolved in exactly one way. For example, if the component is built with CMake, all find_package calls are REQUIRED, are satisfied by vcpkg.json's declared dependencies, or disabled with CMAKE_DISABLE_FIND_PACKAGE_Xxx.
• The versioning scheme in vcpkg.json matches what upstream says.
• The license declaration in vcpkg.json matches what upstream says.
• The installed as the "copyright" file matches what upstream says.
• The source code of the component installed comes from an authoritative source.
• The generated "usage text" is accurate. See adding-usage for context.
• The version database is fixed by rerunning ./vcpkg x-add-version --all and committing the result.
• Only one version is in the new port's versions file.
• Only one version is added to each modified port's versions file.

[Mengna-Li]

Note: I will be converting your PR to draft status. When you're ready, please revert to "ready for review". That way, I can be aware that you've responded since you can't modify the tags.

[Mengna-Li]

This is unnecessary, you should remove this and your usage file.

[dg0yt]

Looking at the usage file, I think that it is useful, but it needs to be redacted.

[shybovycha]

i really do not understand why this is unnecessary, could you elaborate on your reasoning @Mengna-Li ?

[dg0yt]

Looking at the usage file, I think that it is useful, but it needs to be redacted.

[Mengna-Li]

@shybovycha
I encountered this issue while testing the usage:

1> [CMake] CMake Error at D:/vcpkg/installed/x64-windows/share/SDL3_image/SDL3_image-shared-targets.cmake:60 (set_target_properties):
1> [CMake]   The link interface of target "SDL3_image::SDL3_image-shared" contains:
1> [CMake] 
1> [CMake]     SDL3::Headers
1> [CMake] 
1> [CMake]   but the target was not found.  Possible reasons include:
1> [CMake] 
1> [CMake]     * There is a typo in the target name.
1> [CMake]     * A find_package call is missing for an IMPORTED target.
1> [CMake]     * An ALIAS target is missing.

[shybovycha]

@Mengna-Li i can confirm this happens. apparently, SDL3-image requires SDL3:

if(NOT TARGET SDL3::Headers OR NOT TARGET ${sdl3_target_name})
    find_package(SDL3 ${SDL_REQUIRED_VERSION} REQUIRED COMPONENTS ${sdl_required_components})
endif()

which would require a separate dependency entry in both vcpkg.json and a separate find_package(SDL3 CONFIG REQUIRED) call in CMakeLists.txt. not sure what's the best approach here would be - some addition to the usage file or an implicit patch to the portfile (to add SDL3 and a call to find_package under the hood when SDL3-image is added to a project)?

[Mengna-Li]

(to add SDL3 and a call to find_package under the hood when SDL3-image is added to a project)?

I think this way is better.

[Mengna-Li]

Note: I will be converting your PR to draft status. When you're ready, please revert to "ready for review". That way, I can be aware that you've responded since you can't modify the tags.