| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 1 | .. -*- coding: utf-8; mode: rst -*- |
| 2 | |
| 3 | .. _v4l2-selection-flags: |
| 4 | |
| 5 | *************** |
| 6 | Selection flags |
| 7 | *************** |
| 8 | |
| 9 | |
| 10 | .. _v4l2-selection-flags-table: |
| 11 | |
| 12 | .. flat-table:: Selection flag definitions |
| 13 | :header-rows: 1 |
| 14 | :stub-columns: 0 |
| 15 | |
| 16 | |
| 17 | - .. row 1 |
| 18 | |
| 19 | - Flag name |
| 20 | |
| 21 | - id |
| 22 | |
| 23 | - Definition |
| 24 | |
| 25 | - Valid for V4L2 |
| 26 | |
| 27 | - Valid for V4L2 subdev |
| 28 | |
| 29 | - .. row 2 |
| 30 | |
| 31 | - ``V4L2_SEL_FLAG_GE`` |
| 32 | |
| 33 | - (1 << 0) |
| 34 | |
| 35 | - Suggest the driver it should choose greater or equal rectangle (in |
| Mauro Carvalho Chehab | 0579e6e | 2016-07-04 16:25:48 -0300 | [diff] [blame] | 36 | size) than was requested. Albeit the driver may choose a lesser |
| 37 | size, it will only do so due to hardware limitations. Without this |
| 38 | flag (and ``V4L2_SEL_FLAG_LE``) the behaviour is to choose the |
| 39 | closest possible rectangle. |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 40 | |
| 41 | - Yes |
| 42 | |
| 43 | - Yes |
| 44 | |
| 45 | - .. row 3 |
| 46 | |
| 47 | - ``V4L2_SEL_FLAG_LE`` |
| 48 | |
| 49 | - (1 << 1) |
| 50 | |
| 51 | - Suggest the driver it should choose lesser or equal rectangle (in |
| Mauro Carvalho Chehab | 0579e6e | 2016-07-04 16:25:48 -0300 | [diff] [blame] | 52 | size) than was requested. Albeit the driver may choose a greater |
| 53 | size, it will only do so due to hardware limitations. |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 54 | |
| 55 | - Yes |
| 56 | |
| 57 | - Yes |
| 58 | |
| 59 | - .. row 4 |
| 60 | |
| 61 | - ``V4L2_SEL_FLAG_KEEP_CONFIG`` |
| 62 | |
| 63 | - (1 << 2) |
| 64 | |
| 65 | - The configuration must not be propagated to any further processing |
| Mauro Carvalho Chehab | 0579e6e | 2016-07-04 16:25:48 -0300 | [diff] [blame] | 66 | steps. If this flag is not given, the configuration is propagated |
| 67 | inside the subdevice to all further processing steps. |
| Markus Heiser | 5377d91 | 2016-06-30 15:18:56 +0200 | [diff] [blame] | 68 | |
| 69 | - No |
| 70 | |
| 71 | - Yes |