rnr::CameraGst Class Reference

GStreamer implementation of the camera class. The video is streamed via a Gstreamer/GTK callback mechanism. More...

#include <CameraGst.h>

Inheritance diagram for rnr::CameraGst:

Public Member Functions
	CameraGst (const std::string &strVideoDevName="/dev/video0", const CamRes &resVideo=CamResQVGA, const CamRes &resImage=CamResVGA)
virtual	~CameraGst ()
	Destructor.
virtual int	startVideo (const CamRes &resVideo=CamResDft)
	Start the camera streaming video. More...
virtual int	stopVideo ()
	Stop the camera from streaming video. More...
virtual int	grabFrame (cv::Mat &frame)
	Grab a image frame from the video stream. More...
virtual int	clickImage (cv::Mat &img, const CamRes &resImage=CamResDft)
	Take a still image. More...
virtual void	autoFocus ()
	Auto-focus camera.
void	setXid (gulong uXid)
	Set X identifier associated with widget receiving streaming video. More...
void	setTextOverlay (const char *sText)
	Overlay text on video stream. More...
void	clearTextOverlay ()
	Clear text overlay on video stream.
Public Member Functions inherited from rnr::Camera
	Camera (const std::string &strVideoDevName=VideoDevDft, const CamRes &resVideo=CamResQVGA, const CamRes &resImage=CamResVGA)
virtual	~Camera ()
	Destructor. More...
bool	isCameraRunning () const
	Test if the camera is on and running. More...
bool	isTakingAnImage () const
	Test if a still image is currently being taken. More...
bool	isFatal () const
	Test if camera object is in a fatal condition. More...
CamRes	getVideoResolution () const
	Get the current video resolution. More...
CamRes	getImageResolution () const
	Get the current still image resolution. More...

Protected Member Functions
virtual CamRes	setCameraResolution (const CamRes &res)
	Set the camera resolution in either video or still image mode. More...
void	startPipeline ()
	Start the camera and the pipeline.
void	stopPipeline ()
	Stop the camera and the pipeline.
int	makePipeline ()
	Make gstreamer video pipeline.
int	makeCameraSrcBin ()
	Video source bin. More...
int	makeVideoSinkBin ()
	Video sink bin. More...
int	makeImageSinkBin ()
	Image sink bin. More...
void	makeTmpFile ()
	Make unique temporary file.

Static Protected Member Functions
static GstBusSyncReply	gstBusSyncHandler (GstBus *bus, GstMessage *message, gpointer user_data)
static void	gstBusMsgCb (GstBus *bus, GstMessage *message, gpointer user_data)
	Gstream pipeline synchronous bus handler. More...
static void	clickCb (GstElement *element, GstBuffer *buffer, GstPad *pad, void *user_data)
	Still image capture asynchronouse callback. More...

Protected Attributes
GstElement *	m_pPipeline
	camera pipeline
GstElement *	m_pBinCameraSrc
	camera source bin
GstElement *	m_pElemCamFilter
	camera properties element
GstElement *	m_pBinVideoSink
	video sink bin
GstElement *	m_pElemVidText
	video text overlay
GstElement *	m_pElemVidSink
	video sink
GstElement *	m_pBinImageSink
	still image sink bin
GstElement *	m_pElemImgSink
	still image sink
int	m_nSignalId
	camera still image callback signal
gulong	m_uVidWinXid
	overlay window X-windows id
char	m_bufTmpName [PATH_MAX]
	temporary file name buffer
Protected Attributes inherited from rnr::Camera
std::string	m_strVideoDevName
	video device name
int	m_nVideoIndex
	video index
CamRes	m_resCurrent
	current camera resolution
CamRes	m_resVideo
	current video resolution
CamRes	m_resImage
	current still image resolution
bool	m_bCameraRunning
	camera is [not] on and running video
bool	m_bTakingImage
	taking an image is [not] finished
bool	m_bFatal
	camera instance is in a fatal state

Additional Inherited Members
Static Public Member Functions inherited from rnr::Camera
static bool	isEqResolution (const CamRes &res1, const CamRes &res2)
	Check is two camera resolutions are equal. More...
static int	getVideoIndex (const std::string &strVideoDevName)
	Get the video index associated with the device. More...

Detailed Description

