Objects

To insert an object:

Select the object to be inserted from the Object Toolbar on the left of the Authoring Stage.
Drag and drop the object to the desired location on the page.

-or-

Click on an object on the Object Toolbar. It will be added to the Stage at a default location.
Position the object to the desired location on the page.

Note: If a Subset is currently selected when adding a new object, that object will be added inside that Subset. If you desire to add an object to the Stage, be sure to click on the Stage. Similarly, if you wish to add an object to a Subset, be sure to click on the Subset to make it your current selection.

Note: Sets cannot be added to Subsets, only at the Stage level. If you wish to create another Subset in a Set, you can use the controls on the Set

Common Properties

A number of Properties are shared by many objects.

To change the Name of an object

1. Open the Properties panel.

2. Click in the Name field.

3. Edit the name as desired.

Tip: When inserting an object, it will be given a generic name. For instance, if you insert a button, it might be named 'Button 2'. In general, it is always good practice to change the name of your object to something specific so that you know what it is just by seeing its name.

Descriptions are used by screen reading software for certain objects. Also for Graphics, Audio and Video, the description will be used for the exported media list.

To add a description to an object:

Open the Properties panel.
Enter text in the Description field.

To change the Start Visible property of an object:

Select the object on the stage.
In the Properties panel check or clear the Start Visible check box.

When the page loads, if the Start Visible property is checked, that item will show.

Note: When adding displays to the Flow Chart, and objects to the Timeline, the child objects' Start Visible Properties are automatically disabled because the Flow Chart and Timeline take control over the display.

To change the Position of an object:

1. Open the Properties panel.

2. Click in the Position > X or Position > Y field according to which value you want to change.

3. Change the value to the desired value.

Note: You can also move an object by clicking and dragging it to its desired position.

To change the Size of an object:

1. Open the Properties panel.

2. Click in the Size > Height or Size > Width field according to which value you want to change.

3. Change the value to the desired value.

Note: You can also resize an object by selecting the object on the stage, then clicking and dragging one of the resize handles to the desired size.

To change the Alpha of an object:

Select the object on the stage.
In the Properties panel set the Alpha field to the desired value.

An Alpha of 100 is completely opaque, and an Alpha of 0 is invisible.

To change an object's Transitions

The transition property of an object refers to any display effects applied when that object is shown or hidden (such as fade in or fade out).

To change an object's transitions:

Open the Properties panel.
Click on the Transitions button.
Click on the Show or Hide tab according to which transition you want to affect.
(Required) Click the Time drop down menu to specify the speed of the transition.
(Optional) Click the Effects Category drop down menu to choose the desired effect.
Then, click the effect tile in the effect display window.
(Optional) Select the Fade check box to cause the effect to fade.
(Optional) Select the Zoom check box to cause the effect to zoom.
(Optional) Select a direction from the Spin dropdown to cause the effect to spin.
Click OK.

Note: For a Transition to work properly, it must have a Time property specified. To turn off Transitions, simply set the Time dropdown to Disabled.

Note: Obviously, one has to select some sort of transition to take place over the required time period. Any or all of the optional properties listed above can be used, meaning that a Medium Fade In, with no Effect is perfectly valid.

The Object Menu

The Object menu shortcut allows you to quickly create a trigger action using that object or find all actions associated with that object.

Create an Action using the Object Menu

Select the object you want to act as the trigger object.
Click the Object menu icon.
Select "Create action".
Select the desired trigger method.
Click the Object selection button.
Choose the desired response object.
Click the Method selection button.
Choose the desired method.
Click OK.
When the summary window appears, you may change the action as desired.
Click OK.

Find actions referencing a particular object

Select the object you want to act as the trigger object.
Click the Object Menu icon.
Select "Actions Using This Object".
Select the desired action category.
If the action is being referenced in the way you specified, it will appear highlighted in the Action List or Flow Chart.

Select the object on the stage and use the Object Menu to select "Actions Using this Object > All"

Or, if you're using Variables, select the Variable (click the Variable's type) and use the "Where Used" Icon.

Where used

This will result in the action(s) getting highlighted in orange in the Action List...

...or highlighted in orange in the Flow Chart.

Audio object

The Audio object holds MP3s.

Note: Although SmartBuilder will play any .MP3 format, it is beneficial to encode your .MP3s at a size that is optimal for online viewing. We suggest:

Layer-3, 44100Hz
128 Kbps, mono

To select the audio media:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, click Select Media.
-or-
Double click on the Audio object.
From the Media Select window, choose the media that you wish to place in your lesson.
Click Select.

Note: You must be an owner of the media, or the media must be located in a shared folder.

You can choose whether or not to preload your audio.

To preload the audio:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, check or clear the Preload checkbox.

You can choose whether the audio starts to play when it is shown or not. Even with Autoplay checked, if an audio object is hidden, or placed in a non-visible Display, it will not play until it is shown. Uncheck autoplay only if you want to start the audio with an action, or a user's click.

User tip: Putting an Audio object in a feedback display with {Autoplay = on} and {Display Controller = off} is a great way to add audio without having to add new actions.

To enable or disable autoplay:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, check or clear the Autoplay checkbox.

You can choose whether the controller is displayed or not.

To enable or disable the controller:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, check or clear the Display Controller checkbox.

You can also choose which type of controller you wish to display.

To choose the controller style:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, choose the controller style that you want from the Controller Style drop down.

You can also determine whether the audio loops or not. A loop count of 0 will play through the audio 1 time and then stop.

To choose the controller style:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, choose the number of loops that you want from the Loop drop down.

You can set the volume for this specific Audio object.

Note: You can set the audio for the entire lesson dynamically using the Page Controller > setAudioVolume response method. You can also use the volume controller widget to further expose this control to the end learner.

To set the volume for this object:

Make sure that you have an Audio object selected on the stage.
In the Properties panel, enter the percentage of volume that you wish in the Volume field. 100 is full volume, and 0 is completely silent.

Note: A volume setting of 100 is the maximum value. Any number above that will be treated the same as 100.

Methods for Audio object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onSoundComplete	Trigger	Triggers when audio track finishes.
Get Current Time	Condition	Returns current time elapsed in audio object.
Get Total Time	Condition	Returns total time of audio object.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
Go to Time	Response	Sets audio object to specified time.
hide	Response	Stops the audio and hides the controller, if there is one.
Pause Sound	Response	Pauses the audio track.
Play Sound	Response	Plays the audio object.
Restart Sound	Response	Plays the audio track from the beginning.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Starts the audio and shows the controller, if there is one.

Button object

Buttons are one of the most common interactive objects that you will use when authoring in SmartBuilder.

To change the Button label:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, enter a name into the Button Label field.

You can have multiple Buttons that are linked in a group, meaning that when you click on one Button, it will remain in the selected state and all other Buttons in that group will become unselected. This is similar to the idea behind Radio Buttons.

To create a Button group:

Multi-select the Buttons on the Authoring Stage that you wish to place in the same group.
In the Properties panel, enter a name into the Group Name field.

Note: You do not have to multiselect all the Buttons at once to do this. As long as the Buttons exist in the same lesson, and have the same Group Name, they will be mutually exclusive. This means Buttons in the same group can exist in different subsets.

Note: Adding a Button to a group will automatically set the Toggle property to on.

If you want similar functionality, but with only one Button, you can declare whether you want the Button to toggle (stay selected when clicked, and unselected when clicked again) and whether you want it to start selected or not.

To set a Button to toggle:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, set or clear the Toggle checkbox.

To set a Button to start selected:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, set or clear the Selected checkbox.

Note: It is uncommon to turn the Selected property on without either using Toggle or having the button in a group.

You can also change the appearance of the Button, either choosing from some preset styles, or importing different button states as graphics or SWFs. Buttons have three states: Normal, On Rollover, and On Press.

Note: To change the appearance of the text, please see the section on Text Formatting.

To choose a different style for your Button:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, choose a different style from the Style drop down.

You can also change the accent color for the default styles. Some styles display this accent more prominently than others.

To change the color of the button:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, enter a color in the Color field.

To assign new graphics to your Button:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, choose a the Custom style from the Style drop down.
Click on the edit button for the Normal Graphic property.
Choose the appropriate graphic or SWF for the Button from the Media Select window.
Click Select.
Repeat steps 4 and 5 for the On Rollover Graphic and On Press Graphic properties.

Note: All button states must have a graphic assigned to it in order to work. They do not have to be unique (you can use the same graphic for one, two, or all different states).

Tip: Once you have set up one button, you can copy and paste it to reuse it.

When creating and importing SWFs to use as buttons, be sure to follow the SWF importing guidelines.

Additionally, you can add a sound to the button to provide an audio cue that the button has been clicked.

To add a sound to your Button:

Make sure that a Button is selected on the Authoring Stage.
In the Properties panel, click the edit button for the Click Sound property.
Choose the appropriate sound for the Button from the Media Select window.
Click Select.

Methods for Button object

onClick	Trigger	Triggers when the object is clicked.
onRollout	Trigger	Triggers when the mouse moves off of the object.
onRollover	Trigger	Triggers when the mouse moves over the object.
onSelect	Trigger	Triggers when object is selected (clicked or moved into down state).
isClicked	Condition	Checks to see if button has been clicked yet.
isSelected	Condition	Checks to see if the button object is in a down state (true) or not (false).
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setClicked	Response	Changes the state of a button to clicked or not.
setHyperlink	Response	Sets the hyperlink associated with the object. The specified resource will be launched in a pop-up browser window when the button is clicked.
setLabel	Response	Changes the button label to static text, variable, name of another object, or other string.
setSelected	Response	Sets the button to a down state. If the button is part of a group (using the "Group Name" property), the other buttons in the group will be set to an up state.
enable	Response	Reverses the disabled state and returning the button back to its normal operations.
disable	Response	Deactivates the button, leaving it frozen on the UP state, with no Rollover change and slightly greyed out.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

CheckBox Group and RadioButton

CheckBox and RadioButton Groups are almost identical.

CheckBox Groups can have 0, 1, or more selected choices.

RadioButton Groups typically have one and only one choice selected. Clicking on another choice will clear the previous choice. They can have 0 choices selected, but this is usually the initial state of a multiple choice question. They cannot have more than 1 choice selected.

To edit, add, or reorder the answers:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, click the Edit Answers button.
-or-
Double click on the object.
In the Edit Answers window, you can:

Add new answers by clicking the Add button.
Delete answers by selecting the undesired answer and clicking the Delete button.
Reorder answers by selecting the desried answer and using the Move Arrows.
Edit answers by selecting the desired answer and clicking the Edit button.
-or by-
Double clicking on the desired answer.

Edit the answers by double clicking on what you want to change. Double click on the object to open the answers, double click on the answer to edit the text.

