The CamCap command-line tool is a simple wrapper that uses libcamcap.
Thus, the functionality provided by the CLI tool maps directly to C++ API calls.
| CLI | API | Description |
|---|---|---|
control <index> <value> | CC::Device::set_control() | Set one of the controls to a specific value. |
control <name> <value> | CC::Device::control_name_to_index() | Convert a control name or hex value to an index so the normal set_control() can be called. |
controls | CC::Device::describe_controls() | Provide a block of text describing the state of all the controls. |
defaults | CC::Device::set_all_controls_to_defaults() | Set all controls back to their default values. |
describe | CC::Device::describe() | Generate a block of text that describes everything known about the camera. |
device <filename> | CC::Device::initialize() | Initialize using the given device filename. |
format | CC::Device::get_format() | Information on the currently-selected format. |
formatindex <index> | CC::Device::get_formats() and CC::Device::set_format() | Set the image format to use. |
ignore <count> | CC::Device::capture() | Capture an image and ignore it (don't save it to disk). |
initialize | CC::Device::initialize() | Autu-detect a device to initialize. |
jpg <filename> | CC::Device::capture_to_jpeg() | Capture an image and save it as a JPEG file. |
jpgs <count> | CC::Device::capture_many_to_jpeg() | Capture many images and save them as JPEG files. |
libv4l enable|disable | CC::Device::set_libv4l_interface() | Enable or disable libv4l interface. |
mmap | CC::Device::set_transfer_method() | Use the mmap() transfer method. |
raw <filename> | CC::Device::capture() | Capture an image, return it as a raw sequence of bytes. |
read | CC::Device::set_transfer_method() | Use the read() transfer method. |
retry <count> | CC::Device::retry_incomplete_captures() | Set the number of retry attempts. |
size <width> <height> | CC::Device::set_format() | Set the preferred image size. |
stream | CC::Device::stream_start() | Turn on image streaming. |
version | CC::get_version() | Get the version string. |