aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/DocBook/media/v4l
diff options
context:
space:
mode:
authorSakari Ailus <sakari.ailus@iki.fi>2012-05-17 16:50:45 -0400
committerMauro Carvalho Chehab <mchehab@redhat.com>2012-07-06 19:14:39 -0400
commit1ec0ed083988ae433305d7f4158fda8c3a1a23b9 (patch)
treeaad35d1ee8bed6a1851fdffa7a4ffd9570f17787 /Documentation/DocBook/media/v4l
parentc133482300113b3b71fa4a1fd2118531e765b36a (diff)
[media] v4l: Remove "_ACTUAL" from subdev selection API target definition names
The string "_ACTUAL" does not say anything more about the target names. Drop it. V4L2 selection API was changed by "V4L: Remove "_ACTIVE" from the selection target name definitions" by Sylwester Nawrocki. This patch does the same for the V4L2 subdev API. Signed-off-by: Sakari Ailus <sakari.ailus@iki.fi> Acked-by: Sylwester Nawrocki <s.nawrocki@samsung.com> Signed-off-by: Mauro Carvalho Chehab <mchehab@redhat.com>
Diffstat (limited to 'Documentation/DocBook/media/v4l')
-rw-r--r--Documentation/DocBook/media/v4l/dev-subdev.xml28
-rw-r--r--Documentation/DocBook/media/v4l/vidioc-subdev-g-selection.xml12
2 files changed, 20 insertions, 20 deletions
diff --git a/Documentation/DocBook/media/v4l/dev-subdev.xml b/Documentation/DocBook/media/v4l/dev-subdev.xml
index 4afcbbec5eda..e88d5ea8f826 100644
--- a/Documentation/DocBook/media/v4l/dev-subdev.xml
+++ b/Documentation/DocBook/media/v4l/dev-subdev.xml
@@ -289,9 +289,9 @@
289 &v4l2-rect; by the coordinates of the top left corner and the rectangle 289 &v4l2-rect; by the coordinates of the top left corner and the rectangle
290 size. Both the coordinates and sizes are expressed in pixels.</para> 290 size. Both the coordinates and sizes are expressed in pixels.</para>
291 291
292 <para>As for pad formats, drivers store try and active 292 <para>As for pad formats, drivers store try and active rectangles for
293 rectangles for the selection targets of ACTUAL type <xref 293 the selection targets <xref
294 linkend="v4l2-subdev-selection-targets">.</xref></para> 294 linkend="v4l2-subdev-selection-targets" />.</para>
295 295
296 <para>On sink pads, cropping is applied relative to the 296 <para>On sink pads, cropping is applied relative to the
297 current pad format. The pad format represents the image size as 297 current pad format. The pad format represents the image size as
@@ -308,7 +308,7 @@
308 <para>Scaling support is optional. When supported by a subdev, 308 <para>Scaling support is optional. When supported by a subdev,
309 the crop rectangle on the subdev's sink pad is scaled to the 309 the crop rectangle on the subdev's sink pad is scaled to the
310 size configured using the &VIDIOC-SUBDEV-S-SELECTION; IOCTL 310 size configured using the &VIDIOC-SUBDEV-S-SELECTION; IOCTL
311 using <constant>V4L2_SUBDEV_SEL_COMPOSE_ACTUAL</constant> 311 using <constant>V4L2_SUBDEV_SEL_TGT_COMPOSE</constant>
312 selection target on the same pad. If the subdev supports scaling 312 selection target on the same pad. If the subdev supports scaling
313 but not composing, the top and left values are not used and must 313 but not composing, the top and left values are not used and must
314 always be set to zero.</para> 314 always be set to zero.</para>
@@ -333,22 +333,22 @@
333 <title>Types of selection targets</title> 333 <title>Types of selection targets</title>
334 334
335 <section> 335 <section>
336 <title>ACTUAL targets</title> 336 <title>Actual targets</title>
337 337
338 <para>ACTUAL targets reflect the actual hardware configuration 338 <para>Actual targets (without a postfix) reflect the actual
339 at any point of time. There is a BOUNDS target 339 hardware configuration at any point of time. There is a BOUNDS
340 corresponding to every ACTUAL.</para> 340 target corresponding to every actual target.</para>
341 </section> 341 </section>
342 342
343 <section> 343 <section>
344 <title>BOUNDS targets</title> 344 <title>BOUNDS targets</title>
345 345
346 <para>BOUNDS targets is the smallest rectangle that contains 346 <para>BOUNDS targets is the smallest rectangle that contains all
347 all valid ACTUAL rectangles. It may not be possible to set the 347 valid actual rectangles. It may not be possible to set the actual
348 ACTUAL rectangle as large as the BOUNDS rectangle, however. 348 rectangle as large as the BOUNDS rectangle, however. This may be
349 This may be because e.g. a sensor's pixel array is not 349 because e.g. a sensor's pixel array is not rectangular but
350 rectangular but cross-shaped or round. The maximum size may 350 cross-shaped or round. The maximum size may also be smaller than the
351 also be smaller than the BOUNDS rectangle.</para> 351 BOUNDS rectangle.</para>
352 </section> 352 </section>
353 353
354 </section> 354 </section>
diff --git a/Documentation/DocBook/media/v4l/vidioc-subdev-g-selection.xml b/Documentation/DocBook/media/v4l/vidioc-subdev-g-selection.xml
index 208e9f0da3f3..4c44808ab25c 100644
--- a/Documentation/DocBook/media/v4l/vidioc-subdev-g-selection.xml
+++ b/Documentation/DocBook/media/v4l/vidioc-subdev-g-selection.xml
@@ -72,10 +72,10 @@
72 <section> 72 <section>
73 <title>Types of selection targets</title> 73 <title>Types of selection targets</title>
74 74
75 <para>There are two types of selection targets: actual and bounds. 75 <para>There are two types of selection targets: actual and bounds. The
76 The ACTUAL targets are the targets which configure the hardware. 76 actual targets are the targets which configure the hardware. The BOUNDS
77 The BOUNDS target will return a rectangle that contain all 77 target will return a rectangle that contain all possible actual
78 possible ACTUAL rectangles.</para> 78 rectangles.</para>
79 </section> 79 </section>
80 80
81 <section> 81 <section>
@@ -93,7 +93,7 @@
93 &cs-def; 93 &cs-def;
94 <tbody valign="top"> 94 <tbody valign="top">
95 <row> 95 <row>
96 <entry><constant>V4L2_SUBDEV_SEL_TGT_CROP_ACTUAL</constant></entry> 96 <entry><constant>V4L2_SUBDEV_SEL_TGT_CROP</constant></entry>
97 <entry>0x0000</entry> 97 <entry>0x0000</entry>
98 <entry>Actual crop. Defines the cropping 98 <entry>Actual crop. Defines the cropping
99 performed by the processing step.</entry> 99 performed by the processing step.</entry>
@@ -104,7 +104,7 @@
104 <entry>Bounds of the crop rectangle.</entry> 104 <entry>Bounds of the crop rectangle.</entry>
105 </row> 105 </row>
106 <row> 106 <row>
107 <entry><constant>V4L2_SUBDEV_SEL_TGT_COMPOSE_ACTUAL</constant></entry> 107 <entry><constant>V4L2_SUBDEV_SEL_TGT_COMPOSE</constant></entry>
108 <entry>0x0100</entry> 108 <entry>0x0100</entry>
109 <entry>Actual compose rectangle. Used to configure scaling 109 <entry>Actual compose rectangle. Used to configure scaling
110 on sink pads and composition on source pads.</entry> 110 on sink pads and composition on source pads.</entry>