Difference between revisions of "Compiled Index of Lua Scripts for Visionaire Studio"

From The Official Visionaire Studio: Adventure Game Engine Wiki
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Here you can find a list of ''verified'' working Lua scripts made by various members of the Visionaire Studio team & forum community. Also included is a list of workflow functions, shader functions & predefined Visionaire Studio functions.
+
Here you can find a list of ''verified'' working Lua scripts made by various members of the Visionaire Studio team & forum community. Also included is a list of workflow functions, shader functions & standard Visionaire Studio functions.
  
== Basic ==
+
 
{| class="ts sortable" style="width:100%"
+
== Community Made Scripts ==
 +
=== Basic ===
 +
{| class="ts sortable"
 +
|-
 +
! style="text-align:left" | Function Name
 +
! style="text-align:left;width:60%" class="unsortable" | Description
 +
! style="text-align:left;width:10%" class="unsortable" | By
 
|-
 
|-
! style="text-align:left" | Script Name
+
| [[Chained_Volume_Control_(CMS)|Chained Volume Control]] || Automatically dips music volume when a character talks & restores it when they have finished talking || AFRLme
! style="text-align:left;width:10%" | By
 
 
|-
 
|-
| [[Chained_Volume_Control_(CMS)|Chained Volume Control (music vs speech)]]
+
| [[Mute/Restore_Volume_(CMS)|Toggle Mute Volume]] || Toggle mute & restore volume via keybind or an interface button || AFRLme
| style="width:10%" | AFRLme
 
 
|-
 
|-
| [[Mute/Restore_Volume_(CMS)|Mute/Restore Volume]] || AFRLme
+
| [[Sliding_Interface_MKIII_(CMS)|Sliding Interface MKIII]] || Slide interfaces in & out with duration & easing options || AFRLme
 
|}
 
|}
  
== Intermediate ==
+
=== Intermediate ===
{| class="ts sortable" style="width:100%"
+
{| class="ts sortable"
 +
|-
 +
! style="text-align:left" | Function Name
 +
! style="text-align:left;width:60%" class="unsortable" | Description
 +
! style="text-align:left;width:10%" class="unsortable" | By
 +
|-
 +
| [[Cycle_Inventory_Items_(CMS)|Cycle Inventory Items]]  || Endlessly scroll through the inventory items forwards or backwards ||  AFRLme
 
|-
 
|-
! style="text-align:left" | Script Name
+
| <s>[[Dynamic_Action_Names_(CMS)|Dynamic Action Names]]</s> || Update action text on mouse over (deprecated) || AFRLme
! style="text-align:left;width:10%" | By
 
 
|-
 
|-
| [[Cycle_Inventory_Items_(CMS)|Cycle Inventory Items]]  
+
| <s>[[Global_Command_Checker_(CMS)|Global Command Checker]]</s> || Dynamically determine which commands are accessible on mouse over objects (needs updating) || AFRLme
| style="width:10%" | AFRLme
 
 
|-
 
|-
| [[Dynamic_Action_Names_(CMS)|Dynamic Action Names]] || AFRLme
+
| [[Insert_Item_(CMS)|Insert Item]] || Insert an item into the inventory before or after a specific item (needs updating) || AFRLme
 
|-
 
|-
| [[Global_Command_Checker_(CMS)|Global Command Checker]] || AFRLme
+
| [[Kill_Background_Text_(CMS)|Kill Background Text]] || Allows you to skip background texts || AFRLme
 
|-
 
|-
| [[High_Score_Display_(CMS)|High Score Display (updated ''via'' function)]] || AFRLme
+
| [[How_to_Load_External_Scripts_Into_Visionaire_Studio_(CMS)|Load External Scripts]] || Allows you to load external scripts into Visionaire || Divo
 
|-
 
|-
| [[Insert_Item_(CMS)|Insert Item]] || AFRLme
+
| [[Loop_Me_Not_(CMS)|Loop Me Not]] || Create a self-looping function that loops a specific amount of times || AFRLme
 
|-
 
|-
| [[Kill_Background_Text_(CMS)|Kill Background Text (multiple options)]] || AFRLme
+
| [[Organize_Inventory_Items_Alphabetically_(CMS)|Organize Inventory Items Alphabetically]] || Sort inventory items alphabetically (needs updating) || AFRLme
 
|-
 
|-
| [[How_to_Load_External_Scripts_Into_Visionaire_Studio_(CMS)|Load External Scripts]] || Divo
+
| [[Replace_Item_(CMS)|Replace Item]] || Replace an item in the inventory with another item (used for item combination) || AFRLme
 
|-
 
|-
| [[Organize_Inventory_Items_Alphabetically_(CMS)|Organize Inventory Items Alphabetically]] || AFRLme
+
| <s>[[Sliding_Interface_MKII_(CMS)|Sliding Interface MKII]]</s> || Slide interfaces in & out (deprecated use [[Sliding_Interface_MKIII_(CMS)|Sliding Interface MKIII]] instead) || AFRLme
 
|-
 
|-
| [[Percentage_Display_(CMS)|Percentage Display (updated ''via'' function)]] || AFRLme
+
| [[UpdateCharName_(CMS)|updateCharName()]] || Dynamically update the name of characters on mouse over  || AFRLme
 
|-
 
|-
| [[Replace_Item_(CMS)|Replace Item]] || AFRLme
+
| [[UpdateName_(CMS)|updateName()]] || Dynamically update the name of the current object below the mouse cursor (multi-language support)  || AFRLme
 
|}
 
|}
  
== Advanced ==
+
=== Advanced ===
{| class="ts sortable" style="width:100%"
+
{| class="ts sortable"
 
|-  
 
|-  
! style="text-align:left" | Script Name  
+
! style="text-align:left" | Function Name  
! style="text-align:left;width:10%" | By
+
! style="text-align:left;width:60%" class="unsortable" | Description
|-
+
! style="text-align:left;width:10%" class="unsortable" | By
| [[Read/Write_Config.ini_(CMS)|Config.ini (read/write)]] || AFRLme
 
 
|-
 
|-
| [[Dynamic_Action_Names_for_Dragged_Items_(CMS)|Dynamic Action Names for Dragged Items]] || AFRLme
+
| [[Read/Write_Config.ini_(CMS)|Config.ini (read/write)]] || Used to store & retrieve the players option choices || AFRLme
 
|-
 
|-
| [[Dynamic_Loop_Handler_(CMS)|Dynamic Loop Handler (control delay & loop amount)]] || AFRLme
+
| [[Dynamic_Action_Names_for_Dragged_Items_(CMS)|Dynamic Action Names for Dragged Items]] || || AFRLme
 
|-
 
|-
| [[Dynamic_Sound_(CMS)|Dynamic Sound (based on current character position)]] || AFRLme
+
| [[Dynamic_Stylized_Speech_Bubbles_(CMS)|Dynamic Stylized Speech Bubbles (optional styling)]] || || The Argonauts
 
|-
 
|-
| [[Shader_(CMS)|Shader Toolkit]] || SimonS
+
| [[Self_Looping_Function_with_Delay_(CMS)|Self Looping Function with Delay (2 versions)]] || || AFRLme
 
|-
 
|-
| [[Deponia_Based_Sliding_Interface_(CMS)|Sliding Interfaces (based on Deponia)]] || AFRLme
+
| [[Deponia_Based_Sliding_Interface_(CMS)|Sliding Interfaces (based on Deponia)]] || || AFRLme
 
|-
 
|-
| [[Volume_Control_Basic_Version_(CMS)|Volume Control (rail, button, percentage)]] || AFRLme
+
| [[Sliding_Puzzle_(CMS)|Sliding Puzzle (3x3)]] || || AFRLme
 
|}
 
|}
  
== Workflow Functions ==
+
 
 +
== Math Functions ==
 
{| class="ts sortable" style="width:100%"
 
{| class="ts sortable" style="width:100%"
 
|-  
 
|-  
Line 68: Line 76:
 
! style="text-align:left;width:80%" class="unsortable" | Description
 
! style="text-align:left;width:80%" class="unsortable" | Description
 
|-
 
|-
| [[AlignChar_(CMS)|alignChar()]] || Quickly align a character to another character.
+
| [[SecondsToDays_(CMS)|secondsToDays()]] || Convert seconds to dd time format.
 
|-
 
|-
| [[AlignObj_(CMS)|alignObj()]] || Quickly align a character to a scene object.
+
| [[SecondsToHours_(CMS)|secondsToHours()]] || Convert seconds to hh time format.
 
|-
 
|-
| [[ChangeOutfit_(CMS)|changeOutfit()]] || Quickly change the outfit of a character.
+
| [[SecondsToMinutes_(CMS)|secondsToMinutes()]] || Convert seconds to mm time format.
 
|-
 
|-
| [[CheckCond_(CMS)|checkCond()]] || Quickly check the boolean value of a condition.
+
| [[SecondsToSeconds_(CMS)|secondsToSeconds()]] || Convert seconds to ss time format.
 
|-
 
|-
| [[MoveObj_(CMS)|moveObj()]] || Move an object from one position to another over x amount of milliseconds.
+
| [[SecondsToTime_(CMS)|secondsToTime()]] || Convert seconds to dd:hh:mm:ss time format.
 +
|}
 +
 
 +
 
 +
== Shader Toolkit  ==
 +
{| class="ts"
 +
|-
 +
! style="text-align:left" | Script Name
 +
! style="text-align:left;width:10%" | By
 
|-
 
|-
| [[SetAnimFrames_(CMS)|setAnimFrames()]] || Quickly set the first & last frame of an active animation.
+
| [[Shader_(CMS)|Shader Toolkit]] || SimonS
|-
 
| [[SetAnimSize_(CMS)|setAnimSize()]] || Quickly set the size of an active animation.
 
|-
 
| [[SetCondition_(CMS)|setCondition()]] || Quickly set the boolean value of a condition.
 
|-
 
| [[SetLang_(CMS)|setLang()]] || Quickly set the spoken language & subtitle language.
 
|-
 
| [[SetSceneBrightness_(CMS)|setSceneBrightness()]] || Quickly set the brightness/contrast level of a specific scene or the current scene.
 
|-
 
| [[setVal_(CMS)|setVal()]] || Quickly set the integer or string of a value.
 
|-
 
| [[ToggleCondition_(CMS)|toggleCondition()]] || Quickly toggle the boolean value of a condition.
 
 
|}
 
|}
 
+
=== Shader Toolkit Functions ===
== Shader Toolkit Functions ==
+
{| class="ts sortable"
{| class="ts sortable" style="width:100%"
 
 
|-  
 
|-  
 
! style="text-align:left" | Function Name  
 
! style="text-align:left" | Function Name  
 
! style="text-align:left;width:80%" class="unsortable" | Description
 
! style="text-align:left;width:80%" class="unsortable" | Description
 +
|-
 +
| [[ShaderAddEffect_(CMS)|shaderAddEffect()]] || Add various dynamic pre-made warp effects to the screen.
 
|-
 
|-
 
| [[ShaderBlur_(CMS)|shaderBlur()]] || Blur/Focus the screen over x amount of milliseconds.
 
| [[ShaderBlur_(CMS)|shaderBlur()]] || Blur/Focus the screen over x amount of milliseconds.
Line 106: Line 111:
 
|-
 
|-
 
| [[ShaderFollowCharacter_(CMS)|shaderFollowCharacter()]] || Softly follow the linked character around the screen.
 
| [[ShaderFollowCharacter_(CMS)|shaderFollowCharacter()]] || Softly follow the linked character around the screen.
 +
|-
 +
| [[ShaderGlow_(CMS)|shaderGlow()]] || Create a glow effect on light/saturated scene objects (automatically selected) over x amount of milliseconds.
 
|-
 
|-
 
| [[ShaderHue_(CMS)|shaderHue()]] || Adjust the hue level of the screen over x amount of milliseconds.
 
| [[ShaderHue_(CMS)|shaderHue()]] || Adjust the hue level of the screen over x amount of milliseconds.
Line 127: Line 134:
 
| [[ShaderZoomObject_(CMS)|shaderZoomObject()]] || Zoom camera into or out of linked objects location over x amount of milliseconds.
 
| [[ShaderZoomObject_(CMS)|shaderZoomObject()]] || Zoom camera into or out of linked objects location over x amount of milliseconds.
 
|}
 
|}
 +
  
 
