Mirrors_Framework/SDL
1
0
Fork 0
mirror of https://github.com/libsdl-org/SDL.git synced 2026-06-01 06:44:27 +08:00
Code Issues Actions 4 Packages Projects Releases Wiki Activity

Clarify that icon and cursor alternate images are added with SDL_AddSurfaceAlternateImage()

Browse Source
This commit is contained in:
Sam Lantinga
2025-06-05 09:00:49 -07:00
parent 2ef7944170
commit 27464ffb08
2 changed files with 5 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
include/SDL3/SDL_mouse.h
+2 -1
View File
@@ -578,7 +578,7 @@ extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_CreateCursor(const Uint8 *data,
/** /**
* Create a color cursor. * Create a color cursor.
* *
* If this function is passed a surface with alternate representations, the * If this function is passed a surface with alternate representations added with SDL_AddSurfaceAlternateImage(), the
* surface will be interpreted as the content to be used for 100% display * surface will be interpreted as the content to be used for 100% display
* scale, and the alternate representations will be used for high DPI * scale, and the alternate representations will be used for high DPI
* situations. For example, if the original surface is 32x32, then on a 2x * situations. For example, if the original surface is 32x32, then on a 2x
@@ -598,6 +598,7 @@ extern SDL_DECLSPEC SDL_Cursor * SDLCALL SDL_CreateCursor(const Uint8 *data,
* *
* \since This function is available since SDL 3.2.0. * \since This function is available since SDL 3.2.0.
* *
* \sa SDL_AddSurfaceAlternateImage
* \sa SDL_CreateCursor * \sa SDL_CreateCursor
* \sa SDL_CreateSystemCursor * \sa SDL_CreateSystemCursor
* \sa SDL_DestroyCursor * \sa SDL_DestroyCursor
include/SDL3/SDL_video.h
+3 -1
View File
@@ -1680,7 +1680,7 @@ extern SDL_DECLSPEC const char * SDLCALL SDL_GetWindowTitle(SDL_Window *window);
/** /**
* Set the icon for a window. * Set the icon for a window.
* *
* If this function is passed a surface with alternate representations, the * If this function is passed a surface with alternate representations added using SDL_AddSurfaceAlternateImage(), the
* surface will be interpreted as the content to be used for 100% display * surface will be interpreted as the content to be used for 100% display
* scale, and the alternate representations will be used for high DPI * scale, and the alternate representations will be used for high DPI
* situations. For example, if the original surface is 32x32, then on a 2x * situations. For example, if the original surface is 32x32, then on a 2x
@@ -1698,6 +1698,8 @@ extern SDL_DECLSPEC const char * SDLCALL SDL_GetWindowTitle(SDL_Window *window);
* \threadsafety This function should only be called on the main thread. * \threadsafety This function should only be called on the main thread.
* *
* \since This function is available since SDL 3.2.0. * \since This function is available since SDL 3.2.0.
*
* \sa SDL_AddSurfaceAlternateImage
*/ */
extern SDL_DECLSPEC bool SDLCALL SDL_SetWindowIcon(SDL_Window *window, SDL_Surface *icon); extern SDL_DECLSPEC bool SDLCALL SDL_SetWindowIcon(SDL_Window *window, SDL_Surface *icon);