Action Parts - Revision history

EK at 13:56, 2 May 2024

2024-05-02T13:56:54Z

EK at 21:38, 15 January 2024

2024-01-15T21:38:40Z

EK at 18:52, 15 January 2024

2024-01-15T18:52:19Z

EK at 23:07, 18 August 2023

2023-08-18T23:07:00Z

EK at 09:58, 24 February 2023

2023-02-24T09:58:05Z

EK at 10:24, 25 January 2023

2023-01-25T10:24:06Z

EK at 12:01, 14 October 2022

2022-10-14T12:01:30Z

EK at 15:29, 11 October 2022

2022-10-11T15:29:10Z

EK at 14:08, 11 October 2022

2022-10-11T14:08:57Z

EK at 13:42, 10 October 2022

2022-10-10T13:42:04Z

← Older revision		Revision as of 13:56, 2 May 2024
Line 685:		Line 685:
	* If <span class="inlinecode">"Show as background text"</span> is not checked, the cursor gets hidden while the text is displayed. The user may then skip the text by clicking the left mouse button (unless the cursor was manually hidden prior to calling the action part). All action parts listed after "Display narration text" will not be performed until the displayed text has finished being displayed.		* If <span class="inlinecode">"Show as background text"</span> is not checked, the cursor gets hidden while the text is displayed. The user may then skip the text by clicking the left mouse button (unless the cursor was manually hidden prior to calling the action part). All action parts listed after "Display narration text" will not be performed until the displayed text has finished being displayed.
	* If <span class="inlinecode">"Show as background text"</span> is checked, the user can perform actions while the text is being displayed. Background text cannot be skipped. All action parts listed after "Display narration text" will continue to be executed without waiting for the text display to finish.		* If <span class="inlinecode">"Show as background text"</span> is checked, the user can perform actions while the text is being displayed. Background text cannot be skipped. All action parts listed after "Display narration text" will continue to be executed without waiting for the text display to finish.
		+
		+
		+	=== Wait for narration text ===
		+
		+	Prevents action parts listed after this one from being performed until a currently active narration text has disappeared. This is especially useful when dealing with background text.

← Older revision		Revision as of 21:38, 15 January 2024
Line 140:		Line 140:
	=== Stop dialog ===		=== Stop dialog ===

−	~~[[File:Stop dialog action part restriction.png\|thumb\|150px]]~~
	Allows you to manually stop and close the currently running dialog.		Allows you to manually stop and close the currently running dialog.
−
−	~~<span class="red">Note that this action part only works, if it is used inside of the first action called by the dialog (see image)!</span>~~

← Older revision		Revision as of 18:52, 15 January 2024
Line 228:		Line 228:


−	=== Fade "~~snoop~~" animations in/out ===	+	=== Fade "hotspot" animations in/out ===

−	This action part allows you to fade in/out the objects' snoop ~~(hotspot~~) animations for the current scene. The fading time (<span class="inlinecode">"Delay"</span>) can be set in milliseconds. In general it's a good idea to add this action part to a "key pressed" action (fade in) and to a "key released" action (fade out).	+	This action part allows you to fade in/out the objects' hotspot (formerly known as "snoop") animations for the current scene. The fading time (<span class="inlinecode">"Delay"</span>) can be set in milliseconds. In general it's a good idea to add this action part to a "key pressed" action (fade in) and to a "key released" action (fade out).

@@ Line 8: / Line 8: @@
 You can always change the type of action part after you added it. Just choose another part from the list at the top of the action part properties area.
-Visionaire Studio offers the possibility to create your own action parts through [[Plugins|plugins]]. Members of the community have shared plugins they developed; you can download them from the [[Action Part Plugins|list of action part plugins]]. If you have installed such plugins, you will not find the custom action parts in the action part selection dialog. Either use the "Enter" key method to search for them or add a random action part from the dialog first and change it afterwards; custom action parts are to be found at the bottom of the list.
+Visionaire Studio offers the possibility to create your own action parts through [[Plugins|plugins]]. Members of the community have shared plugins they developed; you can download them from the [[Action Part Plugins|list of action part plugins]]. If you have installed such plugins, you will find them in the "Custom" section of the action part selection dialog.
@@ Line 417: / Line 417: @@
 === Give all items to other character ===
