Package org.opensourcephysics.media.mov

Class MovieVideo

java.lang.Object

org.opensourcephysics.display.OSPRuntime.Supported

org.opensourcephysics.media.core.VideoAdapter

org.opensourcephysics.media.mov.MovieVideo

All Implemented Interfaces:

PropertyChangeListener, EventListener, Drawable, Interactive, Measurable, DrawableImage, InteractiveImage, Trackable, Video

Direct Known Subclasses:

JSMovieVideo, XuggleVideo

public abstract class MovieVideo
extends VideoAdapter

An abstract class that describes common aspects of VideoAdapters that involve actual digital video sources such as MP4 (JSMovieVideo and XuggleVideo). (formerly MovieVideoI interface)

Author:

hansonr

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MovieVideo.Loader

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	allowControlData	set true to read control data start_times, duration (for rawDuration), and frame_count; false to instead scan video again
protected XMLControl	control	the originating video XMLControlElement, if it exists
protected String	fileName
protected double	frameRateMaximum
protected double	frameRateMinimum
protected ArrayList<Double>	frameTimes	These are temporary only, during loading.
protected boolean	isExport
protected boolean	isLocal
protected boolean	isVariableFrameRate
protected int	nominalFrameRate	nominal rounded frame rate -- 24, 25, 30, 50, 60...; used only for offset to center of frames
protected String	path
protected static final String	PLATFORM_JAVA
static final String	PROPERTY_VIDEO_PROGRESS
static final String	PROPERTY_VIDEO_STALLED
protected double	rawDuration	the duration reported by the video, possibly longer for Xuggle than this.getDuration(); in seconds
protected int	rawFrameCount	frame count by this engine's calculation; may be different from frameCount, which could be coming from another creator via a video XMLControlElement
protected static final double	TIME_SLOP_MS
protected URL	url

Fields inherited from class org.opensourcephysics.media.core.VideoAdapter

aspects, baseDir, bufferedImage, clearRaster, coords, displayedSize, endFrameNumber, filteredImage, filterStack, frameCount, frameNumber, isMeasured, isValidFilteredImage, isValidImage, isValidMeasure, looping, maxX, maxY, minX, minY, mouseEnabled, playing, properties, rate, rawImage, size, startFrameNumber, startTimesMS, visible, widthDominates

Fields inherited from interface org.opensourcephysics.media.core.Trackable

PROPERTY_ADJUSTING

Fields inherited from interface org.opensourcephysics.media.core.Video

PROPERTY_VIDEO_COORDS, PROPERTY_VIDEO_ENDFRAME, PROPERTY_VIDEO_FILTERCHANGED, PROPERTY_VIDEO_FRAMENUMBER, PROPERTY_VIDEO_IMAGE, PROPERTY_VIDEO_LOOPING, PROPERTY_VIDEO_NEXTFRAME, PROPERTY_VIDEO_PLAYING, PROPERTY_VIDEO_RATE, PROPERTY_VIDEO_SIZE, PROPERTY_VIDEO_VIDEOVISIBLE

Constructor Summary

Constructors

Constructor	Description
MovieVideo(String fileName, String basePath, XMLControl control)

Method Summary

Modifier and Type	Method	Description
protected abstract void	finalizeLoading()
protected int	getFrameNumberBefore(double time)	Gets the number of the last frame before the specified time.
protected abstract BufferedImage	getImageForMSTimePoint(double timeSec)
protected abstract String	getPlatform()	Get this platform's name
protected abstract boolean	seekMS(double timeMS)	seek to a time in milliseconds.
protected XMLControl	setFromControl(XMLControl control)	Set frameCount, startTimes, and rawDuration if available from the control.
protected String	setFromMediaTrackInfo(Map<String,Object> info)	JavaScript only -- use MediaInfo for rate information
protected void	setStartTimes()

Methods inherited from class org.opensourcephysics.media.core.VideoAdapter

