meta data for this page
  •  

📚 差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录前一修订版
后一修订版		前一修订版
scripting:world:billboard [2023/09/11 00:13] – bibiboxsscripting:world:billboard [2025/08/09 06:12] (当前版本) – bibiboxs
行 49: 行 49:
  
 ```javascript ```javascript
-Billboard.Type: int+billboard.Type: int
 ``` ```
  
行 62: 行 62:
 ### billboard.Color ### billboard.Color
  
-> 设置展示牌实例对象颜色，不同的`Type`对象有不同的默认值（例如`Sprite: 白色；Bubble: 黑色；ProgressBar: 蓝色`）。+> 设置展示牌实例对象颜色，不同的`Type`对象有不同的默认值（例如`Sprite: White；Bubble: Black；ProgressBar: Blue`）。
 > >
 > *注意：这里所设置的颜色目标不一定是想象中的目标，比如`Bubble`设置的颜色其实是【气泡背景颜色】，如果想修改文本颜色请使用`Text`UBB颜色代码。* > *注意：这里所设置的颜色目标不一定是想象中的目标，比如`Bubble`设置的颜色其实是【气泡背景颜色】，如果想修改文本颜色请使用`Text`UBB颜色代码。*
  
 ```javascript ```javascript
-billboard.Color = Color(255, 255, 255); //Color+billboard.Color = Color(255, 255, 255, 255); //Color
 ``` ```
  
行 74: 行 74:
 ### billboard.Alpha ### billboard.Alpha
  
-> 设置展示牌实例透明度，默认为`255`。+> 设置展示牌实例整体透明度，默认为`255`。
  
 ```javascript ```javascript
行 94: 行 94:
 ### billboard.Baffle ### billboard.Baffle
  
-> 设置展示牌是否存在遮挡逻辑，默认为`false`，如果设置`true`将作为一个物体，可以被其他物体遮挡。+> 设置展示牌是否存在遮挡逻辑，默认为`true`，如果设置`false`将不会被其他物体遮挡（超过一定渲染距离后仍然不可见）。
  
 ```javascript ```javascript
-billboard.Baffle = false; //bool+billboard.Baffle = true; //bool
 ``` ```
  
行 146: 行 146:
 ### billboard.Text ### billboard.Text
  
-> 设置展示牌显示气泡文本（只在`Type: 1`模式生效）。+> 设置展示牌显示气泡文本（只在可附带文本的组件生效，例如图片组件则是无效的）。
  
 ```javascript ```javascript
行 187: 行 187:
 ```javascript ```javascript
 billboard.MaxProgress = 0.0; //float billboard.MaxProgress = 0.0; //float
 +```
 +
 +
 +
 +### billboard.Target
 +
 +> 设置展示牌**跟随目标对象**（优先级最高）。
 +
 +```javascript
 +billboard.Target: Entity
 +```
 +
 +
 +
 +### billboard.TargetPos
 +
 +> 设置展示牌**跟随目标坐标**，默认为`Vector(0, 0, 0)`。
 +
 +```javascript
 +billboard.TargetPos: Vector
 +```
 +
 +
 +### billboard.Match
 +
 +> 设置展示牌**白名单匹配**表达式。
 +> 
 +> 如果表达式字符串不为`null`，则只有表达式内包含的`PlayerID`可见，反之则不可见。这可能用于【玩家头顶名称】对玩家自身不可见等情况。
 +
 +```javascript
 +billboard.Match = ""; //string
 +```
 +
 +```javascript
 +billboard.Match = ""; //All visible
 +billboard.Match = "2"; //Only visible: player id == 2
 +billboard.Match = "2|3|5|7|8"; //visible: player id == 2\3\5\7\8
 ``` ```
  
