Pixi’VN
indexFunctions

Function: showImage()

pixi-vn on GitHub

Call Signature

> showImage(alias, options?): Promise<ImageSprite<ImageSpriteMemory>>

Defined in: src/canvas/functions/image-utility.ts:93

Add and show a image in the canvas, using alias as the image alias.

Parameters

alias

string

The unique alias of the component, also used as the alias of the asset (it must be registered in the asset cache or manifest).

options?

ImageSpriteOptions

The options of the image.

Returns

Promise<ImageSprite<ImageSpriteMemory>>

This function returns an ImageSprite that you can use to manipulate the component.

Throws

when alias is not registered in the asset cache.

Example

Assets.add({ alias: "bunny", src: "https://pixijs.com/assets/bunny.png" });
await showImage("bunny", { xAlign: 0.5 });

Call Signature

> showImage(alias, imageUrl?, options?): Promise<ImageSprite<ImageSpriteMemory>>

Defined in: src/canvas/functions/image-utility.ts:111

Add and show a image in the canvas. This function is a combination of addImage.

Parameters

alias

string

The unique alias of the image. You can use this alias to refer to this image

imageUrl?

string

The url of the image. If you have initialized the "asset matrix", you can use the alias of the texture. If you don't provide the URL, then the alias is used as the URL.

options?

ImageSpriteOptions

The options of the image.

Returns

Promise<ImageSprite<ImageSpriteMemory>>

This function returns an ImageSprite that you can use to manipulate the component.

Throws

when imageUrl is not provided and alias is not registered in the asset cache.

Example

Assets.add({ alias: "bunny", src: "https://pixijs.com/assets/bunny.png" });

// "bunny" is the alias of the component and of the asset
const bunny1 = await showImage("bunny");
// a different alias for the component: (alias, assetAlias, options)
const bunny2 = await showImage("bunny2", "bunny", { xAlign: 1 });

On this page