logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

TTF_OpenFontWithProperties - Create a font with the specified properties.

Availability

       This function is available since SDL_ttf 3.0.0.

Description

       These are the supported properties:

       • TTF_PROP_FONT_CREATE_FILENAME_STRING :
         the font file to open, if an SDL_IOStream isn't being used. This is
         required if

       TTF_PROP_FONT_CREATE_IOSTREAM_POINTER and

       TTF_PROP_FONT_CREATE_EXISTING_FONT aren't set.

       • TTF_PROP_FONT_CREATE_IOSTREAM_POINTER :
         an SDL_IOStream containing the font to be opened. This should not be
         closed until the font is closed. This is required if

       TTF_PROP_FONT_CREATE_FILENAME_STRING and

       TTF_PROP_FONT_CREATE_EXISTING_FONT aren't set.

       • TTF_PROP_FONT_CREATE_IOSTREAM_OFFSET_NUMBER :
         the offset in the iostream for the beginning of the font, defaults to 0.

       • TTF_PROP_FONT_CREATE_IOSTREAM_AUTOCLOSE_BOOLEAN :
         true if closing the font should also close the associated SDL_IOStream.

       • TTF_PROP_FONT_CREATE_SIZE_FLOAT : the
         point size of the font. Some .fon fonts will have several sizes embedded
         in the file, so the point size becomes the index of choosing which size.
         If the value is too high, the last indexed size will be the default.

       • TTF_PROP_FONT_CREATE_FACE_NUMBER :
         the face index of the font, if the font contains multiple font faces.

       • TTF_PROP_FONT_CREATE_HORIZONTAL_DPI_NUMBER :
         the horizontal DPI to use for font rendering, defaults to

       TTF_PROP_FONT_CREATE_VERTICAL_DPI_NUMBER if set, or 72 otherwise.

       • TTF_PROP_FONT_CREATE_VERTICAL_DPI_NUMBER :
         the vertical DPI to use for font rendering, defaults to

       TTF_PROP_FONT_CREATE_HORIZONTAL_DPI_NUMBER if set, or 72 otherwise.

       • TTF_PROP_FONT_CREATE_EXISTING_FONT :
         an optional TTF_Font
        that, if set, will be used as the font
         data source and the initial size and style of the new font.

Function Parameters

props  the properties to use.

Header File

       Defined in SDL3_ttf/SDL_ttf.h

Name

       TTF_OpenFontWithProperties - Create a font with the specified properties.

Return Value

       ( TTF_Font
        *) Returns a valid TTF_Font , or NULL on failure; call SDL_GetError() for more information.

See Also

(3), TTF_CloseFont(3)

SDL_ttf                                           SDL_ttf 3.2.2                    TTF_OpenFontWithProperties(3)

Synopsis

#include"SDL3_ttf/SDL_ttf.h"TTF_Font*TTF_OpenFontWithProperties(SDL_PropertiesIDprops);#defineTTF_PROP_FONT_CREATE_FILENAME_STRINGSDL_ttf.font.create.filename"#defineTTF_PROP_FONT_CREATE_IOSTREAM_POINTERSDL_ttf.font.create.iostream"#defineTTF_PROP_FONT_CREATE_IOSTREAM_OFFSET_NUMBERSDL_ttf.font.create.iostream.offset"#defineTTF_PROP_FONT_CREATE_IOSTREAM_AUTOCLOSE_BOOLEANSDL_ttf.font.create.iostream.autoclose"#defineTTF_PROP_FONT_CREATE_SIZE_FLOATSDL_ttf.font.create.size"#defineTTF_PROP_FONT_CREATE_FACE_NUMBERSDL_ttf.font.create.face"#defineTTF_PROP_FONT_CREATE_HORIZONTAL_DPI_NUMBERSDL_ttf.font.create.hdpi"#defineTTF_PROP_FONT_CREATE_VERTICAL_DPI_NUMBERSDL_ttf.font.create.vdpi"#defineTTF_PROP_FONT_CREATE_EXISTING_FONTSDL_ttf.font.create.existing_font"

Thread Safety

       It is safe to call this function from any thread.

See Also