Skin Actions | Object2VR

 

You can apply actions or a set of directions for any object added to the skin to create interactivity. You get to the actions list by selecting the element in the editor or the tree and then add an action in the Properties panel. A dialog will appear. Select the Source and the Action. To see a list of examples of source and action combinations, see here. For a list of sources, see this article.

Change of Angle and Field of View

The following actions will cause the object to either rotate in a specified direction or will change the image’s field of view (zoom). All give the option to apply the speed of the movement.

Pan Left and Pan Right

These actions are commonly used on buttons that have an arrow indicating left or right. Applying this action to an interactive button or image will cause the object to rotate to the left or right.

Speed: When you add this action, you get the option to adjust how fast or slow the movie will pan. The speed is determined by a rate of degree per frame.

For example: Entering the number, .40, will cause the movie to rotate to the right four tenths of an angle per frame. A negative number will rotate towards the left.

◊ TIP: If you’re unsure about the speed, you can leave it blank and let the default speed be applied. Or you can get an idea of the speed using the auto rotation option in the HTML5 and Flash settings to see which speed is desired.

Tilt Up and Tilt Down

These actions are also commonly used for buttons; especially ones that use an arrow indicating up or down. Applying this action to an interactive button or image will cause the object to tilt up or down.

Speed: When you add this action, you get the option to adjust how fast or slow the movie will tilt. The speed is determined by a rate of degree per frame. For example: Entering the number, .40, will cause the movie to tilt upwards four tenths of an angle per frame. A negative number will rotate downwards.

◊ TIP: If you’re unsure about the speed, you can leave it blank and let the default speed be applied. Or you can get an idea of the speed using the auto rotation option in the HTML5 and Flash settings to see which speed is desired.

Zoom In and Zoom Out

When these actions are applied to an interactive button or image, the object will narrow or broaden its field of view respectively.

Speed: When you add this action, you get the option to adjust how fast or slow the movie will zoom in or out. The speed is determined by a rate of degree per frame. For example: Entering the number, .40, will cause the movie to zoom in at a rate of four tenths of an angle per frame. A negative number will cause the movie to zoom out.

◊ TIP: If you’re unsure about the speed, you can leave it blank and let the default speed be applied. Or you can get an idea of the speed using the auto rotation option in the HTML5 and Flash settings to see which speed is desired.


View and Move Actions

The following actions will cause the object to change its view or area seen. The movement will end with a soft stop – as if it has mass rather than coming to a sudden stop.

Change Viewstate

An action for Object2VR that will switch between view states.

State: Add the number of the state to change to.

Speed: The speed is determined by a rate of degree per frame. For example: Entering the number, .40, will cause the movie to move at a rate of four tenths of an angle per frame.

◊ TIP: If you’re unsure about the speed, you can leave it blank and let the default speed be applied. Or you can get an idea of the speed using the auto rotation option in the HTML5 and Flash settings to see which speed is desired.

Change Viewer Mode

This action changes between turn and move modes in Object2VR and between rotate and drag modes in Pano2VR.

Mode: Enter the following to change the mode:

0 = turn/rotate
1 = move/drag
2 = toggle between turn and move.

◊ TIP: In HTML5, make sure the Auto move mode in the Zoom controls is deselected.

Change Polygon Mode

With this action, you can have an element in the skin editor change how polygon hotspots appear.

Mode: Enter the following to change the mode:

0 = hide
1 = always show
2 = on hover, show current
3 = on hover, show all

Enter Fullscreen

Add this action to a button with a Click action to enter fullscreen.

Exit Fullscreen

Add this action to a button with a Click action to exit fullscreen.

Toggle Full Screen

Add to a button that will toggle between Enter and Exit Fullscreen modes.

Start Auto Rotate

This action will start to rotate the object.

Speed: The speed is determined by a rate of degree per frame. For example: Entering the number, .40, will cause the movie to move at a rate of four tenths of an angle per frame.

Stop Auto Rotate

Use this action to stop auto rotation.

Toggle Auto Rotate

Select this action to toggle between Start Auto Rotate and Stop Auto Rotate.

Default View

This action will jump to the default view.

Move to Default View

This action will cause the object to move back to the default view. You can specify the speed of this movement.

Speed: The speed is determined by a rate of degree per frame. For example: Entering the number, .40, will cause the movie to move at a rate of four tenths of an angle per frame.

◊ TIP: If you’re unsure about the speed, you can leave it blank and let the default speed be applied. Or you can get an idea of the speed using the auto rotation option in the HTML5 and Flash settings to see which speed is desired.

Move to View

Apply this action to a skin element to move the object to a specified point or view.

Pan/Tilt/FoV: Enter the exact location of the view using the Pan, Tilt, and Field of View parameters. Enter the parameters separated by forward slashes (/): 324.0/-3.5/70.0.

Speed: The speed is determined by a rate of degree per frame. For example: Entering the number, .40, will cause the movie to move at a rate of four tenths of an angle per frame.

◊ TIP: You can easily determine the location by using the parameters in the viewing parameters section]].

Go To URL

When an element is given this action, interaction with this element will send the user to a specified URL. This can be a web link or another SWF, however it is generally good practice to use this action for opening HTML files or web links.

URL: Enter the path of the web page or HTML file. You can also enter a placeholder here. For example, $hu will call the URL used in the URL field of the hotspot editor.

Target: Add a target to specify where to open the website. You can also use Placeholders here. For example, $ht will be the target specified in the target field of the hotspot editor.

Show Element

This action will show the chosen element.

Target: Choose which element will be affected by the action.

Hide Element

This action will hide the chosen element.

Target: Choose which element will be affected by the action.


Change, Set, Toggle Actions

Set: Set actions will change the element or target to the specified parameters, but the change from one parameter to the next will not be visible. It will jump to the change.

Change: Change actions will cause the element or target to visibly change depending on the action.

Toggle: Toggle actions are like an on/off switch. This command will toggle or switch from one parameter to another successively.

Set Element Position

This action will move the element to the position defined in the Offset X/Y field without visible movement.

Offset X/Y: This is the difference between the current position of the element and its new position. In the field, your offset would look something like this: 10/5. This would move the element 10 pixels to the right and 5 pixels down.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Change Element Position

When this action is applied, it will cause the chosen element or target to visibly move from its current position to the position defined in the Offset X/Y field.

Offset X/Y: This is the difference between the current position of the element and its new position. In the field, your offset would look something like this: 10/5. This would move the element 10 pixels to the right and 5 pixels down.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Toggle Element Position

Toggles the element from its current position to the specified location.

Offset X/Y: This is the difference between the current position of the element and its new position. In the field, your offset would look something like this: 10/5. This would move the element 10 pixels to the right and 5 pixels down. Click again, to return to its original position.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Set Relative Position

Use this action to change an element’s position to a set amount with each button click. With each click the relative position is changed.

Offset X/Y (/Limit X/Y): Set the initial position the element to be moved to, then sent the limit. For example, 10/0/100/0 will have the element move 10 pixels to the right at every click, until it has moved the length of 100 pixels. Likewise, a setting of -10/0/0/0, will move the element to the left until it reaches the limit of 0.

Target: Choose which element will be affected by the action.

Set Element Angle

This action will adjust the angle of the targeted element.

Angle: Enter the angle you would like to change to here. The angle is represented by integers.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Change Element Angle

This action will change the angle of the targeted element. The change from the current angle to the new angle will be visible.

Angle: Enter the angle you would like to change to here. The angle is represented by integers.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Toggle Element Angle

Use this action to toggle or switch between angles.

Angle: Enter the angle you would like to toggle to here.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Toggle Element Visibility

This action will toggle between the Show and Hide element actions.

Target: Choose which element will be affected by the action.

Set Element Alpha

This action will adjust the transparency of the element to the parameter set in the Alpha field.

Alpha: Enter the amount of transparency for the element. Alpha is based on percentage values. The integer, 1, represents 100%, .50 represents 50%, etc.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Change Element Alpha

The element’s alpha channel will gradually change from the alpha set in the element’s settings tab to the parameter applied in this Alpha field.

Alpha: Enter the amount of transparency for the element. Alpha is based on percentage values. The integer, 1, represents 100%, .50 represents 50%, etc.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Toggle Element Alpha

Toggle between transparency parameters. The parameter set in the Alpha field will be applied on the first interaction, then back to its original state (set in the settings tab) on the second interaction and so on and so forth.

Alpha: Enter the amount of transparency the element will be toggled to. Alpha is based on percentage values. The integer, 1, represents 100%, .50 represents 50%, etc.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Set Element Scale

The element will be scaled up or down depending on the parameter set in the Scale X/Y text field. The scaling will not be visible (animated).

Scale X/Y: Enter the scale parameters here. Scale is based on percentage values. The integer, 1, represents 100%, .50 represents 50%, etc. For example: .5/.25 will scale the element’s x-axis down 50% and its y-axis to 25%.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Change Element Scale

The element will be changed to the scale parameters set in the Scale X/Y text field. The scaling will be visible (animated).

Scale X/Y: Enter the scale parameters here. Scale is based on percentage values. The integer, 1, represents 100%, .50 represents 50%, etc. For example: .5/.25 will scale the element’s x-axis down 50% and its y-axis to 25%.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Toggle Element Scale

The element will change to the specified scale parameters on the initial action, then scale back to it’s original parameters set in the settings tab on the subsequent action.

Scale X/Y: Enter the scale parameters here. Scale is based on percentage values. The integer, 1, represents 100%, .50 represents 50%, etc. For example: .5/.25 will scale the element’s x-axis down 50% and its y-axis to 25%.

Target: Choose which element will be affected by the action.

◊ TIP: You can use placeholders for both the Offset X/Y and Target fields.

Other Actions

Trigger Click

Use the Trigger Click action to prompt a mouse click action (without an actual mouse click).

Set Text

The Set Text action allows you to dynamically change text. This means you can easily change the text without the need of multiple text boxes – rather useful for VR tours.

It can also be used to dynamically set files paths for the external loader to display different content. For example: Text = pictures/image01.jpg and the target = external 01.

If you are outputting an HTML5 project, you can use this action to display framed content (video, objects, panoramas), using a text box.

Text: Add the text that should appear (or path).

Target: Choose which element will be affected by the action.


Media Controls

For the following the actions (for Pano2VR only), you’ll see recurring targets. See below for what they are targeting.

_main = Targets all media added to the Media Editor.

_background = Targets the media added to the background audio section of the Media Editor.

Play Media

An action to playback the audio or video.

Loop: Set the amount of times the media should play back.

0 = play back a continuous loop
1 = single playback
-1 = media will not play back until activated

Target: Choose the media element that should be targeted.

Pause Media

This action will pause the targeted media.

Target: Choose the media element that should be targeted.

Stop Media

This action will stop the targeted media.

Target: Choose the media element that should be targeted.

Play/Pause Media

Use this action on a button toggle between playing the targeted media or pausing it.

Loop: Set the amount of times the media should play back.

0 = play back a continuous loop
1 = single playback
-1 = media will not play back until activated

Target: Choose the media element that should be targeted.

Activate Media

This action will let you activate any element in the Media Editor. If you add this to a button, this will pop out the media (image and video) and play it (video and audio).

Mode:

0 = deactivate the media element
1 = activate the media element
2 = toggle between activate and deactivate

Target: Choose the media element that should be targeted.

Set Volume

Apply this action to a button to set the volume of the media to a specified level. It will jump from it’s current level to the level set.

Level: Set the level. The maximum is 100% or 1.00 while the minimum is 0.

Target: Choose the media element that should be targeted.

Change Volume

Apply this action to a button to set the volume of the media to a specified level. It will gradually change the volume from it’s current level to the level set.

Level: Set the level. The maximum is 100% or 1.00 while the minimum is 0.

Target: Choose the media element that should be targeted.


See also

Skin Sources
Skin Modifiers
Skin Editor