back, dispose, draw, finalize, findInteractive, findMinMaxValues, getAbsolutePath, getAngle, getCoords, getEndFrameNumber, getEndTime, getFilterStack, getFrameCount, getFrameDuration, getFrameNumber, getFrameTime, getHeight, getImage, getImageSize, getProperty, getPropertyNames, getRate, getRawBufferedImage, getRelativeAspect, getStartFrameNumber, getStartTime, getWidth, getX, getXMax, getXMin, getY, getYMax, getYMin, goToEnd, goToStart, initialize, invalidateVideoAndFilter, isEnabled, isLooping, isMeasured, isPlaying, isVisible, notifyFrame, notifySize, propertyChange, refreshBufferedImage, reset, setAngle, setCoords, setEnabled, setEndFrameNumber, setEndTime, setFilterStack, setFrameAngle, setFrameCount, setFrameHeight, setFrameNumber, setFrameRelativeAspect, setFrameWidth, setFrameX, setFrameXY, setFrameY, setHeight, setLooping, setNotify, setPlaying, setProperty, setRate, setRelativeAspect, setStartFrameNumber, setStartTime, setVisible, setWidth, setX, setXY, setY, step, updateBufferedImage

Methods inherited from class org.opensourcephysics.display.OSPRuntime.Supported

addListeners, addPropertyChangeListener, addPropertyChangeListener, addPropertyChangeListenerSafely, dispose, firePropertyChange, firePropertyChange, removeListeners, removePropertyChangeListener, removePropertyChangeListener

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.opensourcephysics.display.Interactive

isInteractive

Methods inherited from interface org.opensourcephysics.media.core.Video

addListener, addPropertyChangeListener, addPropertyChangeListener, getAverageFrameDuration, getAverageFrameRate, getFrameCountDurationMS, getOutliers, getTypeName, isValid, play, removeListener, removePropertyChangeListener, removePropertyChangeListener, stop

Field Details

PROPERTY_VIDEO_PROGRESS

public static final String PROPERTY_VIDEO_PROGRESS

See Also:

• Constant Field Values

PROPERTY_VIDEO_STALLED

public static final String PROPERTY_VIDEO_STALLED

See Also:

• Constant Field Values

PLATFORM_JAVA

protected static final String PLATFORM_JAVA

See Also:

• Constant Field Values

TIME_SLOP_MS

protected static final double TIME_SLOP_MS

See Also:

• Constant Field Values

fileName

protected String fileName

url

protected URL url

frameTimes

protected ArrayList<Double> frameTimes

These are temporary only, during loading. see startTimes

allowControlData

protected boolean allowControlData

set true to read control data start_times, duration (for rawDuration), and frame_count; false to instead scan video again

rawDuration

protected double rawDuration

the duration reported by the video, possibly longer for Xuggle than this.getDuration(); in seconds

nominalFrameRate

protected int nominalFrameRate

nominal rounded frame rate -- 24, 25, 30, 50, 60...; used only for offset to center of frames

path

protected String path

isLocal

protected boolean isLocal

isExport

protected boolean isExport

rawFrameCount

protected int rawFrameCount

frame count by this engine's calculation; may be different from frameCount, which could be coming from another creator via a video XMLControlElement

control

protected XMLControl control

the originating video XMLControlElement, if it exists

isVariableFrameRate

protected boolean isVariableFrameRate

frameRateMinimum

protected double frameRateMinimum

frameRateMaximum

protected double frameRateMaximum

Constructor Details

MovieVideo

public MovieVideo(String fileName,
 String basePath,
 XMLControl control)
           throws IOException

Throws:

IOException

Method Details

getPlatform

protected abstract String getPlatform()

Get this platform's name

Returns:

"Java" or navigator.userAgent

seekMS

protected abstract boolean seekMS(double timeMS)

seek to a time in milliseconds.

Parameters:

timeMS -

Returns:

finalizeLoading

protected abstract void finalizeLoading()
                                 throws IOException

Throws:

IOException

getImageForMSTimePoint

protected abstract BufferedImage getImageForMSTimePoint(double timeSec)

setStartTimes

protected void setStartTimes()

Specified by:

setStartTimes in class VideoAdapter

getFrameNumberBefore

protected int getFrameNumberBefore(double time)

Gets the number of the last frame before the specified time. a 0.1-ms slop is added

Parameters:

time - the time in milliseconds

Returns:

the frame number, or -1 if not found

setFromControl

protected XMLControl setFromControl(XMLControl control)

Set frameCount, startTimes, and rawDuration if available from the control. Ignore if the saved platform string is "Java" and

Parameters:

control -

Returns:

null if cannot be set (older versions)

setFromMediaTrackInfo

protected String setFromMediaTrackInfo(Map<String,Object> info)

JavaScript only -- use MediaInfo for rate information

Parameters:

info -

Returns:

error string or null if no error