跳到主要内容

egret.Bitmap

    egret

    public class Bitmap

继承     egret.Bitmap → egret.DisplayObjectegret.EventDispatcheregret.HashObject

子类     eui.Image

Bitmap 类表示用于显示位图图片的显示对象。利用 Bitmap() 构造函数,可以创建包含对 BitmapData 对象引用的 Bitmap 对象。创建了 Bitmap 对象后,使用父级 DisplayObjectContainer 实例的 addChild() 或 addChildAt() 方法可以将位图放在显示列表中。一个 Bitmap 对象可在若干 Bitmap 对象之中共享其 texture 引用,与缩放或旋转属性无关。由于能够创建引用相同 texture 对象的多个 Bitmap 对象,因此,多个显示对象可以使用相同的 texture 对象,而不会因为每个显示对象实例使用一个 texture 对象而产生额外内存开销。

公共属性

属性
defaultSmoothing : boolean
[静态] 控制在缩放时是否进行平滑处理的默认值
fillMode : string
确定位图填充尺寸的方式
pixelHitTest : boolean
是否开启精确像素碰撞
scale9Grid : egret.Rectangle
矩形区域,它定义素材对象的九个缩放区域
smoothing : boolean
控制在缩放时是否对位图进行平滑处理
texture : egret.Texture
被引用的 Texture 对象

公共方法

方法
Bitmap(value: egret.Texture)
创建一个引用指定 Texture 实例的 Bitmap 对象

事件

Events
egret.Event.ADDED
将显示对象添加到显示列表中时调度。
egret.Event.ADDED_TO_STAGE
在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。
egret.Event.REMOVED
将要从显示列表中删除显示对象时调度。
egret.Event.REMOVED_FROM_STAGE
在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。
egret.Event.ENTER_FRAME
[广播事件] 播放头进入新帧时调度。
egret.Event.RENDER
[广播事件] 将要更新和呈现显示列表时调度。
egret.TouchEvent.TOUCH_MOVE
当用户触碰设备时进行调度,而且会连续调度,直到接触点被删除。
egret.TouchEvent.TOUCH_BEGIN
当用户第一次触摸启用触摸的设备时(例如,用手指触摸手机屏幕)调度。
egret.TouchEvent.TOUCH_END
当用户移除与启用触摸的设备的接触时(例如,将手指从屏幕上抬起)调度。
egret.TouchEvent.TOUCH_TAP
当用户在启用触摸设备上的已启动接触的同一 DisplayObject 实例上抬起接触点时(例如,手机点击屏幕后抬起)调度。
egret.TouchEvent.TOUCH_RELEASE_OUTSIDE
当用户在启用触摸设备上的已启动接触的不同 DisplayObject 实例上抬起接触点时(例如,按住屏幕上的某个对象,然后从它上面挪开后再松开手指)调度。

属性详细信息

defaultSmoothing

defaultSmoothing : boolean = true。

  • 支持版本:Egret 3.0
  • 运行平台:Web

控制在缩放时是否进行平滑处理的默认值。在 Bitmap 等对象创建时,smoothing 属性会被设置为该值。

fillMode

fillMode : string = BitmapFillMode.SCALE

  • 支持版本:Egret 2.4
  • 运行平台:Web

确定位图填充尺寸的方式。设置为 BitmapFillMode.REPEAT时,位图将重复以填充区域。设置为 BitmapFillMode.SCALE时,位图将拉伸以填充区域。

pixelHitTest

pixelHitTest : boolean = false

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

是否开启精确像素碰撞。设置为true显示对象本身的透明区域将能够被穿透。

注意:若图片资源是以跨域方式从外部服务器加载的,将无法访问图片的像素数据,而导致此属性失效。

scale9Grid

scale9Grid : egret.Rectangle

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

矩形区域,它定义素材对象的九个缩放区域。注意:此属性仅在fillModeBitmapFillMode.SCALE时有效。

smoothing

smoothing : boolean

  • 支持版本:Egret 2.4
  • 运行平台:Web

控制在缩放时是否对位图进行平滑处理。

texture

texture : egret.Texture

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native

被引用的 Texture 对象。如果传入构造函数的类型为 BitmapData 或者最后设置的为 bitmapData,则此值返回 null。

方法详细信息

Bitmap()

public Bitmap(value: egret.Texture)

创建一个引用指定 Texture 实例的 Bitmap 对象

  • 支持版本:Egret 2.4
  • 运行平台:Web,Native
  • 参数

示例

/*
* 以下示例演示了使用 ImageLoader 加载图片资源并使用 Bitmap 进行显示。
* 还可以配合 RES 模块更便捷的加载。
*/
class BitmapExample extends egret.DisplayObjectContainer {
ublic constructor() {
super();
this.startLoad();
}
private startLoad():void {
//创建 ImageLoader 对象
var loader:egret.ImageLoader = new egret.ImageLoader();
//添加加载完成侦听
loader.addEventListener(egret.Event.COMPLETE, this.onLoadComplete, this);
var url:string = "resource/assets/egret_icon.png";
//开始加载
loader.load(url);
}
private onLoadComplete(event:egret.Event):void {
var loader:egret.ImageLoader = <egret.ImageLoader>event.target;
//获取加载到的纹理对象
var bitmapData:egret.BitmapData = loader.data;
//创建纹理对象
var texture = new egret.Texture();
texture.bitmapData = bitmapData;
//创建 Bitmap 进行显示
this.addChild(new egret.Bitmap(texture));
}
}