You can randomize answers if you want to deter learners from simply learning the positions of correct answers, rather than learning the . Randomization only occurs when previewing or viewing published content, and is only cosmetic. This means it does not effect the order of the answers when viewing them on the Authoring Stage, or in any actions.

To randomize the answers:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, check or clear the Randomize Answers checkbox.

You can also customize the look of the CheckBox Groups or RadioButton Groups in a number of ways.

To change the layout:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, choose Vertical or Horizontal from the Layout dropdown.

To change the label placement:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, choose a placement from the Label Placement dropdown.

To change the distance between the label and the radio button/checkbox:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, enter a value in the Label Spacing field.

To change the distance between one radio button/checkbox and the next:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, enter a value in the Box Spacing field.

To change the size of the radio buttons/checkboxes:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, select a size from the Radio Button Size drop down.

To change the style of the radio buttons/checkboxes:

Select a CheckBox or RadioButton Group on the stage.
In the Properties panel, select a style from the Style drop down.

Methods for CheckBox Group object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onSelectionChange	Trigger	Triggers when an option is selected or deselected.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
getSelection	Condition	Returns a comma delimited string indicating the checked status. For example, a checkbox group with 4 boxes and boxes 2 and 4 selected would return: f,t,f,t
isOptionSelected	Condition	Checks to see if the specified value (option) is selected.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setSelection	Response	Changes which checkboxs are selected to the specified values.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Methods for RadioButton object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onSelectionChange	Trigger	Triggers when an option is selected or deselected.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
getSelection	Condition	Returns radio button object's current selection as a number (first option selected = 1, second = 2, etc).
getOptionText	Condition	Returns the text of the specified option. Often used with getSelection.
isOptionSelected	Condition	Checks to see if specified value (option) is selected.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setSelection	Response	Changes which radio buttons are selected to the specified values.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Display Sets

It is often useful to show or hide a number of objects at the same time. For instance, you might want to show feedback for a question that includes a text object, a graphic, a background shape, and an audio clip. Rather than creating four separate actions to show these objects, you can group these objects and then create a single action to simply show the entire group.

Display sets control when each subset is shown or hidden. Here, the term "subset" refers to a display in the set.

Group of objects = display = subset

Set = group of subsets

The image below shows that "Display Set 1" contains three displays, and "Display 1" contains three objects.

Sets can save you time in the following ways:

You can show and hide multiple objects with one action method (eg. show Display 1 will show all the elements inside the set).
When you show a subset, you don't have to bother hiding the other subsets (you con't need to tell the system to hide Q1 when Q2 is shown).
You can move ALL the subsets in a set with just one move
You can apply transitions to ALL the subsets in a set in one step.
You can easily/visually create conditional branching by linking subsets to the Flow Chart.

The Display toolbar can be used to navigate, add or remove displays from the set.

To navigate between displays in the set:

Use the Back and Next buttons on the display toolbar.
Alternatively, click on the desired display in the Cast panel.

To add a display to a set:

Click the Insert button on the display toolbar. This will add a new display at the end of the set with the default objects.
Click the Duplicate button on the display toolbar. This will add a new display at the end of the set with all the same objects as the duplicated set.
Select a display by clicking in it once, clicking the header, or selecting it in the Cast panel. Use the copy and paste buttons in the Main Toolbar or using the keyboard shortcuts. This is useful for copying displays from one set to another.

To delete a display from a set:

Select the display you wish to delete, either on the Authoring Stage, or from the Cast.
Click the Delete button on the display toolbar.

Methods for Display Set

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onSubsetChange	Trigger	Triggers when current display is changed.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getActiveSubsetIndex	Condition	Returns the number of the currently visible subset.
getSubsetCount	Condition	Returns the total number of subsets.
hide	Response	Hides the display.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the display and starts any media within that display.
gotoSubset	Response	Goes to a particular subset index number, based on a static value, or a function from a variable or another object.
nextSubset	Response	Shows the next subset.
previousSubset	Response	Shows the previous subset.
printVisibleSubset	Response	Sends the active subset to the printer.
submitCurrentSubset	Response	Submits the currently active subset in the Flow Chart. If one of the children is not the active subset in the Flow Chart, this mnethod doesn't do anything.

Methods for Display

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onSubmit	Trigger	Triggers when display is submitted.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Hides the display.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the display and starts any media within that display.
submit	Response	Submits the display (continues the Flow).

Drag and Drop object

A drag-and-drop interaction is good for classification, association, and identification interactions. Typically, a user drags multiple objects onto one or more drop objects.

The drag-and-drop object is considered a master object which means that it takes control of other objects on the page. There are three types of objects that can be used as drag objects: text, shapes, and graphics. The drag-and-drop object can only control objects located in the same peer group as itself. For example, if the drag-and-drop object is within a display, it can only control objects also in that display.

Select drag objects

1.Select the Drag and Drop object.

2. Open the Properties panel.

3. Click the Edit Drag and Drop button.

4. Under the first column, labeled Drag objects, click the Add button.

5. Select the desired object to be added out of the list.

Tip: You can also simply double-click the drag and drop object to edit its properties.

Select drop objects

1.Select the Drag and Drop object.

2. Open the Properties panel.

3. Click the Edit Drag and Drop button.

4. Under the second column, labeled Drop objects, click the Add button.

5. Select the desired object to be added out of the list.

Tip: You can also simply double-click the drag and drop object to edit its properties.

Specify the correct drag and drop object pairings

1. Select the Drag and Drop object.

2.Open the Properties panel.

3. Click the Edit Drag and Drop button.

4. After adding your drag and drop objects respectively, select the drag object for which you want to specify the correct drop zone.

5. Select the radio button next to the drop object which you want to match with this drag object.

6. Repeat this process of all the drag objects.

Select feedback objects

There are five object types that can be used as feedback objects: text, shapes, graphics, audio, and video. These objects must be located on the same root level as the drag and drop object.

To select which objects to use as feedback objects:

Select the Drag and Drop object.
Open the Properties panel.
Click the Edit Drag and Drop button.
Under the third column, labeled Correct feedback, click the Add button.
Select the desired object to be added out of the list.
Repeat this process with the fourth column, labeled incorrect feedback.
Once feedback objects have been selected, they need to be associated with drag and drop pairings.

Associate feedback objects with drag and drop pairings

1. Select the Drag and Drop object.

2. Open the Properties Panel.

3. Click the Edit Drag and Drop button.

4. Select the drag object for which you want to specify feedback.

5. In the Correct feedback column, click the Show check box next to the object you want to display as correct feedback (selection of multiple objects is possible).

6. Repeat this process for the Incorrect feedback column.

Specify correct release settings

The correct release settings determine how the system should behave when a correct drag and drop pairing is achieved.

When a drag object is dropped on the correct drop object:

Selecting the Hide drag object setting will cause the drag object to disappear.
Selecting the Use feedback graphic setting will cause a feedback graphic to appear anchored to the drag object.
Selecting the Hide feedback on start of next drag setting will hide feedback for that drag object once the next drag object is clicked.

Specify incorrect release settings

The incorrect release settings determine how the system should behave when an incorrect drag and drop pairing is specified.

When a drag object is dropped on the incorrect drop object:

Selecting the Hide drag object setting will cause the drag object to disappear.
Selecting the Use feedback graphic setting will cause a feedback graphic to appear anchored to the drag object.
Selecting the Hide feedback on start of net drag setting will hide feedback for that drag object once the next drag object is clicked.
Selecting the Slide to start setting will cause the drag object to slide to its original position if it has been dropped in the incorrect drop zone.

Specify drop settings

Drop settings determine the behavior of the drop object when it is dropped during the drag and drop interaction.

When a drag object is released outside (off) of a drop area, it can be set to slide, or snap, back to the starting position, or remain in place (stay).

When a drag object is released on a drop area, it can be set to slide, or snap, into position on the drop area, or stay where it was dropped.

Select the Drag and Drop object.
Open the Properties panel.
Click the Edit drag and drop button.
In the Drop settings section, select the radio buttons to change the settings of the drag object's drop behavior.

Use delayed feedback

In the Feedback Settings section, selecting delayed feedback will cause all the triggered feedback objects to not show until some external event tells them to. For instance, when all drag objects have been dropped, then show the feedback objects. This will require setting up an action to trigger delayed feedback.

Select the Drag and Drop object.
Open the Properties panel.
Click the Edit drag and drop button.
In the Feedback Settings section, click the Delay feedback until all objects are dropped radio button.

How to trigger delayed feedback

When using the delayed feedback setting, you must specify both the trigger (for example, onAllDropped) and type of feedback (eg. "Show All", which will show feedback for both correctly and incorrectly dropped objects).

The trigger and feedback settings are specified in the Action List as exemplified below:

Use immediate feedback

In the Feedback Settings section, selecting to show feedback immediately will cause all the feedback objects associated with that drag and drop object to verify if they should be shown or not as soon as that drag object is dropped.

Select the Drag and Drop object.
Open the Properties panel.
Click the Edit drag and drop button.
In the Feedback Settings section, click the Show feedback immediately after each drop radio button.

Using the align feature

Selecting the Auto align setting will cause drag objects to align themselves to the drop object. This is a useful setting for when you have multiple drag objects dropped on the same drop object. The direction corresponds to which side of the drop object to align the drag objects. The distance between objects specifies how close to each other drag objects should line up.

Using the 'Correct Placement' button

This feature will allow you to specify the number of incorrect drops the learner can make before a button shows up. Clicking that button will move all the drag objects to their correct positions. You must specify the number of drops, and point to a particular button on the Authoring Stage. The Drag and Drop object will handle when to show, hide, and what will happen when the button is clicked.

Methods for Drag and Drop object

onAllCorrect	Trigger	Triggers when all drop areas contain the correct drag objects.
onAllDropped	Trigger	Triggers when all drag objects have been dropped.
onDrag	Trigger	Triggers when a drag object is clicked and dragged.
onDrop	Trigger	Triggers when a drag object is released.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onCorrectDrop	Trigger	Triggers when an object is dropped correctly.
onIncorrectDrop	Trigger	Triggers when an object is dropped incorrectly.
Get Correct Drop Count	Condition	Returns number of objects dropped on the correct drop areas.
Get Incorrect Drop Count	Condition	Returns number of objects not dropped on the correct drop areas.
Get Pass	Condition	Returns true or false based on whether enough objects were dropped on their correct drop areas to meet the "pass" requirement.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
MoveAllToCorrect	Response	Moves all drag objects the correct drop areas.
Reset All	Response	Moves all drag objects back to the original places.
Reset Incorrect	Response	Moves all incorrectly dropped drag objects back to the original places.
Reset Incorrect Drop Count	Response	Sets incorrect drop count to zero.
Set Pass	Response	Sets the "pass" requirement to true or false.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.
Show All	Response	Shows all drag objects.
Show Correct	Response	Makes the correctly placed drag objects visible.
Show Incorrect	Response	Makes the incorrectly placed drag objects visible.

Drop Down list

Drop Down Lists are another way to collect data from learners.

To edit, add, or reorder the answers:

Select a Drop Down List on the stage.
In the Properties panel, click the Edit Answers button.
-or-
Double click on the Drop Down List.
In the Edit Answers window, you can:

Add new answers by clicking the Add button.
Delete answers by selecting the undesired answer and clicking the Delete button.
Reorder answers by selecting the desried answer and using the Move Arrows.
Edit answers by selecting the desired answer and clicking the Edit button.
-or by-
Double clicking on the desired answer.

To change the default text:

Select a Drop Down List on the stage.
In the Properties panel, enter the new value in the Default Text field.

Methods for DropDown List object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onSelectionChange	Trigger	Triggers when the selection changes.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
getSelection	Condition	Returns the object's current selection in number format (first selection = 1, second = 2, etc).
getOptionText	Condition	Returns the text of the specified option. Often used with getSelection.
isOptionSelected	Condition	Checks to see if specified value (option) is selected.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setSelection	Response	Changes which drop down item is selected to the specified value.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Graphic object

Graphic objects can hold the following image types:

JPGs
GIFs
PNGs
SWFs

Because they can hold SWFs, Graphics can contain animations. If using animated SWFs, please refer to the SWF Best Practices page.

Note: Graphic placeholders will display their Name and Description properties, which can be useful for rapid prototyping.

To select media to place in the Graphic:

Make sure a graphic object is selected on the stage.
In the Properties panel, click the button next to Select Media.
-or-
Double click on the Graphic placeholder.
From the Media Selection window, choose the graphic that you wish to load.
Click Select.

When Graphics are loading, they display a loading image, which can be changed in the Preferences. If you wish for the page to not display until the image has been loaded, you will want to preload that image. Really, it is a matter of whether you want your learner to see a loading screen for a while, or one that loads piece by piece. By default preloading is set to off for each new Graphic.

To turn on or off preloading a Graphic:

Make sure a graphic object is selected on the stage.
In the Properties panel, check or clear the Preload checkbox.

When scaling graphics, sometimes you don't want to change the size at all (say it is a raster image), or you want to make sure it scales proportionally.

To lock a Graphic at its original size:

Make sure a graphic object is selected on the stage.
In the Properties panel, check or clear the Lock at Original Size checkbox.

To lock a Graphic's aspect ratio:

Make sure a graphic object is selected on the stage.
In the Properties panel, check or clear the Lock Aspect Ratio checkbox.

You can also flip a Graphic horizontally and/or vertically. You cannot rotate graphics.

To flip a Graphic horizontally:

Make sure a graphic object is selected on the stage.
In the Properties panel, check or clear the Flip Horizontal checkbox.

To flip a Graphic vertically:

Make sure a graphic object is selected on the stage.
In the Properties panel, check or clear the Flip Vertical checkbox.

Methods for Graphic object

onClick	Trigger	Triggers when the object is clicked.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onRollout	Trigger	Triggers when the mouse moves off of the object.
onRollover	Trigger	Triggers when the mouse moves over the object.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Hotspot object

The Hotspot is an object that is typically used in conjunction with graphics. It is very similar to a Button object, but often is invisible to the learner to simulate them clicking on the image below the Hotspot. However, the appearance of Hotspots can be configured to allow for a multitude of different interaction styles.

You can change the fill color and transparency individually for each of the three interaction states: Initial, Rollover, and Clicked.

To change state's fill color:

Make sure a Hotspot is selected on the Authoring Stage.
In the properties panel, enter a new value in the Initial/Rollover/Clicked Fill Color field.
-or-
Select a color from the Initial/Rollover/Clicked Fill Color color picker.

To change the state's transparancy:

Make sure a Hotspot is selected on the Authoring Stage.
In the properties panel, enter a new value in the Initial/Rollover/Clicked Transparency field between 0 and 100.

Note: A Transparency value of 100 is completely invisible, and a value of 0 is completely opaque.

You can give the Hotspot a border, which will change to be the current state's Color property, but will always be completely opaque, regardless of the state's Transparency property.

To turn on the border:

Make sure a Hotspot is selected on the Authoring Stage.
In the properties panel, enter a line width in the Border Thickness field.

You can make the Hotspot stay in its clicked state when selected by setting the Toggle property. This can be useful if you want the learner to be able to select, or highlight, aspects of the learning interaction.

To turn on the Toggle property:

Make sure a Hotspot is selected on the Authoring Stage.
In the properties panel, set or clear the Toggle checkbox.

Methods for Hotspot object

onClick	Trigger	Triggers when the object is clicked.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onRollout	Trigger	Triggers when the mouse moves off of the object.
onRollover	Trigger	Triggers when the mouse moves over the object.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
getClickCount	Condition	Returns the number of times the object has been clicked.
isClicked	Condition	Checks to see if button is in clicked state (true) or not (false).
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setClickCount	Response	Sets the number of times the object has been clicked.
setClicked	Response	Changes the state of a button to clicked or not.
setHyperlink	Response	Sets the hyperlink associated with the object. The specified resource will be launched in a pop-up browser window when the hyperlink is clicked.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Input Text object

The input text object is generally used to capture data from the user.

For instance, input text objects can be used to create a fill-in-the-blank quiz where the learner types answers into blank input boxes. The answers can then be compared to the correct answers for scoring.

How to set up a Conditional Action

Use default text

The input text object can contain default text such as <type here> or <specify>. To set this up, just type the desired text in the input text field. At preview time, that text will default in the input text object.

Default text can be a useful way of verifying that a leraner has not entered anything into that input text field. If the submitted state of the input text object reflects the default text, you can set up unique feedback for that instance.

Change the color of the input text border

With the input text object selected, Open the Properties panel.
In the Border Color property, click on the color tile .
Select the desired color.
OR
Enter the appropriate hex color code in the Border Color field .

Change the color of the input text fill

With the input text object selected, Open the Properties panel.
In the Fill Color property, click on the color tile .
Select the desired color.
OR
Enter the appropriate hex color code in the Fill Color field .

Change the number of rows displayed

With the input text object selected, Open the Properties panel.
Click in the Number of Rows field.
Change the value to the desired number of rows to display.

Turn on or turn off the input text border

With the input text object selected, Open the Properties panel.
Select or clear the Border check box.

NOTE: When the check box is checked, the border is on.

Turn on or turn off the input text fill

With the input text object selected, Open the Properties panel.
Select or clear the Fill check box.

NOTE: When the check box is checked, the fill is on.

Store the value of the input text object to a variable

At the time an action is triggered, the value of the input text field will be based on what text it currently includes. To pass the value of the input text object to a variable, you would need to set up an action like this:

On some system trigger (on a button click for isntance), set the value of a text variable to a function that gets the value of the input text object.

Whatever text is in the input text when that button is clicked will be stored to the variable.

Methods for Input Text object

onFocus	Trigger	Triggers when the object has focus (is clicked).
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onUnfocus	Trigger	Triggers when the object loses focus (is clicked away from).
onEnter	Trigger	Triggers when the Enter key is pressed (for example after a value has been typed in and the user presses "Enter" to submit it).
onValueChange	Trigger	Triggers when the text is changed.
contains	Condition	Checks for the specified string (text) in the text object. Returns true if it is found or false if it is not.
getText	Condition	Returns the text object's current value.
getNumber	Condition	Returns the text object’s current value as a number.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setText	Response	Changes text to the specified value.
setTextColor	Response	Changes the text color to the specified value.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

More Objects

SmartBuilder allows you to import your own custom objects that were created in Flash, and use them in your SmartBuilder lesson. These SDK objects must follow the Widget Documentation located in the Shared Library > SmartBuilder Widgets > Documentation folder in the Home Tree.

The terms SDK object and Widget are interchangeable.

Widgets are essentially treated the same as other SmartBuilder objects, except that they are usually more specific in their functions. SmartBuilder offers a number of these specialty objects for your use.

To add a widget to the Authoring Stage

Click on the More Objects icon on the Object Toolbar.
Choose one of the Widgets from the popup menu.
-or-
Click Browse to locate a widget that you have uploaded separately.

Each Widget looks and acts a little differently. All will have a placeholder of some sort on the Authoring Stage, and context specific methods for Triggers, Conditions, and Responses.

Widgets cannot automatically control other objects or the lesson. In addition to being placed in a lesson, they will often need to be "hooked up" to the lesson or other objects in order to provide the desired functionality. Luckily, properly designed Widgets will provide "hooks" (methods) that allow them to be useful via actions in the Action List.

Methods for Flash SDK Object

Note: Individual methods for SDK objects will vary based on the purpose of the object.

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Cookie Object

This object will allow you to save and retrieve cookies on a user's computer, provided that that user's security settings will allow cookies.

You can use this object to store a bookmark, a student name, or even a score, on the user's computer. There is a template in the Template > - Master Page: Resources folder that deals with bookmarking using cookies, and it is best to take a look at it if you're planning on implementing that functionality.

You must set the name and the value of the cookie as well as how long you want to keep the cookie (in days).

Note: You will most likely leave the Path section blank. If you are an advanced user, and want to save and retrieve cookies from different lessons, you may wish to choose a path to the shared cookies. Be aware that cookies can only be retrieved/saved from a directory that is in their path. For example, if the lesson is located at "example.com/section4/lesson2" (making your default path for the cookie "/section4/lesson2"), then you cannot choose "/section4/lesson10" as your path. You must choose "/section4" or just "/" and it will work.

Methods for Cookie object

Note: While this object has a placeholder on the Authoring Stage, it cannot actually be seen on the page when the lesson is in Preview or published mode. Similarly, the onShow, onHide, show, hide, setVisibility, and isVisible methods, as well as the Start Visible property all exist and are kept track of, but they never show the Cookie object's placeholder. They exist simply because every object in SmartBuilder need these methods to work properly.

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getCookie	Condition	Takes the name of a cookie, and returns the value of that Cookie.
hide	Response	Hides the object.
setCookie	Response	Saves a cookie with the specified name (e.g. "bookmark") and value (e.g. "4"). Also takes an Expiration value for how many days the cookie should be kept.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

Email object

This object is used to launch the learner's default email client. It can pass information directly into the new email, including the following fields:

To
CC
BCC
Subject
Body

This widget will NOT automatically send an email from a server. Every server handles emails differently, and since there are no standards, it would be impossible for SmartBuilder to try to execute any server-side scripting. If you wish to send emails directly from the server, you can use the URL Data object to communicate with a PHP or other language script executing the actions, which would have to be built completely outside of SmartBuilder.

Note, that you don't have to fill in all the fields, only the ones that you care about.

Example of use

Trigger: Send Button > onClick
Response: Email object > setToField "robertDenero@company.com"
Response: Email object > setCCField "alPacino@company.com"
Response: Email object > setSubjectField > "Bank Score"
Response: Email object > setBodyField > Function > Input Field 1 > getText
Response: Email object > sendEmail

Methods for Email object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Hides the object.
setToField	Response	Sets the To field of the outgoing email. Can be a static value, or taken from an object or variable.
setCCField	Response	Sets the CC field of the outgoing email. Can be a static value, or taken from an object or variable.
setBCCField	Response	Sets the BCC field of the outgoing email. Can be a static value, or taken from an object or variable.
setSubjectField	Response	Sets the subject field of the outgoing email. Can be a static value, or taken from an object or variable.
setBodyField	Response	Sets the body field of the outgoing email. Can be a static value, or taken from an object or variable.
sendEmail	Response	Launches the learner's email client and passes the information collected above into it. Does NOT send email directly from a server.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

Google Analytics Object

This object allows you to track or report status to Google Analytics.

You must specify your Google Analytics ID in the Account ID Property of the object.

Then you can use the methods to communicate information.

The 2 object-specific response methods are:

reportPageview

Tracks object statistics as special page views. The "url" parameter is an optional parameter to indicate what page URL to track metrics under. When using this option, use a beginning slash (/) to indicate the page URL, which could be a custom name cued by any action, e.g. a display being shown or a button click being clicked.

For example, when a passing final feedback display is shown, you might send "/pass1" to Google Analytics as the page that was viewed.

reportEvent

Tracks data into Event Tracking reports. "category" and "action" parameters are required.

For more information on Google Analytics, please view their website here:

http://code.google.com/apis/analytics/docs/

HTML Frame

This widget allows you to control URLs of other html frames that are possibly outside of SmartBuilder.

The HTML Frame object is a very unique object for when you have a SmartBuilder lesson embedded inside a larger website. For example, a help site, where you are using frames (e.g., a frame on the left for the Table of Contents, one at the top for the header, and one in the center for the content). The HTML Frame objects allows the SmartBuilder object to control those other frames, for example changing the Table of Contents to another section.

It was created for a specific organization, and we made it available to everyone, but chances are, most users will never have a situation that warrants using the HTML Frame object.

It has 2 methods.

setURL(url) - To change the target frame url. Internally, it calls "setFrameTarget" through the Flash interface, which takes the window path and the url.

setFramePath(path) - This is just another way to dynamically change frame path during runtime.

The object has no visiblity on the stage during runtime.

IFrame object

This object will allow you to embed HTML in your SmartBuilder lesson.

An example of this would be a lesson that has instructions on navigating a company's resource website. It has the real website embedded in the middle of the lesson, and instructions on where to go below it. It could also have a question based on that embedded content.

Below is a lesson with a menu, page navigation, and instructions with the Flash Help site embedded in the middle.

Some other possible examples of using the IFrame effectively are:

Embedding YouTube videos (follow the instructions in this video to see how).
Displaying external resources (such as help or a website).
Displaying internal resources that are easier to build en masse in a different technology (e.g., a glossary built in HTML, or a PDF resource).
Getting around embedding things directly in SmartBuilder, such as AS3-based Flash content, or content from other tools (like Articulate).

The IFrame object has a few limitations, but often these are not significant barriers. They are:

IFrame always shows up on top of other content. Since it is technically a popup window without borders or bars, it will always float to the top, even if you layer other objects on top of it on the Authoring Stage.
Your lesson cannot scale proportionally. It must be fixed size. IFrame does not scale with the content, so it will look strange if the background can change size, but the IFrame does not.
IFrame is only visible after publishing.
IFrame is also incompatible with some of the 508 functionality, and both cannot be used in the same lesson.

You can resize the IFrame object on the stage, or specify the size in the Properties panel.

To point the IFrame to the content of your choice, you have 2 options - one to point to a live URL on the web, or to point to an asset that has been uploaded to SmartBuilder that will be bundled with your lesson.

You can specify the URL in the Properties panel. You can set the URL via the action list as well.
Similarly, you can use the Embed code provided by YouTube, Jing, and hundreds of other web-based tools (you could even put a SmartBuilder lesson inside a SmartBuilder lesson!).
You can specify the Asset in the Properties panel only. For more on uploading Assets, see the page here.

Methods for IFrame object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Hides the object.
setUrl	Response	Sends IFrame object to a URL, which can be entered as a static value, or pulled from another object or variable.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object

Icon Tracker

This object is similar to the Percent Tracker, however instead of reporting a value between 0 and 100 based on a smooth gradation, it allows an author to provide feedback based on a whole number. It is useful for telling how many points are possible, and also how many points the learner has earned. An example might be a quiz with 10 questions.

You can customize the Spacing between icons property to change the look of the Icon Tracker. You cannot change the graphic. However, if you have a need for a custom graphic, you can request the source file of the widget or a customized widget from Suddenly Smart.

Methods for Icon Tracker

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getValue	Condition	Returns the value of the tracker.
hide	Response	Hides the object.
addValue	Response	Adds specified value to the Tracker. Takes positive and negative integers.
setValue	Response	Sets the value of the Tracker regardless of its current value.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

Menu with Pages

This object will automatically create a list of the pages from the Lesson. You can customize the look and feel of this object using the Properties panel and Text Toolbar.

More often than not, this menu will be located on the Master Page.

Setting up the Menu Widget:

After placing the menu object on the Master Page, you will need to set up the following actions:

Trigger: Page Controller > onPageChange
Response: Menu Widget > setSelectedPageIndex > Page Controller > getPageIndex

This will update the Menu Widget, even if a means other than itself is used to change pages. If a "next" button is used to advance the lesson then we still want to Menu Widget to show a checkmark.

Trigger: Menu Widget > onSelection
Response: Page Controller > gotoPage > Function > Menu Widget > getSelectedPageIndex

This will allow the user to click on the items in the menu to go directly to that page.

Note: You can check the Allow skip ahead checkbox in the Properties panel if you want your learner to be able to use the menu to go to pages ahead of their current page, or clear the checkbox if you want to only allow them to use the menu to get to previously viewed pages.

A more customizable menu that allows topics, customizable skins, and selecting which pages are part of the menu can be found here.

Methods for Menu object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onAllVisited	Trigger	Triggers when all pages have been visited. Can be used to show final feedback or other functionality in linear and non-linear lessons.
onSelection	Trigger	Triggers every time a learner clicks on one of the pages in the menu.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getSelectedPageIndex	Condition	Returns the number of the currently selected page in the menu object (used to tell which page the learner clicked on)
hide	Response	Hides the object.
setSelectedPageIndex	Response	Takes a number value or function, and sets that item in the menu to a selected state (used to update the menu when other means are used to change pages).
clearVisitedPages	Response	Clears the state of the menu object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

Menu with Topics and Pages

This object is similar to the Menu Object, but allows you to create topics or folder to organize your menu pages.

You can customize the look and feel by modifying and loading a specially created SWF into the "Custom skin" Property. You can obtain the FLA needed to generate the SWF by contacting support -at- suddenlysmart.com.

More often than not, this menu will be located on the Master Page.

Before you can use this object, you must specify which pages are part of the menu, by clicking on the Edit Structure property. The following actions are required for the menu object to operate properly.

Choosing which pages to show in the Menu:

Setting up the Menu actions:

After placing the menu object on the Master Page, you will need to set up the following actions:

Trigger: Page Controller > onPageChange
Response: Menu Widget > setSelectedPageIndex > Page Controller > getPageIndex

This will update the Menu Widget, even if a means other than itself is used to change pages. If a "next" button is used to advance the lesson then we still want to Menu Widget to show a checkmark.

Trigger: Menu Widget > onSelection
Response: Page Controller > gotoPage > Function > Menu Widget > getSelectedPageIndex

This will allow the user to click on the items in the menu to go directly to that page.

You can also store and retrieve the state of the object by following the directions here.

Methods for Menu object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onAllVisited	Trigger	Triggers when all pages have been visited. Can be used to show final feedback or other functionality in linear and non-linear lessons.
onSelection	Trigger	Triggers every time a learner clicks on one of the pages in the menu.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getSelectedPageIndex	Condition	Returns the number of the currently selected page in the menu object (used to tell which page the learner clicked on)
hide	Response	Hides the object.
setSelectedPageIndex	Response	Takes a number value or function, and sets that item in the menu to a selected state (used to update the menu when other means are used to change pages).
clearVisitedPages	Response	Clears the state of the menu object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

RTMP Streaming Video Object

This object allows you to use a streaming media service to host your video content (usually a paid service provided by a 3rd party), and to bring that video into SmartBuilder. You can even use cue points like the regular video object to trigger events in SmartBuilder.

To use this object, you need to know both the URL and the Stream. These are placed in the appropriate property fields in the Properties panel. Here is an example URL and Stream that you can use for testing.

URL:	rtmp://dk2isqp3f.rtmphost.com/flowplayer
Stream:	honda_accord

SWF Messenger

This object is similar to the Streaming SWF object. The widget is placed on the Authoring Stage and a SWF is loaded into it, allowing SWFs to embedded in SmartBuilder lessons. Using this SWF Messenger widget will allow you to:

Fire an event from a SWF that SmartBuilder can catch and use as a trigger.
Send a message from SmartBuilder to the SWF, which can be used to change the state of the SWF.

Preparing a SWF

In Flash, place the following code on the first frame of the main timeline:

function sbPlay() {
play();
}
//
function sbStop(){
stop();
}

This will keep the SWF from playing on the authoring stage. Read more on SWF Best Practices.

Setting up an event: SWF -> SmartBuilder communication

This example will show a text object when the SWF event "done" is called.

1. In Flash, simply place the following ActionScript code in your SWF on the frame that you want to fire the event:

this.smartbuilderRef.fireEvent("done");

Where "done" is the name of the event.

Note: There can be more than one event in a single SWF.

2. In SmartBuilder, create a SWF Messenger object and load your SWF with the above code in it. Be sure to rename the widget so it's easy to find.

3. Then set up an action with the following:

Trigger: SWF Messenger > onEvent
Condition: SWF Messenger > getEvent == done
True Response: Done text > show
False Response: [leave blank]

Note: If there is only one event, it is not entirely necessary to set up a condition, as it will be the only event that is fired from the SWF.

Setting up a message: SmartBuilder -> SWF communication

This example will show make the SWF go to a particular frame.

1. In Flash, place the following ActionScript code on the first frame of your SWF.

function sbReceiveMessage(name:String, value:String) {
    if (name == "gotoFrame") {
        gotoAndStop(value);
    }
}

Note: There can be several different messages sent to the SWF, but only one at a time.

Note: If there is only one message, it is not entirely necessary to set up a condition, as it will be the only message that is sent from SmartBuilder.

2. In SmartBuilder, create a SWF Messenger object and load your SWF with the above code in it. Be sure to rename the widget so it's easy to find.

3. Then set up an action with the following:

Trigger: Jump Button > onClick
Response: SWF Messenger > sendMessage > "gotoFrame", "10"

View an Example FLA

You can download an example FLA here. You would load this into the SWF Messenger's "SWF" Property. You can send it a name in the form of "LastName, FirstName" along with the format you want it back, and it will automatically fire an event to send the sorted results back to SmartBuilder. It also illustrates how you would send information to, and receive information back from, the SWF.

The actions in SmartBuilder would look like this -

Trigger: SWF Messenger > onEvent
Condition: SWF Messenger > getEvent == "loaded"
True Response: SWF Messenger > sendMessage "full" ; "LastName, FirstName"
False Response: [blank]

Trigger: SWF Messenger > onEvent
Condition: SWF Messenger > getEvent != "loaded"
True Response: Text output > setText > Function SWF Messenger > getValue
False Response: [blank]

Methods for SWF Event Messenger

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onEvent	Trigger	Triggered every time an event is fired from the SWF
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getEvent	Condition	Returns the name of the event fired from the SWF.
hide	Response	Hides the object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
sendMessage	Response	Takes a name and value parameter and passes them to the SWF, where the SWF's own ActionScript can use them.
show	Response	Shows the object.

Scalable Shapes

This object is similar to both Graphic objects and Shape objects. Like a Graphic object, it is just a placeholder that can load SWFs. When the SWF is loaded, it is displayed, and (like a Shape) can be resized without distorting the corners and a Color Property can be set to customize the way it looks.


Scaling proportionally without Widget	Scaling with Scalable Shape Widget

Notice how the elements on the left and the bottom do not distort.

After choosing the Scalable Shape, you will have to choose the SWF that you want to load.

You can preview these object in the Media Select window and see how they look and scale in a similar manner to the examples above.

These SWFs have to be specially created in Flash and contain ActionScript to work properly. There are a number located in the Shared Library > SmartBuilder Media & Assets > Design Elements subfolders. Mostly in the Scalable Shapes subfolder. They can be used to make backgrounds for displays, and often go well with Graphic Effects.

If you wish to learn how to create your own Scalable Shapes we can send you the source files, or you have an idea that you would like to see created, please email us with the design and we can build it and share it with everyone.

Methods for Scalable Shape object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Hides the object.
setColor	Response	Sets the accent color property of the object.
show	Response	Shows the object.

Search object

This object will allow you to run searches on the text in your entire lesson, and then go to the page with that text. Because of this, it makes the most sense to place this object on the Master Page.

The search object itself is the search results box, and requires an Input Text object and a Button or Hotspot to work properly.

The following outline will show you how to set up a Search widget. Depending on the layout and functionality of your lesson, you can change the actions as you see fit. For example, you may want to have the search results always be visible if the search functionality is located inside a popup display that is built into the interface. Or you may want to set the trigger to Input Text > onValueChange instead of having a search button.

To set up the Search widget

First, place the Search widget on the Master Page, and change the name to "search widget". Also uncheck the Start Visible property.
Also add an Input Text object and a Button object.
Create the following actions:

This action will run a search based on the word(s) that the user places in the Input Text object, return the results in the widget, and make the widget visible.

Trigger: Button 1 > onClick
Response: search widget > runSearch > Input Text 1 > getText
Response: search widget > show

When the learner clicks on one of the results, we want them to be taken to that page. For good usability, we also want to automatically hide the search results afterwards.

Trigger: search widget > onSelection
Response: Page Controller > gotoPage > search widget > getSelectedPageIndex
Response: search widget > hide

Finally we need an action that will allow the learner to dismiss the search results without having made a selection.

Trigger: search widget > onClickOutside
Response: search widget > hide

Methods for Search object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onClickOutside	Trigger	Triggers whenever the learner clicks somewhere that is not the search widget. Generally used to hide widget when the learner doesn't want to make a selection.
onSelection	Trigger	Triggers when the learner clicks on one of the options in the search widget. Used to go to the page of the search result.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getSelectedPageIndex	Condition	Returns the page index of the search result that was clicked on by the learner.
hide	Response	Hides the object.
runSearch	Response	Starts searching through all the text in the lesson for the string specified and returns the results in the widget.
clear	Response	Clears the search results in the widget.
show	Response	Shows the object.

URL Data Object

This object is used to send data to a server. It is similar to the Server Communication object built into SmartBuilder, except for the following differences:

It can send data across domains, and
the lesson does not wait for a response from said server.

Typical uses for a URL Data object include sending information to a server where server-side script will capture it, or launching a certain page or search results based on data captured in SmartBuilder. See this forum post for more information on how to use it.

Samples using the URL Data object

Here is a sample action that will send an update command with a value being passed along. Of course, there needs to exist some sort of server-side script that can store this in a database. Essentially this is the same as entering http://www.website.com/serverScript.php?query=update&q1=45&q2=2009 into the address bar of your browser.

Trigger: Submit Button > onClick
Response: URL widget > addParam > "query" = "update"
Response: URL widget > addParam > "q1" = "45"
Response: URL widget > addParam > "q2" = InputText 1 > getText
Response: URL widget > setURL > "http://www.website.com/serverScript.php"
Response: URL widget > invoke

Here is an example of sending a search query to google, essentially the equivalent of entering "http://www.google.com/search?q=e-learning" into the address bar of your browser. Since it automatically shows a bunch of search results and changes the webpage, it would make sense to invoke this in a new window so that it doesn't navigate away from your lesson.

Trigger: Submit Button > onClick
Response: URL widget > addParam > "q" = "e-learning"
Response: URL widget > setURL > "http://www.google.com/search"
Response: URL widget > invokeInNewWindow

Note: When using the "invoke" method, another name value pair is appended at the end of the url. This is "&rand=1111111111111", where the string of 1s is a randomly generated number. This is to prevent caching and the same value being ignored if sent multiple times. Your server-side script should allow for this value to be received, but it can disregard it (basically, just make sure that your script can handle this extra data without breaking). This is currently not the case with "invokeInNewWindow" method, but this method may be updated in the near future as well to keep everything consistent.

Methods for URL Data object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Hides the object.
setURL	Response	Sets the URL that will be called. Typically points to a PHP or similar file that can capture the data and save it on a server. This method only stores the URL, and does not call it (see invoke and invokeInNewWindow methods).
addParam	Response	Adds a parameter to the URL that will be sent. Takes a parameter name and a value.
invoke	Response	Sends the data (parameters) to the URL specified.
invokeInNewWindow	Response	Sends the data (parameters) to the URL specified in a new window. Used when passing information to a website, and not a PHP file.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

Volume Controller

This is an object that provides a volume controller to your lesson. It controls the lesson volume, which will include any background audio, voice over narration, sound effects, etc. It will not pause or play any audio.

There are several of these objects with different skins. They operate identically.

To set up a volume controller

1. Place a Volume Controller widget on the Authoring Stage. Uncheck the Start Visible Property.

2. Set up an action that sets the volume according to the position of the slider.

Trigger: Volume widget > onValueChange
Response: Page Controller > setAudioVolume > Volume widget > getValue

3. Next, create an action to turn on and off the mute function.

Trigger: Volume widget > onMuteChange
Condition: Volume widget > isMute == true (checked)
True Response: Page Controller > setAudioVolume > 0
False Response: Page Controller > setAudioVolume > Volume widget > getValue

4. After that, you'll want to make sure that the learner can close the volume widget after making their changes.

Trigger: Volume widget > onCloseClick
Response: Volume widget > hide

5. Finally, because the Start Visible property is disabled, you'll need some sort of action to show the Volume widget. This example assumes that you have a speaker button on your interface called "Speaker button".

Trigger: Speaker button > onClick
Response: Volume widget > show

Methods for Volume Controller

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onValueChange	Trigger	Triggered every time the learner moves the slider on the volume controller.
onMuteChange	Trigger	Triggered whenever the mute checkbox is set or cleared by the learner.
onCloseClick	Trigger	Triggered when the learner clicks the close button built into the Volume Controller.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getValue	Condition	Returns the value of the slider, a number between 0 (bottom) and 100 (top).
isMute	Condition	Returns a true or false value based on whether or not the Mute checkbox is checked or empty at that time.
hide	Response	Hides the object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the object.

Widget Download Page

For those of you that do not have a separate, installed environment that we do not have access to, you can ignore this post. For those that do, since Suddenly Smart does not have access to your environment, you must upgrade your widgets. Luckily, this is as easy as uploading or replacing graphics!

Right-click to do a ‘Save As’ on the widget file. Remember that you will need to upload it to SmartBuilder as ‘widget.zip’, so do not rename this package. If you want to download multiple widgets at once we suggest storing them in separate folders. However, once uploaded into SmartBuilder, you will be able to edit the meta-data for this widget. We suggest naming the widget according to function (eg. ‘Cookie Object’) to mirror the names on the widget list.

If you do not already have any widgets, or a certain widget, you will need to upload these into the "Shared Library > SmartBuilder Widgets" folder. Choose "Upload Media & Assets", and then pick "A SmartBuilder Widget" from the radio buttons. Upload the widget.zip and remember to rename the meta-data.

If you are updating an existing widget, then you need to find the widget (usually located in the "Shared Library > SmartBuilder Widgets" folder.) Select that widget in your list, and use the ‘Replace’ function to update the widget package. Upload the widget.zip and remember to rename the meta-data. By using the ‘Replace’ function, you ensure that all existing instances of that widget in your learning content will automatically be updated the next time it is referenced from a work in progress lesson.

When you bring a widget into SmartBuilder, it needs to be called "widget.zip". That is why they all have the same name. If you plan to download all of them, keep them separated in subfolders. When you upload each one, and it prompts you to enter Meta Data, you can change the name from "widget" to the name given on this page, or the subfolder name where you found the widget. Keeping these widgets named the same as the folder will help if support issues arise later.

Let us know if you have any issues during the process. You can reach me at 760.635.5700x207 or via email ndhillon at suddenly smart dot com.

Widget Name	Date updated
Cookie Object	April 15, 2010	Download
Email Object	August 19, 2009	Download
Google Analytics Object	February 28, 2011	Download
IFrame Object	November 02, 2010	Download
Icon Tracker	August 19, 2009	Download
Menu with Pages	February 28, 2011	Download
Menu with Topics and Pages	November 13, 2013	Download
RTMP Streaming Video Object	March 7, 2012	Download
SWF Messenger	August 21, 2009	Download
Scalable Shapes	April 15, 2010	Download
Search Objects	August 21, 2009	Download
Tabs Object	April 24, 2012	Download
URL Data Object	February 28, 2011	Download
Volume Controller - Blue	August 21, 2009	Download
Volume Controller - Grey	August 21, 2009	Download
Volume Controller - BlueIce	November 4, 2009	Download

MultiState Button

The multistate button allows the learner to flip through a sequential series of images in order to make a selection. For example, in an interaction where the learner must select a screw size, you can use a multistate button containing graphics for each screw. The learner would click on the multistate button until the desired screw was displayed. (NOTE: Only one of the button states can be the correct choice.)

To edit, add, or reorder the answers:

Select a MultiState Button on the stage.
In the Properties panel, click the Select Media button.
-or-
Double click on the object.
In the Multi-State Media Select window, you can:

Add new states by clicking the Add button.

Then select the desired media from the Media Select window and click Select.
Delete states by selecting the undesirable state and clicking the Delete button.
Reorder states by selecting the desired state and using the Move Arrows.
Replace a state's media by selecting the state you wish to replace and clicking the Edit button.
-or by-
Double clicking on the state you wish to replace.

The size of the multistate button is based on the first graphic being referenced. Similarly, the Lock Aspect Ratio, and Lock Original Size properties will reference the first graphic to compute those settings.

Change a multi-state button alpha

With the multistate button object selected, Open the Properties panel.
Edit the value in the Alpha field to the desired amount.

NOTE: An alpha value of 100 means that the button graphic is solid, while an alpha value of 0 means the button graphic is totally transparent.

Lock a multistate button aspect ratio

With the multi-state button object selected, Open the Properties panel.
Click the Lock Aspect Ratio check box.

NOTE: If the check box is checked, then the button graphic's aspect ratio has been locked.

Lock multistate button mdiea at original size

With the multi-state button object selected, Open the Properties panel.
Click the Lock at Original Size check box.

NOTE: If the check box is checked, then the button graphic has been locked at its original size.

Methods for MultiState Button object

onClick	Trigger	Triggers when the object is clicked.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onStateChange	Trigger	Triggers when object changes states (clicked or set).
getStateIndex	Condition	Returns in the current state of the object in number format.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setStateIndex	Response	Changes the state of the button to the specified value. Note, if value is higher than number of states, it will break the multistate button.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Page Controller

The Page Controller is only visible on the Master Page.

It is available in the action menus on every page.

The Page Controller has access to page level methods such as onPageLoad, nextPage, previousPage, reload, and others. On the Master Page, the Page Controller has additional methods available to it.

You can use the Page Controller to communicate between pages. Because SmartBuilder lesson pages are reset to their initial status when loaded, communicating between pages only really makes sense when it happens between the current page and the Master Page, which is always visible. Communication between regular pages is typically handled by storing data in variables.

Note: Only one Global Event can be sent at any one time.

Sending a Global Event

This is an example where when a quiz page loads, it will fire a Global Event to disable the menu button, which exists on the Master Page. When the quiz has been passed, it will fire another Global Event to hide the next mask. The names of Global Events can be any string.

On the Quiz Page:

Trigger: Page Controller > onPageLoad
Response: Page Controller > fireGlobalEvent = "disableMenu"

Trigger: Question Set 1 > onComplete
Condition: Question Set 1 > isPassed == true
True Response: Page Controller > fireGlobalEvent = "enableMenu"
False Response: [leave blank]

On the Master Page:

Trigger: Page Controller > onEvent
Condition: Page Controller > getEvent == "disableMenu"
True Response: Menu Button > disable
False Response: [leave blank]

Trigger: Page Controller > onEvent
Condition: Page Controller > getEvent == "enableMenu"
True Response: Menu Button > enable
False Response: [leave blank]

How to use getInitialParam method

You can set some parameters in the player.html file, and pull them into SmartBuilder. First open the player.html file in a text editor, and find the segment that has this section:

"tsunamiplayer?runtime=true&langid=_default&gload=&lload="

Note that these parameters appear twice. Whatever you add must be added to the second instance of the parameters (or both instances).

There might be a value associated with lload. In any case, right before the closing single quote, add your parameter in the form of "&param1=someText".

Note that the parameter name must start with the string "param", and that you can have more than one parameter by adding continuing in the same way and adding "&param2=someOtherText".

Finally in SmartBuilder, you can use the getInitialParam method to pull this parameter out and use it in the lesson. The action below is a simple case to display the parameter in a text object.

Trigger: Page Controller > onPageLoad
Response: Text 1 > setText > Page Controller > getInitialParam (param1)

Methods for Page Controller object (Master Page)

onPageLoad	Trigger	Triggers when the object is clicked.
onGlobalEvent	Trigger	Triggers when the object's visibility changes from visible to hidden.
onPageChange	Trigger	Triggers when the mouse moves off of the object.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
isAssistiveDeviceOn	Condition	Returns true/false value. True when an assistive device, such as Windows Narrator or JAWS is turned on.
getTotalPages	Condition	Returns the total number of pages in the lesson.
getInitialParam	Condition	Returns parameters placed in HTML launch code.
getPageIndex	Condition	Returns the number of the currently visible page.
getPageName	Condition	Returns the name of the currently visible page.
getGlobalEvent	Condition	Returns the name of the last global event that was fired.
nextPage	Response	Advances to the next page.
previousPage	Response	Goes to the previous page.
reloadPage	Response	Reloads the current page into its inital state.
gotoPage	Response	Takes a number value and goes to that page.
gotoPageByName	Response	Takes a string and goes to the page with that title.
printPage	Response	Sends the current page to the printer.
closeBrowser	Response	Closes the current browser (or lesson in Preview mode).
setAudioVolume	Response	Sets the volume of any audio or video in the lesson. Values range between 0 (mute) and 100.
fireGlobalEvent	Response	Fires a Global Event. Takes a string, which will be used to identify the Global Event.
show	Response	Makes the object visible and begins playing.
hide	Response	Pauses and hides the object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.

Methods for Page Controller object (Regular pages)

onPageLoad	Trigger	Triggers when the object is clicked.
onGlobalEvent	Trigger	Triggers when the object's visibility changes from visible to hidden.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
isAssistiveDeviceOn	Condition	Returns true/false value. True when an assistive device, such as Windows Narrator or JAWS is turned on.
getTotalPage	Condition	Returns the total number of pages in the lesson.
getPageIndex	Condition	Returns the number of the currently visible page.
getPageName	Condition	Returns the name of the currently visible page.
getGlobalEvent	Condition	Returns the name of the last global event that was fired.
nextPage	Response	Advances to the next page.
previousPage	Response	Goes to the previous page.
reloadPage	Response	Reloads the current page into its inital state.
gotoPage	Response	Takes a number value and goes to that page.
gotoPageByName	Response	Takes a string and goes to the page with that title.
printPage	Response	Sends the current page to the printer.
closeBrowser	Response	Closes the current browser (or lesson in Preview mode).
setAudioVolume	Response	Sets the volume of any audio or video in the lesson. Values range between 0 (mute) and 100.
fireGlobalEvent	Response	Fires a Global Event. Takes a string, which will be used to identify the Global Event.

Percent Tracker

The Percent Tracker object gives you a way to visually represent a value on a scale from 0 - 100.

For instance, imagine the learning objective was to teach someone how to manipulate sensitive production machinery, and a negative outcome of doing the proper safety checks incorrectly was that the machinery would overheat. You might use the gauge style tracker, and label it to appear to have a safe, warning, and danger level. As the user made mistakes in the learning interaction, the gauge would increment from safe, to warning, to danger. If the gauge reached the danger level, you could end the interaction, and display negative final feedback.

Select a tracker style

There are several different tracker styles including a bar tracker

and a gauge

Select the Percent Tracker object.
Open the Properties panel.
Click the Style dropdown list.
Select the desired style.

Use a start value

The start value is what the tracker object value will be set to initially.

Select the Percent Tracker object.
Open the Properties panel.
Type the desired start value in the Start Value text entry field.

Select the foreground and background colors

Select the Percent Tracker object.
Open the Properties panel.
In the Foreground/Background Color property, click on the color tile .
Select the desired color.
OR
Enter the appropriate hex color code in the Foreground/Background Color field .

Specify the speed

The Speed property controls how quickly the tracker visually changes values.

Select the Percent Tracker object.
Open the Properties panel.
Click the Speed dropdown list.
Select the desired speed.

Specify the value label location

The Value Label Location affects where the current value of the tracker displays in relation to the tracker.

Select the Percent Tracker object.
Open the Properties panel.
Click the Value Label Location dropdown list.
Select the desired location.

Set the tracker to a variable value

Often times you will want to use the percent tracker object to display a value being stored in a number variable.

To do this, you will need to specify the trigger when you want this action to take place. The response object will be the tracker object. Choose the method "Set value" and set the value to a function which calls the variable's get value method.

Change the background alpha

Select the Percent Tracker object.
Open the Properties panel.
Enter the desired alpha value in the Background Alpha text entry field.

Methods for Percent Tracker object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onValueChange	Trigger	Triggers when the object's value changes.
getValue	Condition	Returns the current value of the object.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
toString	Condition	Returns the current value of the object as number between 0 and 100 in a string (text) format.
addValue	Response	Adds specified value to the object.
hide	Response	Makes the object invisible.
setValue	Response	Sets the value of the object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Question Sets

A Question Set is the same as a Display Set, but includes the following addtional functionality when it is linked to the Flow Chart:

Sequencing

Question sets can be configured to automatically control the order in which questions are displayed. This logic is based on settings such as random or linear order of questions, when to repeat incorrectly answered questions, etc. Display sets, on the other hand, are "dumb" in the sense that you must specify, using the Flow Chart or Action List, when displays are to be shown or hidden.

Scoring

Question sets track correct and incorrect responses and report scores to an LMS using the SCORM API.

For clarification on this functionality, read about Reporting a Score when using a question set in the Flow Chart.

Methods for Question Set

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onSubsetChange	Trigger	Triggers when current display is changed.
onComplete	Trigger	Triggers when the Flow Chart has completed the Question Set (either all sets have shown, or if the Question Set ends early).
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
getActiveSubsetIndex	Condition	Returns the number of the currently visible subset.
getSubsetCount	Condition	Returns the total number of subsets.
getPoints	Condition	Returns the number of points scored in the Question Set.
getScore	Condition	Returns the score (0-100) of the Question Set.
getTotalPoints	Condition	Returns the total possible points available in the Question Set.
isPassed	Condition	Returns a true/false value on whether the Question Set was passed. See above section on Scoring to set pass threshold.
getCorrectCount	Condition	Returns the number of questions correct.
getIncorrectCount	Condition	Returns the number of questions that were incorrect.
hide	Response	Hides the display.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the display and starts any media within that display.
gotoSubset	Response	Goes to a particular subset index number, based on a static value, or a function from a variable or another object.
nextSubset	Response	Shows the next subset.
previousSubset	Response	Shows the previous subset.
printVisibleSubset	Repsonse	Sends the active subset to the printer.

Methods for Question

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onSubmit	Trigger	Triggers when display is submitted.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Hides the display.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Shows the display and starts any media within that display.
submit	Response	Submits the display (continues the Flow).

SCORM / AICC

SCORM stands for Sharable Content Object Reference Model. It is a standardized set of calls that allow lessons and courses (Sharable Content Objects, or SCOs) to communicate with a Learning Management System (LMS), such as Moodle or BlackBoard.

SmartBuilder has a number of preconfigured SCORM calls that can be sent on appropriate triggers, as well as the ability to send any other recognized SCORM call.

The SCORM / AICC is an object that only exists in action menus, and not on the Authoring Stage at all.

There are two versions of SCORM, SCORM v1.2 and SCORM 2004. It is not the place of this help documentation to question why a collection of standards does not choose to standardize their own version numbering system, but SCORM 2004 is more recent and has a number of improvements and additional methods available to it than v1.2 does. However, v1.2 is more widely used.

Upon downloading a lesson, one must specify if they want their content to be SCORM compliant, along with the version. SmartBuilder will automatically convert its SCORM calls to the appropriate version, if those calls are available in that version (for example, there is no v1.2 equivalent of setInteractionResponse).

SmartBuilder is not an LMS, and as such SCORM calls will not work when previewing or viewing content from SmartBuilder. The best way to test a lesson's SCORM calling functionality is to download it and upload it into your LMS. If you are troubleshooting, and want detailed logs of what is being transmitted to your LMS, www.scorm.com's TestTrack is an extremely useful (and free) tool for testing your SCORM compliant content. You must still download your content from SmartBuilder and then upload it into TestTrack.

Question Sets can automatically submit their raw score to the LMS without having to set up an action. If you wish to get or set a SCORM call that is not prebuilt, use the LMSSetValue or LMSGetValue to manually enter the SCORM call you wish to send.

Example using a prebuilt SmartBuilder SCORM method

Trigger: Feedback Set > Final positive feedback > onShow
Response: SCORM / AICC > setLessonStatus = "passed"

Example of SCORM call that is not prebuilt

Trigger: Page Controller > onPageLoad
Response: SCORM / AICC > LMSSetValue > "cmi.core.exit" = "normal"

Note that if you are going to be using non-prebuilt SCORM calls, you have to send the exact call. You can find a great reference for SCORM calls here.

Example storing and retrieving data

This is an example of a more complicated SCORM call that stores the contents of a text box to the LMS, then retrieves it when the page is next launched:

Trigger: Notes Input Text > onValue Change
Response: SCORM / AICC > LMSSetValue > Name: "cmi.suspend_data" ; Value: Function > Notes Input Text > getValue

Trigger: Page Controller > onPageLoad
Response: SCORM / AICC > Notes Input Text > setValue > LMSGetValue > Name: "cmi.suspend_data"

Note - "cmi.suspend_data" is a single place to store information. If you were try to store 2 separate notes, this would not work, as one would overwrite the other.

You can use the LMS to store information such as a bookmark, user notes, or the status of a menu object, all of which can be retrieved later. For bookmarking, please see the Template > Master Page: Resources folder, and refer to the example in the above collapsed section on how to store data.

Methods for SCORM / AICC

Smartbuilder method name	Type	Description
LMSGetValue	Condition/Response	Returns in the value of specified SCORM parameter
LMSSetValue	Response	Sets the value of the specified SCORM parameter.
getMasteryScore	Condition/Response	Returns the mastery score.
getStudentID	Condition/Response	Returns the student's ID from the LMS database.
getStudentName	Condition/Response	Returns the student's name from the LMS database.
setRawScore	Condition/Response	Sets the raw score of the lesson.
getRawScore	Condition/Response	Gets the raw score of the lesson.
getSCOLocation	Condition/Response	Returns the recorded SCO location (also known as page name) from the LMS.
setSCOLocation	Condition/Response	Sets the SCO location (page name) to the LMS.
getLessonStatus	Condition/Response	Returns the lesson status from the LMS. Possible statuses are "passed", "completed", "failed", "incomplete", "browsed", "not attempted".
setLessonStatus	Condition/Response	Sets the lesson status to the LMS. Possible statuses are "passed", "completed", "failed", "incomplete", "browsed", "not attempted".
getTotalLearningTime	Condition/Response	Returns the time from the LMS since the lesson was launched (tracked by LMS).
getMaxScore	Condition/Response	Gets the maximum score.
setMaxScore	Condition/Response	Sets the maximum score for the lesson.
getMinScore	Condition/Response	Gets the minimum score for the the lesson from the LMS.
setMinScore	Condition/Response	Sets the minimum score for the lesson to the LMS.
getObjectiveRawScore	Condition/Response	Returns the raw score for the objective specified.
setObjectiveRawScore	Response	Sets the the raw score for the objective specified.
setInteractionResponse	Response	The ID number of the interaction is automatically tracked, so the author only needs to worry about the interaction name and the value. If the same name is encountered, its value will be overwritten, and if a new name is entered it will create a new interaction.

Server Communication

This object will allow you to communicate directly with a server-side script. See this forum post for more information. The SmartBuilder lesson must be located on the same server as the server-side script it is trying to communicate with. SmartBuilder will wait until it gets a response from the server before continuing.

Important: This means that if SmartBuilder does not receive a response, it will "break" the lesson (it will become unresponsive).

Use the URL Data widget if you wish to communicate across domains and/or do not want your lesson to wait for a response from the server.

This object is often used when an organization doesn't want to use an LMS, but still wants to track learners' progress.

Sample action using the Server Communication object

Trigger: Submit Button > onClick
Response: Server Communication > setParameter > "query" = "update"
Response: Server Communication > setParameter > "q1" = "45"
Response: Server Communication > setParameter > "q2" = InputText 1 > getText
Response: Server Communication > sendToURL > "http://www.website.com/serverScript.php"

Note: Another name value pair is appended at the end of the url. This is "&rand=1111111111111", where the string of 1s is a randomly generated number. This is to prevent caching and the same value being ignored if sent multiple times. Your server-side script should allow for this value to be received, but it can disregard it (basically, just make sure that your script can handle this extra data without breaking).

The postToURL method is used in SmartBuilder the same way as sendToURL method. However, there are these differences:

sendToURL uses the GET form submission method (appends the data to the URL that is called). This means that the data is less secure, but easier to manipulate.
postToURL uses the POST form submission method (sends the data in the message body of the HTTP request). This means the data is more secure and more data can be sent, but it is generally more difficult to create a server-side script to make use of this data.

To learn more about the differences between these methods, please refer to this external resource - http://www.diffen.com/difference/Get_vs_Post

Methods for Server Communication object

isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
sendToURL	Condition/Response	Sets the URL and invokes te call. To be used after setting any parameters. Uses the GET submission method.
postToURL	Condition/Response	Sets the URL and invokes te call. To be used after setting any parameters. Uses the POST submission method.
setParameter	Response	Adds a parameter to the query being sent.

Shape object

Shapes are basic building blocks for SmartBuilder lessons. They can be used to give feedback, provide backgrounds for Displays, mask interactions, and be used as drop areas or drag objects, just to name a few of their uses.

By default, a shape is a rectangle.

To select a new Shape:

Select a Shape on the stage.
In the Properties panel, click on the Select Shape button.
In the Shape window, choose the Shape Category from the drop down.
Select the Shape Tile that you wish to change your Shape to.
Click OK.

To lock a Shape's aspect ratio:

Make sure a Shape object is selected on the stage.
In the Properties panel, check or clear the Lock Aspect Ratio checkbox.

Set the Line Width and Line Color:

Open the Properties Panel.
Choose a width, or choose No Line, from the Line Width drop down.
Choose a color for the Line Color if applicable.

Turn on or off the Fill and Set the Fill Color:

Open the Properties Panel.
Select or clear the Fill checkbox.
Choose a color for the Fill Color if applicable.

You can also flip a Shape horizontally and/or vertically. You cannot rotate Shapes.

To flip a Shape horizontally:

Make sure a Shape object is selected on the stage.
In the Properties panel, check or clear the Flip Horizontal checkbox.

To flip a Shape vertically:

Make sure a Shape object is selected on the stage.
In the Properties panel, check or clear the Flip Vertical checkbox.

Methods for Shape object

onClick	Trigger	Triggers when the object is clicked.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onRollout	Trigger	Triggers when the mouse moves off of the object.
onRollover	Trigger	Triggers when the mouse moves over the object.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setHyperlink	Response	Sets the hyperlink associated with the object. The specified resource will be launched in a pop-up browser window when the shape is clicked.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
setFillColor	Response	Changes the fill color to the specified hex value.
show	Response	Makes the object visible.

Streaming SWF

This object is used for SWF animations, such as Captivate movies. If using animated SWFs built in Flash, please refer to the SWF Best Practices page.

It is identical to the Graphic object, except for the following:

It does not display on the Authoring Stage (so it does not take computer resources when authoring).
It will start playing before it is fully loaded during Preview and Published views (useful for longer movies that you wish to stream).
When using Captivate movies, it resizes more crisply than the graphic object.

Please refer to the Graphic object page for common actions.

Methods for Streaming SWF object

onClick	Trigger	Triggers when the object is clicked.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onRollout	Trigger	Triggers when the mouse moves off of the object.
onRollover	Trigger	Triggers when the mouse moves over the object.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Pauses and hides the object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible and begins playing.

Text object

The text object in SmartBuilder is quite flexible, and all text editing and formatting can be done directly to the text object on the page. What's more is that each text object can include an unlimited amount of different text formats.

Text formatting can be applied to the entire text object, or just a selected portion of it. To see how to format text, see the page on Formatting.

For more on creating hyperlinks, see the page on hyperlinks.

In addition, you can change the following properties:

Turn on or off the Text Border:

Open the Properties Panel.
Select or clear the Border checkbox.
Choose a color for the Border Color if applicable.

Note: To have more control of text borders, consider placing a Shape object behind the text object, and formatting that to your liking.

Turn on or off the Text Fill:

Open the Properties Panel.
Select or clear the Fill checkbox.
Choose a color for the Fill Color if applicable.

Turn on or off the Scroller:

Open the Properties Panel.
Select or clear the Scroller checkbox.

Methods for Text object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onValueChange	Trigger	Triggers when the value of the object changes.
getText	Condition	Returns the current value of the text object in string (text) format.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Makes the object invisible.
setText	Response	Changes the text value to a static value, object property, or variable. Takes a string (text).
setTextColor	Response	Changes the text color to the specified hexidecimal value (e.g. 0099CC).
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

keywords: scrollbar scroll bar

Timeline object

The Timeline object allows a user to organize and control the appearance of objects over time. It can be used to control the showing and hiding of objects in relation to a timeline or to an audio file. It also controls animations and transition effects associated with the showing and hiding of objects.

The Timeline is considered a master object, which means that it takes control of other objects. It can only control objects located in the same peer group as the timeline. For example, if the timeline object is within a display, it can only control objects also in that display.

User tip: Double click the Timeline object on the Authoring Stage to view its properties for editing.

Add cue points to a timeline

Select the Timeline object.
Open the Properties panel.
Move the Set Cue pointer (see right) to the desired time.
Click Add Cue.
Click OK when finished adding cue points.

Add objects to a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Click Add Object.
Select the desired object to be added.
Click OK when finished adding objects.

Add object animations to a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
In your object list, select the object which you want to animate.
Click Animate In or Animate Out depending on the object's current display state.
Select the direction, time, effects category and effect as desired.
(NOTE: The animation time is required.)
Click OK.
After you've added all the desired animations, click OK.

Time Based vs. Audio Based timeline

The timeline can be either Time Based or Audio Based. A Time Based timeline allows you to specify exactly how long you want your timeline to be in seconds. An Audio Based timeline sets the length of your timeline to be the length of a specified audio clip.

Change the length of a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Click in the Time Based seconds field.
Change the current amount to the desired length.
Click OK.

Delete cue points from a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Select the cue to be deleted.
Click Delete Cue.
Click OK when finished deleting cue points.

Edit cue points on a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Select the cue to be edited.
Click Edit Cue.
Select Rename or Set Time depending on whether you want to edit the title or the time.
Change the value to the desired value.
Click OK when finished editing cue points.

Make an object show/hide on a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Select the cue point on which youw ant the object to show or hide.
Select the object which you want to show or hide.
Check or uncheck the Show check box (see right) to either show or hide the object.
(NOTE: If the check box is checked, the object is set to show on that cue point.)

Pause a timeline on a cue point

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Check the Pause check box (see right) next to the cue point at which you want to pause the timeline.
Click OK.

Use an audio based timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
In the timeline window, select the Audio Based radio button.
Click the Select button.
Navigate to the audio file you would like to use, and select it in the display list.
Click the Select button.

Loop a timeline

With the Timeline object selected, Open the Properties panel.
Select the Loop check box.

Remove objects from a timeline

With the Timeline object selected, Open the Properties panel.
Click the Edit Timeline button.
Select the object to be removed from the timeline.
Click Remove Object.
Click OK when finished removing objects.

Methods for Timeline object

onContinue	Trigger	Triggers when timeline continues past a pause point.
onCue	Trigger	Triggers whenever a cue is reached.
onEnd	Trigger	Triggers when timeline ends.
onReset	Trigger	Triggers when timeline restarts.
onStart	Trigger	Triggers when timeline starts.
Get CuePoint	Condition	Returns the current cue point.
Get Current Time	Condition	Returns the current time of the object.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
Pause	Response	Pauses the timline object.
Play	Response	Resumes or starts the timeline object.
Restart	Response	Restarts the timeline object.

Timer object

The timer object allows you to time an interaction in two ways:

Count down time, forcing a user to finish an interaction in a specified amount of time
Count up, which gives you the ability to track the total completion time of an interaction.

The Start and Cue points of the timer object can be set in the properties panel, as well as Trigger Intervals, all of which can be used as triggers for actions.

Additionally, the visual characteristics (size, color, font family) of the timer object can be configured using the text control toolbar.

Adjust the start time

This is the time from which the timer will begin counting.

With the Timer object selected, Open the Properties panel.
Enter the desired start time in the Start Time text entry field.

Select the direction

The timer direction determines if the timer will count up or count down.

With the Timer object selected, Open the Properties panel.
Click the Direction dropdown menu.
Select the desired value.

Adjust the style

The timer style specifies whether to display the time in milliseconds or seconds.

With the Timer object selected, Open the Properties panel.
Click the Style dropdown menu.
Select the desired style.

Use the auto-start feature

The auto-start setting will cause the timer object to begin counting as soon as it is shown. If this setting is not checked, then the timer object will need to be triggered to start via the Action Panel.

With the Timer object selected, Open the Properties panel.
Click the Auto-start check box.

Specify the count sound interval

The sound interval specifies how frequently the count sound should play while the timer progresses.

With the Timer object selected, Open the Properties panel.
Click the Count Sound Interval dropdown menu.
Select the desired value.

Select the count sound

The count sound will play each time the sound interval is reached.

With the Timer object selected, Open the Properties panel.
Click the Count Sound dropdown list.
Select the desired cue sound.

Select the end sound

The end sound will play when the timer reaches 0 (only when the direction is set to count down).

With the Timer object selected, Open the Properties panel.
Click the End Sound dropdown list.
Select the desired cue sound.

Use the cue point

When using the count up direction of the timer, the cue point allows you to specify a functional end point. So for instance, if you are using the timer to count up, you could set the cue point to be 2 minutes, and use the onCuePoint trigger event to end the interaction and show feedback when the 2 minute mark is reached.

With the Timer object selected, Open the Properties panel.
Enter the desired cue point time in the Cue Point text entry field.
Make sure the Direction is set to Count up.

Set the timer to stop on cue point

With the Timer object selected, Open the Properties panel.
Select the Stop on Cue Point checkbox.

NOTE: The timer direction must be Count up, and the cue point time must be specified.

Use a trigger interval

The timer object has the ability to fire a trigger event every so often as it progresses its count. The amount of time between these trigger events being fired is called the trigger interval.

With the Timer object selected, Open the Properties panel.
Insert the desired trigger interval value in the Trigger Interval text entry field.

Methods for Timer object

onCuePoint	Trigger	Triggers when cue point is reached.
onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onInterval	Trigger	Triggers whenever the interval value is reached.
onPause	Trigger	Triggers when the timer object pauses.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onStart	Trigger	Triggers when the timer starts.
onTimeZero	Trigger	Triggers when the timer object counts down to zero.
getTime	Condition	Returns current time of counter object.
isCuePointReached	Condition	Returns true or false based on whether cue point has been reached.
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
addTime	Response	Adds specified time to the timer object.
continue	Response	Resumes or starts the timer object.
hide	Response	Makes the object invisible.
pause	Response	Pauses the timer object.
reset	Response	Restarts the timer object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible.

Video object

The video object in SmartBuilder requires a FLV file type.

If you have an MP4 video, you can change the file extension to FLV and it will upload into SmartBuilder

If you have a video file type other than MP4 or FLV, it is possible to upload that video as an asset, and launch the video in a separate window. There are also a number of free FLV converters that you can find online.

The optimal encoding settings for your FLV object will depend on the size, and nature of the video. The best resource for determining these settings will be to use the Flash website. Here is a very good article in their developers forum for this exact topic.

For larger videos, you can upload your video to an external server, and use the FLV URL property. As soon as you enter the URL, the video will show on your page, and will behave the same as if you were loading from inside SmartBuilder. This is beneficial because you will not have to download large lessons that contain the videos - it is always dynamically pulling the video from that external server. This also makes updating the video or the lesson easier, because they are separate.

You can use either FLVs or MP4s with this process. Make sure that the URL thatyou are using ends in either MP4 or FLV, if you just point to a page, like a Vimeo url or YouTube url, or another page hosting a streaming video, that will not work. You would want to use the IFrame for those situations.

To select the video media:

Make sure that you have an Video object selected on the stage.
In the Properties panel, click Select Media.
-or-
Double click on the Video object.
From the Media Select window, choose the media that you wish to place in your lesson.
Click Select.

Note: You must be an owner of the media, or the media must be located in a shared folder.

You can choose whether the video starts to play when it is shown or not. Even with Autoplay checked, if an video object is hidden, or placed in a non-visible Display, it will not play until it is shown. Uncheck autoplay only if you want to start the video with an action, or a user's click.

To enable or disable autoplay:

Make sure that you have an Video object selected on the stage.
In the Properties panel, check or clear the Autoplay checkbox.

When scaling videos, sometimes you don't want to change the size at all, or you want to make sure it scales proportionally.

To lock a Video at its original size:

Make sure that you have an Video object selected on the stage.
In the Properties panel, check or clear the Lock at Original Size checkbox.

To lock a Video's aspect ratio:

Make sure that you have an Video object selected on the stage.
In the Properties panel, check or clear the Lock at Original Size checkbox.

You can choose whether the controller is displayed or not.

To enable or disable the controller:

Make sure that you have an Video object selected on the stage.
In the Properties panel, check or clear the Display Controller checkbox.

You can also choose which type of controller you wish to display.

To choose the controller style:

Make sure that you have an Video object selected on the stage.
In the Properties panel, choose the controller style that you want from the Controller Style drop down.

You can also determine whether the video loops or not. A loop count of 0 will play through the video 1 time and then stop.

To choose the controller style:

Make sure that you have an Video object selected on the stage.
In the Properties panel, choose the number of loops that you want from the Loop drop down.

You can set the volume for this specific Video object.

To set the volume for this object:

Make sure that you have an Video object selected on the stage.
In the Properties panel, enter the percentage of volume that you wish in the Volume field. 100 is full volume, and 0 is completely silent.

Note: A volume setting of 100 is the maximum value. Any number above that will be treated the same as 100.

Methods for Video object

onHide	Trigger	Triggers when the object's visibility changes from visible to hidden.
onShow	Trigger	Triggers when the object is initially shown, or when it’s visibility changes from hidden to visible.
onVideoComplete	Trigger	Triggers when video object finishes.
onPlay	Trigger	Triggers when the video starts to play (either via actions or the learner clicks on the play button).
onPause	Trigger	Triggers when the video is paused (either via actions or the learner clicks the pause button).
isVisible	Condition	Checks to see if object is currently visible on the stage. Returns a "True" value if the object is visible and a "False" value if it is hidden.
hide	Response	Pauses the video object and makes it invisible.
Pause Video	Response	Pauses the video object at the current time.
Play Video	Response	Plays the video object.
Restart Video	Response	Restarts and plays the video object.
setVisibility	Response	Sets the visibility of object based on a Boolean (True/False) value. The Boolean value can be entered as a static value, or can be pulled from another object, or variable.
show	Response	Makes the object visible and begins playing.