Home    News    Components    Get ViTooKi    Documentation    Community    Developers    @sf.net  

Info

Last update:
12 Feb 2007

Documentation

Doxygen LXR

SDLRenderer Class Reference

This I/O class renders a gray-scale or RGB24/32 or YUV I420/YV12 stream the used SDL surface is created within this function, incl. CTRL-C/ESC signal/event catchers. More...

#include <SDLRenderer.hpp>

Inheritance diagram for SDLRenderer:

List of all members.

Public Member Functions
	SDLRenderer (const VideoESInfo *es, UncompressedVideoFrame::ColorSpace colorSpace=UncompressedVideoFrame::ColorSpaceI420, int width=0, int height=0, bool fullScreen=false, bool pollEvents=true, bool isLabelResizable=true, bool fixAspectRatio=true, bool allowUpscaleX=false, bool rotateXDisplay=false)
	Constructor.
virtual	~SDLRenderer ()
	Destructor.
virtual int	writeFrame (Frame *frm, ESInfo *out_es=NULL)
	Renders a frame to the destination YUV_Overlay/RGB_Surface.
virtual bool	open ()
	Creates internal frame buffers and checks whether the stream to be rendered matches the widget dimensions.
void	setESInfo (ESInfo *es)
	Not implemented.
Protected Member Functions
bool	updateDisplayRegion ()
	Update frame_info (except size) and display_region.
void	doRotateXDisplay (int orientation)
	rotate the X11 display using the XRandr extension

---

Detailed Description

This I/O class renders a gray-scale or RGB24/32 or YUV I420/YV12 stream the used SDL surface is created within this function, incl. CTRL-C/ESC signal/event catchers.

It is intended to be used as a DataSink connected to a DataChannel.

Video frames will be (down or up) scaled to fit into the given size by preserving the aspect ratio given in VideoESInfo.

The expected format of the gray-scale stream is: 1 byte per pixel.

The expected format of the RGB24 stream is: 3 bytes per pixel, in the order RGB (red, green, blue).

The expected format of the RGB32 stream is: 4 bytes per pixel, in the order BGRA (blue, green, red, alpha). This conforms to the PIX_FMT_RGBA32 format defined in ffmpeg/libavcodec/avcodec.h on little endian architectures.

Author:

Michael Kropfberger

Version:

Id

SDLRenderer.hpp,v 1.11 2006/01/20 15:37:18 mkropfbe Exp

Definition at line 80 of file SDLRenderer.hpp.

---

Constructor & Destructor Documentation

SDLRenderer::SDLRenderer (  const VideoESInfo *  es, UncompressedVideoFrame::ColorSpace  colorSpace = UncompressedVideoFrame::ColorSpaceI420, int  width = 0, int  height = 0, bool  fullScreen = false, bool  pollEvents = true, bool  isLabelResizable = true, bool  fixAspectRatio = true, bool  allowUpscaleX = false, bool  rotateXDisplay = false )

