Portals - Revision history

Rob at 08:21, 22 November 2008

2008-11-22T08:21:22Z

← Older revision		Revision as of 08:21, 22 November 2008
Line 1:		Line 1:
	~~[[Category:~~Basic Concepts and Terminology]]		{{context\|Basic Concepts and Terminology\|Visual Building Blocks}}
	~~[Context: [[Home~~\|~~HL Kit]] [[Basic Concepts and Terminology]] [[~~Visual Building Blocks~~]]]~~

	==Overview==		==Overview==

Rob: /* Overview */

2008-11-21T13:50:09Z

Overview

← Older revision		Revision as of 13:50, 21 November 2008
Line 8:		Line 8:
	Each of the different types of portals is summarized in the sections below. Complete details on each portal type will be found within the [[Kit Reference]] section of this documentation.		Each of the different types of portals is summarized in the sections below. Complete details on each portal type will be found within the [[Kit Reference]] section of this documentation.

	~~<span class="~~important~~">IMPORTANT!</span>~~ Portals are unlike most other elements used within the Kit. For portals that are defined within templates, the unique ids of those portals must only be unique within the context of the template. This means that you may freely re-use the same unique id for portals within different templates. For example, you could have a "name" or "delete" portal within multiple templates. Since portals within templates are only accessible through the template in which they are defined, their scope is uniquely restricted to the template, which makes the re-use of ids possible. Please note that this ability to re-use unique ids '''only''' applies to portals defined within a layout, so it does '''not''' apply to tables and other portals used directly within layouts.		{{important}}Portals are unlike most other elements used within the Kit. For portals that are defined within templates, the unique ids of those portals must only be unique within the context of the template. This means that you may freely re-use the same unique id for portals within different templates. For example, you could have a "name" or "delete" portal within multiple templates. Since portals within templates are only accessible through the template in which they are defined, their scope is uniquely restricted to the template, which makes the re-use of ids possible. Please note that this ability to re-use unique ids '''only''' applies to portals defined within a layout, so it does '''not''' apply to tables and other portals used directly within layouts.

	==Label Portals==		==Label Portals==

Rob: /* Overview */

2008-11-21T00:26:12Z

Overview

← Older revision		Revision as of 00:26, 21 November 2008
Line 7:		Line 7:

	Each of the different types of portals is summarized in the sections below. Complete details on each portal type will be found within the [[Kit Reference]] section of this documentation.		Each of the different types of portals is summarized in the sections below. Complete details on each portal type will be found within the [[Kit Reference]] section of this documentation.

			<span class="important">IMPORTANT!</span> Portals are unlike most other elements used within the Kit. For portals that are defined within templates, the unique ids of those portals must only be unique within the context of the template. This means that you may freely re-use the same unique id for portals within different templates. For example, you could have a "name" or "delete" portal within multiple templates. Since portals within templates are only accessible through the template in which they are defined, their scope is uniquely restricted to the template, which makes the re-use of ids possible. Please note that this ability to re-use unique ids '''only''' applies to portals defined within a layout, so it does '''not''' apply to tables and other portals used directly within layouts.

	==Label Portals==		==Label Portals==

Rob: /* Output Portals */

2008-11-16T09:18:06Z

Output Portals

← Older revision		Revision as of 09:18, 16 November 2008
Line 199:		Line 199:
	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|Label		\|class="leftnormal"\|Label
	\|		\|Renders text onto the character sheet, with the text being driven by any of the different mechanisms supported by on-screen label portals.
	\|-		\|-
	\|Image		\|Image
	\|		\|Draws an image onto the character sheet, with the image being handled in any of the different ways supported by on-screen image portals.
	\|-		\|-
	\|Table		\|Table
	\|		\|Renders a table of picks to the character sheet, using a template to specify the contents of each item within the table.
	\|-		\|-
	\|}		\|}

Rob: /* Special Portals */

2008-11-16T09:14:24Z

Special Portals

← Older revision		Revision as of 09:14, 16 November 2008
Line 183:		Line 183:
	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|Edit Settings		\|class="leftnormal"\|Edit Settings
	\|		\|Displayed as button that allows the user to edit configuration settings when clicked. This portal is typically used on the Configure Hero form.
	\|-		\|-
	\|Settings Summary		\|Settings Summary
	\|		\|Displayed as a grid that shows the currently selected configuration settings. This portal is typically used on the Configure Hero form.
	\|-		\|-
	\|Alliance		\|Alliance
	\|		\|Displayed as a menu that allows the user to select whether the character is to be considered an ally or an enemy for the purposes of the Tactical Console. This portal is typically used on the Configure Hero form.
	\|-		\|-
	\|}		\|}

