Namespaces

MovieSurface /

#include “cinder/qtime/QuickTimeImplAvf.h”

Typedefs:

MovieSurfaceRef

Class Hierarchy:

cinder::qtime::MovieBase
cinder::qtime::MovieSurface

Public Member Functions

operator unspecified_bool_type () const

Emulates shared_ptr-like behavior.
void

reset ()

Emulates shared_ptr-like behavior.
~MovieSurface ()
Surface8uRef

getSurface ()

Returns the Surface8u representing the Movie's current frame.
SurfaceRef

getSurface ()

Returns the Surface8u representing the Movie's current frame.
int32_t

getWidth () const

Returns the width of the movie in pixels.
int32_t

getWidth () const

Returns the width of the movie in pixels.
int32_t

getHeight () const

Returns the height 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.
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.
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]
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

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

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
float

getFramerate () const

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

getNumFrames ()

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

getNumFrames () const

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

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

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

hasAlpha () const

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

checkNewFrame ()

Returns whether a movie has a new frame available.
bool

checkNewFrame ()

Returns whether a movie has a new frame available.
float

getCurrentTime () const

Returns the current time of a movie in seconds.
float

getCurrentTime () const

Returns the current time of a movie in seconds.
void

seekToTime (float seconds)

Sets the movie to the time 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

seekToFrame (int frame)

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

seekToStart ()

Sets the movie time to its beginning.
void

seekToStart ()

Sets the movie time to its beginning.
void

seekToEnd ()

Sets the movie time to its end.
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

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

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

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.
void

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.
void

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

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].
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].
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

isPlaying () const

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

isDone () const

Returns whether the movie has completely finished playing.
bool

isDone () const

Returns whether the movie has completely finished playing.
void

play (bool toggle=false)

Begins movie playback.
void

play ()

Begins movie playback.
void

stop ()

Stops playback.
void

stop ()

Stops movie 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 ()
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
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
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.

Static Public Member Functions

MovieSurfaceRef

create (const ci::Url &url)
MovieSurfaceRef

create (const fs::path &path)
MovieSurfaceRef

create (const MovieLoaderRef &loader)
MovieSurfaceRef

create (const fs::path &path)
MovieSurfaceRef

create (const MovieLoaderRef &loader)
MovieSurfaceRef

create (const void *data, size_t dataSize, const std::string &fileNameHint, const std::string &mimeTypeHint="")
MovieSurfaceRef

create (DataSourceRef dataSource, const std::string mimeTypeHint="")

Protected Member Functions

MovieSurface ()
MovieSurface (const Url &url)
MovieSurface (const fs::path &path)
MovieSurface (const MovieLoader &loader)
NSDictionary *

avPlayerItemOutputDictionary () const override
void

allocateVisualContext () override
void

deallocateVisualContext () override
void

newFrame (CVImageBufferRef cvImage) override
void

releaseFrame () override
MovieSurface ()
MovieSurface (const fs::path &path)
MovieSurface (const class MovieLoader &loader)
MovieSurface (const void *data, size_t dataSize, const std::string &fileNameHint, const std::string &mimeTypeHint="")

Constructs a MovieSurface from a block of memory of size dataSize pointed to by data , which must not be disposed of during the lifetime of the movie.

fileNameHint and mimeTypeHint provide important hints to QuickTime about the contents of the file. Omit both of them at your peril. "video/quicktime" is often a good choice for mimeTypeHint .
MovieSurface (DataSourceRef dataSource, const std::string mimeTypeHint="")
void

allocateVisualContext ()
MovieBase::Obj *

getObj () const
void

init ()
void

init ()
void

initFromUrl (const Url &url)
void

initFromPath (const fs::path &filePath)
void

initFromPath (const fs::path &filePath)
void

initFromLoader (const MovieLoader &loader)
void

initFromLoader (const class MovieLoader &loader)
void

loadAsset ()
void

updateFrame ()
void

updateFrame ()
uint32_t

countFrames () const
void

processAssetTracks (AVAsset *asset)
void

createPlayerItemOutput (const AVPlayerItem *playerItem)
void

lock ()
void

unlock ()
void

removeObservers ()
void

addObservers ()
void

playerReady ()
void

playerItemEnded ()
void

playerItemCancelled ()
void

playerItemJumped ()
void

outputWasFlushed (AVPlayerItemOutput *output)
void

updateLoadState ()
void

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

getStartTimeOfFirstSample () const
void

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

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

countFrames (::Movie theMovie)

Protected Attributes

Surface8uRef

mSurface
std::shared_ptr< Obj >

mObj
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

Namespaces

Classes

Modules

Guides

Reference

MovieSurface /

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes