summaryrefslogtreecommitdiff
path: root/Documentation/camera-sensor-model.rst
diff options
context:
space:
mode:
authorLaurent Pinchart <laurent.pinchart@ideasonboard.com>2024-01-09 16:30:02 +0200
committerKieran Bingham <kieran.bingham@ideasonboard.com>2024-01-09 15:35:06 +0000
commit12fb8ed5cbcd064de860928ede30abc9273fb743 (patch)
tree3b456aed3540a6e592ba80a186ff443964ec8e11 /Documentation/camera-sensor-model.rst
parent0e0043053fb2ced0f7e271df04256091642ea6e6 (diff)
Documentation: camera-sensor-model: Support Sphinx < 2.0
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>
Diffstat (limited to 'Documentation/camera-sensor-model.rst')
-rw-r--r--Documentation/camera-sensor-model.rst25
1 files changed, 12 insertions, 13 deletions
diff --git a/Documentation/camera-sensor-model.rst b/Documentation/camera-sensor-model.rst
index 58bf70e1..b66c880a 100644
--- a/Documentation/camera-sensor-model.rst
+++ b/Documentation/camera-sensor-model.rst
@@ -105,35 +105,34 @@ control:
will be downscaled in its vertical and horizontal sizes by the specified
factor.
- .. code-block::
+ .. code-block:: c
:caption: Definition: The horizontal and vertical binning factors
horizontal_binning = xBin;
vertical_binning = yBin;
-
- skipping
Skipping reduces the image resolution by skipping the read-out of a number
of adjacent pixels. The skipping factor is specified by the 'increment'
number (number of pixels to 'skip') in the vertical and horizontal
directions and for even and odd rows and columns.
- .. code-block::
+ .. code-block:: c
:caption: Definition: The horizontal and vertical skipping factors
- horizontal_skipping = (xOddInc + xEvenInc) / 2
- vertical_skipping = (yOddInc + yEvenInc) / 2
+ horizontal_skipping = (xOddInc + xEvenInc) / 2;
+ vertical_skipping = (yOddInc + yEvenInc) / 2;
Different sensors perform the binning and skipping stages in different
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
combining the binning and skipping factors.
- .. code-block::
+ .. code-block:: c
:caption: Definition: The total scaling factor (binning + sub-sampling)
- total_horizontal_downscale = horizontal_binning + horizontal_skipping
- total_vertical_downscale = vertical_binning + vertical_skipping
+ total_horizontal_downscale = horizontal_binning + horizontal_skipping;
+ total_vertical_downscale = vertical_binning + vertical_skipping;
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
image stream frame rate. The equation is the well known:
- .. code-block::
+ .. code-block:: c
- frame_duration = total_frame_size / pixel_rate
- frame_rate = 1 / frame_duration
+ frame_duration = total_frame_size / pixel_rate;
+ frame_rate = 1 / frame_duration;
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
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;