[ Previous | Next | Contents | Glossary | Home | Search ]
Ultimedia Services Version 2 for AIX: Programmer's Guide and Reference

Specific Alias Stanza Types

Use of the configuration file evolves with increasing alias stanza types and properties. This section describes the alias stanza types and properties of the default configuration file.

To learn more about alias stanza types, see:

For introductory information, see Programming with Configuration Objects.

Audio Device Alias

An audio device alias can have multiple clauses where each clause defines properties of a specific audio device. An audio device alias must minimally contain the properties:

device_path             "<device>" 
CLASS_UMSAudioDevice    "<object_name>"
audio_formats_alias     "<formats_alias_name>"
audio_inputs_alias      "<inputs_alias_name>"
audio_outputs_alias     "<outputs_alias_name>"

Where:

Audio Inputs Alias and Outputs Alias

The audio_inputs_alias and audio_outputs_alias names found in the audio device alias are used to list the sets of input connections and output connections that the device object supports. These connections are listed as properties of the respective alias. For example, if the audio_inputs_alias is UMSACPAInputs, the alias stanza might be:

UMSACPAInputs:
 LINE_IN         "<don't care>"
 LOW_GAIN_MIC    "<don't care>"
 HIGH_GAIN_MIC   "<don't care>"

In this case, only the property names are significant. The property value is not of interest.

Audio Formats Alias and Video Formats Alias

The audio formats alias is used to list the formats that an object supports. The formats supported are listed as property names under the alias with the property names being string values the device object supports as audio formats. If the audio_formats_alias for a device is UMSACPAFormats, the alias stanza might be:

UMSACPAFormats:
        PCM     "PCM" 
        A_LAW   "A_LAW"
        MU_LAW  "MU_LAW"
        ADPCM   "IBMADPCM4E"

Unlike the audio input or audio outputs alias stanza, the value strings for these property names are significant. The value string is used to confirm format matches between objects. For example, file objects and device objects advertise their supported formats in alias stanzas. Equality of value strings signifies a format match even if the property names are different. Inequality of the value string signifies that the formats are not the same even if the property names are the same. In this case, the value string is referred to as a format qualifier.

Video formats alias stanzas are similarly phrased. For example, if the video_formats_alias for an object is UMSAVIVideoFormats, the alias stanza might be:

UMSAVIVideoFormats:
        ULTI     "IBMUltimotion"
        JPEG     "IBMMotionJPEG"
        mJPG     "IBMMotionJPEG"
        RTV2     "IBMRTV2"
        RT21     "IBMRTV21"
 

Detector Alias

A detector alias stanza typically has multiple clauses where each clause specifies a detection module to be applied in the detection process. Each clause in a detection alias stanza must contain the following property names:

detection_module        "<pathname>"
file_type_alias         "<file_type_alias_name>"

Where:

File Type Alias

A file type alias stanza defines properties of a specific file access object. An audio file type alias stanza must contain the properties:

CLASS_UMSAudioFile        "<object_name>"
audio_formats_alias       "<formats_alias_name>"

Where:

A movie file type alias stanza must contain the property names:

CLASS_UMSMovieFileReader         "<object_name>"
audio_formats_alias              "<formats_alias_name1>"
video_formats_alias              "<formats_alias_name2>"

Where:

TO<Format> Alias

A TO<Format> alias stanza typically has multiple clauses where each clause defines a from format and an object to convert data to the Format. Each clause must contain the property names:

<data_type>_format_qualifier     "<qualifier>"
CLASS_<object_type>              "<classname>"

Where:

For example, if the TO format for audio data is PCM16, a TO<Format> alias stanza could be:

TOPCM16:
  audio_format_qualifier         "IMAADPCM"
  CLASS_UMSFilter                "UMSADPCMtoPCM16"
*NEXT:
  audio_format_qualifier         "IBMADPCM4E"
  CLASS_UMSFilter                "UMSADPCM4EtoPCM16"

For introductory information, see Programming with Configuration Objects.


[ Previous | Next | Contents | Glossary | Home | Search ]