The capabilities for the imaging service is returned in the Capabilities element. Indicates whether or not Image Stabilization feature is supported. Indicates whether or not Imaging Presets feature is supported. Reference token to the VideoSource for which the ImagingSettings. ImagingSettings for the VideoSource that was requested. Reference token to the VideoSource for which the imaging parameter options are requested. Valid ranges for the imaging parameters that are categorized as device specific. Reference to the VideoSource for the requested move (focus) operation. Content of the requested move (focus) operation. Reference token to the VideoSource for the requested move options. Valid ranges for the focus lens move options. Reference token to the VideoSource where the focus movement should be stopped. Reference token to the VideoSource where the imaging status should be requested. Requested imaging status. Describes standard Imaging Preset types, used to facilitate Multi-language support and client display. "Custom" Type shall be used when Imaging Preset Name does not match any of the types included in the standard classification. Type describing the Imaging Preset settings. Human readable name of the Imaging Preset. Unique identifier of this Imaging Preset. Indicates Imaging Preset Type. Use timg:ImagingPresetType. Used for multi-language support and display. A reference to the VideoSource where the operation should take place. List of Imaging Presets which are available for the requested VideoSource. Reference token to the VideoSource where the current Imaging Preset should be requested. Current Imaging Preset in use for the specified Video Source. Reference token to the VideoSource to which the specified Imaging Preset should be applied. Reference token to the Imaging Preset to be applied to the specified Video Source. Returns the capabilities of the imaging service. The result is returned in a typed answer. Get the ImagingConfiguration for the requested VideoSource. Set the ImagingConfiguration for the requested VideoSource. This operation gets the valid ranges for the imaging parameters that have device specific ranges. This command is mandatory for all device implementing the imaging service. The command returns all supported parameters and their ranges such that these can be applied to the SetImagingSettings command.
For read-only parameters which cannot be modified via the SetImagingSettings command only a single option or identical Min and Max values is provided. The Move command moves the focus lens in an absolute, a relative or in a continuous manner from its current position. The speed argument is optional for absolute and relative control, but required for continuous. If no speed argument is used, the default speed is used. Focus adjustments through this operation will turn off the autofocus. A device with support for remote focus control should support absolute, relative or continuous control through the Move operation. The supported MoveOpions are signalled via the GetMoveOptions command. At least one focus control capability is required for this operation to be functional.
The move operation contains the following commands:
Absolute – Requires position parameter and optionally takes a speed argument. A unitless type is used by default for focus positioning and speed. Optionally, if supported, the position may be requested in m-1 units.
Relative – Requires distance parameter and optionally takes a speed argument. Negative distance means negative direction. Continuous – Requires a speed argument. Negative speed argument means negative direction. Imaging move operation options supported for the Video source. The Stop command stops all ongoing focus movements of the lense. A device with support for remote focus control as signalled via the GetMoveOptions supports this command.
The operation will not affect ongoing autofocus operation. Via this command the current status of the Move operation can be requested. Supported for this command is available if the support for the Move operation is signalled via GetMoveOptions. Via this command the list of available Imaging Presets can be requested. Via this command the last Imaging Preset applied can be requested. If the camera configuration does not match any of the existing Imaging Presets, the output of GetCurrentPreset shall be Empty. GetCurrentPreset shall return 0 if Imaging Presets are not supported by the Video Source. The SetCurrentPreset command shall request a given Imaging Preset to be applied to the specified Video Source. SetCurrentPreset shall only be available for Video Sources with Imaging Presets Capability. Imaging Presets are defined by the Manufacturer, and offered as a tool to simplify Imaging Settings adjustments for specific scene content. When the new Imaging Preset is applied by SetCurrentPreset, the Device shall adjust the Video Source settings to match those defined by the specified Imaging Preset.