From patchwork Fri Dec 19 19:06:31 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Walter Werner Schneider X-Patchwork-Id: 25615 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 1C475C326C for ; Fri, 19 Dec 2025 19:23:45 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 7296061F9C; Fri, 19 Dec 2025 20:23:42 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (2048-bit key; unprotected) header.d=schnwalter.eu header.i=@schnwalter.eu header.b="MYqmmvVj"; dkim=pass (2048-bit key; unprotected) header.d=messagingengine.com header.i=@messagingengine.com header.b="Yo/713wE"; dkim-atps=neutral Received: from fhigh-b5-smtp.messagingengine.com (fhigh-b5-smtp.messagingengine.com [202.12.124.156]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id B019F61F85 for ; Fri, 19 Dec 2025 20:06:50 +0100 (CET) Received: from phl-compute-11.internal (phl-compute-11.internal [10.202.2.51]) by mailfhigh.stl.internal (Postfix) with ESMTP id C3C187A0069; Fri, 19 Dec 2025 14:06:49 -0500 (EST) Received: from phl-frontend-03 ([10.202.2.162]) by phl-compute-11.internal (MEProxy); Fri, 19 Dec 2025 14:06:49 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=schnwalter.eu; h=cc:cc:content-transfer-encoding:content-type:content-type :date:date:from:from:in-reply-to:in-reply-to:message-id :mime-version:references:reply-to:subject:subject:to:to; s=fm2; t=1766171209; x=1766257609; bh=Mq2NxLc729gYKc8CuFQimCXWuOnxfNJ+ uCujrakEu7o=; b=MYqmmvVjZmX7IJRCUiiBMCRH+L9IwxvQxiPN8/IcTJ4BAMs0 reGiI87Ar7d0eV9DH6f3wnKhrh5aDbC6dmiAdJKQn37Wnboe0YDUN+24BUmIkE20 cxiOltr9Npx7nvvwIK/BuudQBeLWrifyjkgWQpt/hRQ3cFh6/3laYBmgjXvNz1ef cK7ptxlarIwwIJk1jE2dnqZtBNijT8M9MD6/BMimLjtOlyP99qWWZerLxNXQ+gPo zlSXhBR3cgz9iUZTD2T9sB04DeCsJnc0TtNYTNJ5/Rhz8YlSlFUiBtNG1Ld19zV6 9H2dz5CMZ5aFmJuHfoL/YxJ731ObKtEq+6gJBA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1766171209; x= 1766257609; bh=Mq2NxLc729gYKc8CuFQimCXWuOnxfNJ+uCujrakEu7o=; b=Y o/713wEh3HGFCVmMS5/E8xDBWXqTp/NpDxW97W3QEvp1rVESDFwrnB0Rz5LKLmoY daIoWE6zYZ6ahXEVX4rM90xIjrCgxYXBgWcLDTIPhJGF9VKCgL+o+9kyoPE9NegQ 2U1Wdm8KOpkPdJ3AgSAv6T/SELOW4aquSmfEyreHbVDRfyCjpkKsfkrEpwiPBKDF DZK4AznqoFbuuzZONXywV43hGa8jKcr5toE8aE+YOPEiID/919MLuMXeZzPzHBvE M1Ck2DQ/lGyBDcyLWOD4RrmA+xacK3u8SiwEWk+Bdt2REYZOcFmldrym15Ej1Mcg EXT2Ekmk7T3otEuIrt91Q== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefgedrtddtgdegledutdcutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpuffrtefokffrpgfnqfghnecuuegr ihhlohhuthemuceftddtnecunecujfgurhephfffufggtgfgkfhfjgfvvefosehtjeertd ertdejnecuhfhrohhmpeghrghlthgvrhcuhggvrhhnvghrucfutghhnhgvihguvghruceo tghonhhtrggtthesshgthhhnfigrlhhtvghrrdgvuheqnecuggftrfgrthhtvghrnhepve duteehgfdtfeevuedvgeeuffekieeuhfduudfffffgieffffduhfdvleehkeevnecuffho mhgrihhnpehlihhnuhigthhvrdhorhhgnecuvehluhhsthgvrhfuihiivgeptdenucfrrg hrrghmpehmrghilhhfrhhomheptghonhhtrggtthesshgthhhnfigrlhhtvghrrdgvuhdp nhgspghrtghpthhtohepvddpmhhouggvpehsmhhtphhouhhtpdhrtghpthhtoheplhhisg gtrghmvghrrgdquggvvhgvlheslhhishhtshdrlhhisggtrghmvghrrgdrohhrghdprhgt phhtthhopegtohhnthgrtghtsehstghhnhifrghlthgvrhdrvghu X-ME-Proxy: Feedback-ID: i455149b6:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Fri, 19 Dec 2025 14:06:48 -0500 (EST) From: Walter Werner Schneider Date: Fri, 19 Dec 2025 21:06:31 +0200 Subject: [PATCH 2/2] Documentation: Link to glossary terms from the introduction page MIME-Version: 1.0 Message-Id: <20251219-glossary-page-v1-2-971ba0ab4b2f@schnwalter.eu> References: <20251219-glossary-page-v1-0-971ba0ab4b2f@schnwalter.eu> In-Reply-To: <20251219-glossary-page-v1-0-971ba0ab4b2f@schnwalter.eu> To: libcamera-devel@lists.libcamera.org Cc: Walter Werner Schneider X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1766171205; l=2209; i=contact@schnwalter.eu; s=20251106; h=from:subject:message-id; bh=4Dnwsd7IeyMF8wwUsQPS7Lzy4QiZHBp4nMi9+ArbHXs=; b=CGicZr+aVITjiAEXhwZLcCiF0RKHn0q3HpdNM2NFi0pgkK/YgpjFtLyGOmAVn/AkwKyaPBElp 61USiePgDjCCxnJw8jCugzUBhxnbQ5hiasNsGz3a+r3LYylHWRYm8UB X-Developer-Key: i=contact@schnwalter.eu; a=ed25519; pk=OoafUGtB7zQJLYhKA7ALCjqddXAaem/uP/eb3GGNkTI= X-Mailman-Approved-At: Fri, 19 Dec 2025 20:23:39 +0100 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" Signed-off-by: Walter Werner Schneider --- Documentation/introduction.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/introduction.rst b/Documentation/introduction.rst index 07b3a27ed007b7ed700774107f2d7e6059c6fb21..190b4229da86d66bbf61e73477f2610dc661553b 100644 --- a/Documentation/introduction.rst +++ b/Documentation/introduction.rst @@ -29,8 +29,8 @@ interface to interact and control media devices. .. _Video for Linux 2: https://www.linuxtv.org/downloads/v4l-dvb-apis-new/userspace-api/v4l/v4l2.html .. _Media Controller: https://www.linuxtv.org/downloads/v4l-dvb-apis-new/userspace-api/mediactl/media-controller.html -Included in this subsystem are drivers for camera sensors, CSI2 (Camera -Serial Interface) receivers, and ISPs (Image Signal Processors). +Included in this subsystem are camera sensors, :term:`CSI-2` receivers, and +:term:`ISP` drivers. The usage of these drivers to provide a functioning camera stack is a responsibility that lies in userspace, and is commonly implemented separately @@ -67,7 +67,7 @@ The library handles the rest for you. These documentary pages give more information on the internal workings of libcamera (and the kernel camera stack that lies behind it) as well as guidance on using libcamera in an application or extending the library with support for your hardware (through the pipeline -handler and IPA module writer's guides). +handler and :term:`IPA` module writer's guides). How should I use it? ==================== @@ -153,8 +153,8 @@ The camera stack comprises four software layers. From bottom to top: * The libcamera adaptation is an umbrella term designating the components that interface to libcamera in other frameworks. Notable examples are a V4L2 compatibility layer, a gstreamer - libcamera element, and an Android camera HAL implementation based - on libcamera. + libcamera element, and an Android camera :term:`HAL` implementation + based on libcamera. Those components can live in the libcamera project source code in separate repositories, or move to their respective project's