SDL_ttf

TTF_RenderText_Solid

SDL_Surface *TTF_RenderText_Solid(TTF_Font *font, const char *text, SDL_Color fg)
SDL_Surface *TTF_RenderUTF8_Solid(TTF_Font *font, const char *text, SDL_Color fg)
SDL_Surface *TTF_RenderUNICODE_Solid(TTF_Font *font, const Uint16 *text, SDL_Color fg);

font

Font to render the text with. Must be non-NULL.

text

A NULL-terminated string in corresponding encoding.

The color to render the text in. This becomes colormap index 1.

This family of functions will render the given text with the given font with fg color onto a new surface. The Solid mode is used and this is the fastest.

Returns: a pointer to a new SDL_Surface. NULL is returned on errors.

int DrawText(SDL_Surface* screen, TTF_Font* font, const char* text)
{
    SDL_Color color = {0,0,0};
    SDL_Surface *text_surface;

    text_surface = TTF_RenderText_Solid(font, text, color);
    if (text_surface != NULL)
    {
        SDL_BlitSurface(text_surface, NULL, screen, NULL);
        SDL_FreeSurface(text_surface);
        return 1;
    }
    else
    {
        // report error
        return 0;
    }
}

This example draws the text in the upper left corner of the given surface.

SDL_ttf

TTF_RenderText_Solid

See Also