CreatePlayerTextDraw

Добавлено

Функция работает только начиная с версии SA-MP 0.3e и не будет работать в предыдущих версиях!

Описание:

Создает TextDraw для одного игрока. Это можно использовать как способ обойти глобальный предел рисования текста.

Параметры:

(playerid, Float: x, Float: y, text[])

playerid

ID игрока, для которого создается TextDraw.

Float: x

X-координата.

Float: y

Y-координата.

text[]

Текст в TextDraw.

Возвращаемые значения:

ID созданного текстового рисунка.

Пример использования:

// Эта переменная используется для хранения идентификатора текстового рисунка, чтобы мы могли использовать его в сценарии 
new PlayerText:welcomeText[MAX_PLAYERS];
public OnPlayerConnect(playerid)
{
    // Создадим TextDraw
    welcomeText[playerid] = CreatePlayerTextDraw(playerid, 320.0, 240.0, "Добро пожаловать на сервер SA-MP");
    // Теперь покажем его только определенному пользователю 
    PlayerTextDrawShow(playerid, welcomeText[playerid]);
}

Предупреждение

Если вы выберете значения для y меньше 1, первая текстовая строка будет невидимой и будет видна только тень.
text[] НЕ должен быть пустым, иначе сервер выйдет из строя! Если вам нужен текстовый рисунок, который ничего не показывает, используйте "" (пробел) или _ (подчеркивание)
Если последний символ в тексте - это пробел («»), весь текст будет пустым.
Если часть текста находится за пределами экрана, цвет текста не будет отображаться, будет отображаться только тень (если она включена).

Предупреждение

Это относится ТОЛЬКО к версиям sa-mp до 0.3z:

Максимальная длина TextDraw - 800 символов. Более длинный текст приведет к сбою клиента в старых версиях.
Если вы используете цветовые коды (такие как ~ R ~ ~ G ~) после 255-го символа, клиент выйдет из строя при попытке отобразить TextDraw.

Предупреждение

Коды сопоставления клавиш клавиатуры (например, ~ k ~~ VEHICLE_ENTER_EXIT ~ Не работает после 255-го символа.

Примечание

Координаты x, y - это верхняя левая координата области рисования текста на основе «холста» 640x448 (независимо от разрешения экрана). Если вы планируете использовать TextDrawAlignment с выравниванием 3 (справа), координаты x, y являются верхней правой координатой для рисования текста.
Эта функция просто СОЗДАЕТ текстовый рисунок, вы должны использовать PlayerTextDrawShow, чтобы показать его игроку.
При создании текстовых рисунков проигрывателя рекомендуется использовать ВСЕ числа вместо десятичных разрядов, чтобы обеспечить удобное разрешение дизайна.

Примечание

Текстовые рисунки игрока автоматически уничтожаются, когда игрок отключается.

Связанные функции

Следующие функции также могут быть полезны, поскольку они так или иначе связаны с рассматриваемой функцией.

PlayerTextDrawDestroy - Уничтожить PlayerTextDraw.
PlayerTextDrawColor - Установите цвет текста в PlayerTextDraw.
PlayerTextDrawBoxColor - Устанавливает цвет поля PlayerTextDraw.
PlayerTextDrawBackgroundColor - Установите цвет фона для PlayerTextDraw.
PlayerTextDrawAlignment - Задает выравнивание PlayerTextDraw.
PlayerTextDrawFont - Установить шрифт для PlayerTextDraw.
PlayerTextDrawLetterSize - Установите размер буквы текста в PlayerTextDraw.
PlayerTextDrawTextSize - Установите размер поля для рисования текста игрока (или интерактивной области для PlayerTextDrawSetSelectable).
PlayerTextDrawSetOutline - Переключение контура на PlayerTextDraw.
PlayerTextDrawSetShadow - Установить тень на PlayerTextDraw.
PlayerTextDrawSetProportional - Масштабирование интервала текста в текстовом изображении проигрывателя до пропорционального соотношения.
PlayerTextDrawUseBox - Переключение поля на текстовом изображении игрока.
PlayerTextDrawSetString - Устанавливает текст PlayerTextDraw.

PlayerTextDrawShow - Показать PlayerTextDraw.
PlayerTextDrawHide - Скрыть PlayerTextDraw.