Rob at 09:11, 16 November 2008

2008-11-16T09:11:43Z

← Older revision		Revision as of 09:11, 16 November 2008
Line 178:		Line 178:

	==Special Portals==		==Special Portals==

			Special portals are those portals that have highly specialized uses and cannot generally be customized by the author in term of behavior. However, they do need to be properly placed within the interface, so a special portal is used to represent the mechanism and allow placement. There are a number of special portals, as outlined below.

	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|		\|class="leftnormal"\|Edit Settings
	\|		\|
	\|-		\|-
			\|Settings Summary
	\|		\|
			\|-
			\|Alliance
	\|		\|
	\|-		\|-
			\|}

			==Output Portals==

			The output of character sheets entails a number of critical differences from the interactive visual elements used on-screen. As such, a different set of portals is used to render character sheet output. The presentation behaviors of output portals is similar, yet distinct, from interactive portals, and the set of available output portals consists of those outlined below.

			:{\| class="infotable"
			\|class="leftnormal"\|Label
	\|		\|
			\|-
			\|Image
			\|
			\|-
			\|Table
	\|		\|
	\|-		\|-
	\|}		\|}

Rob at 09:04, 16 November 2008

2008-11-16T09:04:05Z

← Older revision		Revision as of 09:04, 16 November 2008
Line 155:		Line 155:
	==Region Portals==		==Region Portals==

			Region portals make it possible to place a border around a rectangular region that doesn't correspond to a single portal. For example, if you want to visual group a few portals, you can define a region that encompasses all of them and place a border around the region, thereby placing a box around the group of portals.

	==Separator Portals==		==Separator Portals==

	~~:{\| class="infotable"~~		Separator portals allow you to put either a vertical or horizontal separator bar between sections of the display. Separators are an excellent way to visual group portals and make the interface more intuitive for the user.
	~~\|class="leftnormal"\|~~
	\|
	\|-
	\|
	\|
	\|-
	\|
	\|
	\|-
	\|}

	==Table Portals==		==Table Portals==

			Table portals present a collection of related picks in a tabular list. Each item in the table is displayed via a template that is specified with the table. The template specifies how to position the various facets of the pick within the table entry. There are different types of table portals, depending on what the portal contains and how it is to be presented.

	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|		\|class="leftnormal"\|Fixed
	\|		\|Fixed table portals display a table of picks that provides no means for the user to add or delete items.
	\|-		\|-
	\|		\|Dynamic
	\|		\|Dynamic table portals display a table of picks that includes an option at the bottom to add new items to the table. If the "add" option is used, the user is presented with a list of things to choose from and the one selected is added to the container as a new pick.
	\|-		\|-
	\|		\|Auto
	\|		\|Auto table portals display a table of picks that includes an option at the bottom to add new items to the table. If the "add" option is used, a specific thing is added to the container as a new pick, which the user can subsequently customize. The journal is an example of an "auto" table, where adding a new item automatically adds a new journal entry.
	\|-		\|-
	\|}		\|}

Rob at 08:50, 16 November 2008

2008-11-16T08:50:37Z

← Older revision		Revision as of 08:50, 16 November 2008
Line 67:		Line 67:

	==Menu Portals==		==Menu Portals==

			Menu portals enable the user to select one choice from a list of available choices. There are different types of menu portals, depending on what the portal contains.

	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|		\|class="leftnormal"\|Literal
	\|		\|Literal menus present a choice from a set of options that are pre-defined and fixed. They are suited for situations like the gender of a character and the method used for selecting ability scores in the d20 System.
	\|-		\|-
	\|		\|Array
	\|		\|Array-based menus use a script or other technique to synthesize the list of valid choices the user can select from.
	\|-		\|-
	\|		\|Things
	\|		\|Thing-based menus dynamically identify a group of things from which the user can select. They are useful when choosing a weapon type or spell type to assign a skill bonus.
			\|-
			\|Picks
			\|Pick-based menus dynamically identify a group of picks from which the user can select. They are ideal when you need apply an adjustment to something that is restricted to what the character possesses, such as choosing a weapon that the character has.
	\|-		\|-
	\|}		\|}


	==Chooser Portals==		==Chooser Portals==

			Chooser portals allow the user to select a thing from a table of options that include full descriptions. Once the thing is selected, it is added to the character as a pick and becomes an integral part of the character. Chooser portals are perfect for selecting a race or an alignment, since exactly one selection must be made for the character, and the user will want to be able to review the details associated with each possible choice.

	==Action Portals==		==Action Portals==

			Action portals are presented as buttons that trigger a specific action when interacted with by the user. There are many types of action portals, depending on what action is desired.

	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|		\|class="leftnormal"\|Delete
	\|		\|Triggers the deletion of a pick from the table that added it.
			\|-
			\|Info
			\|When clicked or the mouse is moved over the portal, full details on the pick are displayed.
			\|-
			\|Edit
			\|Triggers editing of the gizmo associated with a pick by bringing up a suitable form for the purpose.
			\|-
			\|Form
			\|Triggers the display of a specific tab panel as a form, such as is used to directly apply damage to actors from within the Tactical Console.
			\|-
			\|Trigger
			\|Invokes a script, such as when applying damage to an actor or resetting the accrued damage.
			\|-
			\|Notes
			\|Displays a form where arbitrary notes can be edited for a pick.
			\|-
			\|Load
			\|Switches to the actor associated with the specified pick, such as is used on the Dashboard and Tactical Console.
			\|-
			\|Lock
			\|Transitions the character into a locked state for the purposes of advancement.
			\|-
			\|Unlock
			\|Transitions the character into an unlocked state for the purposes of advancement.
			\|-
			\|Master
			\|Switches to the actor that is the "master" of the current actor.
			\|-
			\|Minion
			\|Switches to an actor that is the "minion" of the current actor.
			\|-
			\|Manage Gear
			\|Displays a menu through which the user can move gear between different containers.
			\|-
			\|Get Gear
			\|Displays a menu through which the user can move gear between actors.
			\|-
			\|Start Combat
			\|Begins a new combat within the Tactical Console.
			\|-
			\|End Combat
			\|End the current combat within the Tactical Console.
			\|-
			\|New Turn
			\|Starts a new combat turn within the Tactical Console.
			\|-
			\|Initiative Change
			\|Incorporates any direct initiative changes made by the user within the Tactical Console.
	\|-		\|-
	\|		\|Integrate
	\|		\|Integrates any pending actors into the current combat.
	\|-		\|-
	\|		\|Sort Dashboard
	\|		\|Triggers a re-sort of the actors shown on the Dashboard.
	\|-		\|-
	\|}		\|}

Rob at 05:40, 16 November 2008

2008-11-16T05:40:00Z

@@ Line 46: / Line 46: @@
 ==Edit Portals==
-Edit portals enable the user to edit the contents of a specific field. Simple edits provide direct editing of a numeric or text field, while date edits offer structured editing that ensures the contents of the field always subscribe to specific rules (e.g. four digits for year, two digits for month, etc.).
 :{| class="infotable"
-|class="leftnormal"|
+|class="leftnormal"|Simple
+|Simple edit portals provide direct editing of a numeric or text field.
 |-
+|Date
+|Date edit portals offer structured editing that ensures the contents of the field always subscribe to specific rules (e.g. four digits for year, two digits for month, etc.).
 |-
 |}
@@ Line 62: / Line 60: @@
 ==Incrementer Portals==
 ==Checkbox Portals==
 ==Menu Portals==
@@ Line 74: / Line 86: @@
 ==Action Portals==
 ==Region Portals==
@@ Line 80: / Line 103: @@
 ==Separator Portals==
 ==Table Portals==
 ==Special Portals==

Rob at 05:33, 16 November 2008

2008-11-16T05:33:26Z

← Older revision		Revision as of 05:33, 16 November 2008
Line 28:		Line 28:

	==Image Portals==		==Image Portals==
	Image portals enable the display of images to the user~~, and there~~ are different types~~. Literal images display the same~~ image ~~always~~, ~~field-based images show~~ the ~~image specified by a field, user images present the image selected by a user,~~ and ~~reference images allow a user-added image~~ to be ~~adapted dynamically at run-time (such as using the character portrait on the Tactical Console)~~.		Image portals enable the display of images to the user. There are different types of image portals, depending on what the portal contains and how it is to be presented.

	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|		\|class="leftnormal"\|Literal
	\|		\|Literal image portals always display the same, fixed image.
	\|-		\|-
	\|		\|Field-Based
	\|		\|Field-based image portals show the image dictated by the contents of a specific field.
	\|-		\|-
	\|		\|User
	\|		\|User image portals present the image that has been selected by a user.
			\|-
			\|Reference
			\|Reference image portals allow a user-added image to be dynamically adapted for use at run-time (such as using a tiny version of the first character portrait on the Tactical Console).
	\|-		\|-
	\|}		\|}