跳到主要内容

egret.StageScaleMode

   egret

   public class StageScaleMode

StageScaleMode 类为舞台缩放模式提供值。

公共属性

属性
EXACT_FIT : string
[静态]不保持原始宽高比缩放应用程序内容,缩放后应用程序内容正好填满播放器视口
FIXED_HEIGHT : string
[静态]保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,但只保持应用程序内容的原始高度不变,宽度可能会改变
FIXED_NARROW : string
[静态]保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,应用程序内容的较窄方向可能会不够宽而填充
FIXED_WIDE : string
[静态]保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,应用程序内容的较宽方向的两侧可能会超出播放器视口而被裁切
FIXED_WIDTH : string
[静态]保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,但只保持应用程序内容的原始宽度不变,高度可能会改变
NO_BORDER : string
[静态]保持原始宽高比缩放应用程序内容,缩放后应用程序内容的较窄方向填满播放器视口,另一个方向的两侧可能会超出播放器视口而被裁切
NO_SCALE : string
[静态]不缩放应用程序内容
SHOW_ALL : string
[静态]保持原始宽高比缩放应用程序内容,缩放后应用程序内容的较宽方向填满播放器视口,另一个方向的两侧可能会不够宽而留有黑边

属性详细信息

EXACT_FIT

EXACT_FIT : string = "exactFit"

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

不保持原始宽高比缩放应用程序内容,缩放后应用程序内容正好填满播放器视口。

在此模式下,舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终等于初始化时外部传入的应用程序内容尺寸。

FIXED_HEIGHT

FIXED_HEIGHT : string = "fixedHeight"

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

保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,但只保持应用程序内容的原始高度不变,宽度可能会改变。

在此模式下,舞台高度(Stage.stageHeight)始终等于初始化时外部传入的应用程序内容高度。舞台宽度(Stage.stageWidth)由当前的缩放比例与播放器视口宽度决定。

FIXED_NARROW

FIXED_NARROW : string = "fixedNarrow"

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

保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,应用程序内容的较窄方向可能会不够宽而填充。

在此模式下,舞台高度(Stage.stageHeight)和舞台宽度(Stage.stageWidth)由当前的缩放比例与播放器视口宽高决定。

FIXED_WIDE

FIXED_WIDE : string = "fixedWide"

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

保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,应用程序内容的较宽方向的两侧可能会超出播放器视口而被裁切。

在此模式下,舞台高度(Stage.stageHeight)和舞台宽度(Stage.stageWidth)由当前的缩放比例与播放器视口宽高决定。

FIXED_WIDTH

FIXED_WIDTH : string = "fixedWidth"

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

保持原始宽高比缩放应用程序内容,缩放后应用程序内容在水平和垂直方向都填满播放器视口,但只保持应用程序内容的原始宽度不变,高度可能会改变。

在此模式下,舞台宽度(Stage.stageWidth)始终等于初始化时外部传入的应用程序内容宽度。舞台高度(Stage.stageHeight)由当前的缩放比例与播放器视口高度决定。

NO_BORDER

NO_BORDER : string = "noBorder"

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

保持原始宽高比缩放应用程序内容,缩放后应用程序内容的较窄方向填满播放器视口,另一个方向的两侧可能会超出播放器视口而被裁切。

在此模式下,舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终等于初始化时外部传入的应用程序内容尺寸。

NO_SCALE

NO_SCALE : string = "noScale"

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

不缩放应用程序内容。即使在更改播放器视口大小时,它仍然保持不变。如果播放器视口比内容小,则可能进行一些裁切。

在此模式下,舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终跟播放器视口大小保持一致。

SHOW_ALL

SHOW_ALL : string = "showAll"

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

保持原始宽高比缩放应用程序内容,缩放后应用程序内容的较宽方向填满播放器视口,另一个方向的两侧可能会不够宽而留有黑边。

在此模式下,舞台尺寸(Stage.stageWidth,Stage.stageHeight)始终等于初始化时外部传入的应用程序内容尺寸。

示例

/*
* 以下示例演示了设置屏幕适配方式。
* 游戏默认的适配方式在egret_loader.js和native_require.js中修改
*/
class StageScaleModeExample extends egret.DisplayObjectContainer {
public constructor() {
super();
this.addEventListener(egret.Event.ADDED_TO_STAGE, this.onAddToStage, this);
}
private onAddToStage():void {
this.removeEventListener(egret.Event.ADDED_TO_STAGE, this.onAddToStage, this);
//设置屏幕适配方式为 EXACT_FIT
this.stage.scaleMode = egret.StageScaleMode.EXACT_FIT;
}
}