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
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
trueInherited from
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
style?
> optional style?: string
Defined in: src/types/GenerateOptions.ts:27
Desired style (tone of voice, art style, etc).