Appendix D: RealPlayer Controls

This appendix identifies the RealPlayer controls that can be added to your Web page using the CONTROLS parameter. Each description includes the parameter value that must be specified to create the control, the recommended width and height to reproduce the control as it appears in RealPlayer, and an example of how the control will look on your Web page.

RealPlayer Controls

RealPlayer controls are individual components that support specific RealPlayer functionality, such as playing a presentation, muting clip volume, and displaying the current clip position. RealPlayer controls are also sometimes available in combination with other controls, to support different scenarios of playback control and presentation status.

For More Information: For more information about embedding combinations of playback and status controls, see "Convenience Controls".

Clip Information Field

An information area that displays the title, author, and copyright for the currently playing clip or portion of a multi-clip. The arrow button to the right of the field allows you to scroll through the information. The round button opens a dialog with additional information about the clip, supplied by the content provider.


CONTROLS Value	`TACCtrl`
Width	370 pixels
Height	32 pixels

Clip Position Slider

A slide control that indicates the currently playing position within the clip. You can jump to other positions within the clip by dragging the slider to the left or the right.


CONTROLS Value	`PositionSlider`
Width	120 pixels
Height	26 pixels

Note: When the clip is a live broadcast, the clip position slider is automatically disabled.

Fast Forward Button

A button with a graphical image representing the fast forward action. When this button is clicked, playback of the currently loaded clip jumps to the next frame. If the button is pressed down, playback continues to jump forward until the button is released.


CONTROLS Value	`FFCtrl`
Width	28 pixels
Height	18 pixels

Image Window

A basic image window for displaying video or animation presentations. While the presentation is loading, the RealPlayer G2 logo is displayed in the image window. Even when no other controls are visible on the Web page, the user can typically right-click (in Windows) or hold down the mouse button (on Macintosh) over the window to display a menu of playback choices, such as Play and Stop.


CONTROLS Value	`ImageWindow`
Width	176 pixels or wider, depending on your presentation width
Height	132 pixels or higher, depending on your presentation height

Information Panel

An information area that displays the title, author, and copyright for the currently playing presentation.


CONTROLS Value	`InfoPanel`
Width	300 pixels
Height	55 pixels

Mute Button

A button with a graphical image representing the mute volume action. When the mute action has been selected, the button appears to be pressed in and the clip volume is temporarily lowered to zero. Clicking the button again, deselects the mute action and restores the clip volume to its previous level.


CONTROLS Value	`MuteCtrl`
Width	26 pixels
Height	26 pixels

Pause Button

A button with a graphical image representing the pause action. When this button is clicked, playback of the currently loaded clip is paused. If the clip is already paused or stopped, clicking this button has no effect.


CONTROLS Value	`PauseButton`
Width	26 pixels
Height	26 pixels

Play Button

A button with a graphical image representing the play (start) action. When this button is clicked, playback of the currently loaded clip is started. If the clip is already playing, clicking this button has no effect.


CONTROLS Value	`PlayOnlyButton`
Width	26 pixels
Height	26 pixels

Rewind Button

A button with a graphical image representing the rewind action. When this button is clicked, playback of the currently loaded clip jumps to the previous frame. If the button is pressed down, playback continues to jump backward until the button is released.


CONTROLS Value	`RWCtrl`
Width	28 pixels
Height	18 pixels

Stop Button

A button with a graphical image representing the stop action. When this button is clicked, playback of the currently loaded clip is halted and reset to the beginning. If the clip is already stopped, clicking this button has no effect.


CONTROLS Value	`StopButton`
Width	26 pixels
Height	26 pixels

Volume Slider

A slider with a graphical image representing the volume control. Dragging the volume button up the slider increases the clip volume, and dragging the button down decreases the volume.


CONTROLS Value	`MuteVolume`
Width	26 pixels
Height	65 pixels

www.real.com Home Button

A button with the RealNetworks logo. When the button is clicked, a browser window is opened and connected to the www.real.com Web site.


CONTROLS Value	`HomeCtrl`
Width	45 pixels
Height	45 pixels

Convenience Controls

Convenience controls are combinations of RealPlayer controls that provide different levels of support for controlling playback of your presentation and providing status to your audience.

All Playback Controls

A complex panel of playback and status controls, including the www.real.com Home Button, Play Button, Pause Button, Stop Button, Fast Forward Button, Rewind Button, Clip Position Slider, Clip Information Field, and Status Bar.


CONTROLS Value	`All` or `default`
Width	375 pixels
Height	100 pixels

Control Panel, Simple

A simple panel of playback controls, including the www.real.com Home Button, Play Button, Pause Button, Stop Button, Fast Forward Button, Rewind Button, and Clip Position Slider.


CONTROLS Value	`All`
Width	350 pixels
Height	36 pixels

Mute / Volume Bar

A simple playback control bar consisting of the Mute Button and the Volume Slider.


CONTROLS Value	`MuteVolume`
Width	26 pixels
Height	88 pixels

Play / Pause Bar

A simple playback control bar consisting of the Play Button and the Pause Button.

Note: This control is available only for RealPlayer 8 and earlier versions.


CONTROLS Value	`PlayButton`
Width	44 pixels
Height	26 pixels

Information / Volume Bar

A simple playback control bar consisting of an Information Panel and the Mute / Volume Bar.


CONTROLS Value	`InfoVolumePanel`
Width	325 pixels
Height	55 pixels

Status Panels

Status panels display information about your presentation using a variety of different controls, including a text message area, a network congestion LED, and a current clip position indicator.

Note: If you do not embed a status panel in your Web page, error messages received from RealPlayer are displayed in the browser's status bar.

Status Bar

A complex status panel consisting of a text message area, the network congestion LED, and the current clip position indicator.


CONTROLS Value	`StatusBar`
Width	325 pixels
Height	30 pixels

Status Field

An simple status panel consisting only of a text message area.


CONTROLS Value	`StatusField`
Width	200 pixels
Height	30 pixels

Position Field

An information panel consisting only of the current clip position indicator, that identifies the clip's current place within the presentation timeline and the total clip length.


CONTROLS Value	`PositionField`
Width	90 pixels
Height	30 pixels