Список методов в категории Text:
UseNewDefaultFonts
Описание
Начиная с версии 2.0.20 AGK имеет новую систему шрифтов, которая может отображать больше символов и отображать символы более плавно, однако для сохранения обратной совместимости она по умолчанию отключена. Чтобы использовать новую систему, установите для этой команды значение 1. Это влияет только на шрифт по умолчанию, если вы его сами не установили.
Определение
void agk::UseNewDefaultFonts( int mode )
Параметры
mode - 1=использовать новые шрифты по умолчанию, 0=использовать старые шрифты по умолчанию
Пример кода
SetTextX
Описание
Обновляет положение X текстового объекта в мировых координатах, по умолчанию текст позиционируется с помощью его верхнего левого угла. При использовании выравнивания по правому краю текст позиционируется с помощью его верхнего правого угла. При использовании выравнивания по центру текст позиционируется с помощью точки на полпути вдоль его верхнего края.
Определение
void agk::SetTextX( UINT iTextIndex, float fX )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fX - Новая позиция X.
Пример кода
SetTextY
Описание
Обновляет положение Y текстового объекта в мировых координатах, по умолчанию текст позиционируется с помощью его верхнего левого угла. При использовании выравнивания по правому краю текст позиционируется с помощью его верхнего правого угла. При использовании выравнивания по центру текст позиционируется с помощью точки на полпути вдоль его верхнего края.
Определение
void agk::SetTextY( UINT iTextIndex, float fY )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fY - Новая позиция Y.
Пример кода
SetTextVisible
Описание
Задает, будет ли текст отрисовываться во время обновления экрана.
Определение
void agk::SetTextVisible( UINT iTextIndex, int bVisible )
Параметры
iTextIndex - Идентификатор текста для изменения.
bVisible - 1, чтобы нарисовать этот текст, 0, чтобы скрыть его.
Пример кода
SetTextTransparency
Описание
Установите прозрачность текста на определенную настройку с выбором без прозрачности, альфа-прозрачности и аддитивного смешивания. По умолчанию текст создается с альфа-прозрачностью.
Определение
void agk::SetTextTransparency( UINT iTextIndex, int mode )
Параметры
iTextIndex - Идентификатор текста для изменения.
mode - Режим прозрачности для этого текста: 0=выкл., 1=альфа-прозрачность, 2=аддитивное смешивание
Пример кода
SetTextString
Описание
Обновляет строку текстового объекта, новый текст будет отображаться при следующем обновлении экрана.
Определение
void agk::SetTextString( UINT iTextIndex, const char *string )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
string - Новая строка для использования.
Пример кода
SetTextSpacing
Описание
Устанавливает интервал между буквами. Значение 0 не создает зазора между ограничивающими буквами, положительное значение увеличивает этот зазор, отрицательное значение перекрывает буквы. Если каждый символ построен с некоторым пробелом по обе стороны от него в изображении шрифта, то это значение интервала по умолчанию, и эта команда будет увеличивать или уменьшать расстояние от него.
Определение
void agk::SetTextSpacing( UINT iTextIndex, float fSpacing )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fSpacing - Новый интервал для использования.
Пример кода
SetTextSize
Описание
Устанавливает размер текстового объекта, по умолчанию 4. Это значение представляет высоту каждого символа в мировых единицах. Ширина каждого символа зависит от шрифта и рассчитывается в соответствии с заданным размером.
Определение
void agk::SetTextSize( UINT iTextIndex, float fSize )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fSize - Новый размер текста.
Пример кода
SetTextScissor
Описание
При рисовании текст привязывается к указанным мировым координатам. Используйте значения 0,0,0,0 для отключения текстовых ножниц
Определение
void agk::SetTextScissor( UINT iTextIndex, float x, float y, float x2, float y2 )
Параметры
iTextIndex - Идентификатор текста для изменения.
x - Координата x верхнего левого угла прямоугольника для использования в качестве границы клипа.
y - Координата y верхнего левого угла прямоугольника для использования в качестве границы клипа.
x2 - Координата x в правом нижнем углу окна для использования в качестве границы клипа.
y2 - Координата y в правом нижнем углу окна для использования в качестве границы клипа.
Пример кода
SetTextMaxWidth
Описание
Задает максимальную ширину, которую текстовый объект будет использовать для рисования, любые символы, выходящие за пределы этого значения, будут переноситься на новую строку.
Определение
void agk::SetTextMaxWidth( UINT iTextIndex, float width )
Параметры
iTextIndex - Идентификатор изменяемого текстового объекта
width - Максимальная ширина, которую будет использовать текст
Пример кода
SetTextPosition
Описание
Обновляет положение текстового объекта в мировых координатах, по умолчанию текст позиционируется с помощью его верхнего левого угла. При использовании выравнивания по правому краю текст позиционируется с помощью его верхнего правого угла. При использовании выравнивания по центру текст позиционируется с помощью точки на полпути вдоль его верхнего края.
Определение
void agk::SetTextPosition( UINT iTextIndex, float fX, float fY )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fX - Новая позиция X.
fY - Новая позиция Y.
Пример кода
SetTextLineSpacing
Описание
Задает интервал между строками текста. Значение 0 не создает зазора между линиями, положительное значение увеличивает этот зазор, отрицательное значение перекрывает линии. Если каждый символ построен с некоторым пробелом над и под ним в изображении шрифта, то это значение интервала по умолчанию, и эта команда увеличит или уменьшит расстояние от него.
Определение
void agk::SetTextLineSpacing( UINT iTextIndex, float fSpacing )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fSpacing - Новый интервал для использования.
Пример кода
SetTextExtendedFontImage
Описание
Задает расширенный шрифт, используемый для этого текстового объекта. Расширенный шрифт предназначен для нестандартных символов выше значения ascii 127 и может быть установлен отдельно для стандартных символов, так что вы можете иметь несколько изображений для расширенного набора и базовое изображение для обычных символов шрифта. AGK имеет встроенный расширенный шрифт, который он использует для текстовых объектов с символами от 128 до 255, эта команда позволяет переопределить его. Если вы устанавливаете все свои текстовые объекты на один и тот же расширенный шрифт, вам следует использовать вместо этого SetTextDefaultExtendedFontImage, так как это сэкономит некоторое время обработки. Изображение должно содержать все белые символы, окруженные прозрачным альфа-каналом. Полностью прозрачные пиксели также должны содержать белый цвет в своих компонентах RGB. Изображение шрифта может быть либо фиксированной ширины, либо переменной ширины. Для фиксированной ширины изображение шрифта должно быть выложено в сетку из 16 символов поперек и 8 символов вниз, начиная с символа ascii 32 (пробел) в левом верхнем углу и продолжая слева направо, сверху вниз, заканчивая символом ascii 127 (DEL) в правом нижнем углу. Ширина изображения должна быть кратна 16, а высота изображения-6. Для переменной ширины изображение должно быть текстурой атласа, сопровождаемой subimages.txt файл, в котором указано расположение каждого символа на изображении. AGK будет искать изображения 32 до 127 включительно в файле подизображений, и любые не найденные будут по умолчанию использовать символ пробела (32). Символы переменной высоты не поддерживаются, и все символы должны быть одинаковой высоты с любым необходимым заполнением, включенным в изображение шрифта. Если этот текстовый объект использует шрифт TrueType, то эта команда не влияет, шрифт TrueType обрабатывает как обычные, так и расширенные символы (unicode).
Определение
void agk::SetTextExtendedFontImage( UINT iTextIndex, UINT iImageID )
Параметры
iTextIndex - Идентификатор изменяемого текстового объекта
iImageID - Изображение, содержащее новый шрифт.
Пример кода
SetTextFont
Описание
Задает шрифт TrueType, используемый для этого текстового объекта. Шрифт должен быть загружен с помощью LoadFont из файла шрифтов TrueType. Это отличается от старых растровых шрифтов тем, что он поддерживает символы юникода, и символы обычно появляются более четкими на экране всех размеров. Обратите внимание, что изменение размера текстового объекта, использующего шрифт TrueType, приведет к перерисовке всех символов из файла шрифта на изображение для рисования, для больших размеров текста с использованием сотен различных символов юникода это может быть медленным процессом, но при нормальном использовании он обычно не заметен. Недавно использованные размеры сохраняются в течение короткого периода времени, поэтому, если вы часто переключаетесь между двумя или тремя размерами текста, вам не нужно будет перерисовывать его, и это будет быстрее. Используйте идентификатор шрифта 0, чтобы использовать встроенный шрифт TrueType, поддерживающий широкий диапазон символов unicode.
Определение
void agk::SetTextFont( UINT iTextIndex, UINT iFontID )
Параметры
iTextIndex - Идентификатор изменяемого текстового объекта.
iFontID - Идентификатор используемого шрифта.
Пример кода
SetTextFontImage
Описание
Устанавливает шрифт, используемый для этого текстового объекта. AGK имеет встроенный шрифт, который он использует для текстовых объектов, это позволяет вам переопределить его. Если вы устанавливаете все свои текстовые объекты на один и тот же шрифт, вам следует использовать вместо этого SetTextDefaultFontImage, так как это сэкономит некоторое время обработки. Изображение должно содержать все белые символы, окруженные прозрачным альфа-каналом. Полностью прозрачные пиксели также должны содержать белый цвет в своих компонентах RGB. Изображение шрифта может быть либо фиксированной ширины, либо переменной ширины. Для фиксированной ширины изображение шрифта должно быть выложено в сетку из 16 символов поперек и 6 символов вниз, начиная с символа ascii 32 (пробел) в левом верхнем углу и продолжая слева направо, сверху вниз, заканчивая символом ascii 127 (DEL) в правом нижнем углу. Ширина изображения должна быть кратна 16, а высота изображения-6. Для переменной ширины изображение должно быть текстурой атласа, сопровождаемой subimages.txt файл, в котором указано расположение каждого символа на изображении. AGK будет искать изображения 32 до 127 включительно в файле подизображений, и любые не найденные будут по умолчанию использовать символ пробела (32). Символы переменной высоты не поддерживаются, и все символы должны быть одинаковой высоты с любым необходимым заполнением, включенным в изображение шрифта. Начиная с версии 2.0.20 вы можете использовать SetTextFont для использования шрифтов TrueType вместо растровых шрифтов. Вы должны выбрать один или другой, установка растрового шрифта удалит шрифт Truetype, а установка шрифта TrueType удалит растровый шрифт.
Определение
void agk::SetTextFontImage( UINT iTextIndex, UINT iImageID )
Параметры
iTextIndex - Идентификатор изменяемого текстового объекта
iImageID - Изображение, содержащее новый шрифт.
Пример кода
SetTextDepth
Описание
Устанавливает порядок рисования текста между 0-10000, 0 - передняя часть экрана, 10000 - задняя. Все, что больше 10000, приведет к тому, что текст будет вырезан из поля зрения. По умолчанию текст установлен на глубину 9 и отображается выше всех других спрайтов в сцене, установка большей глубины приведет к сортировке текста в прозрачный список порядка рисования, что может снизить производительность. Используйте глубину 0 для достижения наилучшей производительности.
Определение
void agk::SetTextDepth( UINT iTextIndex, int iDepth )
Параметры
iTextIndex - Идентификатор текста для изменения.
iDepth - На какой глубине должен быть нарисован этот текст.
Пример кода
SetTextDefaultMagFilter
Описание
Устанавливает фильтр изображений для всех текстовых объектов и функций печати, использующих шрифт по умолчанию, когда текстовое изображение больше занимаемого им пространства экрана. Ближайшая фильтрация выбирает ближайший пиксель для отображения и может выглядеть блочной. Линейная фильтрация смешивает 4 ближайших пикселя и может выглядеть размытой.
Определение
void agk::SetTextDefaultMagFilter( UINT mode )
Параметры
mode - Используемый режим фильтрации: 0=ближайший, 1=линейный
Пример кода
SetTextDefaultMinFilter
Описание
Устанавливает фильтр изображения для всех текстовых объектов и функций печати, использующих шрифт по умолчанию, когда текстовое изображение меньше занимаемого им пространства экрана. Ближайшая фильтрация выбирает ближайший пиксель для отображения и может выглядеть блочной. Линейная фильтрация смешивает 4 ближайших пикселя и может выглядеть размытой.
Определение
void agk::SetTextDefaultMinFilter( UINT mode )
Параметры
mode - Используемый режим фильтрации: 0=ближайший, 1=линейный
Пример кода
SetTextDefaultExtendedFontImage
Описание
Устанавливает расширенный шрифт по умолчанию для текстовых объектов. Расширенный шрифт предназначен для нестандартных символов выше значения ascii 127 и может быть установлен отдельно для стандартных символов, так что вы можете иметь несколько изображений для расширенного набора и базовое изображение для обычных символов шрифта. AGK имеет встроенный расширенный шрифт для символов от 128 до 255, который он использует для текстовых объектов, что позволяет переопределить его. Если вы решите переопределить его, вы должны сделать это перед созданием любых текстовых объектов. Вы можете установить шрифт для каждого текста с помощью Settextendedfontimage. Изображение должно содержать все белые символы, окруженные прозрачным альфа-каналом. Полностью прозрачные пиксели также должны содержать белый цвет в своих компонентах RGB. Расширенное изображение шрифта может быть либо фиксированной ширины, либо переменной ширины. Для фиксированной ширины изображение шрифта должно быть выложено в сетку из 16 символов поперек и 8 символов вниз, начиная с символа ascii 128 в левом верхнем углу и продолжая слева направо, сверху вниз, заканчивая символом ascii 255 в правом нижнем углу. Ширина изображения должна быть кратна 16, а высота-8. Для переменной ширины изображение должно быть текстурой атласа, сопровождаемой subimages.txt файл, в котором указано расположение каждого символа на изображении. AGK будет искать изображения 128 до 255 включительно в файле подизображений, а любые не найденные будут по умолчанию использовать символ пробела (32).
Определение
void agk::SetTextDefaultExtendedFontImage( UINT iImageID )
Параметры
iImageID - Изображение, содержащее новый шрифт.
Пример кода
SetTextDefaultFontImage
Описание
Устанавливает шрифт по умолчанию для текстовых объектов. AGK имеет встроенный шрифт, который он использует для текстовых объектов, это позволяет вам переопределить его. Если вы решите переопределить его, вы должны сделать это перед созданием любых текстовых объектов. Вы можете установить шрифт для каждого текста с помощью SetTextFontImage. Изображение должно содержать все белые символы, окруженные прозрачным альфа-каналом. Полностью прозрачные пиксели также должны содержать белый цвет в своих компонентах RGB. Изображение шрифта может быть либо фиксированной ширины, либо переменной ширины. Для фиксированной ширины изображение шрифта должно быть выложено в сетку из 16 символов поперек и 6 символов вниз, начиная с символа ascii 32 (пробел) в левом верхнем углу и продолжая слева направо, сверху вниз, заканчивая символом ascii 127 (DEL) в правом нижнем углу. Ширина изображения должна быть кратна 16, а высота изображения-6. Для переменной ширины изображение должно быть текстурой атласа, сопровождаемой subimages.txt файл, в котором указано расположение каждого символа на изображении. AGK будет искать изображения 32 до 127 включительно в файле подизображений, и любые не найденные будут по умолчанию использовать символ пробела (32).
Определение
void agk::SetTextDefaultFontImage( UINT iImageID )
Параметры
iImageID - Изображение, содержащее новый шрифт.
Пример кода
SetTextColorGreen
Описание
Установите зеленый компонент цвета текста. Значение должно находиться в диапазоне 0-255.
Определение
void agk::SetTextColorGreen( UINT iTextIndex, UINT iGreen )
Параметры
iTextIndex - Идентификатор текста для изменения.
iGreen - Зеленая составляющая цвета.
Пример кода
SetTextColorRed
Описание
Установите красный компонент цвета текста. Значение должно находиться в диапазоне 0-255.
Определение
void agk::SetTextColorRed( UINT iTextIndex, UINT iRed )
Параметры
iTextIndex - Идентификатор текста для изменения.
iRed - Красная составляющая цвета.
Пример кода
SetTextColorBlue
Описание
Установите синий компонент цвета текста. Значение должно находиться в диапазоне 0-255.
Определение
void agk::SetTextColorBlue( UINT iTextIndex, UINT iBlue )
Параметры
iTextIndex - Идентификатор текста для изменения.
iBlue - Синяя составляющая цвета.
Пример кода
SetTextColorAlpha
Описание
Установите альфа-компонент цвета текста. Значение должно находиться в диапазоне 0-255.
Определение
void agk::SetTextColorAlpha( UINT iTextIndex, UINT iAlpha )
Параметры
iTextIndex - Идентификатор текста для изменения.
iAlpha - Альфа-компонент цвета.
Пример кода
SetTextColor
Описание
Установите цвет текста, значения должны быть в диапазоне 0-255. Это приведет к тому, что все символы в тексте будут иметь этот цвет. Вы можете установить отдельные символы с помощью SetTextCharColor.
Определение
void agk::SetTextColor( UINT iTextIndex, UINT iRed, UINT iGreen, UINT iBlue, UINT iAlpha )
Параметры
iTextIndex - Идентификатор текста для изменения.
iRed - Красная составляющая цвета.
iGreen - Зеленая составляющая цвета.
iBlue - Синяя составляющая цвета.
iAlpha - Альфа-компонент цвета.
Пример кода
SetTextCharX
Описание
Установите положение X отдельного символа относительно позиции текста, установленной ранее. Символ будет расположен в верхнем левом углу. При вызове любой из следующих команд положение всех символов будет сброшено на прямую линию: SetTextPosition, SetTextX, SetTextY, setTextSize, SetTextSpacing, SetTextAlignment. Позиционирование символов внутри текстового объекта более эффективно, чем позиционирование множества небольших текстовых объектов, каждый из которых содержит символ, поскольку все символы могут быть нарисованы в одном вызове рисования.
Определение
void agk::SetTextCharX( UINT iTextIndex, UINT iCharIndex, float x )
Параметры
iTextIndex - Идентификатор текста для изменения.
iCharIndex - Индекс символа для изменения, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
x - Новая позиция X символа относительно текущей позиции текста.
Пример кода
SetTextCharY
Описание
Установите положение Y отдельного символа относительно позиции текста, установленной ранее. Символ будет расположен в верхнем левом углу. При вызове любой из следующих команд положение всех символов будет сброшено на прямую линию: SetTextPosition, SetTextX, SetTextY, setTextSize, SetTextSpacing, SetTextAlignment. Позиционирование символов внутри текстового объекта более эффективно, чем позиционирование множества небольших текстовых объектов, каждый из которых содержит символ, поскольку все символы могут быть нарисованы в одном вызове рисования.
Определение
void agk::SetTextCharY( UINT iTextIndex, UINT iCharIndex, float y )
Параметры
iTextIndex - Идентификатор текста для изменения.
iCharIndex - Индекс символа для изменения, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
y - Новая позиция символа Y относительно текущей позиции текста.
Пример кода
SetTextCharColorRed
Описание
Задает красный компонент заданного цвета символов. Использование команды SetTextColor переопределит это. Значения должны находиться в диапазоне 0-255.
Определение
void agk::SetTextCharColorRed( UINT iTextIndex, UINT iCharIndex, UINT red )
Параметры
iTextIndex - Идентификатор устанавливаемого текстового объекта.
iCharIndex - Индекс устанавливаемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
red - Новое красное значение для использования
Пример кода
SetTextCharPosition
Описание
Установите положение отдельного символа относительно позиции текста, заданной ранее. Символ будет расположен в верхнем левом углу. При вызове любой из следующих команд положение всех символов будет сброшено на прямую линию: SetTextPosition, SetTextX, SetTextY, setTextSize, SetTextSpacing, SetTextAlignment. Позиционирование символов внутри текстового объекта более эффективно, чем позиционирование множества небольших текстовых объектов, каждый из которых содержит символ, поскольку все символы могут быть нарисованы в одном вызове рисования.
Определение
void agk::SetTextCharPosition( UINT iTextIndex, UINT iCharIndex, float x, float y )
Параметры
iTextIndex - Идентификатор текста для изменения.
iCharIndex - Индекс символа для изменения, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
x - Новая позиция X символа относительно текущей позиции текста.
y - Новая позиция символа Y относительно текущей позиции текста.
Пример кода
SetTextCharColorGreen
Описание
Устанавливает зеленый компонент цвета указанного символа. Использование команды SetTextColor переопределит это. Значения должны находиться в диапазоне 0-255.
Определение
void agk::SetTextCharColorGreen( UINT iTextIndex, UINT iCharIndex, UINT green )
Параметры
iTextIndex - Идентификатор устанавливаемого текстового объекта.
iCharIndex - Индекс устанавливаемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
green - Новое зеленое значение для использования
Пример кода
SetTextCharColorBlue
Описание
Устанавливает синий компонент цвета указанного символа. Использование команды SetTextColor переопределит это. Значения должны находиться в диапазоне 0-255.
Определение
void agk::SetTextCharColorBlue( UINT iTextIndex, UINT iCharIndex, UINT blue )
Параметры
iTextIndex - Идентификатор устанавливаемого текстового объекта.
iCharIndex - Индекс устанавливаемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
blue - Новое синее значение для использования
Пример кода
SetTextCharColor
Описание
Задает цвет указанного символа. Использование команды SetTextColor переопределит это. Значения должны находиться в диапазоне 0-255.
Определение
void agk::SetTextCharColor( UINT iTextIndex, UINT iCharIndex, UINT red, UINT green, UINT blue, UINT alpha )
Параметры
iTextIndex - Идентификатор устанавливаемого текстового объекта.
iCharIndex - Индекс устанавливаемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
red - красная составляющая нового цвета.
green - зеленая составляющая нового цвета.
blue - синий компонент нового цвета.
alpha - альфа-компонент нового цвета.
Пример кода
SetTextCharColorAlpha
Описание
Задает альфа-компонент цвета указанного символа. Использование команды SetTextColor переопределит это. Значения должны находиться в диапазоне 0-255.
Определение
void agk::SetTextCharColorAlpha( UINT iTextIndex, UINT iCharIndex, UINT alpha )
Параметры
iTextIndex - Идентификатор устанавливаемого текстового объекта.
iCharIndex - Индекс устанавливаемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
alpha - Новое альфа-значение для использования
Пример кода
SetTextCharAngleRad
Описание
Установите угол отдельного символа в радианах по часовой стрелке. Персонаж будет вращаться вокруг своего центра. Если какая - либо из следующих команд будет вызвана, то вращение всех символов будет сброшено: SetTextPosition, SetTextX, Settextty, setTextSize, SetTextSpacing, SetTextAlignment.
Определение
void agk::SetTextCharAngleRad( UINT iTextIndex, UINT iCharIndex, float angle )
Параметры
iTextIndex - Идентификатор текста для изменения.
iCharIndex - Индекс символа для изменения, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
angle - Новый угол в радианах.
Пример кода
SetTextCharBold
Описание
Задает символу полужирный стиль. Это применимо только в том случае, если текст использует шрифт TrueType, установленный с помощью SetTextFont. Если вы используете SetTextString, то этот параметр будет сброшен на 0. Вы можете использовать SetTextBold, чтобы установить всю строку жирным шрифтом.
Определение
void agk::SetTextCharBold( UINT iTextIndex, UINT iCharIndex, UINT bold )
Параметры
iTextIndex - Идентификатор устанавливаемого текстового объекта.
iCharIndex - Индекс устанавливаемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
bold - 1, чтобы установить символ как жирный, 0, чтобы установить его как нормальный вес (по умолчанию)
Пример кода
SetTextCharAngle
Описание
Установите угол наклона отдельного символа в градусах по часовой стрелке. Персонаж будет вращаться вокруг своего центра. Если какая - либо из следующих команд будет вызвана, то вращение всех символов будет сброшено: SetTextPosition, SetTextX, Settextty, setTextSize, SetTextSpacing, SetTextAlignment.
Определение
void agk::SetTextCharAngle( UINT iTextIndex, UINT iCharIndex, float angle )
Параметры
iTextIndex - Идентификатор текста для изменения.
iCharIndex - Индекс символа для изменения, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
angle - Новый угол в градусах.
Пример кода
SetTextAngleRad
Описание
Обновляет угол наклона текста. Если текст выровнен по левому краю, то он будет вращаться вокруг своего верхнего левого угла. При использовании выравнивания по центру он будет вращаться вокруг точки на полпути вдоль своего верхнего края. При использовании правого выравнивания он будет вращаться вокруг своего верхнего восьмого угла.
Определение
void agk::SetTextAngleRad( UINT iTextIndex, float fAngleRad )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fAngleRad - Новый угол в радианах.
Пример кода
SetTextBold
Описание
Устанавливает все символы в тексте полужирным шрифтом независимо от текущего состояния SetTextCharBold. Этот параметр будет оставаться активным до тех пор, пока он не будет изменен, установка новой текстовой строки не изменит его.
Определение
void agk::SetTextBold( UINT iTextIndex, UINT bold )
Параметры
iTextIndex - Идентификатор текста для изменения.
bold - 1 - жирный шрифт, 0 - нормальный вес (по умолчанию)
Пример кода
SetTextAngle
Описание
Обновляет угол наклона текста. Если текст выровнен по левому краю, то он будет вращаться вокруг своего верхнего левого угла. При использовании выравнивания по центру он будет вращаться вокруг точки на полпути вдоль своего верхнего края. При использовании правого выравнивания он будет вращаться вокруг своего верхнего восьмого угла.
Определение
void agk::SetTextAngle( UINT iTextIndex, float fAngle )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
fAngle - Новый угол в градусах.
Пример кода
SetTextAlignment
Описание
Устанавливает, как текст должен быть расположен на экране. Выравнивание по левому краю позиционирует текст, используя его верхний левый угол, выравнивание по правому краю позиционирует его, используя его верхний правый угол, а центр позиционирует его, используя точку на полпути вдоль его верхнего края.
Определение
void agk::SetTextAlignment( UINT iTextIndex, int iMode )
Параметры
iTextIndex - Идентификатор текстового объекта для обновления.
iMode - Режим выравнивания для использования. 0=слева, 1=в центре, 2=справа
Пример кода
SetPrintSpacing
Описание
Устанавливает интервал между буквами. Значение 0 не создает зазора между ограничивающими буквами, положительное значение увеличивает этот зазор, отрицательное значение перекрывает буквы. Это глобальная команда, которая будет влиять на весь печатный текст при следующем вызове синхронизации. Для управления интервалом на основе каждой строки используйте текстовые команды.
Определение
void agk::SetPrintSpacing( float fSpacing )
Параметры
fSpacing - Интервал между буквами для использования.
Пример кода
SetPrintSize
Описание
Задает размер печатного текста, который будет отображаться на экране. Это глобальная команда, которая будет влиять на весь печатный текст при следующем вызове синхронизации. Для управления размером на основе каждой строки используйте текстовые команды.
Определение
void agk::SetPrintSize( float fSize )
Параметры
fSize - Размер текста в пикселях виртуального разрешения.
Пример кода
SetPrintFont
Описание
Устанавливает шрифт для использования для всего печатного текста, шрифт должен быть предварительно загружен с помощью LoadFont. Используйте идентификатор шрифта 0, чтобы использовать шрифт AGK по умолчанию.
Определение
void agk::SetPrintFont( int fontID )
Параметры
fontID - Идентификатор шрифта, используемый для печати текста
Пример кода
SetPrintColor
Описание
Задает цвет печатного текста. Это глобальная команда, которая будет влиять на весь печатный текст при следующем вызове синхронизации. Для управления цветом на основе каждой строки используйте текстовые команды. Эта версия устанавливает альфа-код на 255, полностью непрозрачный.
Определение
void agk::SetPrintColor( UINT iRed, UINT iGreen, UINT iBlue )
void agk::SetPrintColor( UINT iRed, UINT iGreen, UINT iBlue, UINT iAlpha )
Параметры
iRed - Красная составляющая цвета.
iGreen - Зеленая составляющая цвета.
iBlue - Синяя составляющая цвета.
iAlpha - Альфа-компонент цвета.
Пример кода
PrintC
Описание
Выводит заданное значение или строку на экран, но не добавляет новый символ строки в конец. Следующая команда Print или PrintC будет следовать непосредственно из этой.
Определение
void agk::PrintC( const char *szString )
void agk::PrintC( int i )
void agk::PrintC( float f )
Параметры
szString - Строка для печати.
i - Целое число для печати.
f - float для печати.
Пример кода
Описание
Выводит заданное значение или строку на экран и добавляет новый символ строки, чтобы следующая команда печати была на одну строку ниже.
Определение
void agk::Print( int i )
void agk::Print( float f )
void agk::Print( const char *szString )
Параметры
i - Целое число для печати.
f - float для печати.
szString - Строка для печати.
Пример кода
GetTextX
Описание
Возвращает текущее положение X текстового объекта в мировых координатах, текст позиционируется с помощью его верхнего левого угла.
Определение
float agk::GetTextX( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор возвращаемого текстового объекта.
Пример кода
GetTextY
Описание
Возвращает текущее положение Y текстового объекта в мировых координатах, текст позиционируется с помощью его верхнего левого угла.
Определение
float agk::GetTextY( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор возвращаемого текстового объекта.
Пример кода
GetTextVisible
Описание
Возвращает 0, если текущий текст был установлен как невидимый с помощью SetTextVisible, 1, если он установлен как видимый (по умолчанию). Это не проверяет, находится ли текст в данный момент в видимом видовом окне.
Определение
int agk::GetTextVisible( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextTotalWidth
Описание
Возвращает текущую ширину текстового объекта в мировых единицах измерения. Если текстовый объект отображает текст в нескольких строках, он возвращает ширину самой длинной строки. Это не учитывает индивидуальные смещения символов, если вы использовали SetTextCharX или что-то подобное для перемещения символа. Возвращаемое значение-это ширина, используемая положением рисунка текстовых символов по умолчанию.
Определение
float agk::GetTextTotalWidth( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор возвращаемого текстового объекта.
Пример кода
GetTextTotalHeight
Описание
Возвращает текущую высоту текстового объекта в мировых единицах измерения. Это не учитывает индивидуальные смещения символов, если вы использовали SetTextCharY или что-то подобное для перемещения символа. Возвращаемое значение-это высота, используемая для расположения текстовых символов на чертеже по умолчанию. Обратите внимание, что если строка текста пуста, то это значение вернет 0.
Определение
float agk::GetTextTotalHeight( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор возвращаемого текстового объекта.
Пример кода
GetTextString
Описание
Возвращает текущую строку, отображаемую текстовым объектом. В tier 2 возвращаемая строка должна быть удалена, когда вы закончите с ней.
Определение
char* agk::GetTextString( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextSize
Описание
Возвращает текущий размер текстового объекта, заданного с помощью setTextSize.
Определение
float agk::GetTextSize( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextSpacing
Описание
Возвращает текущий интервал текстового объекта, заданного с помощью SetTextSpacing.
Определение
float agk::GetTextSpacing( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextLineSpacing
Описание
Возвращает текущий межстрочный интервал текстового объекта, заданного с помощью SetTextLineSpacing.
Определение
float agk::GetTextLineSpacing( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextLength
Описание
Возвращает текущую длину строки, отображаемой текстовым объектом.
Определение
UINT agk::GetTextLength( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор возвращаемого текстового объекта.
Пример кода
GetTextHitTest
Описание
Возвращает 1, если заданная точка в мировых координатах находится внутри ограничивающего прямоугольника текста. Если вы тестируете мышь или сенсорную координату, не забудьте преобразовать ее в мировые координаты с помощью ScreenToWorldX и ScreenToWorldY. Это не учитывает отдельные позиции символов, например, если вы расположили символ с помощью SetTextCharX или аналогичного. Проверяется только ограничивающая рамка, созданная путем рисования символов в их позициях по умолчанию.
Определение
int agk::GetTextHitTest( UINT iTextIndex, float x, float y )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
x - Координата x точки для проверки в мировых координатах.
y - Координата y точки для проверки в мировых координатах.
Пример кода
GetTextColorRed
Описание
Получите красную составляющую цвета текста. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextColorRed( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текста для проверки.
Пример кода
GetTextExists
Описание
Возвращает 1, если текст существует, и 0, если его нет.
Определение
UINT agk::GetTextExists( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текста для проверки
Пример кода
GetTextColorGreen
Описание
Получите зеленую составляющую цвета текста. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextColorGreen( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текста для проверки.
Пример кода
GetTextDepth
Описание
Возвращает текущую глубину текстового объекта, где 0-передняя часть экрана, а 10000 - задняя.
Определение
int agk::GetTextDepth( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextColorBlue
Описание
Получите синий компонент цвета текста. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextColorBlue( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текста для проверки.
Пример кода
GetTextColorAlpha
Описание
Получите альфа-компонент цвета текста. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextColorAlpha( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текста для проверки.
Пример кода
GetTextCharColorRed
Описание
Возвращает красный компонент заданного цвета символа. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextCharColorRed( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextCharY
Описание
Возвращает текущую позицию Y указанного символа относительно текстового объекта.
Определение
float agk::GetTextCharY( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextCharX
Описание
Возвращает текущую позицию X указанного символа относительно текстового объекта.
Определение
float agk::GetTextCharX( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextCharColorGreen
Описание
Возвращает зеленый компонент заданного цвета символа. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextCharColorGreen( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextCharColorBlue
Описание
Возвращает синий компонент заданного цвета символа. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextCharColorBlue( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextCharAngleRad
Описание
Возвращает текущий угол в радианах указанного символа.
Определение
float agk::GetTextCharAngleRad( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextCharColorAlpha
Описание
Возвращает альфа-компонент заданного цвета символа. Значение будет находиться в диапазоне 0-255.
Определение
UINT agk::GetTextCharColorAlpha( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
GetTextAlignment
Описание
Возвращает текущее выравнивание набора текстовых объектов с помощью SetTextAlignment.
Определение
int agk::GetTextAlignment( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
Пример кода
GetTextCharAngle
Описание
Возвращает текущий угол в градусах указанного символа.
Определение
float agk::GetTextCharAngle( UINT iTextIndex, UINT iCharIndex )
Параметры
iTextIndex - Идентификатор проверяемого текстового объекта.
iCharIndex - Индекс проверяемого символа, индексы начинаются с 0, если индекс находится вне диапазона, он будет проигнорирован.
Пример кода
FixTextToScreen
Описание
По умолчанию текстовые объекты создаются в мировых координатах, и SetViewOffset можно использовать для перемещения по всему миру. Используйте эту команду, чтобы вместо этого зафиксировать текст на экране, чтобы он перемещался вместе с видовым окном при перемещении видового окна. Вы все еще можете изменить положение текста, закрепленного на экране, это влияет только на то, что происходит при перемещении видового экрана.
Определение
void agk::FixTextToScreen( UINT iTextIndex, int mode )
Параметры
iTextIndex - Идентификатор текста, который нужно изменить.
mode - 1=экранный текст, 0=мировой текст
Пример кода
DrawText
Описание
Сразу же рисует текст в backbuffer в его текущем положении, размере и повороте. Это полезно, если вы хотите настроить сцену для захвата getImage. Не забудьте использовать ClearScreen для очистки любого вашего собственного рисунка перед вызовом Sync или Render для фактического кадра, иначе ваш рисунок может появиться дважды в окончательном рендеринге.
Определение
void agk::DrawText( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текста для рисования.
Пример кода
DeleteText
Описание
Удаляет текстовый объект.
Определение
void agk::DeleteText( UINT iTextIndex )
Параметры
iTextIndex - Идентификатор текстового объекта для удаления.
Пример кода
DeleteAllText
Описание
Удаляет все текстовые объекты, созданные с помощью CreateText. Это также сбрасывает идентификатор автотекста до 10000.
Определение
void agk::DeleteAllText()
Параметры
Пример кода
CreateText
Описание
Создает текстовый объект для отображения текста на экране с помощью пустого идентификатора, возвращает используемый идентификатор. По умолчанию текст рисуется на глубине 9 выше глубины спрайтов по умолчанию (10). Любые спрайты, установленные на глубину 8 или меньше, будут отображаться над текстом. Вы можете переопределить это с помощью SetTextDepth, чтобы установить свой собственный порядок розыгрыша.
Определение
UINT agk::CreateText( const char *string )
void agk::CreateText ( UINT iTextIndex, const char *string )
Параметры
string - Начальная строка, используемая в этом текстовом объекте, может быть пустой строкой.
iTextIndex - Текстовый идентификатор, который будет использоваться для ссылки на этот текст позже (отдельно от идентификаторов изображений и спрайтов, поэтому может быть как спрайт 1, так и текст 1)