MovieTexture

class MovieTexture

Bases: Texture

A texture that fetches video frames from an underlying object of class Movie.

Inheritance diagram

explicit MovieTexture(std::string const &name)

explicit MovieTexture(MovieVideo *video)

Creates a blank movie texture. Movies must be added using do_read_one or do_load_one.

Creates a texture playing the specified movie.

MovieVideoCursor *get_alpha_cursor(int page)

Returns the MovieVideoCursor that is feeding the alpha channel for the indicated page, where 0 <= page < get_num_pages().

static TypeHandle get_class_type(void)

MovieVideoCursor *get_color_cursor(int page)

Returns the MovieVideoCursor that is feeding the color channels for the indicated page, where 0 <= page < get_num_pages().

bool get_loop(void) const

Returns true if the movie’s loop count is not equal to one.

int get_loop_count(void) const

Returns the movie’s loop count.

double get_play_rate(void) const

Gets the movie’s play-rate.

double get_time(void) const

Returns the current value of the movie’s cursor. If the movie’s loop count is greater than one, then its length is effectively multiplied for the purposes of this function. In other words, the return value will be in the range 0.0 to (length * loopcount).

int get_video_height(void) const

Returns the height in texels of the source video stream. This is not necessarily the height of the actual texture, since the texture may have been expanded to raise it to a power of 2.

double get_video_length(void) const

Returns the length of the video.

int get_video_width(void) const

Returns the width in texels of the source video stream. This is not necessarily the width of the actual texture, since the texture may have been expanded to raise it to a power of 2.

bool is_playing(void) const

Returns true if the movie’s cursor is advancing.

void play(void)

Plays the movie from the beginning.

void restart(void)

Start playing the movie from where it was last paused. Has no effect if the movie is not paused, or if the movie’s cursor is already at the end.

void set_loop(bool enable)

If true, sets the movie’s loop count to 1 billion. If false, sets the movie’s loop count to one.

void set_loop_count(int count)

Sets the movie’s loop count to the desired value.

void set_play_rate(double play_rate)

Sets the movie’s play-rate. This is the speed at which the movie’s cursor advances. The default is to advance 1.0 movie-seconds per real-time second.

void set_time(double t)

Sets the movie’s cursor.

void stop(void)

Stops a currently playing or looping movie right where it is. The movie’s cursor remains frozen at the point where it was stopped.

void synchronize_to(AudioSound *sound)

Synchronize this texture to a sound. Typically, you would load the texture and the sound from the same AVI file.

void unsynchronize(void)

Stop synchronizing with a sound.