Standard SDL 1.2 streaming objects

---

Detailed Description

There function permit to create standard streaming objects to stream video on sdl surface using YUV overlay or simply using surface. Only for SDL 1.2 !

Functions
WVStreamingObject *	WV_getStreamOverlayObj (SDL_Surface *targetSurface, SDL_Rect *destRect)
	Get a new overlay streaming object.
void	WV_resetStreamOverlayOutput (WVStreamingObject *streamObj, SDL_Surface *targetSurface, SDL_Rect *destRect)
	Change the target sdl surface of a overlay streaming object.
void	WV_freeStreamOverlayObj (WVStreamingObject *streamObj)
	Free a overlay streaming object.
WVStreamingObject *	WV_getStreamSurfaceObj (SDL_Surface *targetSurface, SDL_Rect *destRect, int updateFlag)
	Get a new surface streaming object.
void	WV_resetStreamSurfaceOutput (WVStreamingObject *streamObj, SDL_Surface *targetSurface, SDL_Rect *destRect)
	Change the target sdl surface of a surface streaming object.
void	WV_freeStreamSurfaceObj (WVStreamingObject *streamObj)
	Free an surface streaming object.

---

Function Documentation

void WV_freeStreamOverlayObj

(

WVStreamingObject *

streamObj

)

Free a overlay streaming object.

Parameters:

streamObj

The released streaming object

Free a streaming object created with WV_getStreamOverlayObj. Be carefull that the streaming object pointer is not reset.

void WV_freeStreamSurfaceObj

(

WVStreamingObject *

streamObj

)

Free an surface streaming object.

Parameters:

streamObj

The released streaming object

Free a streaming object created with WV_getStreamSurfaceObj. Be carefull that the streaming object pointer is not reset.

WVStreamingObject* WV_getStreamOverlayObj	(	SDL_Surface *	targetSurface,
		SDL_Rect *	destRect
	)

Get a new overlay streaming object.

Parameters:

targetSurface	The sdl surface where we want to stream video data. ** Need to be the screen surface ! **
destRect	The destination rectangle. All the surface if NULL;

Create a new streaming object for the sdl screen surface. Be carefull to use it only for one video stream !

WVStreamingObject* WV_getStreamSurfaceObj	(	SDL_Surface *	targetSurface,
		SDL_Rect *	destRect,
		int	updateFlag
	)

Get a new surface streaming object.

Parameters:

targetSurface	The sdl surface where we want to stream video data. ** The surface you want ! **
destRect	The destination rectangle. All the surface if NULL;
updateFlag	Set it if you want that waave update the target surface with SDL_UpdateRect

Create a new streaming object for an sdl surface. Be carefull to use it only for one video stream !

void WV_resetStreamOverlayOutput	(	WVStreamingObject *	streamObj,
		SDL_Surface *	targetSurface,
		SDL_Rect *	destRect
	)

Change the target sdl surface of a overlay streaming object.

Parameters:

streamObj	The modified streaming object
targetSurface	The new target surface
destRect	The new destination rectangle. May be NULL.

It's possible to change the target surface of a streaming object without recreate it. This can be done at any time ! Even if the stream is playing.

void WV_resetStreamSurfaceOutput	(	WVStreamingObject *	streamObj,
		SDL_Surface *	targetSurface,
		SDL_Rect *	destRect
	)

Change the target sdl surface of a surface streaming object.

Parameters:

streamObj	The modified streaming object
targetSurface	The new target surface
destRect	The new destination rectangle. May be NULL.

It's possible to change the target surface of a streaming object without recreate it. This can be done at any time ! Even if the stream is playing.