libcamera/jmondi/libcamera.git - Jacopo Mondi's clone of libcamera

Age	Commit message (Collapse)	Author
2019-08-12	include: android: Add SPDX tags	Jacopo Mondi
	Add SPDX indentifier to Apache-2.0 licensed android headers. Signed-off-by: Jacopo Mondi <jacopo@jmondi.org> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
2019-08-12	include: android: Add Android headers from Cros	Jacopo Mondi
	Copy the Android Camera3 HAL headers from the ChromiumOS build system and define a new inclusion directive in the meson build system for them. The header files have been copied from: https://chromium.googlesource.com/chromiumos/platform2 at revision 9e65ddd2c496e712f005ada9715decd2ff8e4a03 and provide: 1) Android CameraHAL3 HAL headers in include/android/hardware/ 2) The Android system headers in include/android/system/ 3) The Android camera metadata headers in include/android/metadata/ The original path in the Cros platform2/ repository is, respectively: camera/android/header_files/include/hardware camera/android/header_files/include/system camera/android/libcamera_metadata/include/ Signed-off-by: Jacopo Mondi <jacopo@jmondi.org> Reviewed-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>

/* SPDX-License-Identifier: LGPL-2.1-or-later */ /* * Copyright (C) 2019, Google Inc. * * request.cpp - Capture request handling */ #include <map> #include <libcamera/buffer.h> #include <libcamera/camera.h> #include <libcamera/request.h> #include <libcamera/stream.h> #include "log.h" /** * \file request.h * \brief Describes a frame capture request to be processed by a camera */ namespace libcamera { LOG_DEFINE_CATEGORY(Request) /** * \enum Request::Status * Request completion status * \var Request::RequestPending * The request hasn't completed yet * \var Request::RequestComplete * The request has completed * \var Request::RequestCancelled * The request has been cancelled due to capture stop */ /** * \class Request * \brief A frame capture request * * A Request allows an application to associate buffers and controls on a * per-frame basis to be queued to the camera device for processing. */ /** * \brief Create a capture request for a camera * \param[in] camera The camera that creates the request */ Request::Request(Camera *camera) : camera_(camera), status_(RequestPending) { } /** * \fn Request::buffers() * \brief Retrieve the request's streams to buffers map * * Return a reference to the map that associates each Stream part of the * request to the Buffer the Stream output should be directed to. * * \return The map of Stream to Buffer */ /** * \brief Set the streams to capture with associated buffers * \param[in] streamMap The map of streams to buffers * \return 0 on success or a negative error code otherwise * \retval -EBUSY Buffers have already been set */ int Request::setBuffers(const std::map<Stream *, Buffer *> &streamMap) { if (!bufferMap_.empty()) { LOG(Request, Error) << "Buffers already set"; return -EBUSY; } bufferMap_ = streamMap; return 0; } /** * \var Request::bufferMap_ * \brief Mapping of streams to buffers for this request * * The bufferMap_ tracks the buffers associated with each stream. If a stream is * not utilised in this request there will be no buffer for that stream in the * map. */ /** * \brief Return the buffer associated with a stream * \param[in] stream The stream the buffer is associated to * * \return The buffer associated with the stream, or nullptr if the stream is * not part of this request */ Buffer *Request::findBuffer(Stream *stream) const { auto it = bufferMap_.find(stream); if (it == bufferMap_.end()) return nullptr; return it->second; } /** * \fn Request::status() * \brief Retrieve the request completion status * * The request status indicates whether the request has completed successfully * or with an error. When requests are created and before they complete the * request status is set to RequestPending, and is updated at completion time * to RequestComplete. If a request is cancelled at capture stop before it has * completed, its status is set to RequestCancelled. * * \return The request completion status */ /** * \fn Request::hasPendingBuffers() * \brief Check if a request has buffers yet to be completed * * \return True if the request has buffers pending for completion, false * otherwise */ /** * \brief Validate the request and prepare it for the completion handler * * Requests that contain no buffers are invalid and are rejected. * * \return 0 on success or a negative error code otherwise * \retval -EINVAL The request is invalid */ int Request::prepare() { if (bufferMap_.empty()) { LOG(Request, Error) << "Invalid request due to missing buffers"; return -EINVAL; } for (auto const &pair : bufferMap_) { Buffer *buffer = pair.second; buffer->setRequest(this); pending_.insert(buffer); } return 0; } /** * \brief Complete a queued request * \param[in] status The request completion status * * Mark the request as complete by updating its status to \a status. */ void Request::complete(Status status) { ASSERT(!hasPendingBuffers()); status_ = status; } /** * \brief Complete a buffer for the request * \param[in] buffer The buffer that has completed * * A request tracks the status of all buffers it contains through a set of * pending buffers. This function removes the \a buffer from the set to mark it * as complete. All buffers associate with the request shall be marked as * complete by calling this function once and once only before reporting the * request as complete with the complete() method. * * \return True if all buffers contained in the request have completed, false * otherwise */ bool Request::completeBuffer(Buffer *buffer) { int ret = pending_.erase(buffer); ASSERT(ret == 1); buffer->setRequest(nullptr); return !hasPendingBuffers(); } } /* namespace libcamera */