Start the photo viewfinder on the camera.
camera_error_t camera_start_photo_viewfinder(camera_handle_t handle, void(*viewfinder_callback)(camera_handle_t, camera_buffer_t *, void *), void(*status_callback)(camera_handle_t, camera_devstatus_t, uint16_t, void *), void *arg)
The handle returned by a call to the camera_open() function.
A function pointer to a function with the following signature:
A function pointer to a function with the following signature: void function_name( camera_handle_t, camera_devstatus_t, uint16_t, void*) The function is a callback that gets invoked when status events occur. Set the argument to NULL if no function needs to be called. For information about the callback arguments, see About callback mode.
The argument passed to all callback functions, which is the last argument in the callback functions.
Before calling this function, ensure that you:
- Use the camera_set_photovf_property() function to configure the photo viewfinder.
- Use the camera_set_photo_property() function to set any photo properties.
- Create a screen window to be the parent of the child viewfinder window that will be created by this call.
Once the photo viewfinder is running, the user can take photos, and configure scene modes. In addition, you can reposition or resize their viewfinder windows using the Screen and Windowing API. In order to retrieve a window handle to the viewfinder window that is created, you must listen for the appropriate screen event. After receiving the window handle, you can then use the screen API to manipulate the window.