GStreamer implementation of the camera class. The video is streamed via a Gstreamer/GTK callback mechanism.

Definition at line 84 of file CameraGst.h.

Member Function Documentation

void CameraGst::clickCb ( GstElement *  element, GstBuffer *  buffer, GstPad *  pad, void *  user_data  )

staticprotected

Still image capture asynchronouse callback.

This function is called when an image buffer from the camera has been retrieved.

Parameters

element	GStreamer element.
buffer	Image buffer.
pad	GStreamer pad.
user_data	User data (this)

Definition at line 269 of file CameraGst.cxx.

References rnr::CamRes::height, m_bufTmpName, m_nSignalId, m_pElemImgSink, rnr::Camera::m_resImage, and rnr::CamRes::width.

{
  CameraGst *pCam = (CameraGst *)user_data;

  GstCaps            *caps;
  const GstStructure *structure;
  int                 width, height, stride;
  GdkPixbuf          *pixbuf;
  const int           bits_per_pixel = 8;
  guchar             *data;

  caps      = gst_buffer_get_caps(buffer);
  structure = gst_caps_get_structure(caps, 0);

  gst_structure_get_int(structure, "width", &width);
  gst_structure_get_int(structure, "height", &height);

  stride = buffer->size / height;

  //
  // Only copy the data if we're giving away a pixbuf, not if we're throwing
  // everything away straight away
  // 
  if (pCam->m_bufTmpName[0] != 0 )
  {
    data = NULL;
  }
  else
  {
    data = (guchar *)g_memdup(GST_BUFFER_DATA(buffer), buffer->size);
  }

  pixbuf = gdk_pixbuf_new_from_data(data? data: GST_BUFFER_DATA(buffer),
                          GDK_COLORSPACE_RGB,
                          FALSE, bits_per_pixel, width, height, stride,
                          data? (GdkPixbufDestroyNotify)g_free: NULL, NULL);

  g_signal_handler_disconnect(G_OBJECT(pCam->m_pElemImgSink),
                              pCam->m_nSignalId);

  if (pCam->m_bufTmpName[0] != 0 )
  {
    gdk_pixbuf_save(pixbuf, pCam->m_bufTmpName, "jpeg", NULL, NULL);
    g_object_unref(G_OBJECT(pixbuf));
  }

  pCam->m_resImage.width  = width;
  pCam->m_resImage.height = height;

  pCam->m_nSignalId = 0;
}

int CameraGst::clickImage ( cv::Mat &  img, const CamRes &  resImage = CamResDft  )

virtual

Take a still image.

Parameters

[in,out]	img	Snap shot image taken.
	resImage	Still image resolution. If equal to CamResDft, then the initial/last image resolution setting is used.

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Reimplemented from rnr::Camera.

Definition at line 172 of file CameraGst.cxx.

References rnr::CamResDft, rnr::Camera::isCameraRunning(), rnr::Camera::isEqResolution(), rnr::Camera::m_bTakingImage, rnr::Camera::m_resCurrent, rnr::Camera::m_resImage, rnr::Camera::m_resVideo, rnr::CameraCv::setCameraResolution(), rnr::CameraCv::startVideo(), and rnr::CameraCv::stopVideo().

