HDS ViewStation System Administrator's Guide

A Hypertext Document


HDS Movie Video Client Manual Page

This page describes the ViewStation's HDS Movie Video client manual page.

HDS Movie Manual Page

NAME
hdsmovie - view audio/video interleaved files

SYNOPSIS
hdsmovie [ -f filename ] [ -loop ] [ -playvol (0 to 100) ] [ -invol (1 to 100) ] [ -brightness (-30 to 30) ] [ -contrast (-30 to 30) ] [ -saturation (-30 to 30) ] [ -audio (Mono or Stereo) ] [ -output audiooutputtype ] [ -nobuttons ] [ -noaudio ] [ -noloop ] [ -toolkitOption ... ]

DESCRIPTION
hdsmovie plays audio/video interleaved files. The video can be raw or compressed with the Indeo compression algorithm. Version 3.2 of Indeo is supported.

The audio will be played on the ViewStation's internal speaker, on external headphones or speakers attached to the ViewStation's AUDIO OUT connector. Volume levels should be set in the Audio Controls option dialog.

By default, the program will create a main driver panel called HDS Movie.

The Movie File item should be filled with a ViewStation file path. This should usually begin with the /hostname prefix. Note that video files usually require a fast Access Protocol such as FTP in order to read the file quickly enough for rapid display. The usual default of TFTP is not sufficient. You may need to update the Remote Hosts entries for the host in the ViewStation Setup screen.

The Play Movie button causes the movie file to be played once.

The Loop Movie button causes the movie file to played continuously in a loop.

The Clear File button simply clears the current filename entry to allow a new one to be entered. It does not affect the file contents in any way.

When the video file playing is started, a second window is created. This window has the video file name as its title. The movie window offers several buttons and a volume slider.

The Freeze button can be used to freeze the current image. It affects only the video window in which it is pressed. Pressing the button again cancels the freeze.

The Mute button will mute the ViewStation audio output. Pressing the button again cancels the mute.

The SnapShot button will create a new window containing a still of the current image. The snapshot window contents can be easily captured to a file using common X image manipulations tools such as xwd(1) and xv. Note that if there are not enough free color entries available in the ViewStation's colormap, the snapshot window may not appear to have the correct colors. If this occurs, select the snapshot window with the window manager to see the correct colors. This can generally be avoided if at least 128 colors are available when the first snapshot is taken.

The Restart button causes the current movie to restart from the beginning.

The Done button terminates the movie window.

The Play Volume slider controls the output volume of the ViewStation. Note that the settings of other items in the Audio Controls panel can also have an important affect on the overall audio volume. Changes to this slider are reflected in all the hdsmovie windows.

The main HDS Movie panel also contains an Options menu which offers access to two other control dialogs, Video Controls and Audio Controls.

The Brightness, Contrast, and Saturation sliders control the video characteristics of the video window.

The Output Device item indicates the type of device attached to the ViewStation's AUDIO OUT connector. This value must be set properly or the ViewStation's audio will not operate correctly. The initial value for the output device comes from the ViewStation's Setup client. It is better to make any changes to this value in the Setup menu "Setup Options/User Preferences/Audio Device Settings/ Audio Out Device" and save the value for the future. NOTE: It is important to change this value whenever you change the audio device attached to the ViewStation. Otherwise, the ViewStation will not know what type of device is attached and severe audio quality problems will result. The output device can be set to "HDS Internal Speaker", "External Speakers", "HDS Headset", or "CallPort Spkr/ Mic".

OPTIONS
In addition to the usual Xt and Motif options, hdsmovie supports the following application-specific options.

-f filename
Gives the ViewStation path to the movie file to play. If specified, this file will be played automatically when the hdsmovie program is started.

-loop
Indicates that the file playback should be restarted when finished.

-playvol(0 to 100)
Set the initial play volume.

-brightness (-30 to 30)
Set the initial video window brightness.

-contrast (-30 to 30)
Set the initial video window contrast.

-saturation (-30 to 30)
Set the initial video window saturation.

-output audiooutputtype
Select the audio output type. audiooutputtype can be either Speaker or Head phones. See the DESCRIPTION section for more information.

-nobuttons
This option removes the control panels from the movie window.

-noaudio
This option brings up hdsmovie without using the ViewStation audio capabilities. This allows other programs to control the audio and avoids conflicts with other audio programs.

X RESOURCES
In addition to the usual Xt and Motif resources, the hdsmovie supports the following application specific resources. The values and defaults are the same as the corresponding command line options.

HDSvid.filename: (0 to 4)
HDSvid.loop: Yes | No
HDSvid.brightness: (-30 to 30)
HDSvid.contrast: (-30 to 30)
HDSvid.saturation: (-30 to 30)
HDSvid.outputType: audiooutputtype
HDSvid.showButtons: Yes | No
HDSvid.doAudio: Yes | No


COPYRIGHT
Copyright 1995, HDS Network Systems, Inc.

Return to Section Heading Page


Return to the Home Page

If you need more information than is available here, you can reach HDS via email at info@hds.com, or call us at 1.800.HDS.1551 in the USA, or at +610.277.8300 from outside the US. For questions or problems regarding the HDS WWW page, contact webmaster@hds.com.
© 1996 by HDS Network Systems Inc.