Namespace: settings

PIXI.settings

用户自定义的全局变量,用于覆盖默认的PIXI设置,例如 作为渲染器的默认分辨率、帧率、浮点精度等。

Example

// 使用本机窗口分辨率作为默认分辨率
// 渲染时支持高密度显示
PIXI.settings.RESOLUTION = window.devicePixelRatio;

// 缩放时禁用插值,将使纹理像素化
PIXI.settings.SCALE_MODE = PIXI.SCALE_MODES.NEAREST;

Members

PIXI.settings.ANISOTROPIC_LEVEL number static

纹理的默认各向异性过滤级别。 Usually from 0 to 16

Default Value:
  • 0

PIXI.settings.CAN_UPLOAD_SAME_BUFFER boolean static

我们能在一个帧中上传相同的缓冲区吗?

PIXI.settings.CREATE_IMAGE_BITMAP boolean static

在图像加载之前启用位图创建。此功能是实验性的。

Default Value:
  • false

PIXI.settings.FAIL_IF_MAJOR_PERFORMANCE_CAVEAT boolean static

Should the failIfMajorPerformanceCaveat flag be enabled as a context option used in the isWebGLSupported function. For most scenarios this should be left as true, as otherwise the user may have a poor experience. However, it can be useful to disable under certain scenarios, such as headless unit tests.

Default Value:
  • true

PIXI.settings.FILTER_RESOLUTION number static

默认滤镜分辨率。

Default Value:
  • 1

PIXI.settings.GC_MAX_CHECK_COUNT number static

默认垃圾收集最大检查计数。

Default Value:
  • 600

PIXI.settings.GC_MAX_IDLE number static

默认垃圾回收最大空闲。

Default Value:
  • 3600

PIXI.settings.GC_MODE PIXI.GC_MODES static

默认垃圾回收模式。

Default Value:
  • PIXI.GC_MODES.AUTO

PIXI.settings.MESH_CANVAS_PADDING number static

基于画布的网格渲染的默认canvasPadding

Default Value:
  • 0
See:
  • PIXI.Mesh2d#canvasPadding

PIXI.settings.MIPMAP_TEXTURES PIXI.MIPMAP_MODES static

如果设置为true,WebGL将尝试在默认情况下将纹理设为mimpaped。 Mipmapping只有在上传的基础纹理具有二维能力时才会成功。

Default Value:
  • PIXI.MIPMAP_MODES.POW2

PIXI.settings.PRECISION_FRAGMENT PIXI.PRECISION static

默认在片段着色器中指定浮点精度。 iOS最好设置为highp,原因是 https://github.com/pixijs/pixi.js/issues/3742

Default Value:
  • PIXI.PRECISION.MEDIUM

PIXI.settings.PRECISION_VERTEX PIXI.PRECISION static

默认在顶点着色器中指定浮点精度。

Default Value:
  • PIXI.PRECISION.HIGH

PIXI.settings.PREFER_ENV number static

对使用WebGL的最大支持。 如果设备不支持WebGL版本,例如WebGL 2,它将尝试回退对WebGL 1的支持。 如果要显式删除功能支持以实现更稳定的基准,请选择较低的环境。

由于in chromium, 我们默认为所有非Apple移动设备禁用webgl2。

Default Value:
  • PIXI.ENV.WEBGL2

PIXI.settings.RENDER_OPTIONS object static

默认渲染选项,如果没有提供PIXI.Renderer or PIXI.CanvasRenderer.

Properties:
Name Type Default Description
view HTMLCanvasElement null
resolution number 1
antialias boolean false
forceFXAA boolean false
autoDensity boolean false
transparent boolean false
backgroundColor number 0x000000
clearBeforeRender boolean true
preserveDrawingBuffer boolean false
width number 800
height number 600
legacy boolean false

PIXI.settings.RESOLUTION number static

渲染器的默认分辨率/设备像素比率。

Default Value:
  • 1

PIXI.settings.RETINA_PREFIX RegExp static

The prefix that denotes a URL is for a retina asset.

Default Value:
  • /@([0-9\.]+)x/
Example
`@2x`

PIXI.settings.ROUND_PIXELS boolean staticconstant

如果为true,则在渲染时,PixiJS将使用Math.floor() x/y值,从而停止像素插值。 优点包括更清晰的图像质量(如文本)和在canvas上更快的渲染。 主要缺点是物体的运动可能看起来不太平滑。

Default Value:
  • false

PIXI.settings.SCALE_MODE PIXI.SCALE_MODES static

纹理的默认缩放模式。

Default Value:
  • PIXI.SCALE_MODES.LINEAR

PIXI.settings.SORTABLE_CHILDREN boolean staticconstant

设置容器属性'sortableChildren'的默认值。 如果设置为true,则容器将在调用updateTransform()时,按zIndex值对其子项进行排序, 如果调用sortChildren()则将对其进行手动排序。

这实际上会更改数组中元素的顺序,因此应将其视为与其他解决方案(例如: @link https://github.com/pixijs/pixi-display) 相比性能不佳的基本解决方案

还要注意,这可能无法很好地与addChildAt()函数一起工作, 因为zIndex排序可能会导致子项自动排序到另一个位置。

Default Value:
  • false

PIXI.settings.SPRITE_BATCH_SIZE number static

默认的精灵批处理大小。

默认的目标是平衡桌面和移动设备。

Default Value:
  • 4096

PIXI.settings.SPRITE_MAX_TEXTURES number static

此设备支持的最大纹理。

Default Value:
  • 32

PIXI.settings.STRICT_TEXTURE_CACHE boolean static

如果设置为 true,则Textures和BaseTexture对象存储在缓存中 (TextureCacheBaseTextureCache) 只能在调用Texture.fromBaseTexture.from时使用。 否则,这些from调用将引发异常。如果您想通过Loader 强制预加载所有资源,则使用此属性可能很有用。 Loader.

Default Value:
  • false

PIXI.settings.TARGET_FPMS number static

Target frames per millisecond.

Default Value:
  • 0.06

PIXI.settings.TRANSFORM_MODE PIXI.TRANSFORM_MODE Deprecated : since 5.0.0 static

Default transform type.

Default Value:
  • PIXI.TRANSFORM_MODE.STATIC

PIXI.settings.UPLOADS_PER_FRAME number static

Default number of uploads per frame using prepare plugin.

Default Value:
  • 4

PIXI.settings.WRAP_MODE PIXI.WRAP_MODES static

pixi支持的默认循环模式。

Default Value:
  • PIXI.WRAP_MODES.CLAMP