summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorMatthias Vogelgesang <matthias.vogelgesang@kit.edu>2015-06-02 13:33:04 +0200
committerMatthias Vogelgesang <matthias.vogelgesang@kit.edu>2015-06-02 11:29:33 +0200
commit842584e23685606a80c0996bd9d922a5445a0092 (patch)
treed78b9df345c4a1fc44f4ada4eec7ef974d12ff32 /src
parent5a42f849cc90070a65bf6d3932396e83ff573a4b (diff)
downloaduca-842584e23685606a80c0996bd9d922a5445a0092.tar.gz
uca-842584e23685606a80c0996bd9d922a5445a0092.tar.bz2
uca-842584e23685606a80c0996bd9d922a5445a0092.tar.xz
uca-842584e23685606a80c0996bd9d922a5445a0092.zip
Add uca_camera_readout API
This call allows to readout arbitrary frames from internal camera buffers.
Diffstat (limited to 'src')
-rw-r--r--src/uca-camera.c73
-rw-r--r--src/uca-camera.h6
2 files changed, 79 insertions, 0 deletions
diff --git a/src/uca-camera.c b/src/uca-camera.c
index cc0c1cf..98d4373 100644
--- a/src/uca-camera.c
+++ b/src/uca-camera.c
@@ -360,6 +360,7 @@ uca_camera_class_init (UcaCameraClass *klass)
klass->start_recording = NULL;
klass->stop_recording = NULL;
klass->grab = NULL;
+ klass->readout = NULL;
klass->write = NULL;
camera_properties[PROP_NAME] =
@@ -1066,6 +1067,78 @@ uca_camera_grab (UcaCamera *camera, gpointer data, GError **error)
return result;
}
+/**
+ * uca_camera_readout:
+ * @camera: A #UcaCamera object
+ * @data: (type gulong): Pointer to suitably sized data buffer. Must not be
+ * %NULL.
+ * @index: Index of in-camera frame to be grabbed
+ * @error: Location to store a #UcaCameraError error or %NULL
+ *
+ * Grab a frame a single frame and store the result in @data.
+ *
+ * You must have called uca_camera_start_recording() before, otherwise you will
+ * get a #UCA_CAMERA_ERROR_NOT_RECORDING error.
+ *
+ * Since: 2.1
+ */
+gboolean
+uca_camera_readout (UcaCamera *camera, gpointer data, guint index, GError **error)
+{
+ UcaCameraClass *klass;
+ gboolean result = FALSE;
+
+ /* FIXME: this prevents accessing two independent cameras simultanously. */
+ static GStaticMutex mutex = G_STATIC_MUTEX_INIT;
+
+ g_return_val_if_fail (UCA_IS_CAMERA(camera), FALSE);
+
+ klass = UCA_CAMERA_GET_CLASS (camera);
+
+ g_return_val_if_fail (klass != NULL, FALSE);
+ g_return_val_if_fail (klass->readout != NULL, FALSE);
+ g_return_val_if_fail (data != NULL, FALSE);
+
+ if (camera->priv->buffered) {
+ g_set_error (error, UCA_CAMERA_ERROR, UCA_CAMERA_ERROR_RECORDING,
+ "Cannot grab specific frame in buffered mode");
+ return FALSE;
+ }
+
+ g_static_mutex_lock (&mutex);
+
+ if (!camera->priv->is_recording && !camera->priv->is_readout) {
+ g_set_error (error, UCA_CAMERA_ERROR, UCA_CAMERA_ERROR_NOT_RECORDING,
+ "Camera is not in readout or record mode");
+ }
+ else {
+ g_static_mutex_lock (&access_lock);
+
+#ifdef WITH_PYTHON_MULTITHREADING
+ if (Py_IsInitialized ()) {
+ PyGILState_STATE state = PyGILState_Ensure ();
+ Py_BEGIN_ALLOW_THREADS
+
+ result = (*klass->readout) (camera, data, index, error);
+
+ Py_END_ALLOW_THREADS
+ PyGILState_Release (state);
+ }
+ else {
+ result = (*klass->readout) (camera, data, index, error);
+ }
+#else
+ result = (*klass->readout) (camera, data, index, error);
+#endif
+
+ g_static_mutex_unlock (&access_lock);
+ }
+
+ g_static_mutex_unlock (&mutex);
+
+ return result;
+}
+
static GParamSpec *
get_param_spec_by_name (UcaCamera *camera,
const gchar *prop_name)
diff --git a/src/uca-camera.h b/src/uca-camera.h
index af95123..45b48ca 100644
--- a/src/uca-camera.h
+++ b/src/uca-camera.h
@@ -144,6 +144,7 @@ struct _UcaCameraClass {
void (*trigger) (UcaCamera *camera, GError **error);
void (*write) (UcaCamera *camera, const gchar *name, gpointer data, gsize size, GError **error);
gboolean (*grab) (UcaCamera *camera, gpointer data, GError **error);
+ gboolean (*readout) (UcaCamera *camera, gpointer data, guint index, GError **error);
};
UcaCamera * uca_camera_new (const gchar *type,
@@ -168,6 +169,11 @@ gboolean uca_camera_grab (UcaCamera *camera,
gpointer data,
GError **error)
__attribute__((nonnull (2)));
+gboolean uca_camera_readout (UcaCamera *camera,
+ gpointer data,
+ guint index,
+ GError **error)
+ __attribute__((nonnull (2)));
void uca_camera_set_grab_func (UcaCamera *camera,
UcaCameraGrabFunc func,
gpointer user_data);