Skip to content

Commit 93657af

Browse files
authored
Add inverted cam mode doc
1 parent 42858d9 commit 93657af

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

en/services/camera_def.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,7 @@ CAM_EV | Exposure Compensation (usually only used for automatic exposure modes.)
9797
CAM_EXPMODE | Exposure Mode (Manual, Auto, Program Auto, Aperture Priority, etc.)
9898
CAM_ISO | ISO
9999
CAM_METERING | Metering Mode
100-
CAM_MODE | Camera Mode. Invariably, when switching modes, some of the camera parameters that are available for one mode is not available for the other. Video mode may offer video recording resolutions while photo mode may offer image capture size, format, compression, etc. If you simply use the MAVLink command [MAV_CMD_SET_CAMERA_MODE](../messages/common.md#MAV_CMD_SET_CAMERA_MODE), you won't have a chance to let the GCS know that. If your camera does have different parameters and/or options for [CAMERA_MODE_IMAGE](../messages/common.md#CAMERA_MODE) or [CAMERA_MODE_VIDEO](../messages/common.md#CAMERA_MODE), you may want to use this parameter (along with the proper exclusion rules) instead. The CGS will look to see if this parameter is exposed. If it is, it will use it instead of [MAV_CMD_SET_CAMERA_MODE](../messages/common.md#MAV_CMD_SET_CAMERA_MODE). If the parameter is not exposed, [MAV_CMD_SET_CAMERA_MODE](../messages/common.md#MAV_CMD_SET_CAMERA_MODE) will be used instead. See an example of a definition of `CAM_MODE` below.
100+
CAM_MODE | Camera Mode. This parameter is used to change the camera mode (via [PARAM_EXT_SET](../messages/common.md#PARAM_EXT_SET)) for cameras that support different settings/options (ISO, video/image resolution, frame rates, encoding format, etc.) for image and video capture [camera modes](../messages/common.md#CAMERA_MODE).<br><br>If it is not defined then [MAV_CMD_SET_CAMERA_MODE](../messages/common.md#MAV_CMD_SET_CAMERA_MODE) can be used to set the mode instead (this command is ignored if `CAM_MODE` is defined), and any configuration settings/options will be common to all modes.<br><br>There is an example `CAM_MODE` definition with additional detail [below](#cam_mode_example).
101101
CAM_SHUTTERSPD | Shutter speed
102102
CAM_VIDRES | Video Resolution (for video capture)
103103
CAM_WBMODE | White Balance Mode
@@ -159,7 +159,7 @@ There are cases where an option change requires a parameter to be updated. For e
159159

160160
This tells the GCS that when the `CAM_EXPMODE` parameter changes, the `CAM_APERTURE`, `CAM_SHUTTERSPD` and the `CAM_ISO` parameters must be updated (requested from the camera).
161161

162-
#### Range Limit
162+
#### Mode-Specific Range Limit {#cam_mode_example}
163163

164164
Suppose your camera has the following ISO options:
165165

@@ -210,7 +210,9 @@ But this full range is only available when in *Photo Mode*. For whatever reason,
210210

211211
This indicates to the GCS that when the `CAM_MODE` parameter is set to *Video*, only the given range for the `CAM_ISO` parameter is valid. It additionally gives a condition that this is only the case when the `CAM_EXPOSURE` mode is set to *Manual* (1).
212212

213-
This example also tells the GCS not to display this parameter to the user (`control=“0”`). Camera Mode is a standard parameter defined in the [CAMERA\_INFORMATION](../messages/common.md#CAMERA_INFORMATION) message and it’s handled by the GCS in that way. The parameter definition above was created in order to tell the GCS the rules that are applied when changes to the camera mode occur.
213+
This example also tells the GCS not to display this parameter to the user (`control=“0”`).
214+
Camera Mode is a standard parameter defined in the [CAMERA\_INFORMATION](../messages/common.md#CAMERA_INFORMATION) message and it’s handled by the GCS in that way.
215+
The parameter definition above was created in order to tell the GCS the rules that are applied when changes to the camera mode occur.
214216

215217
### Localization
216218

0 commit comments

Comments
 (0)