SAMP/CreatePlayerTextDraw
Материал из Pawno Wiki
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.