Incrementer Behavior (Savage) - Revision history

Rob: /* Define a New Style */

2009-02-19T22:26:52Z

Define a New Style

← Older revision		Revision as of 22:26, 19 February 2009
Line 17:		Line 17:
	id="incrDie">		id="incrDie">
	<style_incrementer		<style_incrementer
	~~textcolor~~="~~f0f0f0~~"		textcolorid="clrnormal"
	font="~~fntIncrSim~~"		font="fntincrsim"
	editable="no"		editable="no"
	textleft="13" texttop="0" textwidth="44" textheight="20"		textleft="13" texttop="0" textwidth="44" textheight="20"
	fullwidth="70" fullheight="20"		fullwidth="70" fullheight="20"
	plusup="~~incr_plus~~" plusdown="~~incr_pldn~~" plusoff="~~incr_plof" plusmask="incr_plmk~~"		plusup="incplusup" plusdown="incplusdn" plusoff="incplusof"
	plusx="59" plusy="0"		plusx="59" plusy="0"
	minusup="~~incr_minus~~" minusdown="~~incr_mindn~~" minusoff="~~incr_minof" minusmask="incr_minmk~~"		minusup="incminusup" minusdown="incminusdn" minusoff="incminusof"
	minusx="0" minusy="0">		minusx="0" minusy="0">
	</style_incrementer>		</style_incrementer>

Rob: Incrementer Behavior (Skeleton) moved to Incrementer Behavior (Savage)

2008-12-18T04:11:37Z

Incrementer Behavior (Skeleton) moved to Incrementer Behavior (Savage)

← Older revision	Revision as of 04:11, 18 December 2008
(No difference)

Rob at 02:30, 18 December 2008

2008-12-18T02:30:16Z

← Older revision		Revision as of 02:30, 18 December 2008
Line 9:		Line 9:
	The Skeleton files provide an assortment of pre-defined styles that we can build upon. However, for Savage Worlds, we need a special style that is ideal for showing and manipulating the die types of attributes and skills. All of the styles that are used within the user-interface are defined in the file "styles_ui.aug", so open that file. Locate where the various styles are defined for incrementers - there are three of them pre-defined for us.		The Skeleton files provide an assortment of pre-defined styles that we can build upon. However, for Savage Worlds, we need a special style that is ideal for showing and manipulating the die types of attributes and skills. All of the styles that are used within the user-interface are defined in the file "styles_ui.aug", so open that file. Locate where the various styles are defined for incrementers - there are three of them pre-defined for us.

	What we need is a customized version of the "incrSimple" style, so we'll start by copying that style. We need an appropriate id for our new style, so we'll use "incrDie" to clearly indicate that this style is intended for use in managing die types. The color and font details are fine, but we need to widen the incrementer a bit. In addition to increasing the full width of the incrementer, we also need to increase the area for showing text and we need to adjust the position where the "plus" behavior is positioned. This means we need to adjust three of the attributes: "fullwidth", "textwidth", and "plusx". All three values should be adjusted by the same amount, and we'll use 14 as a reasonable increase.		What we need is a customized version of the "incrSimple" style, so we'll start by copying that style. We need an appropriate id for our new style, so we'll use "incrDie" to clearly indicate that this style is intended for use in managing die types. The color and font details are fine, but we need to widen the incrementer a bit. In addition to increasing the full width of the incrementer, we also need to increase the area for showing text and we need to adjust the position where the "plus" behavior is positioned. This means we need to adjust three of the attributes: "fullwidth", "textwidth", and "plusx". All three values should be adjusted by the same amount, and we'll use 20 as a reasonable increase. Why so much? Because the style is used for skills, where we need to handle the display of "d12+2", and that requires about 20 extra pixels of width.

	A convenient feature of incrementers is that clicking within the text region allows the user to directly edit the contents as a textual value. For simple numbers, this feature is quite handy. However, we're multiplying the value by two and potentially including a roll adjustment, so a value displayed as "d8+1" would show the value "4" when the user tries to edit it. That's going to be quite confusing to users, so we're better off disabling this feature for our incrementer. This is accomplished by specifying the "editable" attribute with a value of "no". Putting it all together yields an incrementer style that looks similar to the one below.		A convenient feature of incrementers is that clicking within the text region allows the user to directly edit the contents as a textual value. For simple numbers, this feature is quite handy. However, we're multiplying the value by two and potentially including a roll adjustment, so a value displayed as "d8+1" would show the value "4" when the user tries to edit it. That's going to be quite confusing to users, so we're better off disabling this feature for our incrementer. This is accomplished by specifying the "editable" attribute with a value of "no". Putting it all together yields an incrementer style that looks similar to the one below.
