SDL_ttf

SDL_ttf > Functions > Render

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

text

fg

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.

See Also

SDL_ttf/Functions/Render/TTF_RenderText_Solid (last edited 2008-05-07 03:27:30 by ip68-105-94-65)