-Transfers all items from the selected <span class="inlinecode">Character</span>'s inventory' to another <span class="inlinecode">Character</span>'s inventory. Note that the order of the items will not necessarily be preserved.
+Transfers all items from the selected <span class="inlinecode">Character</span>'s inventory' to another <span class="inlinecode">Character</span>'s inventory.

@@ Line 575: / Line 575: @@
 === Set audio bus ===
-tbd
+<abbr title="to be done">tbd</abbr>
 === Fade audio container in/out ===
-tbd
+<abbr title="to be done">tbd</abbr>

← Older revision		Revision as of 10:24, 25 January 2023
Line 219:		Line 219:

	Sets the linked <span class="inlinecode">Image file</span> as the new lightmap for the selected <span class="inlinecode">Scene</span>. You can define the transition duration in milliseconds.		Sets the linked <span class="inlinecode">Image file</span> as the new lightmap for the selected <span class="inlinecode">Scene</span>. You can define the transition duration in milliseconds.
		+
		+	Note that transition only works when switching from one lightmap to another, i. e. there has to be a lightmap already active when switching to the new one. Otherwise the new lightmap will affect the scene immediately.

← Older revision		Revision as of 12:01, 14 October 2022
Line 8:		Line 8:
	You can always change the type of action part after you added it. Just choose another part from the list at the top of the action part properties area.		You can always change the type of action part after you added it. Just choose another part from the list at the top of the action part properties area.

−	Visionaire Studio offers the possibility to create your own action parts through [[Plugins\|plugins]]. If you have installed such plugins, you will not find the custom action parts in the action part selection dialog. Either use the "Enter" key method to search for them or add a random action part from the dialog first and change it afterwards; custom action parts are to be found at the bottom of the list.	+	Visionaire Studio offers the possibility to create your own action parts through [[Plugins\|plugins]]. Members of the community have shared plugins they developed; you can download them from the [[Action Part Plugins\|list of action part plugins]]. If you have installed such plugins, you will not find the custom action parts in the action part selection dialog. Either use the "Enter" key method to search for them or add a random action part from the dialog first and change it afterwards; custom action parts are to be found at the bottom of the list.

