NekoCWD/libcamera
NekoCWD/libcamera
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages 7 Wiki Activity Actions

Documentation: camera-sensor-model: Support Sphinx < 2.0

Browse source 
The language argument to the code-block directive was mandatory in
Sphinx before 2.0. Fix the few instances where no language is specified
to support older versions of Sphinx.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Reviewed-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Reviewed-by: Jacopo Mondi <jacopo.mondi@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
This commit is contained in:
Laurent Pinchart 2024-01-09 16:30:02 +02:00 • committed by Kieran Bingham
parent 0e0043053f
commit 12fb8ed5cb
1 changed files with 12 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

25
Documentation/camera-sensor-model.rst
View file

@ -105,35 +105,34 @@ control:
will be downscaled in its vertical and horizontal sizes by the specified will be downscaled in its vertical and horizontal sizes by the specified
factor. factor.
.. code-block:: .. code-block:: c
:caption: Definition: The horizontal and vertical binning factors :caption: Definition: The horizontal and vertical binning factors
horizontal_binning = xBin; horizontal_binning = xBin;
vertical_binning = yBin; vertical_binning = yBin;
- skipping - skipping
Skipping reduces the image resolution by skipping the read-out of a number Skipping reduces the image resolution by skipping the read-out of a number
of adjacent pixels. The skipping factor is specified by the 'increment' of adjacent pixels. The skipping factor is specified by the 'increment'
number (number of pixels to 'skip') in the vertical and horizontal number (number of pixels to 'skip') in the vertical and horizontal
directions and for even and odd rows and columns. directions and for even and odd rows and columns.
.. code-block:: .. code-block:: c
:caption: Definition: The horizontal and vertical skipping factors :caption: Definition: The horizontal and vertical skipping factors
horizontal_skipping = (xOddInc + xEvenInc) / 2 horizontal_skipping = (xOddInc + xEvenInc) / 2;
vertical_skipping = (yOddInc + yEvenInc) / 2 vertical_skipping = (yOddInc + yEvenInc) / 2;
Different sensors perform the binning and skipping stages in different Different sensors perform the binning and skipping stages in different
orders. For the sake of computing the final output image size the order of orders. For the sake of computing the final output image size the order of
execution is not relevant. The overall down-scaling factor is obtained by execution is not relevant. The overall down-scaling factor is obtained by
combining the binning and skipping factors. combining the binning and skipping factors.
.. code-block:: .. code-block:: c
:caption: Definition: The total scaling factor (binning + sub-sampling) :caption: Definition: The total scaling factor (binning + sub-sampling)
total_horizontal_downscale = horizontal_binning + horizontal_skipping total_horizontal_downscale = horizontal_binning + horizontal_skipping;
total_vertical_downscale = vertical_binning + vertical_skipping total_vertical_downscale = vertical_binning + vertical_skipping;
4. The output size is used to specify any additional cropping on the sub-sampled 4. The output size is used to specify any additional cropping on the sub-sampled
@ -159,16 +158,16 @@ configurations:
the *pixel rate* of the data sent on the MIPI CSI-2 bus allows to compute the the *pixel rate* of the data sent on the MIPI CSI-2 bus allows to compute the
image stream frame rate. The equation is the well known: image stream frame rate. The equation is the well known:
.. code-block:: .. code-block:: c
frame_duration = total_frame_size / pixel_rate frame_duration = total_frame_size / pixel_rate;
frame_rate = 1 / frame_duration frame_rate = 1 / frame_duration;
where the *pixel_rate* parameter is the result of the sensor's configuration where the *pixel_rate* parameter is the result of the sensor's configuration
of the MIPI CSI-2 bus *(the following formula applies to MIPI CSI-2 when of the MIPI CSI-2 bus *(the following formula applies to MIPI CSI-2 when
used on MIPI D-PHY physical protocol layer only)* used on MIPI D-PHY physical protocol layer only)*
.. code-block:: .. code-block:: c
pixel_rate = CSI-2_link_freq * 2 * nr_of_lanes / bits_per_sample pixel_rate = csi_2_link_freq * 2 * nr_of_lanes / bits_per_sample;