--- title: "TextDrawCreate | open.mp" description: "创建文本绘图" canonical: https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawCreate language: zh-CN --- # TextDrawCreate ## 描述 创建文本绘图。文本绘图（正如其名）是绘制在玩家屏幕上的文字元素（主要形式），也可包含方框、精灵和模型预览（皮肤/车辆/武器/物体等）。详见[文本绘图专题页面](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/textdrawsprites)获取详细信息。 | 参数 | 说明 | | --- | --- | | Float:x | 文本绘图的横向坐标（基于 640x480 基准坐标系） | | Float:y | 文本绘图的纵向坐标（基于 640x480 基准坐标系） | | const format\[\] | 文本绘图的显示内容（支持格式化字符串） | | OPEN\_MP\_TAGS:... | 不定数量的参数（支持任意标签类型） | ## 返回值 创建的文本绘图 ID（从**0**开始递增） ## 示例 ```c // 此变量用于存储文本绘图ID // 以便在脚本中全局使用 new Text:gMyTextdraw; public OnGameModeInit() { // 创建文本绘图 // 注意：此示例创建无格式化的基础文本 gMyTextdraw = TextDrawCreate(240.0, 580.0, "欢迎来到我的OPEN.MP服务器"); return 1; } public OnPlayerConnect(playerid) { // 当玩家连接时显示文本绘图 TextDrawShowForPlayer(playerid, gMyTextdraw); return 1; } ``` ## 注意事项 备注 - `x, y`坐标基于 640x480 虚拟画布定位（与屏幕分辨率无关），表示文本区域左上角坐标若使用[TextDrawAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawAlignment)设置右对齐（`TEXT_DRAW_ALIGN_RIGHT`），`x, y`将作为文本区域的右上角坐标 - 此函数仅创建文本绘图，需调用[TextDrawShowForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForPlayer)或[TextDrawShowForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForAll)方可显示 技巧 建议使用整数值而非小数坐标，以确保不同分辨率下的显示兼容性 注意 键盘按键映射代码（如`~k~~VEHICLE_ENTER_EXIT~`）在第 255 个字符后失效 ## 相关函数 - [TextDrawDestroy](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawDestroy): 销毁文本绘图 - [TextDrawColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawColor): 设置文本颜色 - [TextDrawBoxColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBoxColor): 设置方框颜色 - [TextDrawBackgroundColor](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawBackgroundColor): 设置背景颜色 - [TextDrawAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawAlignment): 设置对齐方式 - [TextDrawFont](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawFont): 设置字体类型 - [TextDrawLetterSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawLetterSize): 设置字符尺寸 - [TextDrawTextSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawTextSize): 设置文本区域尺寸 - [TextDrawSetOutline](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetOutline): 设置文字描边 - [TextDrawSetShadow](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetShadow): 设置阴影效果 - [TextDrawSetProportional](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetProportional): 启用比例间距 - [TextDrawUseBox](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawUseBox): 切换方框显示 - [TextDrawSetString](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetString): 更新文本内容 - [TextDrawShowForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForPlayer): 为玩家显示 - [TextDrawHideForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawHideForPlayer): 为玩家隐藏 - [TextDrawShowForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawShowForAll): 全局显示 - [TextDrawHideForAll](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawHideForAll): 全局隐藏 - [IsTextDrawVisibleForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsTextDrawVisibleForPlayer): 检测可见性 - [IsValidTextDraw](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/IsValidTextDraw): 验证有效性 - [TextDrawGetAlignment](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetAlignment): 获取对齐方式 - [TextDrawGetBackgroundColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetBackgroundColour): 获取背景色 - [TextDrawGetBoxColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetBoxColour): 获取方框颜色 - [TextDrawGetColour](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetColour): 获取文本颜色 - [TextDrawGetFont](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetFont): 获取字体类型 - [TextDrawGetLetterSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetLetterSize): 获取字符尺寸 - [TextDrawGetOutline](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetOutline): 获取描边厚度 - [TextDrawGetPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetPos): 获取坐标位置 - [TextDrawGetPreviewModel](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetPreviewModel): 获取 3D 预览模型 - [TextDrawGetPreviewRot](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetPreviewRot): 获取 3D 模型旋转参数 - [TextDrawGetPreviewVehCol](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetPreviewVehCol): 获取车辆预览颜色 - [TextDrawGetPreviewVehicleColours](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetPreviewVehicleColours): 获取车辆配色方案 - [TextDrawGetShadow](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetShadow): 获取阴影尺寸 - [TextDrawGetString](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetString): 获取文本内容 - [TextDrawGetTextSize](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawGetTextSize): 获取文本区域尺寸 - [TextDrawIsBox](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawIsBox): 检测方框状态 - [TextDrawIsProportional](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawIsProportional): 检测比例间距 - [TextDrawIsSelectable](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawIsSelectable): 检测可选状态 - [TextDrawSetPos](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetPos): 设置坐标位置 - [TextDrawSetStringForPlayer](https://omp.itsneufox.com/zh-CN/docs/scripting/functions/TextDrawSetStringForPlayer): 玩家专属文本更新 ## 相关资源 - [文本绘图精灵使用指南](https://omp.itsneufox.com/zh-CN/docs/scripting/resources/textdrawsprites)