org.ocap.media.S3DSignalingChangedEvent Maven / Gradle / Ivy
package org.ocap.media;
import org.dvb.media.VideoFormatEvent;
/**
* This class represents an event that will be reported to an application with an
* org.ocap.media.VideoFormatControl. For a presenting
* Player the implementation SHALL monitor the signaling of
* 3D formatting data, as defined by [OCCEP], and generate this event when:
*
* - 3D formatting data is signaled after presentation starts,
* - 3D formatting data changes,
* - 3D formatting data is no longer signaled.
*
*
* @see org.ocap.media.VideoFormatControl
*/
public class S3DSignalingChangedEvent extends VideoFormatEvent
{
/**
* 3D formatting data in content transitioned from no 3D
* formatting data present (i.e., 2D content), to 3D formatting data present
* in content.
*/
public static final int TRANSITION_FROM_2D_TO_3D = 1;
/**
* 3D formatting data in content transitioned from 3D formatting data present
* in content to no 3D formatting data present in content (i.e., 2D content).
*/
public static final int TRANSITION_FROM_3D_TO_2D = TRANSITION_FROM_2D_TO_3D + 1;
/**
* 3D formatting data in content transitioned from one format to another;
* e.g., Side by Side to Top and Bottom, Top and Bottom to Side by Side.
*/
public static final int TRANSITION_OF_3D_FORMAT = TRANSITION_FROM_3D_TO_2D + 1;
/**
* Constructs an event.
*
* @param source The source of the event.
*
* @param transitionType Indicates the type of content format change.
* When the content type transitions
* from 2D to 3D this parameter is set to
* TRANSITION_FROM_2D_TO_3D. When the content type
* transitions from 3D to 2D this parameter is set to
* TRANSITION_FROM_3D_TO_2D. When the content type
* transitions between 3D formats this parameter is set to
* TRANSITION_OF_3D_FORMAT.
*
* @param config The 3D configuration that was signaled.
* The value SHALL be null when 2D content
* is currently signaled.
*/
public S3DSignalingChangedEvent(javax.media.Player source,
int transitionType,
S3DConfiguration config)
{
super(source);
}
/**
* Gets the transitionType value passed to the constructor.
*
* @return The 3D signaling transition type.
*/
public int getTransitionType()
{
return 0;
}
/**
* Gets the config value passed to the constructor.
*
* @return The signaled 3D configuration, or null if 2D
* content is currently signaled. Note: Rapid changes in
* 3D signaling may cause the returned S3DConfiguration object
* to be stale as soon as this method completes.
*/
public S3DConfiguration getConfig()
{
return null;
}
}