|real/string||The unique identifier to use for the new label|
|string||The text string to display as a label (or keyword |
|real||The horizontal position to display the label, relative to the global offset|
|real||The vertical position to display the label, relative to the global offset|
|real||The drawing depth of the label, relative to other labels only|
|real||The width in pixels before text is wrapped into a new line|
|font/macro||The font to draw text in, where |
|color/macro||The color to draw text in, where |
|script||Sets the transition animation to perform|
|real||Sets the duration of the transition animation, in seconds|
|integer/macro||Optional: Sets the ease override for the transition script|
|real/string||Optional: Sets the language flag for the label|
Creates a new static string of text which will be displayed until
vngen_label_destroy is run. Multiple labels can exist simultaneously, however no two labels may share the same ID. VNgen entity IDs are arbitrary and most can be either numbers or strings, but bear in mind that -1 is reserved as 'null' and cannot be used as an ID.
While labels share many properties with standard text elements, labels are static and do not affect progression, character speaking animations, or the backlog, and do not support advanced features such as a typewriter effect or markup.
While the actual label text can be anything, it is also possible to set labels to automatically display the name of the current speaker(s) defined by other text elements. This value is updated automatically at the start of every event, meaning the label does not require replacing to reflect each new speaker.