1. Obtain SDL3_ttf 3.2.2 1. Получение SDL3_ttf 3.2.2

• Download two archives from the official release page: Скачайте два архива со страницы официального релиза:
  
• Extract the SDL3_ttf-devel-3.2.2-mingw.zip archive to the C:/libs/SDL3_ttf-devel-3.2.2-mingw folder. Распакуйте архив SDL3_ttf-devel-3.2.2-mingw.zip в папку C:/libs/SDL3_ttf-devel-3.2.2-mingw.
• Move the headers and libraries so the structure is SDL3_ttf-devel-3.2.2-mingw/include, etc: Переместите заголовочные файлы и библиотеки так, чтобы структура папок была SDL3_ttf-devel-3.2.2-mingw/include и т. д.:
  
• Extract the SDL3_ttf-3.2.2-win32-x64.zip archive so the path is exactly C:/libs/SDL3_ttf-3.2.2-win32-x64: Распакуйте архив SDL3_ttf-3.2.2-win32-x64.zip так, чтобы путь был именно C:/libs/SDL3_ttf-3.2.2-win32-x64:
  

2. Add SDL3_ttf to Environment Variables (Path) 2. Добавление SDL3_ttf в переменные среды (Path)

3. Project Structure and Assets 3. Структура проекта и ресурсы

ttf-sdl3-c/
├── CMakeLists.txt
├── assets/fonts/
│   └── LiberationSans-Regular.ttf
└── src/
    └── main.c

ttf-sdl3-cpp/
├── CMakeLists.txt
├── assets/fonts/
│   └── LiberationSans-Regular.ttf
└── src/
    └── main.cpp

4. CMake Configuration 4. Конфигурация CMake

set(CMAKE_BUILD_TYPE "Debug")
cmake_minimum_required(VERSION 3.21)
project(ttf-sdl3-c)

set(SDL3_DIR "C:/libs/SDL3-devel-3.4.8-mingw/lib/cmake/SDL3")
set(SDL3_ttf_DIR "C:/libs/SDL3_ttf-devel-3.2.2-mingw/lib/cmake/SDL3_ttf")

find_package(SDL3 REQUIRED)
find_package(SDL3_ttf REQUIRED)

add_executable(app)
target_sources(app PRIVATE src/main.c)

# Copy the assets folder to the dist folder
if(EXISTS "${CMAKE_SOURCE_DIR}/assets")
    add_custom_command(TARGET app POST_BUILD
        COMMAND ${CMAKE_COMMAND} -E copy_directory
                "${CMAKE_SOURCE_DIR}/assets"
                "$<TARGET_FILE_DIR:app>/assets"
        COMMENT "Copying assets directory"
    )
endif()

target_link_libraries(app PRIVATE SDL3_ttf::SDL3_ttf SDL3::SDL3)
target_link_options(app PRIVATE -mconsole)

set(CMAKE_BUILD_TYPE "Debug")
cmake_minimum_required(VERSION 3.21)
project(ttf-sdl3-cpp)

set(SDL3_DIR "C:/libs/SDL3-devel-3.4.8-mingw/lib/cmake/SDL3")
set(SDL3_ttf_DIR "C:/libs/SDL3_ttf-devel-3.2.2-mingw/lib/cmake/SDL3_ttf")

find_package(SDL3 REQUIRED)
find_package(SDL3_ttf REQUIRED)

add_executable(app)
target_sources(app PRIVATE src/main.cpp)

# Copy the assets folder to the dist folder
if(EXISTS "${CMAKE_SOURCE_DIR}/assets")
    add_custom_command(TARGET app POST_BUILD
        COMMAND ${CMAKE_COMMAND} -E copy_directory
                "${CMAKE_SOURCE_DIR}/assets"
                "$<TARGET_FILE_DIR:app>/assets"
        COMMENT "Copying assets directory"
    )
endif()

target_link_libraries(app PRIVATE SDL3_ttf::SDL3_ttf SDL3::SDL3)
target_link_options(app PRIVATE -mconsole)

5. Source Code 5. Исходный код

Copy and paste the following code into the src/main.c (or src/main.cpp) file:

Скопируйте и вставьте следующее содержимое в файл src/main.c (или src/main.cpp):

main.c / main.cpp

#define SDL_MAIN_USE_CALLBACKS 1
#include <SDL3/SDL.h>
#include <SDL3/SDL_main.h>
#include <SDL3_ttf/SDL_ttf.h>

static SDL_Window *window = NULL;
static SDL_Renderer *renderer = NULL;
static TTF_Font *font = NULL;
static SDL_Texture *textTexture = NULL;

SDL_AppResult SDL_AppInit(void **appstate, int argc, char *argv[]) {
    if (!SDL_Init(SDL_INIT_VIDEO)) return SDL_APP_FAILURE;
    if (!TTF_Init()) return SDL_APP_FAILURE;

    if (!SDL_CreateWindowAndRenderer("SDL3 TTF", 400, 200, 0, &window, &renderer)) {
        return SDL_APP_FAILURE;
    }

    font = TTF_OpenFont("assets/fonts/LiberationSans-Regular.ttf", 48);
    if (!font) return SDL_APP_FAILURE;

    SDL_Color white = {255, 255, 255, 255};
    SDL_Surface *surface = TTF_RenderText_Blended(font, "Hello SDL3_ttf!", 0, white);
    textTexture = SDL_CreateTextureFromSurface(renderer, surface);
    SDL_DestroySurface(surface);

    return SDL_APP_CONTINUE;
}

SDL_AppResult SDL_AppEvent(void *appstate, SDL_Event *event) {
    if (event->type == SDL_EVENT_QUIT) return SDL_APP_SUCCESS;
    return SDL_APP_CONTINUE;
}

SDL_AppResult SDL_AppIterate(void *appstate) {
    SDL_SetRenderDrawColor(renderer, 20, 20, 20, 255);
    SDL_RenderClear(renderer);

    float w, h;
    SDL_GetTextureSize(textTexture, &w, &h);
    SDL_FRect destRect = { 50, 75, w, h };
    SDL_RenderTexture(renderer, textTexture, NULL, &destRect);

    SDL_RenderPresent(renderer);
    return SDL_APP_CONTINUE;
}

void SDL_AppQuit(void *appstate, SDL_AppResult result) {
    SDL_DestroyTexture(textTexture);
    TTF_CloseFont(font);
    TTF_Quit();
}

6. Opening the Project in IDEs 6. Открытие проекта в IDE

Open the CMakeLists.txt file in CLion or Qt Creator. CMake will handle the rest. Откройте файл CMakeLists.txt в CLion или Qt Creator. CMake позаботится об остальном.

7. Automation Scripts (.bat) 7. Скрипты автоматизации (.bat)

You can open the project folder in Sublime Text 4 (or Notepad++). Create the following .bat scripts in the project root directory to automate the configuration, building, and running of your application:

Вы можете открыть папку проекта в Sublime Text 4 (или Notepad++). Создайте следующие .bat скрипты в корневой директории проекта для автоматизации конфигурации, сборки и запуска вашего приложения:

cmake -G "MinGW Makefiles" -S . -B dist/exe

cd dist\exe
cmake --build .
cd ..\..

dist\exe\app

To build and launch the application, run these scripts in the terminal in the following order:

Чтобы собрать и запустить приложение, выполните эти скрипты в терминале в следующем порядке:

config-exe
build-exe
run-exe