---
title: "TextDrawCreate | open.mp"
description: "یک textdraw ایجاد کنید."
canonical: https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawCreate
language: fa
---

# TextDrawCreate

## توضیحات

یک textdraw ایجاد کنید. Textdraw ها، همانطور که از نام مشخص است، متن (عمدتاً - می‌تواند جعبه‌ها، اسپرایت‌ها و پیش‌نمایش مدل‌ها (اسکین‌ها/خودروها/اسلحه‌ها/اشیاء هم) هستند که روی صفحه‌های بازیکنان رسم می‌شوند. برای اطلاعات کامل درباره textdraw ها این صفحه را ببینید.

| نام | توضیحات |
| --- | --- |
| Float:x | مختصات X (چپ/راست) برای ایجاد textdraw. |
| Float:y | مختصات Y (بالا/پایین) برای ایجاد textdraw. |
| const format\[\] | متنی که در textdraw ظاهر می‌شود. |
| OPEN\_MP\_TAGS:... | تعداد نامحدودی از آرگومان‌های هر تگ. |

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

شناسه textdraw ایجاد شده.

شناسه‌های Textdraw از **0** شروع می‌شوند.

## مثال‌ها

```c
// این متغیر برای ذخیره شناسه textdraw استفاده می‌شود
// تا بتوانیم در سراسر اسکریپت از آن استفاده کنیم
new Text:gMyTextdraw;

public OnGameModeInit()
{
    // این خط برای ایجاد textdraw استفاده می‌شود.
    // نکته: این یک textdraw بدون هیچ قالب‌بندی ایجاد می‌کند.
    gMyTextdraw = TextDrawCreate(240.0, 580.0, "Welcome to my OPEN.MP server");
    return 1;
}

public OnPlayerConnect(playerid)
{
    // این برای نشان دادن textdraw به بازیکن هنگام اتصال استفاده می‌شود.
    TextDrawShowForPlayer(playerid, gMyTextdraw);
    return 1;
}
```

## نکته‌ها

یادداشت

-   مختصات `x, y` مختصات بالا سمت چپ برای ناحیه text draw بر اساس "بوم" 640x480 است (بدون توجه به رزولوشن صفحه). اگر قصد استفاده از [TextDrawAlignment](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawAlignment) با چینش 3 (`TEXT_DRAW_ALIGN_RIGHT`) را دارید، مختصات `x, y` مختصات بالا سمت راست برای text draw است.
-   این تابع فقط textdraw را ایجاد می‌کند، باید از [TextDrawShowForPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawShowForPlayer) یا [TextDrawShowForAll](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawShowForAll) برای نمایش آن استفاده کنید.

نکته

توصیه می‌شود هنگام ایجاد textdraw ها از اعداد کامل به جای موقعیت‌های اعشاری استفاده کنید تا طراحی سازگار با رزولوشن اطمینان حاصل شود.

هشدار

کدهای mapping کلیدهای صفحه کلید (مانند `~k~~VEHICLE_ENTER_EXIT~`) بعد از کاراکتر 255 کار نمی‌کنند.

## توابع مرتبط

-   [TextDrawDestroy](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawDestroy): حذف یک textdraw.
-   [TextDrawColor](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawColor): تنظیم رنگ متن در یک textdraw.
-   [TextDrawBoxColor](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawBoxColor): تنظیم رنگ جعبه در یک textdraw.
-   [TextDrawBackgroundColor](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawBackgroundColor): تنظیم رنگ پس‌زمینه یک textdraw.
-   [TextDrawAlignment](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawAlignment): تنظیم چینش یک textdraw.
-   [TextDrawFont](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawFont): تنظیم فونت یک textdraw.
-   [TextDrawLetterSize](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawLetterSize): تنظیم اندازه حروف متن در یک textdraw.
-   [TextDrawTextSize](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawTextSize): تنظیم اندازه جعبه textdraw.
-   [TextDrawSetOutline](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawSetOutline): انتخاب اینکه آیا متن حاشیه دارد یا نه.
-   [TextDrawSetShadow](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawSetShadow): تغییر وضعیت سایه‌ها روی یک textdraw.
-   [TextDrawSetProportional](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawSetProportional): تنظیم فاصله متن در یک textdraw به نسبت متناسب.
-   [TextDrawUseBox](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawUseBox): تغییر وضعیت اینکه آیا textdraw جعبه دارد یا نه.
-   [TextDrawSetString](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawSetString): تنظیم متن در یک textdraw موجود.
-   [TextDrawShowForPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawShowForPlayer): نمایش textdraw برای بازیکن خاص.
-   [TextDrawHideForPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawHideForPlayer): مخفی کردن textdraw برای بازیکن خاص.
-   [TextDrawShowForAll](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawShowForAll): نمایش textdraw برای همه بازیکنان.
-   [TextDrawHideForAll](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawHideForAll): مخفی کردن textdraw برای همه بازیکنان.
-   [IsTextDrawVisibleForPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/IsTextDrawVisibleForPlayer): بررسی اینکه آیا textdraw برای بازیکن نمایش داده می‌شود.
-   [IsValidTextDraw](https://omp.itsneufox.com/fa/docs/scripting/functions/IsValidTextDraw): بررسی اینکه آیا textdraw معتبر است.
-   [TextDrawGetAlignment](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetAlignment): دریافت چینش متن یک textdraw.
-   [TextDrawGetBackgroundColour](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetBackgroundColour): دریافت رنگ پس‌زمینه یک textdraw.
-   [TextDrawGetBoxColour](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetBoxColour): دریافت رنگ جعبه یک textdraw.
-   [TextDrawGetColour](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetColour): دریافت رنگ متن یک textdraw.
-   [TextDrawGetFont](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetFont): دریافت فونت متن یک textdraw.
-   [TextDrawGetLetterSize](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetLetterSize): دریافت عرض و ارتفاع حروف.
-   [TextDrawGetOutline](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetOutline): دریافت ضخامت حاشیه متن textdraw.
-   [TextDrawGetPos](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetPos): دریافت موقعیت یک textdraw.
-   [TextDrawGetPreviewModel](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetPreviewModel): دریافت مدل پیش‌نمایش یک textdraw پیش‌نمایش 3D.
-   [TextDrawGetPreviewRot](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetPreviewRot): دریافت چرخش و زوم یک textdraw پیش‌نمایش مدل 3D.
-   [TextDrawGetPreviewVehCol](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetPreviewVehCol): دریافت رنگ‌های خودروی پیش‌نمایش یک textdraw پیش‌نمایش 3D.
-   [TextDrawGetPreviewVehicleColours](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetPreviewVehicleColours): دریافت رنگ‌های خودروی پیش‌نمایش یک textdraw پیش‌نمایش 3D.
-   [TextDrawGetShadow](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetShadow): دریافت اندازه سایه متن textdraw.
-   [TextDrawGetString](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetString): دریافت متن یک textdraw.
-   [TextDrawGetTextSize](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawGetTextSize): دریافت محور X و محور Y textdraw.
-   [TextDrawIsBox](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawIsBox): بررسی اینکه آیا textdraw جعبه است.
-   [TextDrawIsProportional](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawIsProportional): بررسی اینکه آیا textdraw متناسب است.
-   [TextDrawIsSelectable](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawIsSelectable): بررسی اینکه آیا textdraw قابل انتخاب است.
-   [TextDrawSetPos](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawSetPos): تنظیم موقعیت یک textdraw.
-   [TextDrawSetStringForPlayer](https://omp.itsneufox.com/fa/docs/scripting/functions/TextDrawSetStringForPlayer): تغییر متن روی textdraw برای بازیکن خاص.

## منابع مرتبط

-   [اسپرایت‌های TextDraw](https://omp.itsneufox.com/fa/docs/scripting/resources/textdrawsprites)