From patchwork Fri Apr 5 23:58:34 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Niklas_S=C3=B6derlund?= X-Patchwork-Id: 924 Return-Path: Received: from vsp-unauthed02.binero.net (vsp-unauthed02.binero.net [195.74.38.227]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 15230610B3 for ; Sat, 6 Apr 2019 01:59:16 +0200 (CEST) X-Halon-ID: c0a78f46-57fe-11e9-8144-0050569116f7 Authorized-sender: niklas@soderlund.pp.se Received: from bismarck.berto.se (unknown [89.233.230.99]) by bin-vsp-out-03.atm.binero.net (Halon) with ESMTPA id c0a78f46-57fe-11e9-8144-0050569116f7; Sat, 06 Apr 2019 01:59:12 +0200 (CEST) From: =?utf-8?q?Niklas_S=C3=B6derlund?= To: libcamera-devel@lists.libcamera.org Date: Sat, 6 Apr 2019 01:58:34 +0200 Message-Id: <20190405235842.27884-1-niklas.soderlund@ragnatech.se> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH v3 0/8] libcamera: stream: Add basic stream usages X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 05 Apr 2019 23:59:16 -0000 Hi, This series changes how the default configuration is retrieved from a camera. It replaces the current method where applications have to enumerate a cameras streams and pick a set of them to ask for a default configuration and then try to tune them to its use-case. Instead the application asks libcamera for a set of stream usages to fit its use-case and receives in returns a set of streams with a default configuration (which it then can try and fine tune). The goal of this series is to define the API towards the application and not to implement smart choices in the pipeline handlers to actually select streams. The main reason for this limitation in scope are that all upstream pipeline handlers only support one stream so the new API is not really useful for pipeline handlers yet. The code is tested with a modified cam tool (patches posted in a different series) together with out of tree IPU3 patches to extend it to expose more then one stream per camera. So the API is proven to work with multiple streams and can support capturing multiple streams in the same request. * Changes since v1 - Renamed StreamRole to StreamUsage - Made geometry.h public header and use Size. - Added CameraConfiguration object to handle mapping of stream usages to stream configurations. - Added more documentation, thanks all patient reviewers! - Changes since v2 - Extend CameraConfiguratio with .valid(), ability use operator[](Stream *) in a const context and add operator[](unsinged int) to fetch stream pointers based on insertion index. - Fixed up a lot of documentation. - Added geometry.h to meason.build. - Camera::configureStreams() and PipelineHandler::configureStreams() take a const CameraConfiguration. - Dropped #include from camera.h. Niklas Söderlund (8): cam: Rework how streams configuration is prepared test: camera: Remove streams argument from configurationValid() test: camera: Remove test for bad Stream IDs libcamera: Make geometry.h a public header libcamera: stream: Add basic stream usages libcamera: camera: Add support for stream usages libcamera: camera: Add CameraConfiguration libcamera: Switch to CameraConfiguration include/libcamera/camera.h | 35 ++- .../include => include/libcamera}/geometry.h | 0 include/libcamera/meson.build | 1 + include/libcamera/stream.h | 40 ++++ src/cam/main.cpp | 34 +-- src/libcamera/camera.cpp | 224 +++++++++++++++--- src/libcamera/geometry.cpp | 2 +- src/libcamera/include/formats.h | 2 +- src/libcamera/include/pipeline_handler.h | 8 +- src/libcamera/include/v4l2_subdevice.h | 3 +- src/libcamera/pipeline/ipu3/ipu3.cpp | 14 +- src/libcamera/pipeline/uvcvideo.cpp | 18 +- src/libcamera/pipeline/vimc.cpp | 18 +- src/libcamera/pipeline_handler.cpp | 16 +- src/libcamera/stream.cpp | 92 +++++++ src/libcamera/v4l2_subdevice.cpp | 3 +- src/qcam/main_window.cpp | 5 +- src/qcam/main_window.h | 2 +- test/camera/camera_test.cpp | 27 --- test/camera/camera_test.h | 3 - test/camera/capture.cpp | 11 +- test/camera/configuration_default.cpp | 40 +--- test/camera/configuration_set.cpp | 9 +- test/camera/statemachine.cpp | 6 +- test/v4l2_subdevice/list_formats.cpp | 3 +- 25 files changed, 442 insertions(+), 174 deletions(-) rename {src/libcamera/include => include/libcamera}/geometry.h (100%)