From patchwork Mon Apr 8 13:48:09 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: 940 Return-Path: Received: from bin-mail-out-05.binero.net (bin-mail-out-05.binero.net [195.74.38.228]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 4D54060004 for ; Mon, 8 Apr 2019 15:48:29 +0200 (CEST) X-Halon-ID: f44bb10a-5a04-11e9-846a-005056917a89 Authorized-sender: niklas@soderlund.pp.se Received: from bismarck.berto.se (unknown [89.233.230.99]) by bin-vsp-out-01.atm.binero.net (Halon) with ESMTPA id f44bb10a-5a04-11e9-846a-005056917a89; Mon, 08 Apr 2019 15:48:22 +0200 (CEST) From: =?utf-8?q?Niklas_S=C3=B6derlund?= To: libcamera-devel@lists.libcamera.org Date: Mon, 8 Apr 2019 15:48:09 +0200 Message-Id: <20190408134817.15247-1-niklas.soderlund@ragnatech.se> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH v4 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: Mon, 08 Apr 2019 13:48:29 -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. - Changes since v3 - Add const Stream *CameraConfiguration::front() const. - Rename empty() and valid() to isEmpty() and isValid(). - Improved the documentation. 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 | 36 ++- .../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 | 243 +++++++++++++++--- 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, 462 insertions(+), 174 deletions(-) rename {src/libcamera/include => include/libcamera}/geometry.h (100%)