SAMP/CreatePlayerTextDraw

Материал из Pawno Wiki

CreatePlayerTextDraw


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


Описание:

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


Параметры:

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


playeridID игрока, для которого создается TextDraw.
Float: xX-координата.
Float: yY-координата.
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, чтобы показать его игроку.
  • При создании текстовых рисунков проигрывателя рекомендуется использовать ВСЕ числа вместо десятичных разрядов, чтобы обеспечить удобное разрешение дизайна.


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


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

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