Synthesize Script - Revision history

Rob: /* Description */

2009-05-12T08:14:12Z

Description

← Older revision		Revision as of 08:14, 12 May 2009
Line 61:		Line 61:

	{{note}} The Synthesize script is read-only. Within this script, virtually all aspects of the structural hierarchy can be accessed, but nothing can be changed.		{{note}} The Synthesize script is read-only. Within this script, virtually all aspects of the structural hierarchy can be accessed, but nothing can be changed.

			{{note}} While within a Synthesize script and any procedures that are invoked, a global tag is automatically assigned by HL. The tag belongs to the "dossier" tag group and has the unique id of the dossier being output. This allows the script code to base its behavior on the actual dossier that the user is outputting.

	==Example==		==Example==

Rob: /* Technical Details */

2009-02-20T08:57:59Z

Technical Details

← Older revision		Revision as of 08:57, 20 February 2009
Line 15:		Line 15:
	\|Where Used:		\|Where Used:
	\|[[Dossier Element (Data)\|Dossiers]]		\|[[Dossier Element (Data)\|Dossiers]]
			\|-
			\|Procedure Use:
			\|"synthesize" type, "container" context
	\|-		\|-
	\|}		\|}

Rob at 00:18, 16 December 2008

2008-12-16T00:18:46Z

← Older revision		Revision as of 00:18, 16 December 2008
Line 12:		Line 12:
	\|Fields Finalized?		\|Fields Finalized?
	\|Yes		\|Yes
			\|-
			\|Where Used:
			\|[[Dossier Element (Data)\|Dossiers]]
	\|-		\|-
	\|}		\|}

Rob at 12:27, 15 December 2008

2008-12-15T12:27:08Z

← Older revision		Revision as of 12:27, 15 December 2008
Line 19:		Line 19:
	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|newline		\|class="leftnormal"\|newline
	\|Entry: Contains the appropriate text to begin a new line of text within the output being synthesized (i.e. insert a line break).<br>		\|(String) Entry: Contains the appropriate text to begin a new line of text within the output being synthesized (i.e. insert a line break).<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-
	\|boldon		\|boldon
	\|Entry: Contains the appropriate text to turn on output of bold text.<br>		\|(String) Entry: Contains the appropriate text to turn on output of bold text.<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-
	\|boldoff		\|boldoff
	\|Entry: Contains the appropriate text to turn off output of bold text.<br>		\|(String) Entry: Contains the appropriate text to turn off output of bold text.<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-
	\|italicson		\|italicson
	\|Entry: Contains the appropriate text to turn on output of italic text.<br>		\|(String) Entry: Contains the appropriate text to turn on output of italic text.<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-
	\|italicsoff		\|italicsoff
	\|Entry: Contains the appropriate text to turn off output of italic text.<br>		\|(String) Entry: Contains the appropriate text to turn off output of italic text.<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-
	\|separator		\|separator
	\|Entry: Contains the appropriate text to insert a suitable horizontal separator. In HTML output, this is the "<nowiki><hr></nowiki>" element, and elsewhere it's a line consisting of a string of dashes.<br>		\|(String) Entry: Contains the appropriate text to insert a suitable horizontal separator. In HTML output, this is the "<nowiki><hr></nowiki>" element, and elsewhere it's a line consisting of a string of dashes.<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-

Rob at 23:17, 13 December 2008

2008-12-13T23:17:49Z

← Older revision		Revision as of 23:17, 13 December 2008
Line 39:		Line 39:
	\|-		\|-
	\|separator		\|separator
	\|Entry: Contains the appropriate text to insert a suitable horizontal separator. In HTML output, this is the "<hr>" element, and elsewhere it's a line consisting of a string of dashes.<br>		\|Entry: Contains the appropriate text to insert a suitable horizontal separator. In HTML output, this is the "<nowiki><hr></nowiki>" element, and elsewhere it's a line consisting of a string of dashes.<br>
	Exit: Ignored.		Exit: Ignored.
	\|-		\|-
			\|}

	==Description==		==Description==

	The Synthesize script is utilized when generating text output for a character dossier. A classic example is the creation of statblock output. When the user requests text output, he will also specify the style to be used when synthesizing the output (e.g. HTML, BBCode, or plain text). Before the script is invoked, HL will setup a number of appropriate mechanisms for that output style, which are provided via the various special symbols. For example, in HTML output, the "@boldon" special symbol will map to "<b>", while it will be "[b]" for BBCode output and do nothing for plain text output. This makes it possible for you to write a single Synthesize script that will generate output properly for each different style, without having to do any special handling within the script.		The Synthesize script is utilized when generating text output for a character dossier. A classic example is the creation of statblock output. When the user requests text output, he will also specify the style to be used when synthesizing the output (e.g. HTML, BBCode, or plain text). Before the script is invoked, HL will setup a number of appropriate mechanisms for that output style, which are provided via the various special symbols. For example, in HTML output, the "@boldon" special symbol will map to "<nowiki><b></nowiki>", while it will be "[b]" for BBCode output and do nothing for plain text output. This makes it possible for you to write a single Synthesize script that will generate output properly for each different style, without having to do any special handling within the script.

	Unlike other scripts, the Synthesize script does not use a "@text" special symbol. Since the volume of output in some cases will be significant, using the standard approach simply isn't practical or efficient. Instead, the output is generated in sequential fashion, and the "append" language statement is used to accomplish this ([[Other Language Statements\|see details]]). The "append" statement allows you to systematically construct the output, one section at a time. Once something is output, you can forget about it and let HL handle it.		Unlike other scripts, the Synthesize script does not use a "@text" special symbol. Since the volume of output in some cases will be significant, using the standard approach simply isn't practical or efficient. Instead, the output is generated in sequential fashion, and the "append" language statement is used to accomplish this ([[Other Language Statements\|see details]]). The "append" statement allows you to systematically construct the output, one section at a time. Once something is output, you can forget about it and let HL handle it.

