Display
出自嗶哩嗶哩百科
概术
包括了舞台弹幕的操作 可使用别名$
fullScreenWidth
fullScreenWidth:uint [只读]
- 返回变为全屏大小时使用的显示器宽度（如果立即进入该状态）。如果用户有多台显示器，则使用的显示器是此时显示大部分舞台的显示器。
- 注意：在检索值和变为全屏大小之间，如果用户有机会将浏览器从一台显示器移到另一台显示器，则该值可能不正确。
示例
trace("当前屏幕大小:"+Display.screenWidth+"x"+Display.screenHeight);
fullScreenHeight
fullScreenHeight:uint [只读]
- 返回变为全屏大小时使用的显示器高度（如果立即进入该状态）。如果用户有多台显示器，则使用的显示器是此时显示大部分舞台的显示器。
- 注意：在检索值和变为全屏大小之间，如果用户有机会将浏览器从一台显示器移到另一台显示器，则该值可能不正确。
示例
trace("当前屏幕大小:"+Display.screenWidth+"x"+Display.screenHeight);
width
width:Number [只读]
- 指示显示对象的宽度，以像素为单位。
height
height:Number [只读]
- 指示显示对象的高度，以像素为单位。
createMatrix
public function createMatrix():Matrix;
- 使用指定参数创建新的 [Matrix] 对象。
返回
- Matrix －创建的 [Matrix] 对象。
示例
var g = $.createShape({x:0,y:0,lifeTime:3});
var colors = [0xFF0000, 0x0000FF];
var alphas = [1, 1];
var ratios = [0x00, 0xFF];
var matr = $.createMatrix();
matr.createGradientBox(20, 20, 0, 0, 0);
g.graphics.beginGradientFill("linear", colors, alphas, ratios, matr, "pad");
g.graphics.drawRect(0,0,100,100);
createPoint
public function createPoint(x:Number = 0, y:Number = 0);
- 使用指定参数创建新的 [Point] 对象。
返回
- Point －创建的 [Point] 对象。
createComment
public function createComment(text:String,param:Object):CommentField
- 使用指定参数创建新的弹幕对象。
参数
- text — 弹幕对象中的文字信息。
- param — 创建参数 请参阅 Display#通用创建参数
返回
- CommentField — 新创建的弹幕对象
示例
- 以下示例为创建一个内容为 ● 的弹幕，存活在屏幕中五秒 其中移动时间3秒
$.createComment("●",{
motion:{
x:{ fromValue: 4, toValue: 320, lifeTime: 2, startDelay:600, easing:"None"}, /** x 显示后延迟0.3秒 动态移动0.5秒 不使用加速算法 **/
y:{ fromValue: 30, toValue: 360, lifeTime:1.5, easing:"Linear"} /**y 动态移动时间 3秒 **/
},
lifeTime: 5 /** 总存活时间 5秒 */,
color:Utils.hue(50+bi++*5),
alpha:0.8
});
- 以下示例会创建一个元件，内容为当前播放时间，存活十秒内会不断变化文字大小、色彩、位置及透明度
var a = $.createComment("----",{x:150,y:150,lifeTime:10});
var iu=0;
interval(function(){ a.textColor=Utils.hue(10*iu++); a.alpha=0.2+iu%7/10; a.htmlText="CURRENT:"+Utils.formatTimes(Player.time/1000); a.fontsize=iu*2; a.x+=Math.random()*20-10; a.y+=Utils.rand(-10,10); a.rotationZ=Utils.rand(0,90);},50,200);
- 以下示例会创建一个元件，内容为TEST，存活5秒内会渐显，然后移动X轴并渐隐
$.createComment("test",{x:50,y:50,lifeTime:5,alpha:0,motionGroup:[
{alpha: {fromValue:0,toValue:1,lifeTime:1}},
{alpha: {fromValue:1,toValue:0.2,lifeTime:1},x:{fromValue:50,toValue:250,lifeTime:1}}
]});
createShape
public function createShape(text:String,param:Object):Shape
- 使用指定参数创建新的图型对象。
参数
- param — 创建参数 请参阅 Display#通用创建参数
返回
- Shape— 新创建的图型对象 创建图型请参阅Display.createGraphic.graphics
示例
- 下面的示例在显示对象注册点 (0, 0) 右侧 250 个像素的位置绘制一个绿色圆形对象，宽度和高度为 100 个像素。 绘制 4 条曲线以生成一个圆，并将其填充为绿色。
var g = $.createShape({lifeTime:2,x:10,y:250});
g.graphics.beginFill(0xFFCC00);
g.graphics.moveTo(250, 0);
g.graphics.curveTo(300, 0, 300, 50);
g.graphics.curveTo(300, 100, 250, 100);
g.graphics.curveTo(200, 100, 200, 50);
g.graphics.curveTo(200, 0, 250, 0);
g.graphics.endFill();
- 下面的示例绘制一个矩形和一个圆，它们使用从红色到绿色、再到蓝色的渐变笔触。
var g = $.createShape({lifeTime:3,x:50});
g.graphics.beginGradientFill("linear", [0xFF0000, 0x00FF00, 0x0000FF],[1,1,1],[0x00,0x7f,0xff] , $.createGradientBox(200, 40, 0, 0, 0));
g.graphics.drawRect(0,0,200,40);
g.graphics.drawCircle(100, 120, 50);
g.graphics.endFill();
- 以下示例会创建一个元件，内容为当前播放时间，存活十秒内会不断变化文字大小、色彩、位置及透明度
var a = $.createComment("----",{x:150,y:150,lifeTime:10});
var iu=0;
interval(function(){ a.textColor=Utils.hue(10*iu++); a.alpha=0.2+iu%7/10; a.htmlText="CURRENT:"+Utils.formatTimes(Player.time/1000); a.fontsize=iu*2; a.x+=Math.random()*20-10; a.y+=Utils.rand(-10,10); a.rotationZ=Utils.rand(0,90);},50,200);
createCanvas
public function createCanvas(text:String,param:Object):CommentCanvas
- 使用指定参数创建新的容器。
参数
- param — 创建参数 请参阅 Display#通用创建参数
返回
- CommentCanvas — 新创建的图型容器
示例
var c = $.createCanvas({x:100,y:100});
$.createComment("●",{
motion:{
x:{ fromValue: 4, toValue: 320, lifeTime: 2, startDelay:600, easing:"None"}, /** x 显示后延迟0.3秒 动态移动0.5秒 不使用加速算法 **/
y:{ fromValue: 30, toValue: 360, lifeTime:1.5, easing:"Linear"} /**y 动态移动时间 3秒 **/
},
lifeTime: 5 /** 总存活时间 5秒 */,
color:Utils.hue(50+bi++*5),
alpha:0.8,
parent:c
});
createButton
public function createButton(param:Object):CommentButton
- 使用指定参数创建新的按钮。
参数
- param — 创建参数 请参阅 Display#通用创建参数
- text:String — 按钮标题 创建参数附加值
- onclick:Function — 点击处理函数 创建参数附加值
返回
- CommentButton — 新创建的按钮
示例
a=$.createButton({x:50,y:50,text:"TEST",onclick:function(){
trace("test");
}});
createGlowFilter
public function createGlowFilter(color:uint = 0xFF0000, alpha:Number = 1.0, blurX:Number = 6.0, blurY:Number = 6.0, strength:Number = 2, quality:int = 1, inner:Boolean = false, knockout:Boolean = false):[GlowFilter]
- 用指定参数初始化新的 GlowFilter 实例。
参数
- color:uint (default = 0xFF0000) — 光晕颜色，采用十六进制格式 0xRRGGBB。默认值为 0xFF0000。
- alpha:Number (default = 1.0) — 颜色的 Alpha 透明度值。有效值为 0 到 1。例如，0.25 设置透明度值为 25%。
- blurX:Number (default = 6.0) — 水平模糊量。有效值为 0 到 255（浮点）。2 的乘方值（如 2、4、8、16 和 32）经过优化，呈示速度比其他值更快。
- blurY:Number (default = 6.0) — 垂直模糊量。有效值为 0 到 255（浮点）。2 的乘方值（如 2、4、8、16 和 32）经过优化，呈示速度比其他值更快。
- strength:Number (default = 2) — 印记或跨页的强度。该值越高，压印的颜色越深，而且发光与背景之间的对比度也越强。有效值为 0 到 255。
- quality:int (default = 1) — 应用滤镜的次数。使用 BitmapFilterQuality 常量：
- low
- middle
- high
- 有关详细信息，请参阅 quality 属性的说明。
- inner:Boolean (default = false) — 指定发光是否为内侧发光。值 true 指定发光是内侧发光。值 false 指定发光是外侧发光（对象外缘周围的发光）。
- knockout:Boolean (default = false) — 指定对象是否具有挖空效果。值为 true 将使对象的填充变为透明，并显示文档的背景颜色。。
createBlurFilter
public function createBlurFilter(blurX:Number = 4.0, blurY:Number = 4.0, quality:int = 1):[BlurFilter]
- 用指定参数初始化滤镜。默认值会创建一个柔化的、未聚焦的图像。
参数
- blurX:Number (default = 4.0) — 水平模糊量。有效值为 0 到 255.0（浮点值）。
- blurY:Number (default = 4.0) — 垂直模糊量。有效值为 0 到 255.0（浮点值）。
- quality:int (default = 1) — 应用滤镜的次数。使用 BitmapFilterQuality 常量：
-
- low
- middle
- high
-
-
- 虽然您可以使用不超过 15 的其它数值来达到不同的效果，但是请注意，值越高，呈现速度越慢。
toIntVector
function toIntVector(a:Array):Vector.<int>;
- 转换为vector.<int>
参数
- a:Array — 要转换为vector.<int>的数组
toUIntVector
function toIntVector(a:Array):Vector.<UInt>;
- 转换为vector.<UInt>
参数
- a:Array — 要转换为vector.<UInt>的数组
toNumberVector
function toNumberVector(a:Array):Vector.<Number>;
- 转换为vector.<Number>
参数
- a:Array — 要转换为vector.<Number>的数组
createVector3D
function createVector3D(x:Number=0.0, y:Number=0.0, z:Number=0.0, w:Number=0.0):Vector3D;
- 创建 Vector3D 对象的实例。如果未指定构造函数的参数，则将使用元素 (0,0,0,0) 创建 Vector3D 对象。
参数
- x':Number (default = 0.) — 第一个元素，例如 x 坐标。
- y':Number (default = 0.) — 第二个元素，例如 y 坐标。
- z':Number (default = 0.) — 第三个元素，例如 z 坐标。
- w':Number (default = 0.) — 表示额外数据的可选元素，例如旋转角度。
createMatrix3D
function createMatrix3D(a:*):Matrix3D;
- 创建 Matrix3D 对象。
- 如果未定义任何参数，则构造函数会生成一个恒等或单位 Matrix3D 对象。在矩阵表示法中，恒等矩阵中的主对角线位置上的所有元素的值均为一，而所有其他元素的值均为零。恒等矩阵的 rawData 属性的值为 1,0,0,0,0,1,0,0,0,0,1,0,0,0,0,1。恒等矩阵的位置或平移值为 Vector3D(0,0,0)，旋转设置为 Vector3D(0,0,0)，缩放值为 Vector3D(1,1,1)。
参数
- a:* — 用于初始化的Array或者Vector.<Number>。一个由 16 个数字组成的矢量，其中，每四个元素可以是 4x4 矩阵的一列。
createColorTransform
function createColorTransform(redMultiplier:Number = 1.0, greenMultiplier:Number = 1.0, blueMultiplier:Number = 1.0, alphaMultiplier:Number = 1.0, redOffset:Number = 0, greenOffset:Number = 0, blueOffset:Number = 0, alphaOffset:Number = 0):ColorTransform;
- 用指定的颜色通道值和 Alpha 值为显示对象创建 ColorTransform 对象。
参数
- redMultiplier:Number (default = 1.0) — 红色乘数的值，在 0 到 1 范围内。
- greenMultiplier:Number (default = 1.0) — 绿色乘数的值，在 0 到 1 范围内。
- blueMultiplier:Number (default = 1.0) — 蓝色乘数的值，在 0 到 1 范围内。
- alphaMultiplier:Number (default = 1.0) — Alpha 透明度乘数的值，在 0 到 1 范围内。
- redOffset:Number (default = 0) — 红色通道值的偏移量，在 -255 到 255 范围内。
- greenOffset:Number (default = 0) — 绿色通道值的偏移量，在 -255 到 255 范围内。
- blueOffset:Number (default = 0) — 蓝色通道值的偏移量，在 -255 到 255 范围内。
- alphaOffset:Number (default = 0) — Alpha 透明度通道值的偏移量，在 -255 到 255 范围内。
createTextFormat
function createTextFormat(font:String = null, size:Object = null, color:Object = null, bold:Object = null, italic:Object = null, underline:Object = null, url:String = null, target:String = null, align:String = null, leftMargin:Object = null, rightMargin:Object = null, indent:Object = null, leading:Object = null):TextFormat;
- 创建一个具有指定属性的 TextFormat 对象。然后可更改 TextFormat 对象的属性以更改文本字段的格式设置。
- 任何参数都可设置为 null 以表示该参数未定义。所有参数都是可选的；任何省略的参数都被视为 null。
参数
- font:String (default = null) — 以字符串形式表示的文本字体名称。
- size:Object (default = null) — 一个表示大小（以像素为单位）的整数。
- color:Object (default = null) — 使用此文本格式的文本的颜色。包含三个 8 位 RGB 颜色成分的数字；例如，0xFF0000 为红色，0x00FF00 为绿色。
- bold:Object (default = null) — 一个布尔值，表示文本是否为粗体字。
- italic:Object (default = null) — 一个布尔值，表示文本是否为斜体。
- underline:Object (default = null) — 一个布尔值，表示文本是否带有下划线。
- url:String (default = null) — 使用此文本格式的文本超链接到的 URL。如果 url 为空字符串，则表示文本没有超链接。
- target:String (default = null) — 显示超链接的目标窗口。如果目标窗口为空字符串，则文本显示在默认目标窗口 _self 中。如果 url 参数设置为空字符串或值 null，虽然您可以获取或设置此属性，但该属性不起作用。
- align:String (default = null) — 段落的对齐方式，作为 TextFormatAlign 值。
- leftMargin:Object (default = null) — 表示段落的左边距，以像素为单位。
- rightMargin:Object (default = null) — 表示段落的右边距，以像素为单位。
- indent:Object (default = null) — 一个整数，表示从左边距到段落中第一个字符的缩进。
- leading:Object (default = null) — 一个数字，表示行与行之间的前导垂直间距量。
通用创建参数
Object
参数
- x — 新创建元件的X轴座标
- y — 新创建元件的Y轴座标
- lifeTime — 元件的生存时间
- alpha — 元件的透明度
- color — 文字类元件的色彩
- fontsize — 文字类元件的大小
- parent — 元件的父元件 可选 (进阶应用)
- motion — 元件移动策略 可选
- 可选属性 x, y, alpha, rotationZ, rotationY
- 属性值
| 类型 | 值 | 用途 |
|---|---|---|
| 必填 | fromValue | 起始移动属性值 |
| 可选 | toValue | 结束移动属性值 如留空则不移动 |
| 可选 | lifeTime | 以秒为单位的移动生存时间 如留空则与整体生存时间一致 |
| 可选 | startDelay | 以毫秒为单位的起始移动延时时间 |
| 可选 | easing | 补间效果[1] 值：None, Back, Bounce, Circular, Cubic, Elastic, Exponential, Sine, Quintic, Linear |
| 可选 | repeat | 效果重复次数 |
- motionGroup — 元件移动策略组 可选 此选项填写后motion将失效 此属性为motion数组
