MediaSocket Class Reference

An input or output point of the Transcoder. More...

List of all members.

Static Public Member Functions
static MediaSocket	FromMediaInfo (MediaInfo mediaInfo)
	Creates a media socket from a MediaInfo object.
static MediaSocket	FromPreset (string preset)
	Creates a media socket from an AVBlocks Preset.
Properties
string	File [get, set]
	The file associated with the media socket.
System.IO.Stream	Stream [get, set]
	The user stream associated with the media socket.
StreamType	StreamType [get, set]
	Specifies explicitly the format of the associated MediaSocket.File or MediaSocket.Stream.
IDictionary< string, object >	Params [get, set]
	A collection of socket parameters.
IList< MediaPin >	Pins [get]
	A modifiable collection with all the pins (elementary streams) that are defined for this socket.
double	TimePosition [get, set]
	The time position specifies the position within file/stream.
Metadata	Metadata [get, set]
	The socket metadata.

---

Detailed Description

An input or output point of the Transcoder.

A MediaSocket object describes either a container (WAV, AVI, MP4, etc.) with one or more streams or simply an elementary stream (MP3, M2V, etc.)

When MediaSocket describes a container the child collection of media pins can contain one or more items (for each contained stream). The socket stream type designates the container type.

When MediaSocket describes an elementary stream the child collection of media pins contains a single item which is the elementary stream itself. The socket stream type is the same as the pin stream type.

---

Member Function Documentation

static MediaSocket FromMediaInfo

(

MediaInfo

mediaInfo

)

[static]

Creates a media socket from a MediaInfo object.

Parameters:

mediaInfo

A MediaInfo object with loaded audio/video information. This object is not needed once this method returns.

Returns:

A new MediaSocket object which contains the information supplied by the mediaInfo parameter.

This method is meant to help in setting correctly the inputs of the Transcoder.
The intended usage is as follows:

1. Use MediaInfo to load information for a file or user stream.

2. Create a media socket from the MediaInfo object (MediaSocket.FromMediaInfo(mediaInfo)).

3. Add the newly created socket to the inputs of the Transcoder (Transcoder.Inputs.Add(socket)).

static MediaSocket FromPreset

(

string

preset

)

[static]

Creates a media socket from an AVBlocks Preset.

Parameters:

preset	A constant from the Preset enum.
quality	The required preset quality. A constant from the Quality enum.

Some presets support various levels of quality, while others support only a fixed quality in which case the quality parameter is ignored.

Returns:

A new MediaSocket object which is configured for the specified preset .

This method is meant to help in setting correctly the outputs of the Transcoder.
. The intended usage is as follows:

1. Create a media socket from a Preset (MediaSocket.FromPreset(preset,quality)).

2. Add the newly created socket to the outputs of the Transcoder (Transcoder.Outputs.Add(socket)).

---

Property Documentation

string File [get, set]

The file associated with the media socket.

The default value is null.

Metadata Metadata [get, set]

The socket metadata.

Can be null if the socket has no metadata.

IDictionary<string, object> Params [get, set]

A collection of socket parameters.

These parameters are used when demuxing the input or multiplexing the output defined by this media socket. The default value of this property is null. A System.Collections.Generic.Dictionary instance can be used to set the parameters.

See also:

Param

Param

IList<MediaPin> Pins [get]

A modifiable collection with all the pins (elementary streams) that are defined for this socket.

The default value of this property is an empty collection which can be modified but it cannot be replaced.

System.IO.Stream Stream [get, set]

The user stream associated with the media socket.

The default value of this property is null.

This is an alternative to the File property. When both a file and a user stream are associated with a socket the Transcoder prefers the user stream.

StreamType StreamType [get, set]

Specifies explicitly the format of the associated MediaSocket.File or MediaSocket.Stream.

The default value of this property is StreamType.Unknown.

double TimePosition [get, set]

The time position specifies the position within file/stream.

This property can be used on an input socket to start reading / decoding from a specific point in time. The transcoder tries to seek in the input socket to the time position before the transcoding operation starts.