Rob: New page: {{context|Kit Reference|Script Types}} ==Technical Details== :{| class="scripttable" |class="leftnormal"|Initial Context: |Hero |- |Alternate Context: |None |- |Fields F...

2008-12-13T23:14:23Z

New page: {{context|Kit Reference|Script Types}} ==Technical Details== :{| class="scripttable" |class="leftnormal"|Initial Context: |Hero |- |Alternate Context: |None |- |Fields F...

New page

{{context|Kit Reference|Script Types}}

==Technical Details==

:{| class="scripttable"
|class="leftnormal"|Initial Context:
|[[Hero Context|Hero]]
|-
|Alternate Context:
|None
|-
|Fields Finalized?
|Yes
|-
|}

The Synthesize script utilizes the following special symbols:

:{| class="infotable"
|class="leftnormal"|newline
|Entry: Contains the appropriate text to begin a new line of text within the output being synthesized (i.e. insert a line break). 
Exit: Ignored.
|-
|boldon
|Entry: Contains the appropriate text to turn on output of bold text. 
Exit: Ignored.
|-
|boldoff
|Entry: Contains the appropriate text to turn off output of bold text. 
Exit: Ignored.
|-
|italicson
|Entry: Contains the appropriate text to turn on output of italic text. 
Exit: Ignored.
|-
|italicsoff
|Entry: Contains the appropriate text to turn off output of italic text. 
Exit: Ignored.
|-
|separator
|Entry: Contains the appropriate text to insert a suitable horizontal separator. In HTML output, this is the "<hr>" element, and elsewhere it's a line consisting of a string of dashes. 
Exit: Ignored.
|-

==Description==

The Synthesize script is utilized when generating text output for a character dossier. A classic example is the creation of statblock output. When the user requests text output, he will also specify the style to be used when synthesizing the output (e.g. HTML, BBCode, or plain text). Before the script is invoked, HL will setup a number of appropriate mechanisms for that output style, which are provided via the various special symbols. For example, in HTML output, the "@boldon" special symbol will map to "", while it will be "[b]" for BBCode output and do nothing for plain text output. This makes it possible for you to write a single Synthesize script that will generate output properly for each different style, without having to do any special handling within the script.

Unlike other scripts, the Synthesize script does not use a "@text" special symbol. Since the volume of output in some cases will be significant, using the standard approach simply isn't practical or efficient. Instead, the output is generated in sequential fashion, and the "append" language statement is used to accomplish this ([[Other Language Statements|see details]]). The "append" statement allows you to systematically construct the output, one section at a time. Once something is output, you can forget about it and let HL handle it.

If you need to do special formatting within a Synthesize script that is based on the output style, you can. You can find out the style by using the the "isdossierstyle" script target reference from within the [[State Context|State script context]].

The Synthesize script starts with the actor to be output as its initial context. You can then cull whatever information you need from the actor for inclusion within the output.

{{note}} The Synthesize script is read-only. Within this script, virtually all aspects of the structural hierarchy can be accessed, but nothing can be changed.

==Example==

Every statblock starts with the character's name and then continues with other appropriate information that depends on the game system. The example below shows the start of a Synthesize script that includes the name, race, and age of the character.

<pre>
var txt as string

~start by getting our name
if (empty(hero.actorname) = 0) then
txt = hero.actorname
else
txt = "Unnamed Character"
endif

~output our name
append @boldon & "Name: " & @boldoff & txt & @newline

~output any race
txt = hero.firstchild["Race.?"].field[name].text
if (empty(txt) <> 0) then
txt = "-none-"
endif
append @boldon & "Race: " & @boldoff & txt & @newline

~output age
append @boldon & "Age: " & @boldoff & hero.child[mscPerson].field[perAge].text & @newline
</pre>