Namespaces

MovieBase /

#include “cinder/qtime/QuickTimeImplAvf.h”

Public Member Functions

~MovieBase ()
int32_t

getWidth () const

Returns the width of the movie in pixels.
int32_t

getHeight () const

Returns the height of the movie in pixels.
ivec2

getSize () const

Returns the size of the movie in pixels.
float

getAspectRatio () const

Returns the movie's aspect ratio, the ratio of its width to its height.
Area

getBounds () const

the Area defining the Movie's bounds in pixels: [0,0]-[width,height]
float

getPixelAspectRatio () const

Returns the movie's pixel aspect ratio. Returns 1.0 if the movie does not contain an explicit pixel aspect ratio.
bool

checkPlaythroughOk ()

Returns whether the movie has loaded and buffered enough to playback without interruption.
bool

isLoaded () const

Returns whether the movie is in a loaded state, implying its structures are ready for reading but it may not be ready for playback.
bool

isPlayable () const

Returns whether the movie is playable, implying the movie is fully formed and can be played but media data is still downloading.
bool

isProtected () const

Returns true if the content represented by the movie is protected by DRM.
float

getDuration () const

Returns the movie's length measured in seconds.
float

getFramerate () const

Returns the movie's framerate measured as frames per second.

See Also

http://developer.apple.com/mac/library/qa/qa2001/qa1262.html Technical Q&A QA1262
int32_t

getNumFrames ()

Returns the total number of frames (video samples) in the movie.
bool

hasVisuals () const

Returns whether a movie contains at least one visual track, defined as Video, MPEG, Sprite, QuickDraw3D, Text, or TimeCode tracks.
bool

hasAudio () const

Returns whether a movie contains at least one audio track, defined as Sound, Music, or MPEG tracks.
bool

hasAlpha () const

Returns whether the first video track in the movie contains an alpha channel. Returns false in the absence of visual media.

See Also

http://developer.apple.com/qa/qtmtb/qtmtb17.html Technical Q&A QTMTB17
bool

checkNewFrame ()

Returns whether a movie has a new frame available.
float

getCurrentTime () const

Returns the current time of a movie in seconds.
void

seekToTime (float seconds)

Sets the movie to the time seconds .
void

seekToFrame (int frame)

Sets the movie time to the start time of frame frame .
void

seekToStart ()

Sets the movie time to its beginning.
void

seekToEnd ()

Sets the movie time to its end.
void

setActiveSegment (float startTime, float duration)

Limits the active portion of a movie to a subset beginning at startTime seconds and lasting for duration seconds. QuickTime will not process the movie outside the active segment.
void

resetActiveSegment ()

Resets the active segment to be the entire movie.
void

setLoop (bool loop=true, bool palindrome=false)

Sets whether the movie is set to loop during playback. If palindrome is true, the movie will "ping-pong" back and forth.
bool

stepForward ()

Advances the movie by one frame (a single video sample). Ignores looping settings.
bool

stepBackward ()

Steps backward by one frame (a single video sample). Ignores looping settings.
bool

setRate (float rate)

Sets the playback rate, which begins playback immediately for nonzero values. 1.0 represents normal speed. Negative values indicate reverse playback and 0 stops.

Returns a boolean value indicating whether the rate value can be played (some media types cannot be played backwards)
void

setVolume (float volume)

Sets the audio playback volume ranging from [0 - 1.0].
float

getVolume () const

Gets the audio playback volume ranging from [0 - 1.0].
bool

isPlaying () const

Returns whether the movie is currently playing or is paused/stopped.
bool

isDone () const

Returns whether the movie has completely finished playing.
void

play (bool toggle=false)

Begins movie playback.
void

stop ()

Stops playback.
AVPlayer *

getPlayerHandle () const

Returns the native AvFoundation Player data structure.
signals::Signal< void()> &

getNewFrameSignal ()
signals::Signal< void()> &

getReadySignal ()
signals::Signal< void()> &

getCancelledSignal ()
signals::Signal< void()> &

getEndedSignal ()
signals::Signal< void()> &

getJumpedSignal ()
signals::Signal< void()> &

getOutputWasFlushedSignal ()
~MovieBase ()
bool

checkPlayable ()

Returns whether the movie has loaded and buffered enough to playback without interruption.

The movie has loaded and buffered enough to playback without interruption
int32_t

getWidth () const

Returns the width of the movie in pixels.
int32_t

getHeight () const

Returns the height of the movie in pixels.
ivec2

getSize () const

Returns the size of the movie in pixels.
float

getAspectRatio () const

Returns the movie's aspect ratio, the ratio of its width to its height.
Area

getBounds () const

the Area defining the Movie's bounds in pixels: [0,0]-[width,height]
float

getPixelAspectRatio () const

Returns the movie's pixel aspect ratio. Returns 1.0 if the movie does not contain an explicit pixel aspect ratio.
float

getDuration () const

Returns the movie's length measured in seconds.
float

getFramerate () const

Returns the movie's framerate measured as frames per second.
int32_t

getNumFrames () const

Returns the total number of frames (video samples) in the movie.
bool

hasAlpha () const

Returns whether the first video track in the movie contains an alpha channel. Returns false in the absence of visual media.
bool

hasVisuals () const

Returns whether a movie contains at least one visual track, defined as Video, MPEG, Sprite, QuickDraw3D, Text, or TimeCode tracks.
bool

hasAudio () const