{  
  CamRes  resVideoPrev    = m_resVideo;
  bool    bCamWasRunning  = isCameraRunning();
  CamRes  res             = resImage;
  uint_t  usecSleep       = 10000;      // 10 milliseconds
  uint_t  usecMax         = 10000000;   // 10 seconds
  uint_t  usec;
  int     rc;

  if( m_bTakingImage || (m_nSignalId != 0) )
  {
    LOGDIAG3("Image capture already in progress.");
    return RC_ERROR;
  }

  m_bTakingImage = true;

  // default is the current image resolution
  if( isEqResolution(res, CamResDft) )
  {
    res = m_resImage;
  }

  // new resolution
  if( !isEqResolution(res, m_resCurrent) )
  {
    stopPipeline();
    setCameraResolution(res);
  }

  // start camera
  if( !isCameraRunning() )
  {
    startPipeline();
  }

  m_resImage = res;

  // take the photo by connecting the handoff signal
  m_nSignalId = g_signal_connect(G_OBJECT(m_pElemImgSink),
                                  "handoff",
                                  G_CALLBACK(clickCb),
                                  this);

  //
  // Block wait with timeout
  //
  for(usec = 0; (usec < usecMax) && (m_nSignalId != 0); usec += usecSleep)
  {
    gtk_main_iteration_do(FALSE);
    
    if( m_nSignalId != 0 )
    {
      usleep(usecSleep);
    }
  }
  
  // timed out
  if( m_nSignalId != 0 )
  {
    // g_signal_handler_disconnect(G_OBJECT(m_pElemImgSink), m_nSignalId);
    m_nSignalId = 0;
    LOGERROR("Timedout taking still image.");
    rc = RC_ERROR;
  }

  // got an image
  else
  {
    img = imread(m_bufTmpName, CV_LOAD_IMAGE_COLOR);
    LOGDIAG3("Took a %dx%d still image.", img.cols, img.rows);
    rc = OK;
  }

  // video was running
  if( bCamWasRunning )
  {
    // restart at different resolution
    if( !isEqResolution(m_resVideo, m_resCurrent) )
    {
      startVideo(m_resVideo);
    }
    // else live running at current resolution
  }

  // video only started to take image - stop
  else
  {
    stopVideo();
  }

  m_bTakingImage = false;

  return rc;
}

int CameraGst::grabFrame ( cv::Mat &  frame )

virtual

Grab a image frame from the video stream.

Parameters

[in,out]

The

image frame matrix. May be resized.

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Reimplemented from rnr::Camera.

Definition at line 157 of file CameraGst.cxx.

References rnr::CameraCv::clickImage(), rnr::Camera::isCameraRunning(), and rnr::Camera::m_resVideo.

{
  if( !isCameraRunning() )
  {
    LOGERROR("No video capture pipeline started.");
    return RC_ERROR;
  }

  // grab a frame 
  else 
  {
    return clickImage(frame, m_resVideo);
  }
}

void CameraGst::gstBusMsgCb ( GstBus *  bus, GstMessage *  message, gpointer  user_data  )

staticprotected

Gstream pipeline synchronous bus handler.

Parameters

bus	GStream bus.
message	Bus message.
user_data	User data.

Returns

Returns GST_BUS_PASS if message not relevant for the stream.
Returns GST_BUS_DROP otherwise.

Definition at line 886 of file CameraGst.cxx.

References m_uVidWinXid.

{
  CameraGst *pCam = (CameraGst *)user_data;

  switch( GST_MESSAGE_TYPE(message) )
  {
    case GST_MESSAGE_EOS:
      LOGDIAG3("GST: End of stream.");
      break;

    case GST_MESSAGE_ERROR:
      {
        gchar  *debug;
        GError *error;

        gst_message_parse_error(message, &error, &debug);
        g_free(debug);
        LOGERROR("GST: %s.", error->message);
        g_error_free(error);
      }
      break;

    default:
      //fprintf(stderr, "DBG: GST: busmsg=%u\n", GST_MESSAGE_TYPE(message));
      break;
  }
}

int CameraGst::makeCameraSrcBin ( )

protected

Video source bin.

*           |---------------------------------|
* camera - [] v4l2src - capsfilter - identity [] -
*           |---------------------------------|
* 

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Definition at line 463 of file CameraGst.cxx.

References rnr::CamRes::height, rnr::Camera::m_bFatal, rnr::Camera::m_resVideo, rnr::Camera::m_strVideoDevName, and rnr::CamRes::width.

