MovieVideo

class MovieVideo

Bases: TypedWritableReferenceCount, Namable

A MovieVideo is actually any source that provides a sequence of video frames. That could include an AVI file, a digital camera, or an internet TV station.

The difference between a MovieVideo and a MovieVideoCursor is like the difference between a filename and a file handle. The MovieVideo just indicates a particular movie. The MovieVideoCursor is what allows access.

Inheritance diagram

Inheritance diagram of MovieVideo

MovieVideo(std::string const &name = "Blank Video")
MovieVideo(MovieVideo const&) = default

This constructor returns a null video stream — a stream of plain blue and white frames that last one second each. To get more interesting video, you need to construct a subclass of this class.

static PointerTo<MovieVideo> get(Filename const &name)

Obtains a MovieVideo that references a file. Just calls MovieTypeRegistry::make_video().

static TypeHandle get_class_type(void)
Filename const &get_filename(void) const

Returns the movie’s filename. A movie is not guaranteed to have a filename, if not, then this function returns an empty filename.

SubfileInfo const &get_subfile_info(void) const

If the movie is to be loaded from a subfile on disk, this returns the subfile info. Check info.is_empty() to see if this is valid data.

virtual PointerTo<MovieVideoCursor> open(void)

Open this video, returning a MovieVideoCursor of the appropriate type. Returns NULL on error.