.\" This manpage content is licensed under Creative Commons
.\"  Attribution 4.0 International (CC BY 4.0)
.\"   https://creativecommons.org/licenses/by/4.0/
.\" This manpage was generated from SDL_ttf's wiki page for TTF_RenderGlyph32_Shaded:
.\"   https://wiki.libsdl.org/SDL_ttf/TTF_RenderGlyph32_Shaded
.\" Generated with SDL/build-scripts/wikiheaders.pl
.\"  revision 3~git20240320~6e260a2+ds-1
.\" Please report issues in this manpage's content at:
.\"   https://github.com/libsdl-org/sdlwiki/issues/new
.\" Please report issues in the generation of this manpage from the wiki at:
.\"   https://github.com/libsdl-org/SDL/issues/new?title=Misgenerated%20manpage%20for%20TTF_RenderGlyph32_Shaded
.\" SDL_ttf can be found at https://libsdl.org/projects/SDL_ttf
.de URL
\$2 \(laURL: \$1 \(ra\$3
..
.if \n[.g] .mso www.tmac
.TH TTF_RenderGlyph32_Shaded 3 "SDL_ttf 3.0.0" "SDL_ttf" "SDL_ttf3 FUNCTIONS"
.SH NAME
TTF_RenderGlyph32_Shaded \- Render a single 32-bit glyph at high quality to a new 8-bit surface\[char46]
.SH SYNOPSIS
.nf
.B #include \(dqSDL3_ttf/SDL_ttf.h\(dq
.PP
.BI "SDL_Surface * TTF_RenderGlyph32_Shaded(TTF_Font *font,
.BI "                Uint32 ch, SDL_Color fg, SDL_Color bg);
.fi
.SH DESCRIPTION
This function will allocate a new 8-bit, palettized surface\[char46] The surface's
0 pixel will be the specified background color, while other pixels have
varying degrees of the foreground color\[char46] This function returns the new
surface, or NULL if there was an error\[char46]

The glyph is rendered without any padding or centering in the X direction,
and aligned normally in the Y direction\[char46]

This is the same as 
.BR TTF_RenderGlyph_Shaded
(), but
takes a 32-bit character instead of 16-bit, and thus can render a larger
range\[char46] If you are sure you'll have an SDL_ttf that's version 2\[char46]0\[char46]18 or
newer, there's no reason not to use this function exclusively\[char46]

You can render at other quality levels with

.BR TTF_RenderGlyph32_Solid
,

.BR TTF_RenderGlyph32_Blended
, and

.BR TTF_RenderGlyph32_LCD
\[char46]

.SH FUNCTION PARAMETERS
.TP
.I font
the font to render with\[char46]
.TP
.I ch
the character to render\[char46]
.TP
.I fg
the foreground color for the text\[char46]
.SH RETURN VALUE
Returns a new 8-bit, palettized surface, or NULL if there was an error\[char46]

.SH AVAILABILITY
This function is available since SDL_ttf 3\[char46]0\[char46]0\[char46]

.SH SEE ALSO
.BR TTF_RenderGlyph32_Solid (3),
.BR TTF_RenderGlyph32_Blended (3),
.BR TTF_RenderGlyph32_LCD (3)