Line 20:		Line 20:
	font="fntIncrSim"		font="fntIncrSim"
	editable="no"		editable="no"
	textleft="13" texttop="0" textwidth="38" textheight="20"		textleft="13" texttop="0" textwidth="44" textheight="20"
	fullwidth="64" fullheight="20"		fullwidth="70" fullheight="20"
	plusup="incr_plus" plusdown="incr_pldn" plusoff="incr_plof" plusmask="incr_plmk"		plusup="incr_plus" plusdown="incr_pldn" plusoff="incr_plof" plusmask="incr_plmk"
	plusx="53" plusy="0"		plusx="59" plusy="0"
	minusup="incr_minus" minusdown="incr_mindn" minusoff="incr_minof" minusmask="incr_minmk"		minusup="incr_minus" minusdown="incr_mindn" minusoff="incr_minof" minusmask="incr_minmk"
	minusx="0" minusy="0">		minusx="0" minusy="0">

Rob: New page: {{context|Authoring Examples|Savage Worlds Walk-Through}} ===Overview=== One glaring facet of the interface is that the incrementers used for attributes and skills are too narrow. While ...

2008-12-17T07:00:39Z

New page: {{context|Authoring Examples|Savage Worlds Walk-Through}} ===Overview=== One glaring facet of the interface is that the incrementers used for attributes and skills are too narrow. While ...

New page

{{context|Authoring Examples|Savage Worlds Walk-Through}}

===Overview===

One glaring facet of the interface is that the incrementers used for attributes and skills are too narrow. While there is enough space to show the die type, any roll adjustment gets cut off. In addition, the interactive behavior of the incrementers is problematic in one respect. So we need to address these aspects.

===Define a New Style===

The Skeleton files provide an assortment of pre-defined styles that we can build upon. However, for Savage Worlds, we need a special style that is ideal for showing and manipulating the die types of attributes and skills. All of the styles that are used within the user-interface are defined in the file "styles_ui.aug", so open that file. Locate where the various styles are defined for incrementers - there are three of them pre-defined for us.

What we need is a customized version of the "incrSimple" style, so we'll start by copying that style. We need an appropriate id for our new style, so we'll use "incrDie" to clearly indicate that this style is intended for use in managing die types. The color and font details are fine, but we need to widen the incrementer a bit. In addition to increasing the full width of the incrementer, we also need to increase the area for showing text and we need to adjust the position where the "plus" behavior is positioned. This means we need to adjust three of the attributes: "fullwidth", "textwidth", and "plusx". All three values should be adjusted by the same amount, and we'll use 14 as a reasonable increase.

A convenient feature of incrementers is that clicking within the text region allows the user to directly edit the contents as a textual value. For simple numbers, this feature is quite handy. However, we're multiplying the value by two and potentially including a roll adjustment, so a value displayed as "d8+1" would show the value "4" when the user tries to edit it. That's going to be quite confusing to users, so we're better off disabling this feature for our incrementer. This is accomplished by specifying the "editable" attribute with a value of "no". Putting it all together yields an incrementer style that looks similar to the one below.

<pre>
<style
id="incrDie">
<style_incrementer
textcolor="f0f0f0"
font="fntIncrSim"
editable="no"
textleft="13" texttop="0" textwidth="38" textheight="20"
fullwidth="64" fullheight="20"
plusup="incr_plus" plusdown="incr_pldn" plusoff="incr_plof" plusmask="incr_plmk"
plusx="53" plusy="0"
minusup="incr_minus" minusdown="incr_mindn" minusoff="incr_minof" minusmask="incr_minmk"
minusx="0" minusy="0">
</style_incrementer>
</style>
</pre>

===Use the Style===

Once our new style is defined, we need to put it to use. There are only two places where we need to let the user manipulate the die type via an incrementer. The first is on the "Basics" tab where we manipulate attributes, so open the file "tab_basics.dat" and locate the "baAttrPick" template. Change the style of the incrementer used within it to "incrDie". The other location is on the "Skills" tab, so open the file "tab_skills.dat", locate the incrementer used for skills, and change that style as well. Re-loading the data files should now result in more appropriate behaviors for manipulating die types.