[media] doc-rst: add sh_mobile_ceu_camera crop documentation
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Sun, 17 Jul 2016 22:43:22 +0000 (19:43 -0300)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Mon, 18 Jul 2016 01:51:14 +0000 (22:51 -0300)
Convert it to ReST and add it to media/v4l-drivers book.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Documentation/media/v4l-drivers/index.rst
Documentation/media/v4l-drivers/sh_mobile_ceu_camera.rst

index f761627d3fa12ad44fa94908b3c07ada6d9bb791..64556192f12aff2b96ecc34311b5ce51a4b8f9a1 100644 (file)
@@ -34,4 +34,5 @@ License".
        pxa_camera
        radiotrack
        saa7134
+       sh_mobile_ceu_camera
        zr364xx
index 1e96ce6e2d2f9d39705c8a79e60b95bcc6cc9082..e40ffea7708c8b8497d2fa85e6050843ee7e4e87 100644 (file)
@@ -1,5 +1,7 @@
-       Cropping and Scaling algorithm, used in the sh_mobile_ceu_camera driver
-       =======================================================================
+Cropping and Scaling algorithm, used in the sh_mobile_ceu_camera driver
+=======================================================================
+
+Author: Guennadi Liakhovetski <g.liakhovetski@gmx.de>
 
 Terminology
 -----------
@@ -12,29 +14,31 @@ combined scales: sensor_scale * host_scale
 Generic scaling / cropping scheme
 ---------------------------------
 
--1--
-|
--2-- -\
-|      --\
-|         --\
-+-5-- .      -- -3-- -\
-|      `...            -\
-|          `... -4-- .   - -7..
-|                     `.
-|                       `. .6--
-|
-|                        . .6'-
-|                      .´
-|           ... -4'- .´
-|       ...´             - -7'.
-+-5'- .´               -/
-|            -- -3'- -/
-|         --/
-|      --/
--2'- -/
-|
-|
--1'-
+.. code-block:: none
+
+       -1--
+       |
+       -2-- -\
+       |      --\
+       |         --\
+       +-5-- .      -- -3-- -\
+       |      `...            -\
+       |          `... -4-- .   - -7..
+       |                     `.
+       |                       `. .6--
+       |
+       |                        . .6'-
+       |                      .´
+       |           ... -4'- .´
+       |       ...´             - -7'.
+       +-5'- .´               -/
+       |            -- -3'- -/
+       |         --/
+       |      --/
+       -2'- -/
+       |
+       |
+       -1'-
 
 In the above chart minuses and slashes represent "real" data amounts, points and
 accents represent "useful" data, basically, CEU scaled and cropped output,
@@ -134,6 +138,3 @@ Cropping is performed in the following 6 steps:
 5. Calculate and apply host scale = (6' - 6) / (4' - 4)
 
 6. Calculate and apply host crop: 6 - 7 = (5 - 2) * (6' - 6) / (5' - 5)
-
---
-Author: Guennadi Liakhovetski <g.liakhovetski@gmx.de>