From patchwork Fri Dec 14 13:31:43 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 51 Return-Path: Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 5D91860B0C for ; Fri, 14 Dec 2018 14:31:00 +0100 (CET) Received: from avalon.bb.dnainternet.fi (dfj612ybrt5fhg77mgycy-3.rev.dnainternet.fi [IPv6:2001:14ba:21f5:5b00:2e86:4862:ef6a:2804]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id D2DA1549 for ; Fri, 14 Dec 2018 14:30:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1544794260; bh=sEapCMEA68TvttKuPjQzubcV5R1FAKwYZtau5NpB0es=; h=From:To:Subject:Date:From; b=r0ASOCSP7lZ6K8Y/EA6KcEjF4/dADwKvdZiwUIB0vGL21/HFlWcZkxLpc2lnCMGB7 VSz/58HLe5B5A/vyVnSjSOre54bTadmxTiRfN/89zz4AbSBNptnMKsjGuGBUr5OeyX tCMfYnAuDW2OqL2wkhu83X0/uQypJA6USdDTRlU0= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Fri, 14 Dec 2018 15:31:43 +0200 Message-Id: <20181214133143.18281-1-laurent.pinchart@ideasonboard.com> X-Mailer: git-send-email 2.19.2 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH] Documentation: Remove | on the left side of diagrams 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, 14 Dec 2018 13:31:00 -0000 There's no need to add a character on the left side of the ascii art diagrams, provided that we indent them properly. Fix it. Signed-off-by: Laurent Pinchart --- Documentation/docs.rst | 162 ++++++++++++++++++++--------------------- 1 file changed, 81 insertions(+), 81 deletions(-) diff --git a/Documentation/docs.rst b/Documentation/docs.rst index 4bbcd9aa35bf..c3e24bb9797c 100644 --- a/Documentation/docs.rst +++ b/Documentation/docs.rst @@ -150,45 +150,45 @@ Camera Stack :: - | a c / +-------------+ +-------------+ +-------------+ +-------------+ - | p a | | Native | | Framework | | Native | | Android | - | p t | | V4L2 | | Application | | libcamera | | Camera | - | l i | | Application | | (gstreamer) | | Application | | Framework | - | i o \ +-------------+ +-------------+ +-------------+ +-------------+ - | n ^ ^ ^ ^ - | | | | | - | l a | | | | - | i d v v | v - | b a / +-------------+ +-------------+ | +-------------+ - | c p | | V4L2 | | Camera | | | Android | - | a t | | Compat. | | Framework | | | Camera | - | m a | | | | (gstreamer) | | | HAL | - | e t \ +-------------+ +-------------+ | +-------------+ - | r i ^ ^ | ^ - | a o | | | | - | n | | | | - | / | ,................................................ - | | | ! : Language : ! - | l f | | ! : Bindings : ! - | i r | | ! : (optional) : ! - | b a | | \...............................................' - | c m | | | | | - | a e | | | | | - | m w | v v v v - | e o | +----------------------------------------------------------------+ - | r r | | | - | a k | | libcamera | - | | | | - | \ +----------------------------------------------------------------+ - | ^ ^ ^ - | Userspace | | | - | ------------------------ | ---------------- | ---------------- | --------------- - | Kernel | | | - | v v v - | +-----------+ +-----------+ +-----------+ - | | Media | <--> | Video | <--> | V4L2 | - | | Device | | Device | | Subdev | - | +-----------+ +-----------+ +-----------+ + a c / +-------------+ +-------------+ +-------------+ +-------------+ + p a | | Native | | Framework | | Native | | Android | + p t | | V4L2 | | Application | | libcamera | | Camera | + l i | | Application | | (gstreamer) | | Application | | Framework | + i o \ +-------------+ +-------------+ +-------------+ +-------------+ + n ^ ^ ^ ^ + | | | | + l a | | | | + i d v v | v + b a / +-------------+ +-------------+ | +-------------+ + c p | | V4L2 | | Camera | | | Android | + a t | | Compat. | | Framework | | | Camera | + m a | | | | (gstreamer) | | | HAL | + e t \ +-------------+ +-------------+ | +-------------+ + r i ^ ^ | ^ + a o | | | | + n | | | | + / | ,................................................ + | | ! : Language : ! + l f | | ! : Bindings : ! + i r | | ! : (optional) : ! + b a | | \...............................................' + c m | | | | | + a e | | | | | + m w | v v v v + e o | +----------------------------------------------------------------+ + r r | | | + a k | | libcamera | + | | | + \ +----------------------------------------------------------------+ + ^ ^ ^ + Userspace | | | + ------------------------ | ---------------- | ---------------- | --------------- + Kernel | | | + v v v + +-----------+ +-----------+ +-----------+ + | Media | <--> | Video | <--> | V4L2 | + | Device | | Device | | Subdev | + +-----------+ +-----------+ +-----------+ The camera stack comprises four software layers. From bottom to top: @@ -226,48 +226,48 @@ libcamera Architecture :: - | ---------------------------< libcamera Public API >--------------------------- - | ^ ^ - | | | - | v v - | +-------------+ +-------------------------------------------------+ - | | Camera | | Camera Device | - | | Devices | | +---------------------------------------------+ | - | | Manager | | | Device-Agnostic | | - | +-------------+ | | | | - | ^ | | +------------------------+ | - | | | | | ~~~~~~~~~~~~~~~~~~~~~ | - | | | | | { +---------------+ } | - | | | | | } | ////Image//// | { | - | | | | | <-> | /Processing// | } | - | | | | | } | /Algorithms// | { | - | | | | | { +---------------+ } | - | | | | | ~~~~~~~~~~~~~~~~~~~~~ | - | | | | | ======================== | - | | | | | +---------------+ | - | | | | | | //Pipeline/// | | - | | | | | <-> | ///Handler/// | | - | | | | | | ///////////// | | - | | | +--------------------+ +---------------+ | - | | | Device-Specific | - | | +-------------------------------------------------+ - | | ^ ^ - | | | | - | v v v - | +--------------------------------------------------------------------+ - | | Helpers and Support Classes | - | | +-------------+ +-------------+ +-------------+ +-------------+ | - | | | MC & V4L2 | | Buffers | | Sandboxing | | Plugins | | - | | | Support | | Allocator | | IPC | | Manager | | - | | +-------------+ +-------------+ +-------------+ +-------------+ | - | | +-------------+ +-------------+ | - | | | Pipeline | | ... | | - | | | Runner | | | | - | | +-------------+ +-------------+ | - | +--------------------------------------------------------------------+ - | - | /// Device-Specific Components - | ~~~ Sandboxing + ---------------------------< libcamera Public API >--------------------------- + ^ ^ + | | + v v + +-------------+ +-------------------------------------------------+ + | Camera | | Camera Device | + | Devices | | +---------------------------------------------+ | + | Manager | | | Device-Agnostic | | + +-------------+ | | | | + ^ | | +------------------------+ | + | | | | ~~~~~~~~~~~~~~~~~~~~~ | + | | | | { +---------------+ } | + | | | | } | ////Image//// | { | + | | | | <-> | /Processing// | } | + | | | | } | /Algorithms// | { | + | | | | { +---------------+ } | + | | | | ~~~~~~~~~~~~~~~~~~~~~ | + | | | | ======================== | + | | | | +---------------+ | + | | | | | //Pipeline/// | | + | | | | <-> | ///Handler/// | | + | | | | | ///////////// | | + | | +--------------------+ +---------------+ | + | | Device-Specific | + | +-------------------------------------------------+ + | ^ ^ + | | | + v v v + +--------------------------------------------------------------------+ + | Helpers and Support Classes | + | +-------------+ +-------------+ +-------------+ +-------------+ | + | | MC & V4L2 | | Buffers | | Sandboxing | | Plugins | | + | | Support | | Allocator | | IPC | | Manager | | + | +-------------+ +-------------+ +-------------+ +-------------+ | + | +-------------+ +-------------+ | + | | Pipeline | | ... | | + | | Runner | | | | + | +-------------+ +-------------+ | + +--------------------------------------------------------------------+ + + /// Device-Specific Components + ~~~ Sandboxing While offering a unified API towards upper layers, and presenting itself as a single library, libcamera isn't monolithic. It exposes