Still Image Properties
.gif)
| Previous | Next |
Still Image Properties
Windows Portable Devices supports the following still-image properties.
| Property | VarType | Description |
| WPD_STILL_IMAGE_ARTIST | VT_LPWSTR | The name of the owner/user of the device. |
| WPD_STILL_IMAGE_BURST_INTERVAL | VT_UI4 | In a burst-mode image capture, the time delay between image captures, in milliseconds. |
| WPD_STILL_IMAGE_BURST_NUMBER | VT_UI4 | In a burst-mode image capture, the number of images to capture. |
| WPD_STILL_IMAGE_CAPTURE_DELAY | VT_UI4 | Specifies the time delay between the command to capture an image and the actual capture, in milliseconds. |
| WPD_STILL_IMAGE_CAPTURE_FORMAT | VT_CLSID | The format to use to capture the image. This is one of the format GUID values that is defined by Windows Portable Devices. |
| WPD_STILL_IMAGE_CAPTURE_MODE | VT_UI4 | A WPD_CAPTURE_MODES enumerator that specifies the capture mode to use to capture an image. |
| WPD_STILL_IMAGE_CAPTURE_RESOLUTION | VT_LPWSTR | A string that specifies the image size to capture. The image size is specified in pixels, in the format "widthxheight". For example: "800x600". |
| WPD_STILL_IMAGE_COMPRESSION_SETTING | VT_UI8 | Describes the image compression settings that are used when capturing an image. This is device-specific. |
| WPD_STILL_IMAGE_CONTRAST | VT_UI4 | A number that specifies the contrast setting to apply when capturing an image, with zero being the least contrast and larger numbers indicating greater contrast. |
| WPD_STILL_IMAGE_DIGITAL_ZOOM | VT_UI4 | A number that specifies the amount of digital zoom to use when capturing an image. The number is 1 or higher, scaled by a factor of 10. A value of 1 (representing 10) indicates no digital zoom; a value of 2 (representing 20) indicates a 2x zoom (1/4 of the image seen by a 1x zoom will be captured). |
| WPD_STILL_IMAGE_EFFECT_MODE | VT_UI4 | A WPD_EFFECT_MODES enumerator that specifies an image effect to use when capturing an image. |
| WPD_STILL_IMAGE_EXPOSURE_BIAS_COMPENSATION | VT_I4 | A number that specifies the APEX units to adjust the exposure. Units are stops x 1,000. Specifying zero indicates the factory default. |
| WPD_STILL_IMAGE_EXPOSURE_INDEX | VT_UI4 | A number that specifies the ISO film speed to emulate when capturing an image. A value of 0xFFFF indicates that this value should be set automatically. |
| WPD_STILL_IMAGE_EXPOSURE_METERING_MODE | VT_UI4 | A WPD_EXPOSURE_METERING_MODES enumerator that specifies the metering mode to use when capturing an image. |
| WPD_STILL_IMAGE_EXPOSURE_PROGRAM_MODE | VT_UI4 | A WPD_EXPOSURE_PROGRAM_MODES enumerator that specifies the exposure program to use when capturing an image. |
| WPD_STILL_IMAGE_EXPOSURE_TIME | VT_UI4 | The shutter speed to use when capturing an image, in seconds x 10,000. |
| WPD_STILL_IMAGE_FLASH_MODE | VT_UI4 | A WPD_FLASH_MODES enumerator that specifies the flash mode to use when capturing an image. |
| WPD_STILL_IMAGE_FNUMBER | VT_UI4 | A number that specifies the aperture of the lens when capturing an image. The number is the f-stop number 100 (so 14 would indicate f/1.4).
This property is typically only valid when WPD_STILL_IMAGE_EXPOSURE_PROGRAM_MODE is set to manual or aperture priority. |
| WPD_STILL_IMAGE_FOCAL_LENGTH | VT_UI4 | The focal length, in millimeters x 100, to use when capturing an image. So, for example, 35mm would be 3500. |
| WPD_STILL_IMAGE_FOCUS_DISTANCE | VT_UI4 | The focus distance that a device should use, in millimeters. A value of 0xFFFF indicates infinite focus (more than 655 meters). |
| WPD_STILL_IMAGE_FOCUS_METERING_MODE | VT_UI4 | A WPD_FOCUS_METERING_MODES enumerator that specifies which focus mode an image capture device should use when deciding how to focus on a subject. |
| WPD_STILL_IMAGE_FOCUS_MODE | VT_UI4 | A WPD_FOCUS_MODES enumerator that specifies the focus mode to use when capturing an image. |
| WPD_STILL_IMAGE_RGB_GAIN | VT_LPWSTR | A null-terminated string that specifies the RGB gain to use when capturing an image. The string is three colon-delimited numbers with no intervening spaces, in the format "R:G:B". |
| WPD_STILL_IMAGE_SHARPNESS | VT_UI4 | A number that specifies the sharpness to use when capturing an image, where zero is the least sharp and larger numbers indicate increasing sharpness. |
| WPD_STILL_IMAGE_TIMELAPSE_INTERVAL | VT_UI4 | The time delay between image captures in a time-lapse image capture, in milliseconds. |
| WPD_STILL_IMAGE_TIMELAPSE_NUMBER | VT_UI4 | The number of images to capture in a time-lapse mode image capture. |
| WPD_STILL_IMAGE_UPLOAD_URL | VT_LPWSTR | Specifies a URL where the device should send the image, once it is captured. |
| WPD_STILL_IMAGE_WHITE_BALANCE | VT_UI4 | A WPD_WHITE_BALANCE_SETTINGS enumerated value that specifies the white balance settings to use when capturing an image. |
Requirements
Header: Defined in PortableDevice.h
See Also
| Previous | Next |