{"id":3679,"url":"https://patchwork.libcamera.org/api/patches/3679/?format=json","web_url":"https://patchwork.libcamera.org/patch/3679/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20200503011720.3382710-1-kieran.bingham@ideasonboard.com>","date":"2020-05-03T01:17:20","name":"[libcamera-devel] README.rst: Add FAQ section.","commit_ref":null,"pull_url":null,"state":"superseded","archived":false,"hash":"bc5f2783c0840e0119618aebb287db62d0cb703c","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/people/4/?format=json","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"delegate":{"id":11,"url":"https://patchwork.libcamera.org/api/users/11/?format=json","username":"kbingham","first_name":"Kieran","last_name":"Bingham","email":"kieran.bingham@ideasonboard.com"},"mbox":"https://patchwork.libcamera.org/patch/3679/mbox/","series":[{"id":877,"url":"https://patchwork.libcamera.org/api/series/877/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=877","date":"2020-05-03T01:17:20","name":"[libcamera-devel] README.rst: Add FAQ section.","version":1,"mbox":"https://patchwork.libcamera.org/series/877/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/3679/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/3679/checks/","tags":{},"headers":{"Return-Path":"","Received":["from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 56D63603F0\n\tfor ;\n\tSun, 3 May 2020 03:17:25 +0200 (CEST)","from localhost.localdomain\n\t(cpc89242-aztw30-2-0-cust488.18-1.cable.virginm.net [86.31.129.233])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 98976304;\n\tSun, 3 May 2020 03:17:24 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"E4iUJafr\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1588468644;\n\tbh=qnMsWk3LxIvmImUpjXPB5uUbTU6UmmQpLOX98oXCLCY=;\n\th=From:To:Cc:Subject:Date:From;\n\tb=E4iUJafreYLVmMg01xLgN24BjTSPW4jfT0hU6visHElc5C/QQkzqlKJRm7odyEw19\n\t+IHGaWmV2xd9DT1xN/Rmozf7T+l9+nXq+zW+AdMDPa9GsZoxgV2YOX5Hue0YAiQs2W\n\t/Cnno46Ex4OK61UVtjLqmTb3tXrtXi7jrmPsw56E=","From":"Kieran Bingham ","To":"libcamera devel ","Date":"Sun, 3 May 2020 02:17:20 +0100","Message-Id":"<20200503011720.3382710-1-kieran.bingham@ideasonboard.com>","X-Mailer":"git-send-email 2.25.1","MIME-Version":"1.0","Content-Type":"text/plain; charset=UTF-8","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH] README.rst: Add FAQ section.","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","X-List-Received-Date":"Sun, 03 May 2020 01:17:25 -0000"},"content":"Provide an initial set of Questions and Answers.\n\nHopefully these will provide quick insights to the project from the\nREADME, and can be incorporated into the website.\n\nSigned-off-by: Kieran Bingham \n---\n README.rst | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++++\n 1 file changed, 65 insertions(+)","diff":"diff --git a/README.rst b/README.rst\nindex 40d45196c7d6..af44686b969c 100644\n--- a/README.rst\n+++ b/README.rst\n@@ -89,3 +89,68 @@ default video display element on your system.\n gst-launch-1.0 libcamerasrc camera-name=\"Camera 1\" ! videoconvert ! autovideosink\n \n .. section-end-getting-started\n+.. section-begin-faq\n+\n+Frequently Asked Questions\n+--------------------------\n+\n+What is libcamera?\n+ libcamera is an open source camera stack implemented entirely in user space.\n+ It aims to encourage the development of new embedded camera applications by\n+ limiting the complexity that developers have to deal with. The interface is\n+ designed around the way that modern embedded camera hardware works.\n+\n+What is the correct way to display the name 'libcamera'\n+ libcamera, is always in lowercase; in titles, or at the beginning of\n+ sentences.\n+\n+How is libcamera different from V4L2?\n+ We see libcamera as a continuation of V4L2. One that can more easily handle\n+ the recent advances in hardware design. As embedded cameras have developed,\n+ all of the complexity has been pushed on to the developers. With libcamera,\n+ all of that complexity is simplified and a single model is presented to\n+ application developers.\n+\n+Does this mean the camera stack is completely open?\n+ libcamera is open-source friendly which means all of libcamera itself is open\n+ source. Because vendors are reluctant to open-source their Image Processing\n+ Algorithms, libcamera can support closed-source Image Processing Algorithm\n+ modules (IPAs) which will be sandboxed to minimise the exposure of binary\n+ blobs.\n+\n+libcamera has been described as “the MESA of the camera stack”. What does that mean?\n+ Mesa provides powerful high-level APIs to applications and implements\n+ device-specific code in userspace to support the implementation. libcamera\n+ provides high-level APIs that handle device-specific code in userspace to\n+ simplify development for application developers.\n+\n+Which cameras SoCs (pipelines) are supported?\n+ Currently supported pipelines include the Intel IPU3, RockChip RK3399, UVC,\n+ and VIMC/VIVID test drivers\n+\n+Which camera protocols are supported?\n+ libcamera supports cameras that use MIPI/CSI2 protocols.\n+\n+Can I use libcamera to access photos on digital cameras?\n+ No, libcamera is a library for controlling embedded camera hardware, it’s not\n+ an application for accessing photos and has no relationship to gphoto2.\n+ libcamera supports internal cameras designed for point-and-shoot still image\n+ and video capture and external UVC cameras designed for video conferencing.\n+\n+Can libcamera handle multiple cameras simultaneously?\n+ libcamera can support multiple cameras within a system, and allows only a\n+ single application to consume each stream. An application must ‘acquire’ a\n+ Camera to start operations on it, and should release it when finished.\n+ Logical cameras where multiple cameras are treated as a single camera is a\n+ pipeline and hardware specific extension that will be supported in the\n+ future.\n+\n+Does libcamera do format conversion and debayering?\n+ Format conversion and debayering operations are dependent upon the Image\n+ Signal Processor (ISP) and hardware available. Our demonstration application,\n+ QCam, does basic software format conversions to handle display but we aim to\n+ move to using OpenGL to improve real time conversion performance. Where\n+ possible, QCam will request formats that can be displayed natively without\n+ requiring software conversions.\n+\n+.. section-end-faq\n","prefixes":["libcamera-devel"]}