行 196: 行 233:
  
 > 生成一个新的展示牌实例，`Type`类型样式参考`Billboard.Type`属性介绍。 > 生成一个新的展示牌实例，`Type`类型样式参考`Billboard.Type`属性介绍。
 +> 
 +> 注意：`Billboard`的可见范围是256，如果需要更远的可视距离（通常不需要），请考虑使用`Client/Guider`。
  
 ```javascript ```javascript
-function Billboard.Create( type: int, pos: Vector ): Billboard+function Billboard.Create( type: int, target: Entity | Vector ): Billboard
 ``` ```
  
 ```javascript ```javascript
-//在0点坐标处，建立一个类型为0展示牌实例 
 let newBB = Billboard.Create(0, Vector(0, 0, 0)); let newBB = Billboard.Create(0, Vector(0, 0, 0));
-//建立完成后，还需要根据其Type类型为其添加其他属性 
 newBB.Sprite = 0; //因为是Type0（图片）类型，所以设置Sprite属性为0号图片 newBB.Sprite = 0; //因为是Type0（图片）类型，所以设置Sprite属性为0号图片
 ``` ```
行 212: 行 249:
 ### Billboard.CreateTips() ### Billboard.CreateTips()
  
-> 生成一个**小文本气泡**实例（类似**【血量-10】**的气泡样式）。+> 生成一个**小文本气泡**实例（类似**【血量-10】**的气泡样式），这是一个**本地静态**实例，因此没有返回值。
  
 ```javascript ```javascript
-function Billboard.CreateTips( text： string, pos: Vector3, time: float = 3f, hasBG: bool = true, hasRotate: bool = true) +function Billboard.CreateTips( text: string, pos: Vector, time: float = 3, scale: float = 1, hasBG: bool = true, hasRotate: bool = true )
-/* +
- text：文本内容 +
- pos：世界坐标 +
- time：显示时间（自动销毁） +
- hasBG：是否显示黑色背景（默认开启） +
- hasRotate：是否随机角度（默认开启） +
-*/+
 ``` ```
 +
 +- **`text`：**文本内容
 +- **`pos`：**世界坐标
 +- **`time`：**显示时间（自动销毁）
 +- **`scale`：**尺寸缩放（相对于屏幕尺寸，而非距离远近）
 +- **`hasBG`：**是否显示黑色背景（默认开启）
 +- **`hasRotate`：**是否随机角度（默认开启）
 +
 +
 +
 +### Billboard.CreateSpriteBubble()
 +
 +> 生成一个**图片气泡**实例（可实现表情图片等），这是一个本地静态实例，因此没有返回值。
 +
 +```javascript
 +function Billboard.CreateSpriteBubble( texture: int, pos: Vector, time: float = 3, scale: float = 1, hasBG: bool = true, hasRotate: bool = true )
 +```
 +
 +- **`text`：**文本内容
 +- **`pos`：**世界坐标
 +- **`time`：**显示时间（自动销毁）
 +- **`scale`：**尺寸缩放（相对于屏幕尺寸，而非距离远近）
 +- **`hasBG`：**是否显示黑色背景（默认开启）
 +- **`hasRotate`：**是否随机角度（默认开启）
  
  
行 247: 行 301:
  
  
-### Billboard.FindByIndex()+### Billboard.GetCount()
  
-> 寻找一个展示牌实例（通过索引），不存在则返回`null`。+> 获取当前所有存在展示牌数量（不包括静态对象）。
  
 ```javascript ```javascript
-function Billboard.FindByIndex( index: int ): Billboard+function Billboard.GetCount(): int
 ``` ```
  
  
  
-### Billboard.GetCount()+### Billboard.Get()
  
-> 获取当前所有存在展示牌数量（不包括静态对象）。+> 获取当前存在的指定索引展示牌实例，通常搭配`GetCount()`遍历使用。
  
 ```javascript ```javascript
-function Billboard.GetCount(): int+function Billboard.Get( index: int ): Billboard
 ``` ```
  
行 276: 行 330:
 function billboard.Remove() function billboard.Remove()
 ``` ```
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +