Video Object

Here are the object's settings as they appear on the "double-click" Properties dialog.

There are four tabs on the Properties dialog:

Settings

Attributes

Quick Action

Script

Settings Tab

Object

File:

The video file that you want to display in the video object. Click the browse button to select a file.

Note: The video object has a wide range of supported file types.

Stage:

The background color of the object. This is the color that will appear around the video if the object is larger than the video itself. You can click the select button to bring up a color chooser.

Tip: Clicking the "More Colors..." button on the color menu allows you to choose either a standard color/custom color, or use the eyedropper to pick a color from somewhere within the AutoPlay application window.

Scaling mode:

The scale that will be used for the video. Choose from:

Stretch

Resize the video to fill the area defined by the object's bounding box.

Note: This setting ignores the movie's original aspect ratio. The movie may appear distorted as a result.

Maintain Aspect

Maintain the original aspect ratio for the file. The aspect ratio of a video is it's width to height ratio. For example 4:3 or 16:9. This option enables you to ensure the video is viewed at it's intended dimensions.

Control Panel

Style:

Display a control panel for video playback. Click the select button to choose the panel style you want to use.

Note: You can find the skin files for the panel styles in the Plugins\Transports folder located within your AutoPlay Media Studio program directory.

Tip: If you do not want to display a control panel, you can choose None as the panel style.

Time:

The type of time display to include on the control panel. Choose from:

None

Do not show any time display on the control panel.

Elapsed

The time that has elapsed during the video's playback.

Length

The total length of the video.

Both

Both the time that has elapsed and the total length of the video.

Panel:

The color used for the control panel. You can click the select button to bring up a color chooser.

Tip: Clicking the "More Colors..." button on the color menu allows you to choose either a standard color/custom color, or use the eyedropper to pick a color from somewhere within the AutoPlay application window.

Text:

The color used for the text that appears on the control panel, such as the "Elapsed" or "Length" of time. You can click the select button to bring up a color chooser.

Control buttons

Display play/pause and stop buttons on the control panel.

Slider

Include a position slider on the control panel.

Play

Auto start

Start playing the video automatically (as soon as the page or dialog is opened).

Note: If this option is unchecked, the video will not play until you start it with a Video.Play action.

Loop

Automatically begin playing from the beginning again whenever the video reaches the end.

Appearance

Border

Include a border around the object.

Apply custom window mask:

Makes certain parts of the video object transparent. You can use this option to make a custom shaped video object play in your application.

To specify the areas that you want to make transparent, you need to create a transparency mask file in your favorite drawing program.

A transparency mask file is just an image where a single color represents the parts that you want to make transparent. Picture this image as being invisibly "placed over" your video object, like a mask or a stencil.

In AutoPlay, the transparent parts of the mask should all be solid black. Wherever solid black appears in the mask image, the corresponding part of the video object will be made transparent. The transparency mask acts like a "cookie cutter," cutting holes in the video object so whatever is behind it in the project can show through.

Click the browse button to select an image file.

Fit to object

Take your transparency mask image and resize it to fit the video object. The original image dimensions will be used to mask the video object if this option is not selected.

Attributes Tab

Identification

Object name:

The name that is used to identify this object.

State

Enabled

Enable the object so it responds to user interaction. When an object is disabled, it will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

Note: You can use the Video.SetEnabled action to enable this object.

Visible

Set the object's initial visibility (whether it's visible when the page or dialog is displayed). You can use the Video.SetVisible action to make the object visible or invisible at run time.

Note: This option simply controls the initial visibility of the object and does not affect its play state. For example, if the object is set to start automatically, it will begin to play when the page or dialog opens whether it is visible or not.

Auto-Resize

Left

If checked, the left side of the object will move when the application is resized. If unchecked, the left side of the object will not move.

Right

If checked, the right side of the object will move when the application is resized. If unchecked, the right side of the object will not move.

Top

If checked, the top of the object will move when the application is resized. If unchecked, the top of the object will not move.

Bottom

If checked, the bottom of the object will move when the application is resized. If unchecked, the bottom of the object will not move.

Position

Left:

The distance in pixels from the left edge of the object to the left edge of the page or dialog.

Tip: You can also change the position of an object by dragging it or using the arrow keys.

Top:

The distance in pixels from the top edge of the object to the top edge of the page or dialog.

Width:

The width of the object in pixels.

Tip: You can also resize an object by dragging one of the resize handles on its bounding box.

Height:

The height of the object in pixels.

Restore Original

Set's the object's size back to the original values.

Feedback

Tooltip:

This feature is not available for the Video object.

Spelling

Check the spelling of the tooltip text.

Cursor:

The mouse pointer that will be used while the mouse is over this object.

Sounds

Highlight:

The sound that will be played when the mouse moves over this object. Choose from:

None

Don't play any sound.

Standard

Play the default mouse over sound, as configured on the Sound Effects tab of the Audio Settings dialog.

Custom

Play a custom mouse over sound.

File:

The custom audio file to play. Click the browse button to select an appropriate sound file.

Click:

The sound that will be played when the user clicks on this object. Choose from:

None

Don't play any sound.

Standard

Play the default mouse click sound, as configured on the Sound Effects tab of the Audio Settings dialog.

Custom

Play a custom mouse click sound.

File:

The custom audio file to play. Click the browse button to select an appropriate sound file.

Quick Action Tab

You can use this tab to perform a simple action when the object is clicked.

When Object is Clicked

Action to run:

The action to perform when the object is clicked. Choose from:

ACTION

DESCRIPTION

None

Does nothing.

Show Page

Jumps to the specified page in your application. Click here for more information.

Show Dialog

Shows a specific dialog in your application. Click here for more information.

Close Dialog

Closes the currently displayed dialog. Click here for more information.

Run Program

Runs an application with optional command line arguments. Click here for more information.

Open Document

Opens a document in an external viewer. Click here for more information.

Print Document

Prints a document on the user's system. Click here for more information.

Send Email

Sends an email through the user's default email program. Click here for more information.

View Website

Opens a website in the user's default web browser. Click here for more information.

Explore Folder

Explores a folder on the user's system. Click here for more information.

Play Multimedia

Plays a multimedia file in the default player on the user's system. Click here for more information.

Play/Pause Background Music

Toggles the play state of the background music. Click here for more information.

Exit/Close

Exits from the AutoPlay application. Click here for more information.

Properties

Any additional settings corresponding to the selected quick action.

Script Tab

You can use the script editor on this tab to edit the script of actions that will be performed on each of this object's events.

This object supports the following events:

On Click

The actions that will be performed when the user clicks on this object.

On Enter

The actions that will be performed when the mouse moves onto this object ("enters" the object's territory).

On Leave

The actions that will be performed when the mouse moves off of this object ("leaves" the object's territory).

On Play

The actions that will be performed whenever the video starts to play.

On Pause

The actions that will be performed whenever the video is paused.

On Stop

The actions that will be performed whenever the video is stopped.

On Finish

The actions that will be performed whenever the video reaches the end.