codeanticode.gsvideo
Class GSPlayer

java.lang.Object
  processing.core.PImage
      codeanticode.gsvideo.GSPlayer

All Implemented Interfaces:

java.lang.Cloneable, processing.core.PConstants

public class GSPlayer
extends processing.core.PImage
implements processing.core.PConstants

This class makes it possible to load and play generic media content through playbin (not only movies, but also audio files, etc).

Field Summary

byte[]	data
java.lang.String	dataCaps

Fields inherited from class processing.core.PImage

format, height, parent, pixels, width

Fields inherited from interface processing.core.PConstants

A, AB, ADD, AG, ALPHA, ALPHA_MASK, ALT, AMBIENT, AR, ARC, ARGB, ARROW, B, BACKSPACE, BASELINE, BEEN_LIT, BEVEL, BLEND, BLUE_MASK, BLUR, BOTTOM, BOX, BURN, CENTER, CENTER_DIAMETER, CENTER_RADIUS, CHATTER, CLOSE, CMYK, CODED, COMPLAINT, CONTROL, CORNER, CORNERS, CROSS, CUSTOM, DA, DARKEST, DB, DEG_TO_RAD, DELETE, DG, DIAMETER, DIFFERENCE, DILATE, DIRECTIONAL, DISABLE_ACCURATE_TEXTURES, DISABLE_DEPTH_SORT, DISABLE_DEPTH_TEST, DISABLE_OPENGL_2X_SMOOTH, DISABLE_OPENGL_ERROR_REPORT, DODGE, DOWN, DR, DXF, EB, EDGE, EG, ELLIPSE, ENABLE_ACCURATE_TEXTURES, ENABLE_DEPTH_SORT, ENABLE_DEPTH_TEST, ENABLE_NATIVE_FONTS, ENABLE_OPENGL_2X_SMOOTH, ENABLE_OPENGL_4X_SMOOTH, ENABLE_OPENGL_ERROR_REPORT, ENTER, EPSILON, ER, ERODE, ERROR_BACKGROUND_IMAGE_FORMAT, ERROR_BACKGROUND_IMAGE_SIZE, ERROR_PUSHMATRIX_OVERFLOW, ERROR_PUSHMATRIX_UNDERFLOW, ERROR_TEXTFONT_NULL_PFONT, ESC, EXCLUSION, G, GIF, GRAY, GREEN_MASK, HALF_PI, HAND, HARD_LIGHT, HINT_COUNT, HSB, IMAGE, INVERT, JAVA2D, JPEG, LEFT, LIGHTEST, LINE, LINES, LINUX, MACOSX, MAX_FLOAT, MAX_INT, MIN_FLOAT, MIN_INT, MITER, MODEL, MOVE, MULTIPLY, NORMAL, NORMALIZED, NX, NY, NZ, OPAQUE, OPEN, OPENGL, ORTHOGRAPHIC, OTHER, OVERLAY, P2D, P3D, PATH, PDF, PERSPECTIVE, PI, platformNames, POINT, POINTS, POLYGON, POSTERIZE, PROBLEM, PROJECT, QUAD, QUAD_STRIP, QUADS, QUARTER_PI, R, RAD_TO_DEG, RADIUS, RECT, RED_MASK, REPLACE, RETURN, RGB, RIGHT, ROUND, SA, SB, SCREEN, SG, SHAPE, SHIFT, SHINE, SOFT_LIGHT, SPB, SPG, SPHERE, SPOT, SPR, SQUARE, SR, SUBTRACT, SW, TAB, TARGA, TEXT, THIRD_PI, THRESHOLD, TIFF, TOP, TRIANGLE, TRIANGLE_FAN, TRIANGLE_STRIP, TRIANGLES, TWO_PI, TX, TY, TZ, U, UP, V, VERTEX_FIELD_COUNT, VW, VX, VY, VZ, WAIT, WHITESPACE, WINDOWS, X, Y, Z

Constructor Summary

GSPlayer(processing.core.PApplet parent, java.lang.String filename)
Creates an instance of GSPlayer loading the media file from filename and with fps = 30, assuming that it is a video file .

GSPlayer(processing.core.PApplet parent, java.lang.String filename, int type)
Creates an instance of GSPlayer loading the media file from filename and with fps = 30,

GSPlayer(processing.core.PApplet parent, java.lang.String filename, int ifps, int type)
Creates an instance of GSPlayer loading the stream from filename and with fps = ifps.

Method Summary

