پرش به مطلب اصلی

SetObjectMaterialText

توضیحات​

جایگزینی بافت یک آبجکت با متن.

نامتوضیحات
objectidشناسه آبجکتی که قرار است بافت آن با متن جایگزین شود.
const text[]متنی که روی آبجکت نمایش داده می‌شود. (حداکثر ۲۰۴۸ کاراکتر)
materialIndexشاخص متریال آبجکت برای جایگزینی با متن.
OBJECT_MATERIAL_SIZE:materialsizeاندازه متریال.
const fontFace[]فونت مورد استفاده.
fontSizeاندازه متن (حداکثر ۲۵۵).
bool:boldمتن ضخیم. برای ضخیم true، برای غیرضخیم false تنظیم کنید.
fontColourرنگ متن، در فرمت ARGB.
backgroundColourرنگ پس‌زمینه، در فرمت ARGB.
OBJECT_MATERIAL_TEXT_ALIGN:textAlignmentتراز متن (پیش‌فرض: چپ‌چین).
OPEN_MP_TAGS:...تعداد نامحدود آرگومان از هر نوع تگ.

مقدار بازگشتی​

true - تابع با موفقیت اجرا شد.

false - تابع در اجرا شکست خورد.

مثال‌ها​

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (strcmp("/text", cmdtext, true) == 0)
    {
        new objectId = CreateObject(19353, 0, 0, 10, 0.0, 0.0, 90.0); //ایجاد آبجکت
        SetObjectMaterialText(objectId, "SA-MP {FFFFFF}0.{008500}3.{FF8200}DL", 0, OBJECT_MATERIAL_SIZE_256x128, "Arial", 28, false, 0xFFFF8200, 0xFF000000, OBJECT_MATERIAL_TEXT_ALIGN_CENT);
        // نوشتن "SA-MP 0.3.DL" روی آبجکت، با رنگ فونت نارنجی و پس‌زمینه سیاه
        return 1;
    }
    return 0;
}

نکات​

نکته

تعبیه رنگ می‌تواند برای چندین رنگ در متن استفاده شود.

هشدار

شما باید از فرمت رنگ ARGB استفاده کنید، نه RGBA که در پیام‌های کلاینت و غیره استفاده می‌شود. متن پس از ۱۶ فراخوانی در مقابل همان آبجکت به‌روزرسانی نمی‌شود.

توابع مرتبط​

ویرایشگرهای نقشه پیشرفته​

منابع مرتبط​