Графический текст, который может быть обращен на цель визуализации.
#include <Text.hpp>
Публичные типы
enum –
Style {
Regular = 0, – регулярный
Bold = 1 << 0, – жирный
Italic = 1 << 1, – курсив
Underlined = 1 << 2, – подчёркнутый
StrikeThrough = 1 << 3 – зачёркнутый
}
Перечень стилей строки рисования
Функции связанные с sf::Text
Text () Конструктор по умолчанию. |
|
Text (const String &string, const Font &font, unsigned int characterSize=30) Конструктор текста из строки, шрифта и размера. |
|
void | setString (const String &string) Установить строку текста |
void | setFont (const Font &font) Установить шрифт текста |
void | setCharacterSize (unsigned int size) Установить размер символа |
void | setStyle (Uint32 style) Установить стиль текста |
void | setColor (const Color &color) Установить цвет текста |
const String & | getString () const Получить строку текста |
const Font * | getFont () const Получить шрифт текста |
unsigned int | getCharacterSize () const Получить размер символа |
Uint32 | getStyle () const Получить стиль текста |
const Color & | getColor () const Получить цвет текста |
Vector2f | findCharacterPos (std::size_t index) const Возвращает позицию индексного символа |
FloatRect | getLocalBounds () const Получить локальный ограничивающий прямоугольник объекта |
FloatRect | getGlobalBounds () const Получить глобальный ограничивающий прямоугольник объекта |
Функции связанные с sf::Transformable
void | setPosition (float x, float y) |
void | setPosition (const Vector2f &position) |
void | setRotation (float angle) |
void | setScale (float factorX, float factorY) |
void | setScale (const Vector2f &factors) |
void | setOrigin (float x, float y) |
void | setOrigin (const Vector2f &origin) |
const Vector2f & | getPosition () const |
float | getRotation () const |
const Vector2f & | getScale () const |
const Vector2f & | getOrigin () const |
void | move (float offsetX, float offsetY) |
void | move (const Vector2f &offset) |
void | rotate (float angle) |
void | scale (float factorX, float factorY) |
void | scale (const Vector2f &factor) |
const Transform & | getTransform () const |
const Transform & | getInverseTransform () const |
Что делают вышеуказанные функции и так понятно.
Подробное описание
Графический текст, который может быть обращено на цели визуализации.
sf::Text представляет собой рисуемый класс, который позволяет легко отображать текст с пользовательского стиля и цвета на цели визуализации.
Он наследует все функции от sf::Transformable: положение, вращение, масштабирование, происхождение. Он также добавляет текстовые специфические свойства, такие как шрифт, чтобы использовать, размер символов, стиль шрифта (полужирный, курсив, подчеркнутый, пронзаешь), глобальный цвет и текст для отображения конечно. Он также предоставляет удобные функции для расчета графический размер текста, или получить глобальную позицию данного символа.
sf::Text работает в сочетании с классом sf::Font, который загружает и обеспечивает глифы (визуальные символы) данного шрифта.
Разделение sf::Font и sf::Text обеспечивает большую гибкость и лучшую производительность: действительно sf::Font тяжелый ресурс, и любая операция на нем медленная (часто слишком медленная для приложений реального времени). С другой стороны, sf::Text представляет собой легкий объект, который может объединить данные глифы и метрики в sf::Font, чтобы отобразить любой текст на цели визуализации.
Важно отметить, что экземпляр sf::Text не копирует шрифт, который он использует, он только сохраняет ссылку на него. Таким образом, sf::Font не должен быть уничтожен, пока он используется в sf::Text (т.е. никогда нельзя писать функцию, которая использует локальный экземпляр sf::Font для создания текста).
Смотрите также записку о координатах и неискаженной рендеринга в sf::Transformable.
Пример использования:
1 2 3 4 5 6 7 8 9 10 |
// Объявляем и загружаем шрифт sf::Font font; font.loadFromFile("arial.ttf"); // Создаём текст sf::Text text("hello", font); text.setCharacterSize(30); text.setStyle(sf::Text::Bold); text.setColor(sf::Color::Red); // Рисуем это window.draw(text); |