sbITranscodeVideoJob Interface Reference

An object capable of transcoding a source URI to a destination file. More...

import"sbITranscodeVideoJob.idl";

Inheritance diagram for sbITranscodeVideoJob:
[legend]
Collaboration diagram for sbITranscodeVideoJob:
[legend]

Public Member Functions

PRInt32 vote (in sbIMediaItem aMediaItem)
 Vote to be the handler returned for the given url. More...
 
void transcode ()
 Start the transcoding operation. More...
 

Public Attributes

attribute sbIPropertyArray metadata
 An array of metadata properties. More...
 
attribute nsIInputStream metadataImage
 An input stream for the encoded image. More...
 
attribute
sbITranscodingConfigurator 
configurator
 The configurator that will be used to configurate the transcoder for the specific input URI. More...
 
attribute AString sourceURI
 The source URI to transcode from. More...
 
attribute AString destURI
 The destination URI to transcode to. Used only if destStream is set to a non-null value. More...
 
attribute nsIOutputStream destStream
 A stream to write the output to. Used in preference to destURI if this is set. More...
 

Detailed Description

An object capable of transcoding a source URI to a destination file.

User code should request an instance using sbITranscodeManager::getTranscoder()

Implementations should also implement sbIJobProgress, and usually sbIJobCancelable.

See Also
sbITranscodeManager
sbIJobProgress
sbIJobCancelable

Definition at line 52 of file sbITranscodeVideoJob.idl.

Member Function Documentation

void sbITranscodeVideoJob::transcode ( )

Start the transcoding operation.

Caller should monitor progress via sbIJobProgress

PRInt32 sbITranscodeVideoJob::vote ( in sbIMediaItem  aMediaItem)

Vote to be the handler returned for the given url.

The sbITranscodeManager will instantiate one of every sbITranscodeVideoJob subclass and ask it to vote on whether it can support transcoding a given media item with a given transcoding profile. The highest vote will be used as the handler for the media item.

Values less than zero cause that handler to be ignored.

At the moment, our handlers return -1, 0, or 1000 (for "no," "maybe," and "yes").

Parameters
aMediaItemThe media item on which to vote
Returns
The vote
See Also
sbITranscodeManager TODO: Determine what info this will actually be passed!

Member Data Documentation

attribute sbITranscodingConfigurator sbITranscodeVideoJob::configurator

The configurator that will be used to configurate the transcoder for the specific input URI.

The transcoding job will use the configurator to decide on parameters for the raw media input to the encoder, and to decide on the specific encoder settings to use.

Definition at line 81 of file sbITranscodeVideoJob.idl.

attribute nsIOutputStream sbITranscodeVideoJob::destStream

A stream to write the output to. Used in preference to destURI if this is set.

Note that the output stream may not be seekable, in which case some formats may not work correctly. If the stream does implement nsISeekableStream, any format should be usable.

Definition at line 106 of file sbITranscodeVideoJob.idl.

attribute AString sbITranscodeVideoJob::destURI

The destination URI to transcode to. Used only if destStream is set to a non-null value.

Note that, in general, only file URIs will be supported for destination URI. For non-file URIs, an nsIOutputStream should be used instead (see below).

Definition at line 96 of file sbITranscodeVideoJob.idl.

attribute sbIPropertyArray sbITranscodeVideoJob::metadata

An array of metadata properties.

Metadata properties to be written into the destination file. Metadata items in this property array should be used to replace those in the source file (where present), and add them otherwise. Metadata items present in the source stream but not in this array should be preserved where possible.

Definition at line 63 of file sbITranscodeVideoJob.idl.

attribute nsIInputStream sbITranscodeVideoJob::metadataImage

An input stream for the encoded image.

If an image is desired in the encoded file (e.g. album art cover), set this to an input stream that the encoded image can be read from.

Definition at line 71 of file sbITranscodeVideoJob.idl.

attribute AString sbITranscodeVideoJob::sourceURI

The source URI to transcode from.

Definition at line 86 of file sbITranscodeVideoJob.idl.


The documentation for this interface was generated from the following file: