Класс CFont, как и класс CMessages, предназначен для вывода текста в игре. При этом, "сообщения" выводятся на указанное время, а рисование через "шрифт" нужно производить в каждом кадре. Рассмотрим функции, которые принадлежат этому классу. Для этого можно открыть файл CFont.h, или же в исходном файле начать вводить CFont::, и получить доступ к списку переменных и функций класса:
Список переменных и функций класса
Мы рассмотрим только функции, которые можно использовать непосредственно для вывода текста. Например, функция CFont::Initialise вызывается игрой при старте, а CFont::Shutdown — при закрытии игры. Вряд ли нам понадобятся эти функции в коде плагинов.
// Обработка тегов в строке (например, ~r~, ~n~). Вызывается в функциях вывода, так что если мы выводим текст через PrintString(), вызывать эту функцию не нужно.
static char *ParseToken(char *text, CRGBA & color, bool isBlip, char *tag);
// Установка размера текста
static void SetScale(float w, float h);
// Установка размера текста, но с учётом языка игры
static void SetScaleForCurrentlanguage(float w, float h);
// Использовалось в Vice City для поворота текста. В SA работает криво.
static void SetSlantRefPoint(float x, float y);
// Использовалось в Vice City для поворота текста. В SA работает криво.
static void SetSlant(float value);
// Установка цвета текста
static void SetColor(CRGBA color);
// Установка стиля текста (доступные стили перечислены в перечислении eFontStyle)
static void SetFontStyle(short style);
// Установка длины строки при выводе текста слева
static void SetWrapx(float value);
// Установка длины строки при выводе текста по центру
static void SetCentreSize(float value);
// Установка длины строки при выводе текста справа
static void SetRightJustifyWrap(float value);
// Установка значения прозрачности всех текстов в игре
static void SetAlphaFade(float alpha);
// Установка цвета тени или обводки (одновременно может использоваться либо тень, либо обводка)
static void SetDropColor(CRGBA color);
// Установка размера тени
static void SetDropShadowPosition(short value);
// Установка размера обводки
static void SetOutlinePosition(short value);
// Включение/отключении пропорциональности букв в шрифте
static void SetProp(bool on);
// Установка фона для текста
static void SetBackground(bool background, bool backgroundOnlyText);
// Установка цвета фона
static void SetBackgroundColor(CRGBA color);
// Использовать выравнивание текста по длине строки (все слова в строке "растягиваются" в длину строки)
static void SetJustify(bool on);
// Установка выравнивания по стороне (перечисление eFontAlignment)
static void SetAlignment(eFontAlignment alignment);
// Получить длину строки. Параметры неизвестны.
static float GetStringWidth(char *string, bool unk1, bool unk2);
// Отрисовать тексты в рендер-буфере
static void DrawFonts();
// Вывести текст
static void PrintString(float x, float y, char *text);
Для примера выведем на экран информацию об игроке.
#include "plugin.h"
#include "CFont.h" // класс CFont и его функции
#include "CWeaponInfo.h" // класс CWeaponInfo и переменная ms_aWeaponNames
#include "common.h" // функция FindPlayerPed(), подключение CPed.h
#include "stdio.h" // функция sprintf()
using namespace plugin;
class TestPlugin {
public:
TestPlugin() {
Events::drawingEvent += [] {
CPed *playa = FindPlayerPed(); // находим педа игрока
if (playa) { // если пед найден
CFont::SetAlignment(ALIGN_LEFT); // выравние текста по левой стороне
CFont::SetColor(CRGBA(255, 255, 255, 255)); // цвет текста
CFont::SetOutlinePosition(1); // устанавливаем обводку текста
CFont::SetBackground(true, true); // включаем бокс
CFont::SetWrapx(500.0f); // устанавливаем ширину строки
CFont::SetBackgroundColor(CRGBA(0, 0, 0, 180)); // устанавливаем цвет бокса
CFont::SetScale(0.7f, 1.0f); // размер шрифта
CFont::SetFontStyle(FONT_SUBTITLES); // стиль шрифта
CFont::SetProp(true); // включаем пропорциональность шрифта
CWeapon &playaWep = playa->m_aWeapons[playa->m_nActiveWeaponSlot]; // Создаём ссылку на поточное оружие игрока
// форматируем строку для вывода
char string[256];
sprintf(string, "Player Info:~n~Health: ~r~%.2f/%.2f ~w~Armour: ~b~%.2f~n~~w~Weapon: ~y~%s ~w~Ammo: ~g~%d/%d~n~~w~ModelId: ~p~%d",
playa->m_fHealth, playa->m_fMaxHealth, playa->m_fArmour, CWeaponInfo::ms_aWeaponNames[playaWep.m_nType],
playaWep.m_nAmmoInClip, playaWep.m_nTotalAmmo - playaWep.m_nAmmoInClip, playa->m_wModelIndex);
CFont::PrintString(15.0f, 15.0f, string); // выводим текст, указаываем координаты
}
};
}
} test;