← Older revision		Revision as of 15:29, 11 October 2022
Line 1:		Line 1:
−	'''Action parts''' are part of Visionaire Studio's [[Action System\|action system]].	+	'''Action parts''' are an essential part of Visionaire Studio's [[Action System\|action system]].

	[[File:actionpart_box_en.png\|thumb\|300px\|Action part selection dialog]]		[[File:actionpart_box_en.png\|thumb\|300px\|Action part selection dialog]]

@@ Line 1: / Line 1: @@
 [[File:actionpart_box_en.png|thumb|300px|Action part selection dialog]]
 By default, the action part selection dialog (see image) pops up when adding a new action part to an action (you can disable this in the options). The dialog shows all 100+ available action parts grouped by categories on the right hand side. Click on one of the buttons to open up a category list and choose the desired action part. The action parts you use the most will be listed on the left hand side for quick & easy access (double-click to select). There is also a search field available.
 You can always change the type of action part after you added it. Just choose another part from the list at the top of the action part properties area.
-Visionaire Studio offers the possibility to create your own action parts through [[Plugins|plugins]]. If you have installed such plugins, you will not find the custom action parts in the action part selection dialog but only at the very bottom of the list (so add a random action part from the dialog first and change it afterwards).
+Visionaire Studio offers the possibility to create your own action parts through [[Plugins|plugins]]. If you have installed such plugins, you will not find the custom action parts in the action part selection dialog. Either use the "Enter" key method to search for them or add a random action part from the dialog first and change it afterwards; custom action parts are to be found at the bottom of the list.

@@ Line 246: / Line 246: @@
 === If character has item ===
-Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Character</span> owns the selected <span class="inlinecode">Item</span> (has it in his inventory); else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Character</span> owns the selected <span class="inlinecode">Item</span> (has it in his inventory); else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 253: / Line 253: @@
 === If Lua result ===
-Only perform the actions wrapped in the query, if the entered Lua <span class="inlinecode">Script</span> returns "true"; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the entered Lua <span class="inlinecode">Script</span> returns "true"; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 <syntaxhighlight lang="lua">
@@ Line 310: / Line 310: @@
 === If condition ===
-Only perform the actions wrapped in the query, if the linked <span class="inlinecode">Condition</span> equals the boolean "true" or "false" value you selected; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the linked <span class="inlinecode">Condition</span> equals the boolean "true" or "false" value you selected; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 317: / Line 317: @@
 === If value ===
-Only perform the actions wrapped in the query, if the linked <span class="inlinecode">Value</span> matches one of the specified criteria in the <span class="inlinecode">Operators</span> listed below; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the linked <span class="inlinecode">Value</span> matches one of the specified criteria in the <span class="inlinecode">Operators</span> listed below; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 * [ = ] queries if the current <span class="inlinecode">Value</span> equals the second linked <span class="inlinecode">Value</span> or the <span class="inlinecode">number</span> provided
@@ Line 332: / Line 332: @@
 === If character is on scene ===
-Only perform the actions wrapped in the query if the selected <span class="inlinecode">Character</span> is on the selected <span class="inlinecode">Scene</span>; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query if the selected <span class="inlinecode">Character</span> is on the selected <span class="inlinecode">Scene</span>; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 339: / Line 339: @@
 === If character is current character ===
-Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Character</span> is the character you are currently controlling; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Character</span> is the character you are currently controlling; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 346: / Line 346: @@
 === If character is aligned to ===
-Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Character</span> is facing in the given <span class="inlinecode">Direction</span>. You can define a <span class="inlinecode">Range</span> of direction angles, either around the direction set in the widget ("+/-") or starting at that direction ("from-to"). See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Character</span> is facing in the given <span class="inlinecode">Direction</span>. You can define a <span class="inlinecode">Range</span> of direction angles, either around the direction set in the widget ("+/-") or starting at that direction ("from-to"). See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 === If language is current language ===
-Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Language</span> equals the current language being used; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the selected <span class="inlinecode">Language</span> equals the current language being used; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 358: / Line 358: @@
 === If command is current command ===
-Only perform the actions wrapped in the query, if the current command being used equals the selected <span class="inlinecode">Command</span>; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the current command being used equals the selected <span class="inlinecode">Command</span>; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 365: / Line 365: @@
 === If current object ... ===
-Only perform the actions wrapped in the query if the current position of the mouse cursor meets the selected criteria listed in <span class="inlinecode">Object</span>s below; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query if the current position of the mouse cursor meets the selected criteria listed in <span class="inlinecode">Object</span>s below; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 * "exists": only perform the listed actions if an object is under the mouse cursor
@@ Line 379: / Line 379: @@
 === If savegame/autosave exists ===
-Only perform the actions wrapped in the query, if a savegame or the specified autosave number exists; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if a savegame or the specified autosave number exists; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 You can turn this action part into an "else if" by checking <span class="inlinecode">ElseIf</span>.
@@ Line 386: / Line 386: @@
 === Else ===
-Only perform the following actions if neither the initial "if" criteria of this "if…else" query nor any following "else if" criterias are met. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the following actions if neither the initial "if" criteria of this "if…else" query nor any following "else if" criterias are met. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
 === End if ===
-This action part is used to end an "if…else" query. There should be the same amount of "end if", as "if" action parts (with additional "if else" action parts optionally in-between). In other words: always end your "if…else" queries with this action part. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+This action part is used to end an "if…else" query. There should be the same amount of "end if", as "if" action parts (with additional "if else" action parts optionally in-between). In other words: always end your "if…else" queries with this action part. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.
@@ Line 557: / Line 557: @@
 === If ilios script true ===
-Only perform the actions wrapped in the query, if the entered Ilios <span class="inlinecode">Code</span> returns "true"; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Using_conditions_and_.28integer.29_values|conditions and values page]] on how to build "if…else" queries.
+Only perform the actions wrapped in the query, if the entered Ilios <span class="inlinecode">Code</span> returns "true"; else continue with the next "else if" or "else" criteria (if provided) or end the query. See the [[Conditions_and_Values#Build_.22if.E2.80.A6else.22_queries|conditions and values page]] on how to build "if…else" queries.