LogoPixi’VN
indexInterfaces

Interface: ElementImageGenerateOptions

Defined in: src/types/ElementImageGenerateOptions.ts:11

Options accepted by ai.image.generateElement.

Generates a single visual element (e.g. a character) meant to be layered on top of other visuals: the area behind the subject is transparent, and align describes where it will be positioned on screen so the model can compose it accordingly.

Extends

Properties

align?

> optional align?: object

Defined in: src/types/ElementImageGenerateOptions.ts:31

Position of the element within the canvas (Pixi'VN's align, see https://pixi-vn.com/start/canvas-position). Each axis is a 0-1 fraction of the canvas' width/height that is also used as the element's own anchor on that axis, so the value describes both where on the canvas the point sits and which point of the element is placed there: 0 = the element's left/top edge is flush against the canvas' left/top edge, 1 = the element's right/bottom edge is flush against the canvas' right/bottom edge, 0.5 = centered on that axis.

x

> x: number

Horizontal position, as a 0-1 fraction of the canvas' width.

y

> y: number

Vertical position, as a 0-1 fraction of the canvas' height.


backgroundImage?

> optional backgroundImage?: string | true

Defined in: src/types/ElementImageGenerateOptions.ts:21

The background image this element will be placed over, so the model can compose the subject coherently with what's behind it (lighting, perspective, scale, ...).

Pass true to use whatever is currently rendered on the game canvas instead of a specific asset.

Forwarded to the provider as the reference image when referenceImage isn't set.


context?

> optional context?: string

Defined in: src/types/GenerateOptions.ts:19

Additional developer context, injected verbatim into the prompt.

Inherited from

ImageGenerateOptions.context


history?

> optional history?: boolean

Defined in: src/types/GenerateOptions.ts:15

Include the Pixi'VN narrative history.

When not false, the history is retrieved directly from Pixi'VN and serialized into JSON.

Default

true

Inherited from

ImageGenerateOptions.history


referenceImage?

> optional referenceImage?: string

Defined in: src/types/ImageGenerateOptions.ts:11

Optional reference image, forwarded to providers that support image-to-image generation.

Inherited from

ImageGenerateOptions.referenceImage


scene?

> optional scene?: string

Defined in: src/types/GenerateOptions.ts:23

Scene description.

Inherited from

ImageGenerateOptions.scene


style?

> optional style?: string

Defined in: src/types/GenerateOptions.ts:27

Desired style (tone of voice, art style, etc).

Inherited from

ImageGenerateOptions.style

On this page