== Visionaire Studio Functions ==
 
== Visionaire Studio Functions ==
{| class="ts sortable" style="width:100%"
+
{| class="ts sortable"
 
|-
 
|-
 
! style="text-align:left" | Function Name  
 
! style="text-align:left" | Function Name  
Line 230: Line 238:
 
| [[UnregisterEventHandler_(CMS)|unregisterEventHandler()]] || Unregister the linked event handler & function.
 
| [[UnregisterEventHandler_(CMS)|unregisterEventHandler()]] || Unregister the linked event handler & function.
 
|}
 
|}
{{toc}}
+
 
 +
 
 +
== Workflow Functions ==
 +
{| class="ts sortable"
 +
|-
 +
! style="text-align:left" | Function Name
 +
! style="text-align:left;width:70%" class="unsortable" | Description
 +
! style="text-align:left;width:10%" class="unsortable" | By
 +
|-
 +
| [[AlignChar_(CMS)|alignChar()]] || Quickly align a character to another character. || AFRLme
 +
|-
 +
| [[AlignObj_(CMS)|alignObj()]] || Quickly align a character to a scene object. || AFRLme
 +
|-
 +
| [[ChangeOutfit_(CMS)|changeOutfit()]] || Quickly change the outfit of a character. || AFRLme
 +
|-
 +
| [[ChangeScene_(CMS)|changeScene()]] || Change to another scene with a specific transition effect over a specified amount of time. || AFRLme
 +
|-
 +
| [[CheckCond_(CMS)|checkCond()]] || Quickly check the boolean value of a condition. || AFRLme
 +
|-
 +
| [[IsInRadius_(CMS)|isInRadius()]] || Quickly determine if mouse cursor is inside of a specified radius of an objects center or characters position. || AFRLme
 +
|-
 +
| [[LangVisibility_(CMS)|langVisibility()]] || Quickly fade in all scene objects containing the active language name, & fade out all scene objects containing other language names. || AFRLme
 +
|-
 +
| [[MoveObj_(CMS)|moveObj()]] || Move an object from one position to another over x amount of milliseconds. || AFRLme
 +
|-
 +
| [[ObjName_(CMS)|objName()]] || Return the action text name of a specified object (returns active language name). || Sebastian
 +
|-
 +
| [[ObjVisibility_(CMS)|objVisibility()]] || Quickly update the opacity of multiple scene objects, duration & easing are optional. || AFRLme
 +
|-
 +
| [[ResetAnimFrames_(CMS)|resetAnimFrames()]] || Quickly reset the specified animations current frame range back to the default animation frame range. || AFRLme
 +
|-
 +
| [[SetAnimFrames_(CMS)|setAnimFrames()]] || Quickly set the first & last frame of an active animation. || AFRLme
 +
|-
 +
| [[SetAnimSize_(CMS)|setAnimSize()]] || Quickly set the size of an active animation. || AFRLme
 +
|-
 +
| [[SetCondition_(CMS)|setCondition()]] || Quickly set or toggle the boolean value of a condition. || AFRLme
 +
|-
 +
| [[SetConditions_(CMS)|setConditions()]] || Quickly set or toggle the boolean value of multiple conditions. || AFRLme
 +
|-
 +
| [[SetLang_(CMS)|setLang()]] || Quickly set the spoken language & subtitle language. || AFRLme
 +
|-
 +
| [[SetSceneBrightness_(CMS)|setSceneBrightness()]] || Quickly set the brightness/contrast level of a specific scene or the current scene. || AFRLme
 +
|-
 +
| [[setVal_(CMS)|setVal()]] || Quickly set the integer or string of a value. || AFRLme
 +
|-
 +
| [[UpdateData_(CMS)|updateData()]] || Quickly update multiple data types via a table & the function. || AFRLme
 +
|}{{toc}}

Revision as of 16:06, 15 September 2022

Here you can find a list of verified working Lua scripts made by various members of the Visionaire Studio team & forum community. Also included is a list of workflow functions, shader functions & standard Visionaire Studio functions.


Community Made Scripts

Basic

