Text - Revision history

EK at 10:32, 16 January 2024

2024-01-16T10:32:58Z

EK at 10:16, 16 January 2024

2024-01-16T10:16:41Z

EK at 16:54, 15 January 2024

2024-01-15T16:54:14Z

EK at 16:06, 30 August 2023

2023-08-30T16:06:55Z

EK at 17:09, 23 August 2023

2023-08-23T17:09:22Z

EK at 16:49, 19 August 2023

2023-08-19T16:49:40Z

EK at 15:38, 19 August 2023

2023-08-19T15:38:21Z

EK at 10:59, 2 March 2023

2023-03-02T10:59:48Z

EK at 10:04, 24 February 2023

2023-02-24T10:04:06Z

EK at 01:31, 24 February 2023

2023-02-24T01:31:41Z

@@ Line 215: / Line 215: @@
 == Languages / Localisation ==
-If your game supports more than one language, you can switch between the different language text fields for entering your texts by clicking the flag icon. Flags are only shown, if the engine recognizes the language names you used when adding the languages though. Unknown languages show a grey placeholder instead of a country flag (but the flag is for convenience only anyway). Game languages are added in the [[Game Properties#Languages|"Game properties" section]].
+[[File:Language switch.png|thumb|250px|Switch between the different languages]]
 The "Texts" section lists all texts of your game for easy proof-reading and translation. Select an entry, set the two text boxes on the right hand side to different languages (via flag icons), and you can enter the translation for this text.

← Older revision		Revision as of 10:16, 16 January 2024
Line 210:		Line 210:
	This is a special kind of text, which you can only set indirectly as it shows up automatically when hovering over or interacting with objects, items, or characters. It consists of the current command and/or object/character names, e.g. "Door", "Look at door", "Use key with door", "Talk to John" etc. It depends on how you set up your interfaces, whether a complete "sentence" is displayed or maybe only object names show up.		This is a special kind of text, which you can only set indirectly as it shows up automatically when hovering over or interacting with objects, items, or characters. It consists of the current command and/or object/character names, e.g. "Door", "Look at door", "Use key with door", "Talk to John" etc. It depends on how you set up your interfaces, whether a complete "sentence" is displayed or maybe only object names show up.

−	In the [[~~Game Properties~~\|game properties]] you can select, if you want the action text to be attached to the cursor or be displayed at a specified position on the screen or not at all. Additionally, action text can be part of an [[Interfaces\|interface]].	+	In the [[Game_Properties#Action_text\|game properties]] you can select, if you want the action text to be attached to the cursor or be displayed at a specified position on the screen or not at all. Additionally, action text can be part of an [[Interfaces\|interface]].

@@ Line 215: / Line 215: @@
 == Languages / Localisation ==
-If your game supports more than one language, you can switch between the different language text fields for entering your texts by clicking the flag icon. Flags are only shown, if the engine recognizes the language names you used when adding the languages though. Unknown languages show a grey placeholder instead of a country flag (but the flag is for convenience only anyway). Game languages are added in the [[Game Properties#Game_info|"Game info" section]].
+If your game supports more than one language, you can switch between the different language text fields for entering your texts by clicking the flag icon. Flags are only shown, if the engine recognizes the language names you used when adding the languages though. Unknown languages show a grey placeholder instead of a country flag (but the flag is for convenience only anyway). Game languages are added in the [[Game Properties#Languages|"Game properties" section]].
 [[File:text25n.png|right|25px|link=]]

@@ Line 75: / Line 75: @@
 === Text styles ===
-You can define up to 8 different styles for a font by adding subtypes to it (see the [[Fonts]] page on how to do this). These subtype fonts are then used to display text you wrapped in the respective inline tags.
+You can define up to 6 different styles for a font by adding subtypes to it (see the [[Fonts]] page on how to do this). These subtype fonts are then used to display text you wrapped in the respective inline tags.
-The most common text styles are '''bold''' and ''italic'' – that's why the first two subtypes are applied through <code>&lt;b&gt;&lt;/b&gt;</code> and <code>&lt;i&gt;&lt;/i&gt;</code> tags, respectively. The remaining 6 subtypes are applied through numbered tags <code>&lt;0&gt;&lt;/0&gt;</code> to <code>&lt;5&gt;&lt;/5&gt;</code>.
+The 6 subtypes are applied through numbered tags <code>&lt;0&gt;&lt;/0&gt;</code> to <code>&lt;5&gt;&lt;/5&gt;</code>. Since the most common text styles are '''bold''' and ''italic'', the first two subtypes can also be applied through <code>&lt;b&gt;&lt;/b&gt;</code> and <code>&lt;i&gt;&lt;/i&gt;</code> tags, respectively. Note that a different text color of a subtype font is ignored. Use the [[#Color|color]] formatting option instead.
 ''Example 1:
 Use the &lt;b&gt; tag to apply the first subtype of the current font to the wrapped text.''
-  The first subtype should be the &lt;b&gt;bold style&lt;/b&gt;.
+  The first subtype is usually the &lt;b&gt;bold style&lt;/b&gt;.
 ''Example 2:
 Use the &lt;i&gt; tag to apply the second subtype of the current font to the wrapped text.''
-  The second subtype should be the &lt;i&gt;italic style&lt;/i&gt;.
+  The second subtype is usually the &lt;i&gt;italic style&lt;/i&gt;.
 ''Example 3:
-Use the number tags to apply additional subtypes of the current font to the wrapped text.''
+Use number tags to apply any of the subtypes of the current font to the wrapped text.''
-  This is the <0>third subtype style</0>.
+  This is the <0>first subtype style</0> and therefor the same as this &lt;b&gt;first subtype style&lt;/b&gt;.
-  This is the <1>fourth subtype style</1>.
+  This is the <1>second subtype style</1> and therefor the same as this &lt;i&gt;second subtype style&lt;/i&gt;.
-  This is the <2>fifth subtype style</2>.
+  This is the <2>third subtype style</2>.
-  This is the <3>sixth subtype style</3>.
+  This is the <3>fourth subtype style</3>.
-  This is the <4>seventh subtype style</4>.
+  This is the <4>fifth subtype style</4>.
-  This is the <5>eighth subtype style</5>.
+  This is the <5>sixth subtype style</5>.

@@ Line 141: / Line 141: @@
 | Time scale
 |-
-| rowspan="5" | Transitions
+| rowspan="6" | Transitions
-| rowspan="5" | The text moves or fades in and/or out. Available transition types:
+| rowspan="6" | The text moves or fades in and/or out. Available transition types:
 * MoveUp
 * MoveDown
@@ Line 151: / Line 151: @@
 * Wipe
 * Scale
-| rowspan="5" | '''<t ''TYPE''>'''
+| rowspan="6" | '''<t ''TYPE''>'''
 | <nowiki>lw|ww|wt</nowiki>
 | The transition takes place letterwise (lw), wordwise (ww) or for the whole text at once (wt)
-| rowspan="5" | Typewriter effect:<br>
+| rowspan="6" | Typewriter effect:<br>
 <code><t Fade lw d=0.1 s=0.03 NoneOut></code>
@@ Line 171: / Line 171: @@
 | rev
 | Reverse direction
 |-
 | ''easing''

← Older revision		Revision as of 16:49, 19 August 2023
Line 108:		Line 108:
	== Text effects ==		== Text effects ==

−	~~under construction~~...	+	Visionaire Studio offers several motion effects for texts. Like the [[#Text formatting\|formatting options]], they are applied through HTML-like tags, but you don't have to wrap texts between an opening and a closing tag. The tag is added to the beginning of the text and affects the whole string. The setup is adjusted via modifiers inside the tag.
		+
		+	{\| class="ts"
		+	\|-
		+	! style="width:10%" \| Effect
		+	! style="width:20%" \| Description
		+	! style="width:10%" \| Tag
		+	! colspan="2" \| Modifiers
		+	! style="width:30%" \| Examples
		+	\|-
		+	\| rowspan="3" \| Pulse
		+	\| rowspan="3" \| Characters/Words pulsate (change their size like a heartbeat)
		+	\| rowspan="3" \| '''<f pulse>'''
		+	\| <nowiki>lw\|ww\|wt</nowiki>
		+	\| The change in size takes place letterwise (lw), wordwise (ww) or for the whole text at once (wt)
		+	\| rowspan="3" \| <code><f pulse ww xs=0.1 ts=3.0></code>
		+	\|-
		+	\| xs
		+	\| Strength of change in size
		+	\|-
		+	\| ts
		+	\| Time scale
		+	\|-
		+	\| rowspan="2" \| Rainbow
		+	\| rowspan="2" \| The text is colored with a crawling rainbow gradient (the rainbow colors are not applied to letters which are already individually colored using the [[#Color\|hash tag]])
		+	\| rowspan="2" \| '''<f rainbow>'''
		+	\| w
		+	\| Width of the rainbow
		+	\| rowspan="2" \| <code><f rainbow w=30 ts=0.1></code>
		+	\|-
		+	\| ts
		+	\| Time scale
		+	\|-
		+	\| rowspan="5" \| Transitions
		+	\| rowspan="5" \| The text moves or fades in and/or out. Available transition types:
		+	* MoveUp
		+	* MoveDown
		+	* MoveLeft
		+	* MoveRight
		+	* MoveRandom
		+	* Fade
		+	* Wipe
		+	* Scale
		+	\| rowspan="5" \| '''<t ''TYPE''>'''
		+	\| <nowiki>lw\|ww\|wt</nowiki>
		+	\| The transition takes place letterwise (lw), wordwise (ww) or for the whole text at once (wt)
		+	\| rowspan="5" \| Typewriter effect:<br>
		+	<code><t Fade lw d=0.1 s=0.03 NoneOut></code>
		+
		+	Scale out after 2 seconds:<br>
		+	<code><t Scale rev dl=2 s=0.2 ww></code>
		+
		+	Bounce text up:<br>
		+	<code><t MoveUp ww d=1.0 s=0.2 BounceOut></code>
		+	\|-
		+	\| d
		+	\| Duration of the transition (in seconds)
		+	\|-
		+	\| dl
		+	\| Delay (in seconds)
		+	\|-
		+	\| rev
		+	\| Reverse direction
		+	\|-
		+	\| ''easing''
		+	\| Available easings (suffixed by "In", "Out" or "InOut"):
		+	* Back
		+	* Bounce
		+	* Circ
		+	* Cubic
		+	* Elastic
		+	* Linear
		+	* None
		+	* Quad
		+	* Quart
		+	* Quint
		+	* Sine
		+	\|-
		+	\| rowspan="3" \| Wiggle
		+	\| rowspan="3" \| Characters move around wildly and independently from each other
		+	\| rowspan="3" \| '''<f wiggle>''' or
		+	'''<wg>'''
		+	\| xs
		+	\| Strength of shifting in horizontal direction
		+	\| rowspan="3" \| <code><f wiggle xs=2 ys=2 ts=0.1></code> or
		+	<code><wg xs=2 ys=2 ts=0.1></code>
		+	\|-
		+	\| ys
		+	\| Strength of shifting in vertical direction
		+	\|-
		+	\| ts
		+	\| Time scale
		+	\|}

← Older revision		Revision as of 15:38, 19 August 2023
Line 67:		Line 67:
	My name is <vs=char1>.		My name is <vs=char1>.
	-- would display "My name is Fred."		-- would display "My name is Fred."
		+
		+
		+	== Text formatting ==
		+
		+	Text formatting can be applied through HTML-like tags. Be aware that this feature is available for TrueType fonts only.
		+
		+	=== Text styles ===
		+
		+	You can define up to 8 different styles for a font by adding subtypes to it (see the [[Fonts]] page on how to do this). These subtype fonts are then used to display text you wrapped in the respective inline tags.
		+
		+	The most common text styles are '''bold''' and ''italic'' – that's why the first two subtypes are applied through <code><b></b></code> and <code><i></i></code> tags, respectively. The remaining 6 subtypes are applied through numbered tags <code><0></0></code> to <code><5></5></code>.
		+
		+
		+	''Example 1:
		+	Use the <b> tag to apply the first subtype of the current font to the wrapped text.''
		+	The first subtype should be the <b>bold style</b>.
		+
		+	''Example 2:
		+	Use the <i> tag to apply the second subtype of the current font to the wrapped text.''
		+	The second subtype should be the <i>italic style</i>.
		+
		+	''Example 3:
		+	Use the number tags to apply additional subtypes of the current font to the wrapped text.''
		+	This is the <0>third subtype style</0>.
		+	This is the <1>fourth subtype style</1>.
		+	This is the <2>fifth subtype style</2>.
		+	This is the <3>sixth subtype style</3>.
		+	This is the <4>seventh subtype style</4>.
		+	This is the <5>eighth subtype style</5>.
		+
		+
		+	=== Color ===
		+
		+	Use the number sign/hash (#) tag to change the color of a text string. Colors are defined in hex format; the shorthand three-digit form is also supported (e. g. pure red can be defined as #FF0000 or #F00).
		+
		+	''Example:''
		+	Lips red as the <#FF0000>rose</#>, hair black as <#000>ebony</#>, skin white as <#FFF>snow</#>.
		+
		+
		+	== Text effects ==
		+
		+	under construction...

@@ Line 39: / Line 39: @@
 A third type of text is '''object text'''. This is a static text meant to show up more or less indefinitely. Consider it to be like an object image, just that you don't have to create a graphic file, and that it can easily be translated. You could use it to label menu or interface buttons for example.
-As the name indicates, object texts are bound to scene objects (or interface buttons). You add them by using the [[Action Parts#Display_object_text|"Display object text"]] action part. It basically doesn't matter which scene object you choose, because object and object text don't have to show up at the same position on the screen. You are free to place the text anywhere you like. What does matter: if you disable the object, the object text will disappear, too. You cannot bind more than one object text to an object.
+As the name indicates, object texts are bound to scene objects (or interface buttons). You add them by using the [[Action Parts#Display_object_text|"Display object text"]] action part. It basically doesn't matter which scene object you choose, because object and object text don't have to show up at the same position on the screen. You are free to place the text anywhere you like. What does matter: if you disable the object, the object text will disappear, too. Use the [[Action Parts#Hide_object_text|"Hide object text"]] action part to hide an object text without having to hide the whole object.
-Use the [[Action Parts#Hide_object_text|"Hide object text"]] action part to hide an object text without having to hide the whole object.
+You cannot bind more than one object text to an object.
-== Text component ==
+== Component text ==
-See the [[Components]] page for more on this.
+Components in Visionaire Studio can be viewed as object extensions. They add additional features to the respective objects. One of the available components is the '''text component''' which you can add to scene objects and interface buttons.

@@ Line 46: / Line 46: @@
 == Text component ==
-tbd
+See the [[Components]] page for more on this.
@@ Line 98: / Line 98: @@
 ==== LibreOffice ====
-* Start LibreOffice Calc
+* Start LibreOffice/OpenOffice Calc.
 * Open the previously exported .csv file. In the "Text Import" dialog select "Unicode (UTF-8)" as "character set". Set the separator to "Semicolon" (instead of "Colon"). Leave the "Text delimiter" as ". Press "OK" to import the .csv file.
 * After all changes are made and the file is ready for import in Visionaire go to "Save as" and select "Text CSV (.csv)" for file type.

@@ Line 42: / Line 42: @@
 Use the [[Action Parts#Hide_object_text|"Hide object text"]] action part to hide an object text without having to hide the whole object.
@@ Line 73: / Line 78: @@
 [[File:text25n.png|right|25px|link=]]
 The "Texts" section lists all texts of your game for easy proof-reading and translation. Select an entry, set the two text boxes on the right hand side to different languages (via flag icons), and you can enter the translation for this text.
 [[File:Text export.png|thumb|250px|Text export dialog]]
-If you wish to to edit translations externally, you may export all text strings of your game. Choose "Export texts…" from the editor menu. In the dialog window you can select from a list of file formats (<span class="inlinecode">"Export"</span>), with .po and .csv being best suited for translation purposes. Choose the "original" language (<span class="inlinecode">"Active language"</span>) and the <span class="inlinecode">Translation language</span>. After completing the translation, re-import the texts via "Import texts…" in the editor menu.
+If you wish to to edit translations externally or need to pass the texts to voice artists, you may export all text strings of your game. Choose "Export texts…" from the editor menu. In the dialog window you can select from a list of file formats (<span class="inlinecode">"Export"</span>), with .po and .csv being best suited for translation purposes. Choose the "original" language (<span class="inlinecode">"Active language"</span>) and the <span class="inlinecode">Translation language</span>. After completing the translation, re-import the texts via "Import texts…" in the editor menu.
-The ''[https://poedit.net/ "Poedit" application (external link)]'' is a free software for editing .po files; .csv files can be opened in spreadsheet programs (e.g. Microsoft Excel, LibreOffice Calc).
+==== Microsoft Excel ====
-<div style="clear:both"></div>
+* When you open the previously exported .csv file a "Text Import Wizard" is shown. Select the option "Delimited" for the "Original data type". Leave the "File origin" option as "65001: Unicode (UTF-8)". Then click on "Next >".
 {{toc}}