org.mmbase.streams.transcoders

Interface Transcoder

All Superinterfaces:

Cloneable, PublicCloneable<Transcoder>, Serializable

All Known Implementing Classes:

AbstractTranscoder, CommandTranscoder, FFMpeg2TheoraTranscoder, FFMpegSegmenterTranscoder, FFMpegTranscoder, InfiniteTranscoder, MockTranscoder, RecognizerTranscoder, SegmenterTranscoder

public interface Transcoder
extends PublicCloneable<Transcoder>, Serializable

Representation of one transcoding action. Instances should cloned before usage, so the transcoder needs not be stateless.

Version:

$Id$

Author:

Michiel Meeuwissen

Method Summary

Modifier and Type	Method and Description
Codec	getCodec() The codec of the result.
Format	getFormat() The format of the result.
URI	getIn() {#link transcode} is feed with input.
String	getKey() The key of a transcoder uniquely identifies it.
URI	getOut() {#link transcode} is feed with a destination.
void	init(Node destination) Init the transcoder and destination node with appropiate values.
void	transcode(URI in, URI out, Logger logger) Transcode a file to another, follow the process with a logger.

Methods inherited from interface org.mmbase.util.PublicCloneable

clone

Method Detail

getKey

String getKey()

The key of a transcoder uniquely identifies it. It can be compared to the 'ckey' which we use in image conversions. Together with the node number of the source media object, this defines what the transcoded object actually is. Ideally this key can be parsed to redo the transcodation.

Returns:

A String. E.g. containing the actual class name plus parameters.

getFormat

Format getFormat()

The format of the result.

getCodec

Codec getCodec()

The codec of the result.

init

void init(Node destination)

Init the transcoder and destination node with appropiate values.

Parameters:

destination - stream destination Node

transcode

void transcode(URI in,
               URI out,
               Logger logger)
        throws Exception

Transcode a file to another, follow the process with a logger.

Parameters:

in -

out -

logger - Progress is written to this logger

Throws:

If - transcoding was unsucessfull, an Error may be thrown.

Exception

getIn

URI getIn()

{#link transcode} is feed with input. If it was called, you can ask what is was.

getOut

URI getOut()

{#link transcode} is feed with a destination. If it was called, you can ask what is was.