From d782a8992de461ff07995dfee871d79cedb2e02b Mon Sep 17 00:00:00 2001 From: Hans Verkuil Date: Sun, 18 Jan 2009 16:00:07 +0100 Subject: v4l2-spec: document zoom and privacy controls From: Laurent Pinchart Priority: normal Signed-off-by: Laurent Pinchart Signed-off-by: Hans Verkuil --- v4l2-spec/compat.sgml | 7 +++++++ v4l2-spec/controls.sgml | 43 +++++++++++++++++++++++++++++++++++++++++++ v4l2-spec/v4l2.sgml | 4 +++- 3 files changed, 53 insertions(+), 1 deletion(-) (limited to 'v4l2-spec') diff --git a/v4l2-spec/compat.sgml b/v4l2-spec/compat.sgml index c60af84cc..161da3161 100644 --- a/v4l2-spec/compat.sgml +++ b/v4l2-spec/compat.sgml @@ -2264,6 +2264,13 @@ was introduced in its place. V4L2_PIX_FMT_NV16 and V4L2_PIX_FMT_NV61 were added. + + Added camera controls +V4L2_CID_ZOOM_ABSOLUTE, +V4L2_CID_ZOOM_RELATIVE, +V4L2_CID_ZOOM_CONTINUOUS and +V4L2_CID_PRIVACY. + diff --git a/v4l2-spec/controls.sgml b/v4l2-spec/controls.sgml index b7d6b8363..52dd19bcf 100644 --- a/v4l2-spec/controls.sgml +++ b/v4l2-spec/controls.sgml @@ -1742,6 +1742,49 @@ adjustments. The effect of manual focus adjustments while this feature is enabled is undefined, drivers should ignore such requests. + + + V4L2_CID_ZOOM_ABSOLUTE  + integer + Specify the objective lens +focal length as an absolute value. The zoom unit is driver-specific and its +value should be a positive integer. + + + + + V4L2_CID_ZOOM_RELATIVE  + integer + Specify the objective lens +focal length relatively to the current value. Positive values move the zoom +lens group towards the telephoto direction, negative values towards the +wide-angle direction. The zoom unit is driver-specific. + + + + + V4L2_CID_ZOOM_CONTINUOUS  + integer + Move the objective lens group +at the specified speed until it reaches physical device limits or until an +explicit request to stop the movement. A positive value moves the zoom lens +group towards the telephoto direction. A value of zero stops the zoom lens +group movement. A negative value moves the zoom lens group towards the +wide-angle direction. The zoom speed unit is driver-specific. + + + + + V4L2_CID_PRIVACY  + boolean + Prevent video from being acquired +by the camera. When this control is set to TRUE (1), no +image can be captured by the camera. Common means to enforce privacy are +mechanical obturation of the sensor and firmware image processing, but the +device is not restricted to these methods. Devices that implement the privacy +control must support read access and may support write access. + + diff --git a/v4l2-spec/v4l2.sgml b/v4l2-spec/v4l2.sgml index 782ccc36a..307180eec 100644 --- a/v4l2-spec/v4l2.sgml +++ b/v4l2-spec/v4l2.sgml @@ -123,7 +123,9 @@ applications. --> 2009-01-18 hv Added pixel formats VYUY, NV16 and NV61, and changed -the debug ioctls VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT. +the debug ioctls VIDIOC_DBG_G/S_REGISTER and VIDIOC_DBG_G_CHIP_IDENT. +Added camera controls V4L2_CID_ZOOM_ABSOLUTE, V4L2_CID_ZOOM_RELATIVE, +V4L2_CID_ZOOM_CONTINUOUS and V4L2_CID_PRIVACY. -- cgit v1.2.3