{
  const char *sFactoryName;
  GstElement *pElemCamSrc;
  GstElement *pElemCamIdentity;
  GstCaps    *caps;
  GstPad     *pad;
  gboolean    ok;

  m_pBinCameraSrc = gst_bin_new("camera_bin");

  if( m_pBinCameraSrc == NULL )
  {
    LOGERROR("Failed to create new gstreamer camera bin.");
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Source element
  //
  sFactoryName = "v4l2src";
  pElemCamSrc = gst_element_factory_make(sFactoryName, "cam_src"); 

  if( pElemCamSrc == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  g_object_set(G_OBJECT(pElemCamSrc),
      "device", m_strVideoDevName.c_str(),
      NULL);

  //
  // Filter Element
  //
  sFactoryName = "capsfilter";
  m_pElemCamFilter = gst_element_factory_make(sFactoryName, "cam_caps");

  if( m_pElemCamFilter == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  caps = gst_caps_new_simple("video/x-raw-yuv",
                              "width",  G_TYPE_INT, m_resVideo.width,
                              "height", G_TYPE_INT, m_resVideo.height,
                              NULL);

  g_object_set(G_OBJECT(m_pElemCamFilter), "caps", caps, NULL);
  gst_caps_unref(caps);

  m_resVideo = m_resVideo;

  //
  // Identity element
  //
  sFactoryName = "identity";
  pElemCamIdentity = gst_element_factory_make(sFactoryName, "cam_identity"); 

  if( pElemCamIdentity == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  gst_bin_add_many(GST_BIN(m_pBinCameraSrc),
                    pElemCamSrc,
                    m_pElemCamFilter,
                    pElemCamIdentity,
                    NULL);

  ok = gst_element_link_many(
                    pElemCamSrc,
                    m_pElemCamFilter,
                    pElemCamIdentity,
                    NULL);

  if( !ok )
  {
    LOGERROR("Failed to link camera gstreamer elements.");
    m_bFatal = true;
    return RC_ERROR;
  }

  // 
  // Add souce ghostpad since bins normally do not have pads.
  //
  pad = gst_element_get_pad(pElemCamIdentity, "src");
  gst_element_add_pad(m_pBinCameraSrc, gst_ghost_pad_new("src", pad));
  gst_object_unref(GST_OBJECT(pad));

  return OK;
}

int CameraGst::makeImageSinkBin ( )

protected

Image sink bin.

*    |-----------------------|  ~~  |-----
* - [] colorspace - fakesink |      | callback
*    |-----------------------|  ~~  |-----
* 

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Definition at line 768 of file CameraGst.cxx.

References rnr::Camera::m_bFatal.

{
  const char *sFactoryName;
  GstElement *pElemImgFfmpeg;
  GstCaps    *caps;
  GstPad     *pad;
  gboolean    ok;

  m_pBinImageSink = gst_bin_new("image_bin");

  if( m_pBinImageSink == NULL )
  {
    LOGERROR("Failed to create new gstreamer image bin.");
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Colorspace element
  //
  sFactoryName = "ffmpegcolorspace";
  pElemImgFfmpeg = gst_element_factory_make(sFactoryName, "img_color"); 
 
  if( pElemImgFfmpeg == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Sink element
  //
  sFactoryName = "fakesink";
  m_pElemImgSink = gst_element_factory_make(sFactoryName, "img_sink");
  
  if( m_pElemImgSink == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  g_object_set(G_OBJECT(m_pElemImgSink),
      "signal-handoffs", TRUE,
      NULL);

  //
  // Add elements to the pipeline
  //
  gst_bin_add_many(GST_BIN(m_pBinImageSink),
                    pElemImgFfmpeg,
                    m_pElemImgSink,
                    NULL);

  caps = gst_caps_new_simple("video/x-raw-rgb",
                              "bpp",    G_TYPE_INT, 24,
                              "depth",  G_TYPE_INT, 24,
                              NULL);
  ok = gst_element_link_filtered(pElemImgFfmpeg, m_pElemImgSink, caps);

  if( !ok )
  {
    LOGERROR("Failed to set filtered link.");
    m_bFatal = true;
    return RC_ERROR;
  }

  gst_caps_unref(caps);


  // 
  // Add sink ghostpad since bins normally do not have pads.
  //
  pad = gst_element_get_pad(pElemImgFfmpeg, "sink");
  gst_element_add_pad(m_pBinImageSink, gst_ghost_pad_new("sink", pad));
  gst_object_unref(GST_OBJECT(pad));

  return OK;
}

int CameraGst::makeVideoSinkBin ( )

protected

Video sink bin.

*    |------------------------------------------------------------------|
*    |       - queue - scale - capsfilter - colorspace - gconfvideosink |
*    |      /                                                           |
* - [] tee -                                                            |
*    |      \                                                           |
*    |       - queue (to save image)                                    []
*    |------------------------------------------------------------------|
* 

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Definition at line 563 of file CameraGst.cxx.

References rnr::Camera::m_bFatal.

{
  const char *sFactoryName;
  GstElement *pElemVidIdentity;
  GstElement *pElemVidTee;
  GstElement *pElemVidSaveQueue;
  GstElement *pElemVidDispQueue;
  GstElement *pElemVidScale;
  GstElement *pElemVidFilter;
  GstElement *pElemVidFfmpeg;
  GstCaps    *caps;
  GstPad     *pad;
  gboolean    ok;

  m_pBinVideoSink = gst_bin_new("video_bin");

  if( m_pBinVideoSink == NULL )
  {
    LOGERROR("Failed to create new gstreamer video bin.");
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Tee element
  //
  sFactoryName = "tee";
  pElemVidTee = gst_element_factory_make(sFactoryName, "vid_tee"); 
 
  if( pElemVidTee == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Save queue element
  //
  sFactoryName = "queue";
  pElemVidSaveQueue = gst_element_factory_make(sFactoryName, "vid_save_queue"); 

  if( pElemVidSaveQueue == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  g_object_set(G_OBJECT(pElemVidSaveQueue),
      "max-size-buffers", 2,
      NULL);

  //
  // Video display queue element
  //
  sFactoryName = "queue";
  pElemVidDispQueue = gst_element_factory_make(sFactoryName, "vid_disp_queue"); 

  if( pElemVidDispQueue == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Scale element
  //
  sFactoryName = "videoscale";
  pElemVidScale = gst_element_factory_make(sFactoryName, "vid_scale"); 

  if( pElemVidScale == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  // use bilinear scaling
  g_object_set(pElemVidScale, "method", 1, NULL);

  //
  // Filter Element
  //
  sFactoryName = "capsfilter";
  pElemVidFilter = gst_element_factory_make(sFactoryName, "vid_caps");

  if( pElemVidFilter == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  caps = gst_caps_new_simple("video/x-raw-yuv",
                              "width",  G_TYPE_INT, 320,
                              "height", G_TYPE_INT, 240,
                              NULL);

  g_object_set(G_OBJECT(pElemVidFilter), "caps", caps, NULL);
  gst_caps_unref(caps);

  //
  // Text overlay element
  //
  sFactoryName = "textoverlay";
  m_pElemVidText = gst_element_factory_make(sFactoryName, "vid_text"); 

  if( m_pElemVidText == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  // no text
  g_object_set(m_pElemVidText,
      "text", "",
      "font-desc", "Aria 32",
      NULL);

  //
  // Color space element
  //
  sFactoryName = "ffmpegcolorspace";
  pElemVidFfmpeg = gst_element_factory_make(sFactoryName, "vid_color"); 
 
  if( pElemVidFfmpeg == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  //
  // Display sink element
  //
  sFactoryName = "gconfvideosink";
  m_pElemVidSink = gst_element_factory_make(sFactoryName, "vid_sink"); 

  if( m_pElemVidSink == NULL )
  {
    LOGERROR("Failed to create gstreamer element: %s.", sFactoryName);
    m_bFatal = true;
    return RC_ERROR;
  }

  gst_bin_add_many(GST_BIN(m_pBinVideoSink),
                    pElemVidTee,
                    pElemVidSaveQueue,
                    pElemVidDispQueue,
                    pElemVidScale,
                    pElemVidFilter,
                    m_pElemVidText,
                    pElemVidFfmpeg,
                    m_pElemVidSink,
                    NULL);

  ok = gst_element_link_many(
                    pElemVidTee,
                    pElemVidSaveQueue,
                    NULL);

  if( !ok )
  {
    LOGERROR("Failed to link video tee save gstreamer elements.");
    m_bFatal = true;
    return RC_ERROR;
  }

  ok = gst_element_link_many(
                    pElemVidTee,
                    pElemVidDispQueue,
                    pElemVidScale,
                    pElemVidFilter,
                    m_pElemVidText,
                    pElemVidFfmpeg,
                    m_pElemVidSink,
                    NULL);

  if( !ok )
  {
    LOGERROR("Failed to link video tee display gstreamer elements.");
    m_bFatal = true;
    return RC_ERROR;
  }

  // 
  // Add sink ghostpad since bins normally do not have pads.
  //
  pad = gst_element_get_pad(pElemVidTee, "sink");
  gst_element_add_pad(m_pBinVideoSink, gst_ghost_pad_new("sink", pad));
  gst_object_unref(GST_OBJECT(pad));

  // 
  // Add source ghostpad to save stream
  //
  pad = gst_element_get_pad(pElemVidSaveQueue, "src");
  gst_element_add_pad(m_pBinVideoSink, gst_ghost_pad_new("src", pad));
  gst_object_unref(GST_OBJECT(pad));

  return OK;
}

CamRes CameraGst::setCameraResolution ( const CamRes &  res )

protectedvirtual

Set the camera resolution in either video or still image mode.

Parameters

res	Target camera resolution.

Returns

Actual resolution set.

Reimplemented from rnr::Camera.

Definition at line 328 of file CameraGst.cxx.

References rnr::CamRes::height, rnr::Camera::isCameraRunning(), rnr::Camera::m_resCurrent, and rnr::CamRes::width.

{
  bool      bWasRunning;
  GstCaps  *caps;

  // camera pipeline must be stopped before applying capabilities
  if( (bWasRunning = isCameraRunning()) )
  {
    stopPipeline();
  }

  caps = gst_caps_new_simple("video/x-raw-yuv",
                              "width",  G_TYPE_INT, res.width,
                              "height", G_TYPE_INT, res.height,
                              NULL);

  g_object_set(G_OBJECT(m_pElemCamFilter), "caps", caps, NULL);
  gst_caps_unref(caps);

  m_resCurrent = res;

  if( bWasRunning )
  {
    startPipeline();
  }

  return m_resCurrent;
}

void rnr::CameraGst::setTextOverlay ( const char *  sText )

inline

Overlay text on video stream.

Parameters

sText

Null-terminated string.

Definition at line 157 of file CameraGst.h.

References m_pElemVidText.

    {
      g_object_set(m_pElemVidText, "text", sText, NULL);
    }

void CameraGst::setXid

(

gulong

uXid

)

Set X identifier associated with widget receiving streaming video.

Parameters

uXid	X identifier.

Definition at line 357 of file CameraGst.cxx.

{
  m_uVidWinXid = uXid;

  //g_object_set(m_pElemVidGenSrc, "xid", m_uVidWinXid, NULL);
}

int CameraGst::startVideo ( const CamRes &  resVideo = CamResDft )

virtual

Start the camera streaming video.

Parameters

resVideo

Video resolution. If equal to CamResDft, then the initial/last video resolution setting is used.

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Reimplemented from rnr::Camera.

Definition at line 103 of file CameraGst.cxx.

References rnr::CamResDft, rnr::CamRes::height, rnr::Camera::isCameraRunning(), rnr::Camera::isEqResolution(), rnr::Camera::m_resCurrent, rnr::Camera::m_resVideo, rnr::CameraCv::setCameraResolution(), and rnr::CamRes::width.

{
  CamRes  res = resVideo;

  // default is the current video resolution
  if( isEqResolution(res, CamResDft) )
  {
    res = m_resVideo;
  }
  
  // start video with the given resolution
  if( !isCameraRunning() )
  {
    setCameraResolution(res);
    startPipeline();
  }

  // resolution is different from current setting
  else if( !isEqResolution(res, m_resCurrent) )
  {
    stopPipeline();
    setCameraResolution(res);
    startPipeline();
  }

  // camera already running at target resolution
  else
  {
    LOGDIAG3("Camera already started with target resolution.");
  }

  m_resVideo = m_resCurrent;

  LOGDIAG3("Capturing %dx%d video.", m_resVideo.width, m_resVideo.height);

  return OK;
}

int CameraGst::stopVideo ( )

virtual

Stop the camera from streaming video.

Returns

On success, OK(0) is returned.
On error, RC_ERROR(-1) is returned.

Reimplemented from rnr::Camera.

Definition at line 141 of file CameraGst.cxx.

References rnr::Camera::isCameraRunning().

{
  if( !isCameraRunning() )
  {
    LOGDIAG3("Video capture already stoped.");
  }

  else
  {
    stopPipeline();
    LOGDIAG3("Video capturing stopped.");
  }

  return OK;
}

---

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

• include/rnr/appkit/CameraGst.h
• sw/librnr_cam/CameraGst.cxx