SAMP/TextDrawCreate

Материал из Pawno Info Wikipedia

TextDrawCreate


Описание:

Создает TextDraw. Текстовые рисунки - это, как следует из названия, текст (в основном - могут быть блоки, спрайты и превью моделей (скины/автомобили/оружие/объекты), который отображается на экранах игрока. Подробную информацию о текстовых рисунках см. На этой странице.


Параметры:

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


Float: xКоордината X (влево / вправо) для создания TextDraw.
Float: yКоордината Y (вверх / вниз) для создания рисунка.
text[]Текст, который появится в TextDraw.


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

Идентификатор созданного текстового рисунка. Идентификаторы Textdraw начинаются с 0.


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

// Эта переменная используется для хранения идентификатора текстового рисунка 
//, чтобы мы могли использовать его в сценарии 
new  Text:welcomeText;
public OnGameModeInit() 
{ 
    welcomeText = TextDrawCreate(240.0, 580.0, «Добро пожаловать на мой сервер SA-MP от Pawno-Info.Ru»); // Эта строка используется для создания TextDraw.
    // Примечание: это создает текстовый рисунок без какого-либо форматирования. 
    возврат 1;
}

public OnPlayerConnect(playerid) 
{ 
    // Используется, чтобы показать игроку TextDraw при подключении. 
    TextDrawShowForPlayer(playerid, welcomeText);
}


Wiki removed.png

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

Если вы выберете значения для y меньше 1, первая текстовая строка будет невидимой и будет видна только тень.

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

Если часть текста находится за пределами экрана, цвет текста не будет отображаться, будет отображаться только тень (если она включена).


Wiki removed.png

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

Это относится ТОЛЬКО к версиям sa-mp до 0.3z:
  • Максимальная длина отрисовки - 800 символов. Более длинный текст приведет к сбою клиента в старых версиях.
  • Если вы используете цветовые коды (такие как ~ R ~ ~ G ~) после 255-го символа, клиент выйдет из строя при попытке отобразить текстовый рисунок.


Wiki note.png

Примечание

Координаты x, y - это верхняя левая координата области рисования текста на основе «холста» 640x448 (независимо от разрешения экрана). Если вы планируете использовать TextDrawAlignment с выравниванием 3 (справа), координаты x, y являются верхней правой координатой для рисования текста.

Эта функция просто СОЗДАЕТ текстовый рисунок, вы должны использовать TextDrawShowForPlayer или TextDrawShowForAll, чтобы показать его.

При создании текстовых рисунков рекомендуется использовать ВСЕ числа вместо десятичных разрядов, чтобы обеспечить дизайн с оптимальным разрешением.


Wiki removed.png

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

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


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

Следующие функции также могут быть полезны, поскольку они так или иначе связаны с рассматриваемой функцией.
  • TextDrawDestroy - Уничтожить TextDraw.
  • TextDrawColor - Установите цвет текста в TextDraw.
  • TextDrawBoxColor - Установите цвет поля в TextDraw.
  • TextDrawBackgroundColor - Установите цвет фона TextDraw.
  • TextDrawAlignment - Установите выравнивание TextDraw.
  • TextDrawFont - Установка шрифта TextDraw.
  • TextDrawLetterSize - Установка буквенного размера текста в TextDraw.
  • TextDrawTextSize - Установите размер текстового поля.
  • TextDrawSetOutline - Выберите, есть ли у текста контур.
  • TextDrawSetShadow - Переключение теней на TextDraw.
  • TextDrawSetProportional - Масштабирование интервала текста в TextDraw до пропорционального соотношения.
  • TextDrawUseBox - Переключение, есть ли у текстового рисунка поле или нет.
  • TextDrawSetString - Установить текст в существующем TextDraw.