Returns whether a movie contains at least one audio track, defined as Sound, Music, or MPEG tracks.
bool

checkNewFrame ()

Returns whether a movie has a new frame available.
float

getCurrentTime () const

Returns the current time of a movie in seconds.
void

seekToTime (float seconds)

Sets the movie to the time seconds .
void

seekToFrame (int frame)

Sets the movie time to the start time of frame frame .
void

seekToStart ()

Sets the movie time to its beginning.
void

seekToEnd ()

Sets the movie time to its end.
void

setActiveSegment (float startTime, float duration)

Limits the active portion of a movie to a subset beginning at startTime seconds and lasting for duration seconds. QuickTime will not process the movie outside the active segment.
void

resetActiveSegment ()

Resets the active segment to be the entire movie.
void

setLoop (bool loop=true, bool palindrome=false)

Sets whether the movie is set to loop during playback. If palindrome is true, the movie will "ping-pong" back and forth.
void

stepForward ()

Advances the movie by one frame (a single video sample). Ignores looping settings.
void

stepBackward ()

Steps backward by one frame (a single video sample). Ignores looping settings.
void

setRate (float rate)

Sets the playback rate, which begins playback immediately for nonzero values. 1.0 represents normal speed. Negative values indicate reverse playback and 0 stops.
void

setVolume (float volume)

Sets the audio playback volume ranging from [0 - 1.0].
float

getVolume () const

Gets the audio playback volume ranging from [0 - 1.0].
void

setupMonoFft (uint32_t numBands)

Sets up Fourier analysis on the movie using numBands distinct bands in a single (mono) channel. This data is only available during playback.
void

setupStereoFft (uint32_t numBands)

Sets up Fourier analysis on the movie using numBands distinct bands in a two (stereo) channels. This data is only available during playback.
void

setupMultiChannelFft (uint32_t numBands)

Sets up Fourier analysis on the movie using numBands distinct bands in as many channels as the audo track contains. To determine the number of channels, use getNumFftChannels() . This data is only available during playback.
float *

getFftData () const
uint32_t

getNumFftBands () const
uint32_t

getNumFftChannels () const
bool

isPlaying () const

Returns whether the movie is currently playing or is paused/stopped.
bool

isDone () const

Returns whether the movie has completely finished playing.
void

play ()

Begins movie playback.
void

stop ()

Stops movie playback.
void

setNewFrameCallback (void(*aNewFrameCallback)(long, void *), void *aNewFrameCallbackRefcon)

Sets a function which is called whenever the movie has rendered a new frame during playback. Generally only necessary for advanced users.
::Movie

getMovieHandle () const

Returns the native QuickTime Movie data structure.

Protected Member Functions

MovieBase ()
void

init ()
void

initFromUrl (const Url &url)
void

initFromPath (const fs::path &filePath)
void

initFromLoader (const MovieLoader &loader)
void

loadAsset ()
void

updateFrame ()
uint32_t

countFrames () const
void

processAssetTracks (AVAsset *asset)
void

createPlayerItemOutput (const AVPlayerItem *playerItem)
void

lock ()
void

unlock ()
void

removeObservers ()
void

addObservers ()
NSDictionary *

avPlayerItemOutputDictionary () const =0
void

allocateVisualContext ()=0
void

deallocateVisualContext ()=0
void

newFrame (CVImageBufferRef cvImage)=0
void

releaseFrame ()=0
void

playerReady ()
void

playerItemEnded ()
void

playerItemCancelled ()
void

playerItemJumped ()
void

outputWasFlushed (AVPlayerItemOutput *output)
MovieBase ()
void

init ()
void

updateFrame ()
void

updateLoadState ()
void

setupFft (FourCharCode code, uint32_t bandNum, uint8_t channelNum)
TimeValue

getStartTimeOfFirstSample () const
void

initFromPath (const fs::path &filePath)
void

initFromLoader (const class MovieLoader &loader)
void

initFromMemory (const void *data, size_t dataSize, const std::string &fileNameHint, const std::string &mimeTypeHint)
void

initFromDataSource (DataSourceRef dataSource, const std::string &mimeTypeHint)
Obj *

getObj () const =0
int32_t

countFrames (::Movie theMovie)

Protected Attributes

int32_t

mWidth
int32_t

mHeight
int32_t

mFrameCount
float

mFrameRate
float

mDuration
std::atomic< bool >

mAssetLoaded
bool

mLoaded
bool

mPlayThroughOk
bool

mPlayable
bool

mProtected
bool

mPlayingForward
bool

mLoop
bool

mPalindrome
bool

mHasAudio
bool

mHasVideo
bool

mPlaying
AVPlayer *

mPlayer
AVPlayerItem *

mPlayerItem
AVURLAsset *

mAsset
AVPlayerItemVideoOutput *

mPlayerVideoOutput
std::mutex

mMutex
signals::Signal< void()>

mSignalNewFrame
signals::Signal< void()>

mSignalReady
signals::Signal< void()>

mSignalCancelled
signals::Signal< void()>

mSignalEnded
signals::Signal< void()>

mSignalJumped
signals::Signal< void()>

mSignalOutputWasFlushed
MovieResponder *

mResponder
MovieDelegate *

mPlayerDelegate

Friends

friend class

MovieResponder

Namespaces

Classes

Modules

Guides

Reference

MovieBase /

Public Member Functions

Protected Member Functions

Protected Attributes

Friends