From e0c762160b2d5e842b3949a6b611c64f8beac8aa Mon Sep 17 00:00:00 2001 From: SDL Wiki Bot Date: Wed, 28 Aug 2024 00:30:37 +0000 Subject: [PATCH] Sync SDL3_image wiki -> header --- include/SDL3_image/SDL_image.h | 48 +++++++++++++++++----------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/include/SDL3_image/SDL_image.h b/include/SDL3_image/SDL_image.h index 4e803c6a..359b305c 100644 --- a/include/SDL3_image/SDL_image.h +++ b/include/SDL3_image/SDL_image.h @@ -488,7 +488,7 @@ extern SDL_DECLSPEC SDL_Texture * SDLCALL IMG_LoadTextureTyped_IO(SDL_Renderer * * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is AVIF data, SDL_FALSE otherwise. + * \returns non-zero if this is AVIF data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -532,7 +532,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isAVIF(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is ICO data, SDL_FALSE otherwise. + * \returns non-zero if this is ICO data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -575,7 +575,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isICO(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is CUR data, SDL_FALSE otherwise. + * \returns non-zero if this is CUR data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -618,7 +618,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isCUR(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is BMP data, SDL_FALSE otherwise. + * \returns non-zero if this is BMP data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -661,7 +661,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isBMP(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is GIF data, SDL_FALSE otherwise. + * \returns non-zero if this is GIF data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -704,7 +704,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isGIF(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is JPG data, SDL_FALSE otherwise. + * \returns non-zero if this is JPG data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -747,7 +747,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isJPG(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is JXL data, SDL_FALSE otherwise. + * \returns non-zero if this is JXL data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -790,7 +790,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isJXL(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is LBM data, SDL_FALSE otherwise. + * \returns non-zero if this is LBM data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -833,7 +833,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isLBM(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is PCX data, SDL_FALSE otherwise. + * \returns non-zero if this is PCX data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -876,7 +876,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isPCX(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is PNG data, SDL_FALSE otherwise. + * \returns non-zero if this is PNG data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -919,7 +919,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isPNG(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is PNM data, SDL_FALSE otherwise. + * \returns non-zero if this is PNM data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -962,7 +962,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isPNM(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is SVG data, SDL_FALSE otherwise. + * \returns non-zero if this is SVG data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1005,7 +1005,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isSVG(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is QOI data, SDL_FALSE otherwise. + * \returns non-zero if this is QOI data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1048,7 +1048,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isQOI(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is TIFF data, SDL_FALSE otherwise. + * \returns non-zero if this is TIFF data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1091,7 +1091,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isTIF(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is XCF data, SDL_FALSE otherwise. + * \returns non-zero if this is XCF data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1134,7 +1134,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isXCF(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is XPM data, SDL_FALSE otherwise. + * \returns non-zero if this is XPM data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1177,7 +1177,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isXPM(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is XV data, SDL_FALSE otherwise. + * \returns non-zero if this is XV data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1220,7 +1220,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_isXV(SDL_IOStream *src); * determine file type in many cases in its standard load functions. * * \param src a seekable/readable SDL_IOStream to provide image data. - * \returns SDL_TRUE if this is WEBP data, SDL_FALSE otherwise. + * \returns non-zero if this is WEBP data, zero otherwise. * * \since This function is available since SDL_image 3.0.0. * @@ -1958,7 +1958,7 @@ extern SDL_DECLSPEC SDL_Surface * SDLCALL IMG_ReadXPMFromArrayToRGB888(char **xp * \param file path on the filesystem to write new file to. * \param quality the desired quality, ranging between 0 (lowest) and 100 * (highest). - * \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information. + * \returns 0 if successful, -1 on error. * * \since This function is available since SDL_image 3.0.0. * @@ -1980,7 +1980,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_SaveAVIF(SDL_Surface *surface, const ch * SDL_FALSE to leave it open. * \param quality the desired quality, ranging between 0 (lowest) and 100 * (highest). - * \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information. + * \returns 0 if successful, -1 on error. * * \since This function is available since SDL_image 3.0.0. * @@ -1995,7 +1995,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_SaveAVIF_IO(SDL_Surface *surface, SDL_I * * \param surface the SDL surface to save. * \param file path on the filesystem to write new file to. - * \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information. + * \returns 0 if successful, -1 on error. * * \since This function is available since SDL_image 3.0.0. * @@ -2015,7 +2015,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_SavePNG(SDL_Surface *surface, const cha * \param dst the SDL_IOStream to save the image data to. * \param closeio SDL_TRUE to close/free the SDL_IOStream before returning, * SDL_FALSE to leave it open. - * \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information. + * \returns 0 if successful, -1 on error. * * \since This function is available since SDL_image 3.0.0. * @@ -2032,7 +2032,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_SavePNG_IO(SDL_Surface *surface, SDL_IO * \param file path on the filesystem to write new file to. * \param quality [0; 33] is Lowest quality, [34; 66] is Middle quality, [67; * 100] is Highest quality. - * \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information. + * \returns 0 if successful, -1 on error. * * \since This function is available since SDL_image 3.0.0. * @@ -2054,7 +2054,7 @@ extern SDL_DECLSPEC SDL_bool SDLCALL IMG_SaveJPG(SDL_Surface *surface, const cha * SDL_FALSE to leave it open. * \param quality [0; 33] is Lowest quality, [34; 66] is Middle quality, [67; * 100] is Highest quality. - * \returns SDL_TRUE on success or SDL_FALSE on failure; call SDL_GetError() for more information. + * \returns 0 if successful, -1 on error. * * \since This function is available since SDL_image 3.0.0. *