boolean	available() Return the true or false depending on whether there is a new frame ready to be read.
void	delete() Releases the gstreamer resources associated to this player object.
void	dispose() Same as delete.
float	duration() Get the full length of the current stream (in seconds).
int	frame() Return the current frame.
void	frameRate(int ifps) Set how often new frames are to be read from the stream.
java.lang.String	getFilename() Returns the text string containing the filename of the media loaded.
float	getSourceFrameRate() Get the original framerate of the source video.
int	getSourceHeight() Get the height of the source video.
int	getSourceWidth() Get the width of the source video.
void	goToBeginning() Goes to the first frame of the stream.
boolean	isLooping() Returns whether the media is looping or not.
boolean	isPaused() Returns whether the media is paused or not.
boolean	isPlaying() Returns whether the media is playing or not.
void	jump(float where) Jump to a specific location (in seconds).
void	jump(int frame) Jump to a specific frame.
long	length() Get the full length of this movie (in frames).
void	loop() Begin playing the stream, with repeat.
void	noLoop() Shut off the repeating loop.
void	pause() Pause the stream at its current time.
void	play() Begin playing the stream, with no repeat.
void	read() Reads the current video frame or data buffer.
void	setEventHandlerObject(java.lang.Object obj) Uses a generic object as handler of the media file.
void	speed(float irate) Set a multiplier for how fast/slow the movie should be run.
void	stop() Stop the stream, and rewind.
float	time() Return the current time in seconds.
void	volume(float v) Change the volume.

Methods inherited from class processing.core.PImage

blend, blend, blendColor, clone, copy, copy, filter, filter, get, get, get, getCache, getImage, init, isModified, loadPixels, mask, mask, removeCache, resize, save, set, set, setCache, setModified, setModified, updatePixels, updatePixels

Methods inherited from class java.lang.Object

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

Field Detail

data

public byte[] data

dataCaps

public java.lang.String dataCaps

Constructor Detail

GSPlayer

public GSPlayer(processing.core.PApplet parent,
                java.lang.String filename)

Creates an instance of GSPlayer loading the media file from filename and with fps = 30, assuming that it is a video file .

Parameters:

parent - PApplet

filename - String

GSPlayer

public GSPlayer(processing.core.PApplet parent,
                java.lang.String filename,
                int type)

Creates an instance of GSPlayer loading the media file from filename and with fps = 30,

Parameters:

parent - PApplet

filename - String

type - int

GSPlayer

public GSPlayer(processing.core.PApplet parent,
                java.lang.String filename,
                int ifps,
                int type)

Creates an instance of GSPlayer loading the stream from filename and with fps = ifps.

Parameters:

parent - PApplet

filename - String

ifps - int

type - int

Method Detail

delete

public void delete()

Releases the gstreamer resources associated to this player object. It shouldn't be used after this.

dispose

public void dispose()

Same as delete.

setEventHandlerObject

public void setEventHandlerObject(java.lang.Object obj)

Uses a generic object as handler of the media file. This object should have a movieEvent method that receives a GSMovie argument. This method will be called upon a new frame read event.

getSourceWidth

public int getSourceWidth()

Get the width of the source video.

Returns:

int

getSourceHeight

public int getSourceHeight()

Get the height of the source video.

Returns:

int

getSourceFrameRate

public float getSourceFrameRate()

Get the original framerate of the source video.

Returns:

float

frameRate

public void frameRate(int ifps)

Set how often new frames are to be read from the stream. Does not actually set the speed of the playback, that's handled by the speed() method.

Parameters:

int - ifps

See Also:

speed

speed

public void speed(float irate)

Set a multiplier for how fast/slow the movie should be run. The default is 1.0. speed(2) will play the movie at double speed (2x). speed(0.5) will play at half speed. speed(-1) will play backwards at regular speed.

Parameters:

float - irate

duration

public float duration()

Get the full length of the current stream (in seconds).

Returns:

float

time

public float time()

Return the current time in seconds.

Returns:

float

length

public long length()

Get the full length of this movie (in frames).

Returns:

float

frame

public int frame()

Return the current frame.

Returns:

int

jump

public void jump(float where)

Jump to a specific location (in seconds). The number is a float so fractions of seconds can be used.

Parameters:

float - where

jump

public void jump(int frame)

Jump to a specific frame.

Parameters:

frame - int

available

public boolean available()

Return the true or false depending on whether there is a new frame ready to be read.

Returns:

boolean

isPlaying

public boolean isPlaying()

Returns whether the media is playing or not.

Returns:

boolean

isPaused

public boolean isPaused()

Returns whether the media is paused or not. If isPlaying() and isPaused() both return false it means that the media is stopped.

Returns:

boolean

isLooping

public boolean isLooping()

Returns whether the media is looping or not.

Returns:

boolean

play

public void play()

Begin playing the stream, with no repeat.

loop

public void loop()

Begin playing the stream, with repeat.

noLoop

public void noLoop()

Shut off the repeating loop.

pause

public void pause()

Pause the stream at its current time.

stop

public void stop()

Stop the stream, and rewind.

read

public void read()

Reads the current video frame or data buffer.

goToBeginning

public void goToBeginning()

Goes to the first frame of the stream.

volume

public void volume(float v)

Change the volume. Values are from 0 to 1.

Parameters:

float - v

getFilename

public java.lang.String getFilename()

Returns the text string containing the filename of the media loaded.

Returns:

String