Function Name Description By
Chained Volume Control Automatically dips music volume when a character talks & restores it when they have finished talking AFRLme
Toggle Mute Volume Toggle mute & restore volume via keybind or an interface button AFRLme
Sliding Interface MKIII Slide interfaces in & out with duration & easing options AFRLme

Intermediate

Function Name Description By
Cycle Inventory Items Endlessly scroll through the inventory items forwards or backwards AFRLme
Dynamic Action Names Update action text on mouse over (deprecated) AFRLme
Global Command Checker Dynamically determine which commands are accessible on mouse over objects (needs updating) AFRLme
Insert Item Insert an item into the inventory before or after a specific item (needs updating) AFRLme
Kill Background Text Allows you to skip background texts AFRLme
Load External Scripts Allows you to load external scripts into Visionaire Divo
Loop Me Not Create a self-looping function that loops a specific amount of times AFRLme
Organize Inventory Items Alphabetically Sort inventory items alphabetically (needs updating) AFRLme
Replace Item Replace an item in the inventory with another item (used for item combination) AFRLme
Sliding Interface MKII Slide interfaces in & out (deprecated use Sliding Interface MKIII instead) AFRLme
updateCharName() Dynamically update the name of characters on mouse over AFRLme
updateName() Dynamically update the name of the current object below the mouse cursor (multi-language support) AFRLme

Advanced

Function Name Description By
Config.ini (read/write) Used to store & retrieve the players option choices AFRLme
Dynamic Action Names for Dragged Items AFRLme
Dynamic Stylized Speech Bubbles (optional styling) The Argonauts
Self Looping Function with Delay (2 versions) AFRLme
Sliding Interfaces (based on Deponia) AFRLme
Sliding Puzzle (3x3) AFRLme


Math Functions

Function Name Description
secondsToDays() Convert seconds to dd time format.
secondsToHours() Convert seconds to hh time format.
secondsToMinutes() Convert seconds to mm time format.
secondsToSeconds() Convert seconds to ss time format.
secondsToTime() Convert seconds to dd:hh:mm:ss time format.


Shader Toolkit

Script Name By
Shader Toolkit SimonS

Shader Toolkit Functions

Function Name Description
shaderAddEffect() Add various dynamic pre-made warp effects to the screen.
shaderBlur() Blur/Focus the screen over x amount of milliseconds.
shaderColorize() Tint all the graphics on the screen a specific color over x amount of milliseconds.
shaderContrast() Set the global contrast level of the screen over x amount of milliseconds.
shaderFollowCharacter() Softly follow the linked character around the screen.
shaderGlow() Create a glow effect on light/saturated scene objects (automatically selected) over x amount of milliseconds.
shaderHue() Adjust the hue level of the screen over x amount of milliseconds.
shaderLightness() Adjust the lightness of the screen over x amount of milliseconds.
shaderNoise() Apply noise effect to the screen over x amount of milliseconds.
shaderPan() Pan the camera on the x or y axis over x amount of milliseconds.
shaderRotate() Rotate the screen over x amount of milliseconds.
shaderSaturation() Adjust saturation value of the screen over x amount of milliseconds.
shaderViewport() Pan, zoom & rotate the camera over x amount of milliseconds.
shaderZoom() Zoom the camera over x amount of milliseconds.
shaderZoomCharacter() Zoom camera into or out of linked characters position over x amount of milliseconds.
shaderZoomObject() Zoom camera into or out of linked objects location over x amount of milliseconds.


Visionaire Studio Functions

Function Name Description
createScreenshot() Create a screenshot & save as .png to a specified folder or use the screenshot for the save game thumbnail.
getBool() Retrieve boolean value of the linked object.
getCursorPos() Retrieves the current (absolute) position of the mouse cursor.
getFloat() Retrieve the float value of the linked object.
getFloats() Retrieve the float values of the linked objects data table.
getId() Retrieve the table id or table id name of the linked object.
getInt() Retrieve the integer value of the linked object.
getInts() Retrieve the integer values of the linked objects data table.
getLink() Retrieves the data stored inside of a linked objects table.
getLinks() Retrieves grouped data stored inside of a linked objects table.
getName() Returns the "string" name value of the linked objects table.
getObject() Retrieves the data stored inside of a linked objects table.
getParent() Retrieves the parent object which contains the linked object. (only game objects contain no parent)
getPath() Retrieves path (directory in unix format) of linked object. (images, videos, sounds etc)
getPaths() Retrieves multiple paths (directories in unix format) of linked object data table. (images, videos, sounds etc)
getPoint() Retrieves the x,y coordinates associated with the linked object.
getPoints() Retrieves multiple x,y coordinates associated with the linked objects data table.
getProperty() Retrieve various operating system (os) properties; such as: platform, system language etc...
getSoundId() Retrieve id of linked sound. (only applicable for active sounds)
getSoundProperty() Retrieve various properties of linked sound, such as: current playtime, balance, volume, loop. (only applicable for active sounds)
getSteamAchievement Retrieve boolean value of linked steam achievement.
getSteamStat Retrieve integer value of linked steam stat.
getTexts() Retrieve all texts associated with the linked object.
getTextStr() Retrieve a specific text string, based on the current game language or the included language id.
getTime() Developer command for checking time between 2 points; can be re-purposed into a crude delay or loop function.
getVolume() Retrieve volume levels for: music, sound, speech, videos, & master.
getWindowBrightness() Retrieve global window brightness value.
isEmpty() Returns true or false; depending on whether or not the linked object is empty.
registerEventHandler() Create loops, listen out for various events; such as mouse actions, action/text started/stopped etc...
registerHookFunction() Set displayed & action text positions.
resetSteamStats() Reset the linked steam stat back to its default value.
setCursorPos() Set the absolute position of the mouse cursor.
setSoundProperty() Set the properties of a linked sound, such as: current playtime position, balance, volume, loop (requires sound id)
setSteamAchievement() Set the boolean value of the linked steam achievement.
setSteamStat() Set the integer value of the linked steam stat.
setValue() Edit value of the linked object. (all data types)
setVolume() Adjust the volume levels for: music, sound, speech, videos, & master.
setWindowBrightness() Adjust the global window brightness value.
setWindowTitle() Set a custom title in the window application bar (only applicable for window mode)
startAction() Call & start the linked action.
startAnimation() Play the linked animation.
startDefaultBrowser Launch default web browser & open the linked url in a new tab. (only launches browser if not already open)
startSound() Play the linked sound; additional properties can also be set such as: current playtime position, balance, volume, & loop.
stopAction() Stop the linked action. (only applicable for active actions)
stopAnimation() Stop & unload the linked action. (only applicable for active animations)
stopSound() Stop the linked sound; requires sound id. (only applicable for active sounds)
toggleSoundPause() Toggle linked sound between playing & paused state; requires sound id. (only applicable for active sounds)
unregisterEventHandler() Unregister the linked event handler & function.


Workflow Functions

Function Name Description By
alignChar() Quickly align a character to another character. AFRLme
alignObj() Quickly align a character to a scene object. AFRLme
changeOutfit() Quickly change the outfit of a character. AFRLme
changeScene() Change to another scene with a specific transition effect over a specified amount of time. AFRLme
checkCond() Quickly check the boolean value of a condition. AFRLme
isInRadius() Quickly determine if mouse cursor is inside of a specified radius of an objects center or characters position. AFRLme
langVisibility() Quickly fade in all scene objects containing the active language name, & fade out all scene objects containing other language names. AFRLme
moveObj() Move an object from one position to another over x amount of milliseconds. AFRLme
objName() Return the action text name of a specified object (returns active language name). Sebastian
objVisibility() Quickly update the opacity of multiple scene objects, duration & easing are optional. AFRLme
resetAnimFrames() Quickly reset the specified animations current frame range back to the default animation frame range. AFRLme
setAnimFrames() Quickly set the first & last frame of an active animation. AFRLme
setAnimSize() Quickly set the size of an active animation. AFRLme
setCondition() Quickly set or toggle the boolean value of a condition. AFRLme
setConditions() Quickly set or toggle the boolean value of multiple conditions. AFRLme
setLang() Quickly set the spoken language & subtitle language. AFRLme
setSceneBrightness() Quickly set the brightness/contrast level of a specific scene or the current scene. AFRLme
setVal() Quickly set the integer or string of a value. AFRLme
updateData() Quickly update multiple data types via a table & the function. AFRLme