Top | ![]() |
![]() |
![]() |
![]() |
char * | driver | Read |
gboolean | has-capture | Read / Write / Construct Only |
gboolean | has-preview | Read / Write / Construct Only |
gboolean | has-settings | Read / Write / Construct Only |
gboolean | has-viewfinder | Read / Write / Construct Only |
char * | manual | Read |
char * | model | Read / Write / Construct Only |
char * | port | Read / Write / Construct Only |
EntangleProgress * | progress | Read / Write |
char * | serial | Read / Write / Construct Only |
char * | summary | Read |
void | camera-closed | Run First |
void | camera-controls-changed | Run First |
void | camera-file-added | Run First |
void | camera-file-captured | Run First |
void | camera-file-deleted | Run First |
void | camera-file-downloaded | Run First |
void | camera-file-previewed | Run First |
void | camera-opened | Run First |
GEnum ├── EntangleCameraCaptureTarget ╰── EntangleCameraManualFocusStep GObject ╰── EntangleCamera
EntangleCamera * entangle_camera_new (const char *model
,const char *port
,const char *serial
,gboolean hasCapture
,gboolean hasPreview
,gboolean hasSettings
);
const char *
entangle_camera_get_model (EntangleCamera *cam
);
Get the camera model name
const char *
entangle_camera_get_port (EntangleCamera *cam
);
Get the camera port name
gboolean entangle_camera_open (EntangleCamera *cam
,GError **error
);
Attempt to open to and initialize the camera. This may fail if the camera is in use by another application, has gone to sleep or has been disconnected from the port.
This block execution of the caller until completion.
void entangle_camera_open_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Attempt to open to and initialize the camera. This may fail if the camera is in use by another application, has gone to sleep or has been disconnected from the port.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_open_finish
can be used to check the status
gboolean entangle_camera_open_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_open_async
gboolean entangle_camera_close (EntangleCamera *cam
,GError **error
);
Close from the camera, enabling it to be used by other applications.
This block execution of the caller until completion.
void entangle_camera_close_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Close from the camera, enabling it to be used by other applications.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_open_async
can be used to check the status
gboolean entangle_camera_close_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_close_async
gboolean
entangle_camera_get_opened (EntangleCamera *cam
);
Determine if the camera is currently opened
char *
entangle_camera_get_summary (EntangleCamera *cam
);
Get the camera summary text. This is only available while the camera is opened
char *
entangle_camera_get_manual (EntangleCamera *cam
);
Get the camera manual text. This is only available while the camera is opened
char *
entangle_camera_get_driver (EntangleCamera *cam
);
Get the camera driver information text. This is only available while the camera is opened
EntangleCameraFile * entangle_camera_capture_image (EntangleCamera *cam
,GError **error
);
Trigger the camera shutter and download the first resulting image. If the camera is shooting in multiple formats (eg JPEG and RAW) this method will only return the first format captured The caller should watch for signal notifications to detect any additional images
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_capture_image_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Trigger the camera shutter and download the first resulting image. If the camera is shooting in multiple formats (eg JPEG and RAW) this method will only return the first format captured The caller should watch for signal notifications to detect any additional images
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_capture_image_finish
can be used to check the status
EntangleCameraFile * entangle_camera_capture_image_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_capture_image_async.
EntangleCameraFile * entangle_camera_preview_image (EntangleCamera *cam
,GError **error
);
Enable "live view", if not already enabled, and capture a low resolution preview image. The "live view" mode will remain enabled after execution.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_preview_image_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Enable "live view", if not already enabled, and capture a low resolution preview image. The "live view" mode will remain enabled after execution.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_preview_image_finish
can be used to check the status
EntangleCameraFile * entangle_camera_preview_image_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_preview_image_async.
gboolean entangle_camera_download_file (EntangleCamera *cam
,EntangleCameraFile *file
,GError **error
);
Download the data associated with file
and set the data
on file
.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_download_file_async (EntangleCamera *cam
,EntangleCameraFile *file
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Download the data associated with file
and set the data
on file
.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_download_file_finish
can be used to check the status
cam |
the camera. |
[transfer none] |
file |
the file whose contents to download. |
[transfer none] |
cancellable |
optional GCancellable object, NULL to ignore. |
[nullable] |
callback |
a GAsyncReadyCallback to call when the request is satisfied. |
[scope async] |
user_data |
the data to pass to callback function. |
[closure] |
gboolean entangle_camera_download_file_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_download_file_async.
gboolean entangle_camera_delete_file (EntangleCamera *cam
,EntangleCameraFile *file
,GError **error
);
Delete file
from the camera capture target.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_delete_file_async (EntangleCamera *cam
,EntangleCameraFile *file
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Delete file
from the camera capture target.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_delete_file_finish
can be used to check the status
gboolean entangle_camera_delete_file_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_delete_file_async.
gboolean entangle_camera_process_events (EntangleCamera *cam
,guint64 waitms
,GError **error
);
Wait upto waitms
milliseconds for events to arrive from
the camera. Signals will be emitted for any interesting
events that arrive. Multiple events will be processed
until waitms
is exceeded.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_process_events_async (EntangleCamera *cam
,guint64 waitms
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Wait upto waitms
milliseconds for events to arrive from
the camera. Signals will be emitted for any interesting
events that arrive. Multiple events will be processed
until waitms
is exceeded.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_process_events_finish
can be used to check the status
gboolean entangle_camera_process_events_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_process_events_async.
gboolean entangle_camera_set_viewfinder (EntangleCamera *cam
,gboolean enabled
,GError **error
);
If enabled
is TRUE, the view finder will be activated
allowing preview images to be captured. If enabled
is
FALSE, the view finder will be deactivated.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_set_viewfinder_async (EntangleCamera *cam
,gboolean enabled
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
If enabled
is TRUE, the view finder will be activated
allowing preview images to be captured. If enabled
is
FALSE, the view finder will be deactivated.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_set_viewfinder_finish
can be used to check the status
gboolean entangle_camera_set_viewfinder_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_set_viewfinder_async.
gboolean entangle_camera_autofocus (EntangleCamera *cam
,GError **error
);
Trigger the autofocus mechanism on the camera, waiting until focus is achieved or fails.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_autofocus_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Trigger the autofocus mechanism on the camera, waiting until focus is achieved or fails.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_autofocus_finish
can be used to check the status
gboolean entangle_camera_autofocus_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_autofocus_async.
gboolean entangle_camera_manualfocus (EntangleCamera *cam
,EntangleCameraManualFocusStep step
,GError **error
);
Trigger the focus mechanism on the camera, to move
by step
.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_manualfocus_async (EntangleCamera *cam
,EntangleCameraManualFocusStep step
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Trigger the focus mechanism on the camera, to move
by step
.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_manualfocus_finish
can be used to check the status
gboolean entangle_camera_manualfocus_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_manualfocus_async.
gboolean entangle_camera_set_clock (EntangleCamera *cam
,gint64 epochsecs
,GError **error
);
Update the camera clock to be epochsecs
seconds since
the epoch.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_set_clock_async (EntangleCamera *cam
,gint64 epochsecs
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Update the camera clock to be epochsecs
seconds since
the epoch.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_set_clock_finish
can be used to check the status
cam |
the camera. |
[transfer none] |
epochsecs |
new time in seconds since the epoch |
|
cancellable |
optional GCancellable object, NULL to ignore. |
[nullable] |
callback |
a GAsyncReadyCallback to call when the request is satisfied. |
[scope async] |
user_data |
the data to pass to callback function. |
[closure] |
gboolean entangle_camera_set_clock_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_set_clock_async.
gboolean entangle_camera_set_capture_target (EntangleCamera *cam
,EntangleCameraCaptureTarget target
,GError **error
);
Set the destination for storing captured images
to target
.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_set_capture_target_async (EntangleCamera *cam
,EntangleCameraCaptureTarget target
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Set the destination for storing captured images
to target
.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_set_clock_finish
can be used to check the status
gboolean entangle_camera_set_capture_target_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
gboolean
entangle_camera_get_has_capture (EntangleCamera *cam
);
Check if the camera supports images capture
gboolean
entangle_camera_get_has_preview (EntangleCamera *cam
);
Check if the camera supports images preview
gboolean
entangle_camera_get_has_settings (EntangleCamera *cam
);
Check if the camera supports configuration settings
gboolean
entangle_camera_get_has_viewfinder (EntangleCamera *cam
);
Check if the camera supports view finder control
gboolean entangle_camera_load_controls (EntangleCamera *cam
,GError **error
);
Loads the configuration controls from the camera.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_load_controls_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Loads the configuration controls from the camera.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_load_controls_finish
can be used to check the status
gboolean entangle_camera_load_controls_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_load_controls_async.
gboolean entangle_camera_save_controls (EntangleCamera *cam
,GError **error
);
Saves the configuration controls to the camera.
This can only be invoked when the camera is opened.
This block execution of the caller until completion.
void entangle_camera_save_controls_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Saves the configuration controls to the camera.
This can only be invoked when the camera is opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_save_controls_finish
can be used to check the status
gboolean entangle_camera_save_controls_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_save_controls_async.
EntangleControlGroup * entangle_camera_get_controls (EntangleCamera *cam
,GError **error
);
Get the configuration controls associated with the camera.
This can only be invoked when the camera is opened.
void entangle_camera_set_progress (EntangleCamera *cam
,EntangleProgress *prog
);
Set the object instance to receive operation progress notifications
EntangleProgress *
entangle_camera_get_progress (EntangleCamera *cam
);
Get the object instance that is receiving operation progress notifications
gboolean
entangle_camera_is_mounted (EntangleCamera *cam
);
Check whether the camera is mounted as a virtual filesystem, which would prevent opening it.
void entangle_camera_mount_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
gboolean entangle_camera_mount_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
void entangle_camera_unmount_async (EntangleCamera *cam
,GCancellable *cancellable
,GAsyncReadyCallback callback
,gpointer user_data
);
Unmount the camera virtual filesystem, allowing it to be opened.
This will execute in the background, and invoke callback
when complete, whereupon entangle_camera_unmount_finish
can be used to check the status
gboolean entangle_camera_unmount_finish (EntangleCamera *cam
,GAsyncResult *result
,GError **error
);
Check the completion status of a previous call to entangle_camera_unmount_async.
“driver”
property “driver” char *
Camera driver information.
Owner: EntangleCamera
Flags: Read
Default value: NULL
“has-capture”
property “has-capture” gboolean
Whether image capture is supported.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: FALSE
“has-preview”
property “has-preview” gboolean
Whether image preview is supported.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: FALSE
“has-settings”
property “has-settings” gboolean
Whether camera settings configuration is supported.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: FALSE
“has-viewfinder”
property “has-viewfinder” gboolean
Whether camera viewfinder configuration is supported.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: FALSE
“manual”
property “manual” char *
Camera manual.
Owner: EntangleCamera
Flags: Read
Default value: NULL
“model”
property “model” char *
Model name of the camera.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: NULL
“port”
property “port” char *
Device port of the camera.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: NULL
“progress”
property“progress” EntangleProgress *
Operation progress updater.
Owner: EntangleCamera
Flags: Read / Write
“serial”
property “serial” char *
Device serial of the camera.
Owner: EntangleCamera
Flags: Read / Write / Construct Only
Default value: NULL
“camera-closed”
signalvoid user_function (EntangleCamera *entanglecamera, gpointer user_data)
Flags: Run First
“camera-controls-changed”
signalvoid user_function (EntangleCamera *entanglecamera, gpointer user_data)
Flags: Run First
“camera-file-added”
signalvoid user_function (EntangleCamera *entanglecamera, EntangleCameraFile *arg1, gpointer user_data)
Flags: Run First
“camera-file-captured”
signalvoid user_function (EntangleCamera *entanglecamera, EntangleCameraFile *arg1, gpointer user_data)
Flags: Run First
“camera-file-deleted”
signalvoid user_function (EntangleCamera *entanglecamera, EntangleCameraFile *arg1, gpointer user_data)
Flags: Run First
“camera-file-downloaded”
signalvoid user_function (EntangleCamera *entanglecamera, EntangleCameraFile *arg1, gpointer user_data)
Flags: Run First
“camera-file-previewed”
signalvoid user_function (EntangleCamera *entanglecamera, EntangleCameraFile *arg1, gpointer user_data)
Flags: Run First
“camera-opened”
signalvoid user_function (EntangleCamera *entanglecamera, gpointer user_data)
Flags: Run First