Class: BaseTexture

PIXI~BaseTexture

纹理存储表示图像的信息。 所有纹理都有一个基础纹理,其中包含有关源的信息。 因此,您可以使用单个BaseTexture获得许多纹理。

new BaseTexture (resource, options)

Name Type Default Description
resource PIXI.resources.Resource | string | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement null optional

对于不是Resource的对象,要使用的当前资源将其转换为资源。

options Object optional

选项集

Name Type Default Description
mipmap PIXI.MIPMAP_MODES PIXI.settings.MIPMAP_TEXTURES optional

为纹理启用mipmapping

anisotropicLevel number PIXI.settings.ANISOTROPIC_LEVEL optional

各向异性过滤级别的纹理

wrapMode PIXI.WRAP_MODES PIXI.settings.WRAP_MODE optional

纹理包裹模式

scaleMode PIXI.SCALE_MODES PIXI.settings.SCALE_MODE optional

默认缩放模式, linear, nearest

format PIXI.FORMATS PIXI.FORMATS.RGBA optional

GL格式类型

type PIXI.TYPES PIXI.TYPES.UNSIGNED_BYTE optional

GL数据类型

target PIXI.TARGETS PIXI.TARGETS.TEXTURE_2D optional

GL纹理目标

alphaMode PIXI.ALPHA_MODES PIXI.ALPHA_MODES.UNPACK optional

预乘图像alpha

width number 0 optional

纹理的宽度

height number 0 optional

纹理的高度

resolution number optional

基础纹理的分辨率

resourceOptions object optional

可选资源选项, 查看 autoDetectResource

Extends

Members

PIXI.BaseTexture._globalBatch number static

多纹理渲染器使用的纹理批处理的全局编号

_batchEnabled number

多纹理渲染器使用的纹理批处理编号

_batchLocation number

纹理批处理中的位置,由多纹理渲染器使用

_id number Deprecated : since 5.2.0

Batch local field, stores current texture location

See:

alphaMode PIXI.ALPHA_MODES

如何处理预乘alpha, 查看 PIXI.ALPHA_MODES.

Default Value:
  • PIXI.ALPHA_MODES.UNPACK

anisotropicLevel number

各向异性过滤级别的纹理

Default Value:
  • PIXI.settings.ANISOTROPIC_LEVEL

cacheId string

当前默认的缓存ID。

destroyed boolean readonly

标记BaseTexture是否已被销毁。

dirtyId number readonly

TextureSystem用于仅在需要时将纹理更新到GPU。 请调用 update() 增加它。

dirtyStyleId number protected

由TextureSystem使用,仅在需要时更新纹理样式。

format PIXI.FORMATS

纹理的像素格式

Default Value:
  • PIXI.FORMATS.RGBA

hasLoaded boolean Deprecated : since 5.0.0 readonly

See:

height number readonly

加载图像后设置的基础纹理的高度

imageUrl string Deprecated : since 5.0.0

See:
  • PIXI.resource.ImageResource#url

isPowerOfTwo boolean readonly

不论纹理是否为2的幂,请尝试尽可能多地使用2的幂

Default Value:
  • false

纹理的Mipmap模式,影响缩小的图像

Default Value:
  • PIXI.settings.MIPMAP_TEXTURES

premultiplyAlpha boolean Deprecated : since 5.2.0 readonly

See:

realHeight number readonly

此纹理来源的像素高度

realWidth number readonly

此纹理来源的像素宽度

resolution number

分辨率/纹理的设备像素比率

Default Value:
  • PIXI.settings.RESOLUTION

resource PIXI.resources.Resource readonly

此BaseTexture使用的资源,每个BaseTexture只能有一个资源,但是纹理可以共享资源。

scaleMode PIXI.SCALE_MODES

缩放此纹理时应用的缩放模式

Default Value:
  • PIXI.settings.SCALE_MODE

source HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | SVGElement Deprecated : since 5.0.0 readonly

See:

target PIXI.TARGETS

目标类型

Default Value:
  • PIXI.TARGETS.TEXTURE_2D

textureCacheIds Array.<string> readonly

备用缓存ID的集合,因为某些BaseTextures可以具有多个ID,短名称和更长的完整URL

touched number protected

由自动纹理垃圾收集使用,存储绑定时的最后GC的tick

type PIXI.TYPES

资源数据的类型

Default Value:
  • PIXI.TYPES.UNSIGNED_BYTE

uid string protected

此BaseTexture的全局唯一标识符

valid boolean readonly

Generally speaking means when resource is loaded.

width number readonly

加载图像后设置的基础纹理的宽度

wrapMode number

纹理如何包裹

Methods

PIXI.BaseTexture.addToCache (baseTexture, id) static

将BaseTexture添加到全局BaseTextureCache。 该缓存在整个PIXI对象之间共享。

Name Type Description
baseTexture PIXI.BaseTexture

要添加到缓存的BaseTexture。

id string

BaseTexture将针对其存储的ID。

PIXI.BaseTexture.from (source, options, strict)PIXI.BaseTexture static

辅助函数,可根据您提供的源创建基础纹理。 来源可以是-图片网址,图片元素,画布元素。 如果源是图像url或图像元素, 如果不在基础纹理缓存中,则将创建并加载它。

Name Type Description
source string | HTMLImageElement | HTMLCanvasElement | SVGElement | HTMLVideoElement

从中创建基础纹理的源。

options object optional

请参见 PIXI.BaseTexture 的构造函数。

strict boolean optional

强制执行严格模式,请参见 PIXI.settings.STRICT_TEXTURE_CACHE

Returns:
Type Description
PIXI.BaseTexture 新的基础纹理。

PIXI.BaseTexture.fromBuffer (buffer, width, height, options)PIXI.BaseTexture static

使用Float32Array的BufferResource创建一个新的BaseTexture。 RGBA值是从0到1的浮点数。

Name Type Description
buffer Float32Array | Uint8Array

要使用的可选数组,如果未提供数据,则创建一个新的Float32Array。

width number

资源宽度

height number

资源高度

options object optional

请参见 PIXI.BaseTexture 的构造函数。

Returns:
Type Description
PIXI.BaseTexture 新的基础纹理

PIXI.BaseTexture.fromCanvas () Deprecated : since 5.0.0 static

See:

PIXI.BaseTexture.fromImage () Deprecated : since 5.0.0 static

See:

PIXI.BaseTexture.fromSVG () Deprecated : since 5.0.0 static

See:

PIXI.BaseTexture.removeFromCache (baseTexture)PIXI.BaseTexture | null static

从全局BaseTextureCache中删除BaseTexture。

Name Type Description
baseTexture string | PIXI.BaseTexture

要删除的BaseTexture的ID或BaseTexture实例本身。

Returns:
Type Description
PIXI.BaseTexture | null 已删除的BaseTexture。

destroy ()

销毁此基础纹理。 如果资源不希望销毁此纹理,则不应该使用此方法。 从所有缓存中删除纹理。

dispose ()

从WebGL内存中释放纹理,而不会销毁该纹理对象。 这意味着您以后仍然可以使用纹理,它将再次将其上传到GPU内存。

Fires:

获取可绘制的源,例如HTMLCanvasElement或HTMLImageElement, 它们适合使用CanvasRenderer进行渲染。由 @pixi/canvas-renderer 包提供。

Returns:
Type Description
PIXI.ICanvasImageSource 使用CanvasRenderer渲染的源

loadSource () Deprecated : since 5.0.0

setRealSize (realWidth, realHeight, resolution)PIXI.BaseTexture

设置baseTexture的实际大小,保留当前分辨率。

Name Type Description
realWidth number

全渲染宽度

realHeight number

全渲染高度

resolution number optional

(可选)设置分辨率

Returns:
Type Description
PIXI.BaseTexture this

setResolution (resolution)PIXI.BaseTexture

更改分辨率

Name Type Description
resolution number optional

res

Returns:
Type Description
PIXI.BaseTexture this

setResource (resource)PIXI.BaseTexture

设置资源(如果未设置)。 如果资源已经存在,则引发错误

Name Type Description
resource PIXI.resources.Resource

管理的BaseTexture

Returns:
Type Description
PIXI.BaseTexture this

setSize (width, height, resolution)PIXI.BaseTexture

更改w/h/分辨率。 如果宽度和高度大于零,则纹理变为有效。

Name Type Description
width number

视觉宽度

height number

视觉高度

resolution number optional

(可选)设置分辨率

Returns:
Type Description
PIXI.BaseTexture this

setStyle (scaleMode, mipmap)PIXI.BaseTexture

更改BaseTexture的样式选项

Name Type Description
scaleMode PIXI.SCALE_MODES optional

Pixi scalemode

mipmap PIXI.MIPMAP_MODES optional

开启mipmaps

Returns:
Type Description
PIXI.BaseTexture this

update ()

使对象无效。如果宽度和高度大于零,则纹理变为有效。

Events

BaseTexture被销毁时触发。

Name Type Description
baseTexture PIXI.BaseTexture

Instance of texture being destroyed.

当非立即可用的源未能加载时触发。

Name Type Description
baseTexture PIXI.BaseTexture

资源错误。

event ErrorEvent

加载错误事件。

当非立即可用的源完成加载时触发。

Name Type Description
baseTexture PIXI.BaseTexture

Resource loaded.

在更新BaseTexture时触发。

Name Type Description
baseTexture PIXI.BaseTexture

资源已加载。

在更新BaseTexture时触发。

Name Type Description
baseTexture PIXI.BaseTexture

正在更新纹理的实例。