---
title: "CreatePlayerTextDraw | open.mp"
description: "为单个玩家创建文本绘图，用于规避全局文本绘图数量限制。"
canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/CreatePlayerTextDraw
language: zh-CN
---

# CreatePlayerTextDraw

## 描述

为单个玩家创建文本绘图，用于规避全局文本绘图数量限制。

| 参数 | 说明 |
| --- | --- |
| playerid | 要为其创建文本绘图的玩家 ID |
| Float:x | X 轴坐标 |
| Float:y | Y 轴坐标 |
| const format\[\] | 文本绘图中的格式化文本内容 |
| OPEN\_MP\_TAGS:... | 不定数量的任意类型参数 |

## 返回值

返回创建的文本绘图的 ID

## 示例

```c
// 此变量用于存储文本绘图的ID以便脚本全局调用
new PlayerText:welcomeText[MAX_PLAYERS];

public OnPlayerConnect(playerid)
{
    // 首先创建文本绘图
    welcomeText[playerid] = CreatePlayerTextDraw(playerid, 320.0, 240.0, "欢迎来到我的OPEN.MP服务器");

    // 立即显示文本绘图
    PlayerTextDrawShow(playerid, welcomeText[playerid]);
    return 1;
}
```

## 注意事项

备注

-   玩家文本绘图会在玩家断开连接时自动销毁

技巧

建议使用整数值而非小数坐标，以确保不同分辨率下的显示兼容性

注意

已知限制：

-   键盘按键映射代码（如 `~k~~VEHICLE_ENTER_EXIT~`）在超过 255 个字符后将失效

## 相关函数

-   [PlayerTextDrawDestroy](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawDestroy): 销毁玩家文本绘图
-   [PlayerTextDrawColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawColor): 设置玩家文本绘图的文本颜色
-   [PlayerTextDrawBoxColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawBoxColor): 设置玩家文本绘图的方框颜色
-   [PlayerTextDrawBackgroundColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawBackgroundColor): 设置玩家文本绘图的背景颜色
-   [PlayerTextDrawAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawAlignment): 设置玩家文本绘图的对齐方式
-   [PlayerTextDrawFont](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawFont): 设置玩家文本绘图的字体样式
-   [PlayerTextDrawLetterSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawLetterSize): 设置玩家文本绘图的字符尺寸
-   [PlayerTextDrawTextSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawTextSize): 设置玩家文本绘图的方框尺寸（或可点击区域）
-   [PlayerTextDrawSetOutline](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawSetOutline): 切换玩家文本绘图的轮廓显示
-   [PlayerTextDrawSetShadow](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawSetShadow): 设置玩家文本绘图的阴影效果
-   [PlayerTextDrawSetProportional](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawSetProportional): 启用玩家文本绘图的比例间距
-   [PlayerTextDrawUseBox](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawUseBox): 切换玩家文本绘图的方框显示
-   [PlayerTextDrawSetString](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawSetString): 更新玩家文本绘图的文本内容
-   [PlayerTextDrawShow](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawShow): 显示玩家文本绘图
-   [PlayerTextDrawHide](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawHide): 隐藏玩家文本绘图
-   [IsPlayerTextDrawVisible](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsPlayerTextDrawVisible): 检测玩家文本绘图是否可见
-   [IsValidPlayerTextDraw](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidPlayerTextDraw): 验证玩家文本绘图是否有效
-   [PlayerTextDrawBackgroundColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawBackgroundColour): 调整玩家文本绘图的背景色彩
-   [PlayerTextDrawBoxColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawBoxColour): 设置玩家文本绘图的方框色彩
-   [PlayerTextDrawColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawColour): 设置玩家文本绘图的文本色彩
-   [PlayerTextDrawGetAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetAlignment): 获取玩家文本绘图的对齐方式
-   [PlayerTextDrawGetBackgroundColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetBackgroundColour): 获取玩家文本绘图的背景色彩
-   [PlayerTextDrawGetBoxColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetBoxColour): 获取玩家文本绘图的方框色彩
-   [PlayerTextDrawGetColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetColour): 获取玩家文本绘图的文本色彩
-   [PlayerTextDrawGetFont](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetFont): 获取玩家文本绘图的字体样式
-   [PlayerTextDrawGetLetterSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetLetterSize): 获取玩家文本绘图的字符尺寸
-   [PlayerTextDrawGetOutline](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetOutline): 获取玩家文本绘图的轮廓尺寸
-   [PlayerTextDrawGetPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetPos): 获取玩家文本绘图的坐标位置
-   [PlayerTextDrawGetPreviewModel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetPreviewModel): 获取 3D 预览玩家文本绘图的模型 ID
-   [PlayerTextDrawGetPreviewRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetPreviewRot): 获取 3D 模型预览玩家文本绘图的旋转角度
-   [PlayerTextDrawGetPreviewVehicleColours](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetPreviewVehicleColours): 获取 3D 预览玩家文本绘图的车辆颜色
-   [PlayerTextDrawGetShadow](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetShadow): 获取玩家文本绘图的阴影尺寸
-   [PlayerTextDrawGetString](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetString): 获取玩家文本绘图的文本内容
-   [PlayerTextDrawGetTextSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawGetTextSize): 获取玩家文本绘图的文本尺寸
-   [PlayerTextDrawIsBox](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawIsBox): 检测玩家文本绘图是否包含方框
-   [PlayerTextDrawIsProportional](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawIsProportional): 检测玩家文本绘图是否启用比例间距
-   [PlayerTextDrawIsSelectable](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawIsSelectable): 检测玩家文本绘图是否可交互
-   [PlayerTextDrawSetPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawSetPos): 设置玩家文本绘图的位置坐标
-   [PlayerTextDrawSetPreviewVehicleColours](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/PlayerTextDrawSetPreviewVehicleColours): 设置玩家文本绘图车辆模型预览的颜色

## 相关资源

-   [文本绘图精灵列表](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/textdrawsprites)
