javax.media.control
Interface QualityControl

public interface QualityControl

extends Control

This interface is a Control for specifying the parameters for quality. Quality is referenced by a float value of 0.0 for minimal quality and 1.0 for maximum quality. There is usually a tradeoff between CPU usage and the quality: higher quality requires higher CPU usage.

Since:

JMF 2.0

Method Summary

float	getPreferredQuality() Returns the default quality recommended for decoding or encoding.
float	getQuality() Returns the current value of the decoding or encoding quality parameter.
boolean	isTemporalSpatialTradeoffSupported() Returns if the encoder can increase frame rate with reduced resolution and vica-versa.
float	setQuality(float newQuality) Set the quality for the decoding or encoding.

Methods inherited from interface javax.media.Control

getControlComponent

Method Detail

getQuality

public float getQuality()

Returns the current value of the decoding or encoding quality parameter.

Returns:

the current decoding or encoding quality.

setQuality

public float setQuality(float newQuality)

Set the quality for the decoding or encoding. This value may have different effects depending on the type of compression. A higher quality setting will result in better quality of the resulting outputb, e.g. better image quality for video. There is usually a tradeoff between CPU usage and the quality: higher quality requires higher CPU usage. This value is only a hint and the codec can choose to ignore it. The actual value that was set is returned. It should be in the range of 0.0 to 1.0.

Parameters:

newQuality - the decoding or encoding quality.

Returns:

the quality that is actually set.

getPreferredQuality

public float getPreferredQuality()

Returns the default quality recommended for decoding or encoding.

Returns:

the preferred decoding or encoding quality.

isTemporalSpatialTradeoffSupported

public boolean isTemporalSpatialTradeoffSupported()

Returns if the encoder can increase frame rate with reduced resolution and vica-versa.

Returns:

if the encoder can increase frame rate with reduced resolution and vica-versa.