位图 (TeaScript)
TeaScript/Bitmap
bitmap(index).name,是位图的一个属性,一般用于调整当前关卡或玩家屏幕上创建的位图。
用法
读取某个值:bitmap(index).name
修改某个值:bitmap(index).name = value
在TeaScript脚本里,使用call BmpCreate(id, picid, flag1, flag2, sx, sy, sw, sh, dx, dy, scx, scy, pcx, pcy, angle, color)函数创建一个图像。
call BmpCreate(id, picid, flag1, flag2, sx, sy, sw, sh, dx, dy, scx, scy, pcx, pcy, angle, color)
'ID - 表示位图对象的唯一ID。如果未使用ID,该函数将创建一个新的位图,否则将不会发生任何事情。
'picid - 用作位图源的NPC的ID,使用NPC图像文件名中的数字作为ID。
'flag1 - 设置为0,坐标将以关卡坐标系为准;设置为1,则以屏幕为准。
'flag2 - 将其设置为0,将隐藏创建的位图。将此设置为1,位图将可见。
'sx - 表示位图源文件中左上角点的x坐标。
'sy - 表示位图源文件中左上角点的y坐标。
'sw - 表示裁剪后的位图的宽度。
'sh - 表示裁剪后的位图的高度。
'dx - 表示所显示位图的x坐标。
'dy - 表示所显示位图的y坐标。
'scx - 表示横向拉伸比。预设值为1。
'scy - 表示纵向拉伸比。预设值为1。
'pcx - 表示在拉伸和旋转中使用的中心点的x坐标。
'pcy - 表示在拉伸和旋转中使用的中心点的y坐标。
'angle - 表示位图的旋转角度。
'color - 颜色的int值,也可以用rgba,后续可以使用forecolor_x等调整。
更多信息请访问 BmpCreate (函数) 查看。
参数
基础
| 参数名 | 数据类型 | 介绍 |
|---|---|---|
destx
|
double | 位图的X坐标(受创建函数参数flag1影响。)
|
desty
|
double | 位图的Y坐标(受创建函数参数flag1影响。)
|
scalex
|
double | 位图的水平缩放大小 |
scaley
|
double | 位图的垂直缩放大小 |
rotating
|
double | 位图的旋转角度 |
行为
| 参数名 | 数据类型 | 介绍 |
|---|---|---|
attscreen
|
double | 位图的相对位置参数,0为关卡场景,1为玩家屏幕。 |
scrx
|
double | 位图所使用的源文件左上角的X坐标。 |
scry
|
double | 位图所使用的源文件左上角的Y坐标。 |
scrwidth
|
double | 位图所使用的源文件裁剪的长度。 |
scrheight
|
double | 位图所使用的源文件裁剪的高度。 |
rotatx
|
double | 位图缩放和旋转的中心点x坐标。 |
rotaty
|
double | 位图缩放和旋转的中心点y坐标。 |
图像
| 参数名 | 数据类型 | 介绍 |
|---|---|---|
hide
|
double | 1为隐藏,0为显示。 |
scrid
|
double | 位图所使用的源文件对应的 NPC ID。 |
zpos
|
double | 位图的 z-index 坐标(为0~1区间)(0为最靠前景,1为最靠背景。) |
forecolor
|
double | 位图的颜色,使用rgba(red, green, blue, alpha)或整数值控制,默认为-1。(0为完全透明,)
|
forecolor_r
|
double | 位图的 rgba 前景色中的红色通道的数值。 |
forecolor_g
|
double | 位图的 rgba 前景色中的绿色通道的数值。 |
forecolor_b
|
double | 位图的 rgba 前景色中的蓝色通道的数值。 |
forecolor_a
|
double | 位图的 rgba 前景色中的 alpha(即透明度) 通道的数值。 |
| 请注意,这里以下所有的条目均以 SMBX 1.4.5 Patch 31.1 为基底。 | |
|---|---|
| 基础 | 语法 | 函数 | 回调型函数 |
| 组件 | BGP (大背景) | 背景物件 | 位图 | 方块 | 角色 | 特效 | 流体 | 计时器 | NPC | 文本 | 传送点 | 系统变量 |
| 技术性 | 额外值 | BSet 函数 | Playnote 函数 | 特殊图层 | 未知函数 | 自动运行事件 | 编辑器函数 |