From: Mauro Carvalho Chehab Date: Sun, 17 Jul 2016 22:43:22 +0000 (-0300) Subject: [media] doc-rst: add sh_mobile_ceu_camera crop documentation X-Git-Tag: v4.8-rc1~131^2^2~70 X-Git-Url: https://git.karo-electronics.de/?a=commitdiff_plain;h=9cbfcd7cf230393d12a587fdad11c60de5c1f7be;p=karo-tx-linux.git [media] doc-rst: add sh_mobile_ceu_camera crop documentation Convert it to ReST and add it to media/v4l-drivers book. Signed-off-by: Mauro Carvalho Chehab --- diff --git a/Documentation/media/v4l-drivers/index.rst b/Documentation/media/v4l-drivers/index.rst index f761627d3fa1..64556192f12a 100644 --- a/Documentation/media/v4l-drivers/index.rst +++ b/Documentation/media/v4l-drivers/index.rst @@ -34,4 +34,5 @@ License". pxa_camera radiotrack saa7134 + sh_mobile_ceu_camera zr364xx diff --git a/Documentation/media/v4l-drivers/sh_mobile_ceu_camera.rst b/Documentation/media/v4l-drivers/sh_mobile_ceu_camera.rst index 1e96ce6e2d2f..e40ffea7708c 100644 --- a/Documentation/media/v4l-drivers/sh_mobile_ceu_camera.rst +++ b/Documentation/media/v4l-drivers/sh_mobile_ceu_camera.rst @@ -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 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