这是本文档旧的修订版！

---

📚 World/Billboard

📒 Property

📘 billboard.ID

获取展示牌序列ID，每个实例ID是唯一的。

当之前的实例被销毁后，空闲的靠前ID将会被后续新实例重新使用（对于特殊情况，UUID是更合适的筛选选择）。

billboard.ID: int

📘 billboard.UUID

获取展示牌UUID，这是由一串较长的字符串组成的全局唯一文本ID。

billboard.UUID: string

📘 billboard.Pos

设置展示牌坐标。

billboard.Pos = Vector(0, 0, 0);

📘 billboard.World

设置展示牌实例世界ID（不同世界将不可视\不可交互）。

billboard.World = 0; //int

📘 billboard.Type

获取展示牌实例类型，不同类型的展示牌有不同的作用和特定属性。

Billboard.Type: int

📘 billboard.Color

设置展示牌实例对象颜色，不同的Type对象有不同的默认值（例如Sprite: 白色；Bubble: 黑色；ProgressBar: 蓝色）。

注意：这里所设置的颜色目标不一定是想象中的目标，比如Bubble设置的颜色其实是【气泡背景颜色】，如果想修改文本颜色请使用TextUBB颜色代码。

billboard.Color = Color(255, 255, 255); //Color

📘 billboard.Alpha

设置展示牌实例透明度，默认为255。

billboard.Alpha = 255; //int

📘 billboard.Scale

设置展示牌实例尺寸缩放（比例），默认尺寸比例是1.0。

billboard.Scale = 1.0; //float

📘 billboard.Baffle

设置展示牌是否存在遮挡逻辑，默认为false，如果设置true将作为一个物体，可以被其他物体遮挡。

billboard.Baffle = false; //bool

📘 billboard.Collision

设置展示牌是否存在碰撞逻辑，默认为false，通常情况下不需要进行修改。

billboard.Collision = false; //bool

📘 billboard.Target

设置展示牌跟随绑定对象，默认为null。

billboard.Target = null; //Entity（Character\Vehicle等）

📘 billboard.Offset

设置展示牌本地坐标偏移，默认为Vector(0, 0, 0)。

如果想实现角色头顶显示名字，可以先绑定Target然后将偏移高度增加（例如Vector(0, 2, 0)）。

billboard.Offset = Vector(0, 0, 0);

📘 billboard.Sprite

设置展示牌显示图片（只在Type: 0模式生效），设置-1则不显示图片。

billboard.Sprite = 0; //int（基于Store/Texture资源机制）

📘 billboard.Text

设置展示牌显示气泡文本（只在Type: 1模式生效）。

billboard.Text = "Hello World!"; //string

📘 billboard.ProgressType

设置展示牌显示进度条样式（只在Type: 2模式生效）。

billboard.ProgressType = 0; //int

📘 billboard.Progress

设置展示牌显示进度条进度百分比（只在Type: 2模式生效），设置范围0.0~1.0。

billboard.Progress = 0.0; //float

📘 billboard.MaxProgress

设置展示牌显示进度条最大进度（只在Type: 2模式生效）。

billboard.MaxProgress = 0.0; //float

📒 Static Function

📘 Billboard.Create()

生成一个新的展示牌实例，Type类型样式参考Billboard.Type属性介绍。

function Billboard.Create( type: int, pos: Vector ): Billboard

//在0点坐标处，建立一个类型为0展示牌实例
let newBB = Billboard.Create(0, Vector(0, 0, 0));
//建立完成后，还需要根据其Type类型为其添加其他属性
newBB.Sprite = 0; //因为是Type0（图片）类型，所以设置Sprite属性为0号图片

📘 Billboard.Find()

寻找一个展示牌实例（通过ID），不存在则返回null。

function Billboard.Find( id: int ): Billboard

📘 Billboard.FindByUUID()

寻找一个展示牌实例（通过UUID），不存在则返回null。

function Billboard.FindByUUID( uuid: string ): Billboard

📘 Billboard.FindByIndex()

寻找一个展示牌实例（通过索引），不存在则返回null。

function Billboard.FindByIndex( index: int ): Billboard

📘 Billboard.GetCount()

获取当前所有存在展示牌数量（不包括静态对象）。

function Billboard.GetCount(): int

📒 Function

📘 billboard.Remove()

销毁当前展示牌实例。

function billboard.Remove()