Constructor. If the parameters are invalid, the open() method will fail. Parameters: es  elementary stream information about the video stream to be rendered. colorSpace  the color space of the video stream to be rendered; must be one of: VideoFrame::::ColorSpaceGRAY8, UncompressedVideoFrame::ColorSpaceRGB24, UncompressedVideoFrame::ColorSpaceRGB32, UncompressedVideoFrame::ColorSpaceRGB565, UncompressedVideoFrame::ColorSpaceI420, UncompressedVideoFrame::ColorSpaceYV12 width  the width of the SDL window height  the height of the SDL window fullScreen  opens the SDL window in FullScreen Mode pollEvents  if true, the SDL event handler is checked for keypresses like CTRL-C or ESC, and a "SDL window close" is detected if such an event occurs, the state of the stream is set to STREAMERR beware, that this polling might grab away ALL events, so implement on on your own, if you want to support eg. joysticks or more keycodes! isLabelResizable  if true, the given width/height is assumed to be flexible, so it will be tried to keep the original video size (plus adhering #fixAspectRatio) setting this to true, width&height may be zero, only the video is used to determine the resolution fixAspectRatio  if true, video frames may be resized according to their ESInfo aspectRatio, which means upscaling in the y-dimension allowUpscaleX  if true, video frames may be upscaled in x-dimension to fit the label, which may result in significant quality loss, since a very simple upscaling algorithm is used (assumes isLabelResizable==false). rotateXDisplay  uses XRandr X11 extension to rotate the screen, play SDL video, then rotate back Definition at line 68 of file SDLRenderer.cpp. References UncompressedVideoFrame::ColorSpace. : VideoRenderer(_es, colorSpace, width, height, isLabelResizable, fixAspectRatio, allowUpscaleX) { dprintf_full("SDLRenderer Construct %s ES %p\n",this->url, this->es); strcpy(this->url,"SDLRenderer"); this->fullScreen = fullScreen; this->pollEvents = pollEvents; this->rotateXDisplay = rotateXDisplay; overlay=NULL; surface=NULL; video_info=NULL; }

---

Member Function Documentation

void SDLRenderer::doRotateXDisplay (  int  orientation  )  [protected]

rotate the X11 display using the XRandr extension Parameters: orientation  0 for normal, 1 for 90 degrees Definition at line 120 of file SDLRenderer.cpp. Referenced by open(), and ~SDLRenderer(). { #ifdef BUILD_ARCH_ARM #ifdef ENABLE_X11 int status; char *hostname = new char[MAX_STR_LEN]; char *envhost = getenv("DISPLAY"); if (!envhost) strcpy(hostname,"localhost:0"); else strcpy(hostname,envhost); Display *display = XOpenDisplay(hostname); assert(display); XRRScreenConfiguration *sc; sc = XRRGetScreenInfo (display, DefaultRootWindow(display)); status = XRRSetScreenConfigAndRate(display,sc,DefaultRootWindow (display),0,1 << orientation,0,0); dprintf_full("SDLRenderer::open rotating X11 screen, status: %i\n",status); XRRFreeScreenConfigInfo(sc); delete [] hostname; #endif #endif }

bool SDLRenderer::open (   )  [virtual]

Creates internal frame buffers and checks whether the stream to be rendered matches the widget dimensions. Returns: true on success, false on error. See also: IO::open() Reimplemented from VideoRenderer. Definition at line 149 of file SDLRenderer.cpp. References doRotateXDisplay(), UncompressedVideoFrame::mapColorSpaceToBitDepth(), and updateDisplayRegion(). { if (state == OPEN) { dprintf_full("SDLRenderer::open state was already OPEN, ignoring opening request.\n"); return true; } if (state != CLOSED) { dprintf_err("SDLRenderer::open state was not CLOSED but state=%i!\n",state); return false; } if (!updateDisplayRegion()) { state = STREAMERR; return false; } char *buf = new char[MAX_STR_LEN]; //on iPAQ, dont forget: export DISPLAY=:0 //if without X11, maybe this helps: export SDL_NOMOUSE=1 if (SDL_Init(SDL_INIT_VIDEO) < 0 || !SDL_VideoDriverName(buf, 1)) { dprintf_err("Could not init SDL video: %s\r\n", SDL_GetError()); delete [] buf; ::exit(-1); } atexit(SDL_Quit); video_info = SDL_GetVideoInfo(); uint flags = SDL_SWSURFACE; if (fullScreen) flags |= SDL_FULLSCREEN; #ifndef WINCE surface = SDL_SetVideoMode(out_label_info.width, out_label_info.height, 0, flags); #else #ifndef DISABLE_CE_RESIZE int myWidth = GetSystemMetrics(SM_CXSCREEN); int myHeight = GetSystemMetrics(SM_CYSCREEN); #else int myWidth = out_label_info.width; int myHeight = out_label_info.height; #endif surface = SDL_SetVideoMode(myWidth, myHeight, 0, flags); #endif if (surface == NULL) { dprintf_err("Couldn't initialize window with dimension %ix%i: %s\n", out_label_info.width, out_label_info.height, SDL_GetError()); delete [] buf; ::exit(1); } if (rotateXDisplay) doRotateXDisplay(1); SDL_ShowCursor(SDL_DISABLE); if ( (surface->format->BitsPerPixel == UncompressedVideoFrame::mapColorSpaceToBitDepth(colorSpace) ) && (out_label_info.width == frame_info.width) && (out_label_info.height == frame_info.height) && (display_region.left == 0) && (display_region.top == 0) ) directBitBlt=true; //optimize via rgbSurface bitBlitting else directBitBlt=false; //use slow pixel-per-pixel painting and scaling dprintf_full("SDLRenderer::open() set SDL video mode to (%dx%d - %dx%d) bpp %i, using %s.\n", out_label_info.left, out_label_info.width, out_label_info.top, out_label_info.height, surface->format->BitsPerPixel, directBitBlt?"fastBitBlit":"slow pixel painting"); //set 8, 16 or both 24/32 to 24 setOutputDepth(surface->format->BitsPerPixel>=24?24:surface->format->BitsPerPixel); SDL_WM_SetCaption("ViTooKi SDLRenderer", ""); if (overlay) SDL_FreeYUVOverlay(overlay); overlay=NULL; /* initialize frameBuffer */ if (frameBuffer) { delete frameBuffer; frameBuffer = NULL; } bool gray=false; switch (colorSpace) { case UncompressedVideoFrame::ColorSpaceGRAY8: dprintf_full("SDLRenderer::open() ColorSpaceGRAY8\n"); frame_info.size = frame_info.width * frame_info.height; gray=true; break; case UncompressedVideoFrame::ColorSpaceRGB565: dprintf_full("SDLRenderer::open() ColorSpaceRGB565 with 16bit depth\n"); frame_info.size = frame_info.width * frame_info.height * 2; break; case UncompressedVideoFrame::ColorSpaceRGB24: dprintf_full("SDLRenderer::open() ColorSpaceRGB24\n"); frame_info.size = frame_info.width * frame_info.height * 3; break; case UncompressedVideoFrame::ColorSpaceRGB32: dprintf_full("SDLRenderer::open() ColorSpaceRGB32\n"); frame_info.size = frame_info.width * frame_info.height * 4; break; case UncompressedVideoFrame::ColorSpaceYV12: dprintf_full("SDLRenderer::open() ColorSpaceYV12\n"); //overlay is scalable, so frame_info is used, and then up/down-scaled by hardware with SDL_YV12 overlay = SDL_CreateYUVOverlay(frame_info.width, frame_info.height, SDL_YV12_OVERLAY, surface); frame_info.ySize = frame_info.width * frame_info.height; frame_info.uvSize = frame_info.width * frame_info.height / 4; frame_info.size = frame_info.ySize + 2 * frame_info.uvSize; dstrect.x = out_label_info.left; dstrect.y = out_label_info.top; dstrect.w = out_label_info.width; dstrect.h = out_label_info.height; break; case UncompressedVideoFrame::ColorSpaceI420: dprintf_full("SDLRenderer::open() ColorSpaceI420\n"); //overlay is scalable, so frame_info is used, and then up/down-scaled by hardware with SDL_IYUV overlay = SDL_CreateYUVOverlay(frame_info.width, frame_info.height, SDL_IYUV_OVERLAY, surface); frame_info.ySize = frame_info.width * frame_info.height; frame_info.uvSize = frame_info.width * frame_info.height / 4; frame_info.size = frame_info.ySize + 2 * frame_info.uvSize; dstrect.x = out_label_info.left; dstrect.y = out_label_info.top; dstrect.w = out_label_info.width; dstrect.h = out_label_info.height; break; default: dprintf_err("SDLRenderer::open(): invalid color space: %d\n", colorSpace); state = STREAMERR; delete [] buf; return false; } #ifdef WINCE #ifndef DISABLE_CE_RESIZE dstrect.w = GetSystemMetrics(SM_CXSCREEN); dstrect.h = GetSystemMetrics(SM_CYSCREEN); #else dstrect.w = out_label_info.width; dstrect.h = out_label_info.height; #endif #endif if (!overlay) frameBuffer = new SDLFrameBuffer(surface, UncompressedVideoFrame::mapColorSpaceToBitDepth(colorSpace), gray, out_label_info.width, out_label_info.height ); if (!frameBuffer && !overlay) { dprintf_err("SDLRenderer::open(): SDLFrameBuffer creation FAILED! (w = %d, h = %d)\n", out_label_info.width, out_label_info.height ); state = STREAMERR; delete [] buf; return false; } state = OPEN; framesSeen = 0; currentFrameNumber = 0; dprintf_small("SDLRenderer::open() (state=%i): initialized frame and display regions:\n" " frame: width = %d, height = %d, size = %d, scaleX = %5.3f, scaleY = %5.3f\n" " display: x(%d:%d), y(%d:%d), width = %d, height = %d\n", state, frame_info.width, frame_info.height, frame_info.size, FIXED2DOUBLE(frame_info.scaleX), FIXED2DOUBLE(frame_info.scaleY), display_region.left, display_region.right, display_region.top, display_region.bottom, display_region.width, display_region.height); delete [] buf; return true; }

bool SDLRenderer::updateDisplayRegion (   )  [protected]

Update frame_info (except size) and display_region. This function is not thread-safe, and is internally called by the open() method. Reimplemented from VideoRenderer. Definition at line 108 of file SDLRenderer.cpp. References VideoRenderer::updateDisplayRegion(). Referenced by open(). { if (!es || !es->isVisualStream()) { dprintf_err("SDLRenderer::updateDisplayRegion(): invalid members: es = %p\n",es); ::exit(1); return false; } return VideoRenderer::updateDisplayRegion(); }

int SDLRenderer::writeFrame (  Frame *  frm, ESInfo *  out_es = NULL )  [virtual]

Renders a frame to the destination YUV_Overlay/RGB_Surface. Returns: 1 on success, 0 on error. Reimplemented from VideoRenderer. Definition at line 315 of file SDLRenderer.cpp. References Frame::getAU(), and VideoRenderer::writeFrame(). { if (pollEvents && SDL_PollEvent( &event )) { SDL_KeyboardEvent *key = &event.key; char *buf = SDL_GetKeyName( key->keysym.sym ); char c; if (buf[1]=='\0') //only single character (a-zA-Z...) c = toupper(buf[0]); switch( event.type ) { case SDL_KEYUP: PrintKeyInfo( &event.key ); if ( ((key->keysym.mod & KMOD_CTRL) && (c == 'C')) || (strstr(buf, "escape") != NULL)) { dprintf_err("SDLRenderer::writeFrame STREAMERR because of CTRL-C/ESC!\n"); state = STREAMERR; //kill(0,SIGQUIT); //kill the app incl. other eg. audio stream return 0; } break; case SDL_KEYDOWN: PrintKeyInfo( &event.key ); break; /* SDL_QUIT event (window close) */ case SDL_MOUSEBUTTONDOWN: case SDL_QUIT: dprintf_err("SDLRenderer::writeFrame STREAMERR because of window close!\n"); state = STREAMERR; return 0; break; default: break; } } //SDL-YUV will not need a frameBuffer so don't supercall! if ((colorSpace == UncompressedVideoFrame::ColorSpaceI420) || (colorSpace == UncompressedVideoFrame::ColorSpaceYV12)) { if (state != OPEN) return 1; framesSeen++; /* we don't set currentFrameNumber, as we have no way to determine it! */ #ifndef WINCE if (SDL_MUSTLOCK(surface)) { if (SDL_LockSurface(surface) < 0) { ::exit(2); } } if(SDL_LockYUVOverlay(overlay) !=0) { return -1; } #endif #ifndef WINCE memcpy(overlay->pixels[0], frm->getAU()->payload, frame_info.ySize); // Y part if (colorSpace == UncompressedVideoFrame::ColorSpaceI420) { memcpy(overlay->pixels[1], frm->getAU()->payload + frame_info.ySize, frame_info.uvSize); // U part memcpy(overlay->pixels[2], frm->getAU()->payload + frame_info.ySize + frame_info.uvSize, frame_info.uvSize); // V Part } else { // YV12, so exchange U and V memcpy(overlay->pixels[2], frm->getAU()->payload + frame_info.ySize, frame_info.uvSize); // U part memcpy(overlay->pixels[1], frm->getAU()->payload + frame_info.ySize + frame_info.uvSize, frame_info.uvSize); // V Part } #else int i,j,k; int edgedWidth = (frame_info.width + 15) / 16; int pitch = 16 * edgedWidth + 2 * EDGE_SIZE; u8 *y = frm->getAU()->y; u8 *u = frm->getAU()->u; u8 *v = frm->getAU()->v; u8 *pixels1 = overlay->pixels[0]; u8 *pixels2 = overlay->pixels[1]; u8 *pixels3 = overlay->pixels[2]; int halfWidth = frame_info.width >> 1; int halfHeight = frame_info.height >> 1; int halfPitch = pitch >> 1; for (i=0; i < frame_info.height; i++) { memcpy(pixels1, y, frame_info.width); if ( i < halfHeight) { memcpy(pixels2, u, halfWidth); memcpy(pixels3, v, halfWidth); u += halfPitch; v += halfPitch; pixels2 += halfWidth; pixels3 += halfWidth; } y += pitch; pixels1 += frame_info.width; } #endif SDL_DisplayYUVOverlay(overlay, &dstrect); dprintf_full("SDLRenderer::writeFrame -> Displaying YUV Frame (%i bytes) to x:%i y:%i -- w:%i h:%i\n", frm->getAU()->size,dstrect.x,dstrect.y,dstrect.w,dstrect.h); #ifndef WINCE SDL_UnlockYUVOverlay(overlay); if (SDL_MUSTLOCK(surface)) { SDL_UnlockSurface(surface); } #endif #ifdef _POSIX_PRIORITY_SCHEDULING sched_yield(); //this is necessary to give parallel getFrames a chance #endif return 1; } else //RGB scale/write+yield is done in superClass return VideoRenderer::writeFrame(frm); }

---

The documentation for this class was generated from the following files:

• SDLRenderer.hpp
• SDLRenderer.cpp

© ViTooKi 2003 :: [Lite version] Created with Doxygen