API Guide Home (Online version only) |

# palmOneCameraCommon.h File Reference

## Detailed Description

Public 68K common header file for camera support for Zire 72 and Treo 650 devices.

Version:
  3.0

This file contains the library constants and error codes used in the APIs.

Definition in file palmOneCameraCommon.h.

Go to the source code of this file.

## Data Structures

- struct CamLibStatusTag
    Container for the camera status kCamLibStatus*. More...
- struct CamLibBitmapInfoTag
    Bitmap info structure for every format except PalmBMPV4. Data starts after the parameters. More...
- struct CamLibCaptureTag
    Capture settings structure. The callback is called with userDataP passed. More...
- struct CamLibStreamTag
    Video stream structure. Used for capturing a video stream. More...
- struct CamLibSettingTag
    Settings Capabilities structure. For settings without manual values, only type is used. More...
- struct CamLibColorSpaceTag
    Color Space structure. More...

## Defines

- #define kCamLibType 'libr'
- #define kCamLibCreator 'camL'
- #define kCamLibName "CameraLib-camL"
- #define kCamLibBufNumManual 0x01

Library Versions

- #define kCamLibVersion1 sysMakeROMVersion(1, 0, 0, sysROMStageRelease, 0)
- #define kCamLibVersion2 sysMakeROMVersion(2, 0, 0, sysROMStageRelease, 0)
- #define kCamLibVersion3 sysMakeROMVersion(3, 0, 0, sysROMStageRelease, 0)
- #define kCamLibVersion kCamLibVersion3

Features

- #define kCamLibFtrCaptureVersion 0
- #define kCamLibCaptureHwrVersion 0x10
- #define kCamLibFtrVersionNum 0

Error Codes

- #define kCamLibErrorClass (oemErrorClass + 0x100)
- #define kCamLibErrBadParam (kCamLibErrorClass | 0x01)
- #define kCamLibErrNoMemory (kCamLibErrorClass | 0x02)
- #define kCamLibErrNotOpen (kCamLibErrorClass | 0x03)
- #define kCamLibErrStillOpen (kCamLibErrorClass | 0x04)
- #define kCamLibErrInternal (kCamLibErrorClass | 0x05)
- #define kCamLibErrNotSupported (kCamLibErrorClass | 0x06)
- #define kCamLibErrNotCompatible (kCamLibErrorClass | 0x07)
- #define kCamLibErrNoPower (kCamLibErrorClass | 0x08)
- #define kCamLibErrAllFramesLocked (kCamLibErrorClass | 0x09)

Control Commands

- #define kCamLibCtrlPowerOn 0x01
- #define kCamLibCtrlPowerOff 0x02
- #define kCamLibCtrlHardwareSettingsDlg 0x03
- #define kCamLibCtrlPreviewStart 0x04
- #define kCamLibCtrlPreviewStop 0x05
- #define kCamLibCtrlCaptureGetBitmapInfo 0x06
- #define kCamLibCtrlCapture 0x07
- #define kCamLibCtrlStatusGet 0x08
- #define kCamLibCtrlStatusQuery 0x09
- #define kCamLibCtrlCaptureFormatSet 0x10
- #define kCamLibCtrlCaptureFormatGet 0x11
- #define kCamLibCtrlCaptureFormatQuery 0x12
- #define kCamLibCtrlCaptureSizeSet 0x13
- #define kCamLibCtrlCaptureSizeGet 0x14
- #define kCamLibCtrlCaptureSizeQuery 0x15
- #define kCamLibCtrlCaptureAreaSet 0x16
- #define kCamLibCtrlCaptureAreaGet 0x17
- #define kCamLibCtrlPreviewSizeSet 0x20
- #define kCamLibCtrlPreviewSizeGet 0x21
- #define kCamLibCtrlPreviewSizeQuery 0x22
- #define kCamLibCtrlPreviewRectSet 0x23
- #define kCamLibCtrlPreviewRectGet 0x24
- #define kCamLibCtrlPreviewAreaSet 0x26
- #define kCamLibCtrlPreviewAreaGet 0x27
- #define kCamLibCtrlWhiteBalanceSet 0x30
- #define kCamLibCtrlWhiteBalanceGet 0x31
- #define kCamLibCtrlWhiteBalanceQuery 0x32
- #define kCamLibCtrlLightingSet 0x33
- #define kCamLibCtrlLightingGet 0x34
- #define kCamLibCtrlLightingQuery 0x35
- #define kCamLibCtrlZoomSet 0x36
- #define kCamLibCtrlZoomGet 0x37
- #define kCamLibCtrlZoomQuery 0x38
- #define kCamLibCtrlEffectsSet 0x39
- #define kCamLibCtrlEffectsGet 0x3A
- #define kCamLibCtrlEffectsQuery 0x3B
- #define kCamLibCtrlSaturationSet 0x3C
- #define kCamLibCtrlSaturationGet 0x3D
- #define kCamLibCtrlSaturationQuery 0x3E
- #define kCamLibCtrlExposureSet 0x40
- #define kCamLibCtrlExposureGet 0x41
- #define kCamLibCtrlExposureQuery 0x42
- #define kCamLibCtrlContrastSet 0x43
- #define kCamLibCtrlContrastGet 0x44
- #define kCamLibCtrlContrastQuery 0x45
- #define kCamLibCtrlSharpnessSet 0x46
- #define kCamLibCtrlSharpnessGet 0x47
- #define kCamLibCtrlSharpnessQuery 0x48
- #define kCamLibCtrlStreamFormatSet 0x50
- #define kCamLibCtrlStreamFormatGet 0x51
- #define kCamLibCtrlStreamFormatQuery 0x52
- #define kCamLibCtrlStreamSizeSet 0x53
- #define kCamLibCtrlStreamSizeGet 0x54
- #define kCamLibCtrlStreamSizeQuery 0x55
- #define kCamLibCtrlStreamStart 0x56
- #define kCamLibCtrlStreamStop 0x57
- #define kCamLibCtrlStreamWaitForFrame 0x58
- #define kCamLibCtrlStreamUnlockFrame 0x59
- #define kCamLibCtrlStreamBufNumSet 0x60
- #define kCamLibCtrlStreamBufNumGet 0x61
- #define kCamLibCtrlStreamBufNumQuery 0x62
- #define kCamLibCtrlStreamPreviewSet 0x63
- #define kCamLibCtrlStreamPreviewGet 0x64
- #define kCamLibCtrlStreamPreviewQuery 0x65
- #define kCamLibCtrlColorSpaceSet 0x66
- #define kCamLibCtrlColorSpaceGet 0x67
- #define kCamLibCtrlColorSpaceQuery 0x68
- #define kCamLibCtrlShutterSpeedSet 0x69
- #define kCamLibCtrlShutterSpeedGet 0x6A
- #define kCamLibCtrlShutterSpeedQuery 0x6B
- #define kCamLibCtrlApertureValueSet 0x6C
- #define kCamLibCtrlApertureValueGet 0x6D
- #define kCamLibCtrlApertureValueQuery 0x6E

Camera Status

- #define kCamLibStatusPoweredOn 0x01
- #define kCamLibStatusInPreview 0x02
- #define kCamLibStatusInStillCapture 0x04
- #define kCamLibStatusInVideoCapture 0x08

Capture Formats

- #define kCamLibCaptureDataFormatRGB565 0x0002
- #define kCamLibCaptureDataFormatYUV422 0x0004
- #define kCamLibCaptureDataFormatYCbCr422 0x0008
- #define kCamLibCaptureDataFormatYUV422Planar 0x0010
- #define kCamLibCaptureDataFormatYCbCr422Planar 0x0020
- #define kCamLibCaptureDataFormatYUV420 0x0040
- #define kCamLibCaptureDataFormatYCbCr420 0x0080
- #define kCamLibCaptureDataFormatYUV420Planar 0x0100
- #define kCamLibCaptureDataFormatYCbCr420Planar 0x0200

Image Resolution

- #define kCamLibImageSizeQQVGA 0x02
- #define kCamLibImageSizeQVGA 0x04
- #define kCamLibImageSizeVGA 0x08
- #define kCamLibImageSizeSXGA 0x10
- #define kCamLibImageSizeQCIF 0x20
- #define kCamLibImageSizeCIF 0x40
- #define kCamLibImageSizeSXGA960 0x10
- #define kCamLibImageSizeSXGA1024 0x80

White Balance Settings

- #define kCamLibWhiteBalanceAuto 0x02
- #define kCamLibWhiteBalanceIndoor 0x04
- #define kCamLibWhiteBalanceIncandescent 0x04
- #define kCamLibWhiteBalanceOutdoor 0x08
- #define kCamLibWhiteBalanceSunny 0x08
- #define kCamLibWhiteBalanceExtra 0x10
- #define kCamLibWhiteBalanceFluorescent 0x10
- #define kCamLibWhiteBalanceCloudy 0x20
- #define kCamLibWhiteBalanceShade 0x40
- #define kCamLibWhiteBalanceTwilight 0x80

Exposure Level Settings

- #define kCamLibExposureManual 0x01
- #define kCamLibExposureAuto 0x02

Contrast Setting

- #define kCamLibContrastManual 0x01

Zoom Setting

- #define kCamLibZoomManual 0x01

Lighting Settings

- #define kCamLibLightingNormal 0x02
- #define kCamLibLightingLow 0x04

Special Effects

- #define kCamLibEffectsNormal 0x02
- #define kCamLibEffectsBlackWhite 0x04
- #define kCamLibEffectsSepia 0x08
- #define kCamLibEffectsBluish 0x10
- #define kCamLibEffectsNegative 0x20

Saturation Level

- #define kCamLibSaturationManual 0x01

Sharpness Level

- #define kCamLibSharpnessManual 0x01

Stream Preview Settings

- #define kCamLibStreamPreviewOn 0x01
- #define kCamLibStreamPreviewOff 0x02

Color Space Settings

- #define kCamLibColorSpace_sRGB 0x02
- #define kCamLibColorSpaceUncalibrated 0x04

Shutter Speed Settings

- #define kCamLibShutterSpeedManual 0x01
- #define kCamLibShutterSpeedAuto 0x02

Aperture Value Settings

- #define kCamLibApertureValueManual 0x01
- #define kCamLibApertureValueAuto 0x02

Function Traps

- #define kCamLibTrapGetVersion (sysLibTrapCustom + 0)
- #define kCamLibTrapControl (sysLibTrapCustom + 1)

## Typedefs

- typedef UInt16 CamLibControlType
- typedef CamLibStatusTag CamLibStatusType
    Container for the camera status kCamLibStatus*.
- typedef CamLibBitmapInfoTag CamLibBitmapInfoType
    Bitmap info structure for every format except PalmBMPV4. Data starts after the parameters.
- typedef Err CamLibCaptureCallbackFunc (void *bufP, UInt32 size, void *userDataP)
    Image capture callback function pointer.
- typedef CamLibCaptureTag CamLibCaptureType
    Capture settings structure. The callback is called with userDataP passed.
- typedef CamLibStreamTag CamLibStreamType
    Video stream structure. Used for capturing a video stream.
- typedef CamLibSettingTag CamLibBufNumType
- typedef CamLibSettingTag CamLibSettingType
    Settings Capabilities structure. For settings without manual values, only type is used.
- typedef CamLibColorSpaceTag CamLibColorSpaceType
    Color Space structure.
- typedef CamLibSettingTag CamLibCaptureFormatType
- typedef CamLibSettingTag CamLibImageSizeType
- typedef CamLibSettingTag CamLibWhiteBalanceType
- typedef CamLibSettingTag CamLibExposureType
- typedef CamLibSettingTag CamLibContrastType
- typedef CamLibSettingTag CamLibZoomType
- typedef CamLibSettingTag CamLibLightingType
- typedef CamLibSettingTag CamLibEffectsType
- typedef CamLibSettingTag CamLibSaturationType
- typedef CamLibSettingTag CamLibSharpnessType
- typedef CamLibSettingTag CamLibStreamPreviewType
- typedef CamLibSettingTag CamLibShutterSpeedType
- typedef CamLibSettingTag CamLibApertureValueType

## Define Documentation

#define kCamLibApertureValueAuto 0x02

Sets the aperture value automatically.

Definition at line 430 of file palmOneCameraCommon.h.

#define kCamLibApertureValueManual 0x01

Sets the aperture value manually through an additional passed parameter with kCamLibCtrlApertureValueSet.For manual values, all values are x1000 of real aperture value i.e. ap val 1.4 is 1400.

Definition at line 426 of file palmOneCameraCommon.h.

#define kCamLibBufNumManual 0x01

Video Stream Capture buffers

Definition at line 222 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatRGB565 0x0002

Capture format in 16-bit RGB.

Definition at line 254 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYCbCr420 0x0080

Capture format in 16-bit YCbCr420.

Definition at line 260 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYCbCr420Planar 0x0200

Capture format in 16-bit YCbCr420 Planar.

Definition at line 262 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYCbCr422 0x0008

Capture format in 16-bit YCbCr422.

Definition at line 256 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYCbCr422Planar 0x0020

Capture format in 16-bit YCbCr422 Planar.

Definition at line 258 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYUV420 0x0040

Capture format in 16-bit YUV420.

Definition at line 259 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYUV420Planar 0x0100

Capture format in 16-bit YUV420 Planar.

Definition at line 261 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYUV422 0x0004

Capture format in 16-bit YUV422.

Definition at line 255 of file palmOneCameraCommon.h.

#define kCamLibCaptureDataFormatYUV422Planar 0x0010

Capture format in 16-bit YUV422 Planar.

Definition at line 257 of file palmOneCameraCommon.h.

#define kCamLibCaptureHwrVersion 0x10

Feature value if capture h/w present.

Definition at line 54 of file palmOneCameraCommon.h.

#define kCamLibColorSpace_sRGB 0x02

color space sRGB.

Definition at line 406 of file palmOneCameraCommon.h.

#define kCamLibColorSpaceUncalibrated 0x04

color space uncalibrated.

Definition at line 407 of file palmOneCameraCommon.h.

#define kCamLibContrastManual 0x01

Sets the contrast value manually. Use kCamLibCtrlContrastGet to determine the minimum and maximum values allowed and the unit of measurement.

Definition at line 327 of file palmOneCameraCommon.h.

#define kCamLibCreator 'camL'

Camera Manager library creator ID

Definition at line 34 of file palmOneCameraCommon.h.

#define kCamLibCtrlApertureValueGet 0x6D

Gets the Aperture Value. Parameter is CamLibApertureValueType*.

Definition at line 151 of file palmOneCameraCommon.h.

#define kCamLibCtrlApertureValueQuery 0x6E

Queries for the Aperture Value. Parameter is CamLibApertureValueType*.

Definition at line 152 of file palmOneCameraCommon.h.

#define kCamLibCtrlApertureValueSet 0x6C

Sets the Aperture Value. Parameter is CamLibApertureValueType*.

Definition at line 150 of file palmOneCameraCommon.h.

#define kCamLibCtrlCapture 0x07

Captures the current image. Parameter is CamLibCaptureType*.

Definition at line 86 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureAreaGet 0x17

Gets the capture area. Parameter is RectangleType*. Low-res value.

Definition at line 96 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureAreaSet 0x16

Sets the capture area. Parameter is RectangleType*. Low-res value.

Definition at line 95 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureFormatGet 0x11

Gets the current capture format. Parameter is CamLibCaptureFormatType*.

Definition at line 90 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureFormatQuery 0x12

Queries the capture formats available. Parameter is CamLibCaptureFormatType*.

Definition at line 91 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureFormatSet 0x10

Sets the capture format. Parameter is CamLibCaptureFormatType*.

Definition at line 89 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureGetBitmapInfo 0x06

Used to determine the captured image properties. Parameter is CamLibBitmapInfoType*.

Definition at line 85 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureSizeGet 0x14

Gets the current capture size. Parameter is CamLibImageSizeType*.

Definition at line 93 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureSizeQuery 0x15

Queries the capture sizes available. Parameter is CamLibImageSizeType*.

Definition at line 94 of file palmOneCameraCommon.h.

#define kCamLibCtrlCaptureSizeSet 0x13

Sets the capture size. Parameter is CamLibImageSizeType*.

Definition at line 92 of file palmOneCameraCommon.h.

#define kCamLibCtrlColorSpaceGet 0x67

Gets the Color Space. Parameter is CamLibColorSpaceType*.

Definition at line 145 of file palmOneCameraCommon.h.

#define kCamLibCtrlColorSpaceQuery 0x68

Queries for the Color Space. Parameter is CamLibColorSpaceType*.

Definition at line 146 of file palmOneCameraCommon.h.

#define kCamLibCtrlColorSpaceSet 0x66

Sets the Color Space. Parameter is CamLibColorSpaceType*.

Definition at line 144 of file palmOneCameraCommon.h.

#define kCamLibCtrlContrastGet 0x44

Gets the current contrast. Parameter is CamLibContrastType*.

Definition at line 123 of file palmOneCameraCommon.h.

#define kCamLibCtrlContrastQuery 0x45

Checks the contrast values available. Parameter is CamLibContrastType*.

Definition at line 124 of file palmOneCameraCommon.h.

#define kCamLibCtrlContrastSet 0x43

Sets the contrast. Parameter is CamLibContrastType*.

Definition at line 122 of file palmOneCameraCommon.h.

#define kCamLibCtrlEffectsGet 0x3A

Gets the current camera effect. Parameter is CamLibEffectsType*.

Definition at line 114 of file palmOneCameraCommon.h.

#define kCamLibCtrlEffectsQuery 0x3B

Queries the camera effects available. Parameter is CamLibEffectsType*.

Definition at line 115 of file palmOneCameraCommon.h.

#define kCamLibCtrlEffectsSet 0x39

Sets the camera effect. Parameter is CamLibEffectsType*.

Definition at line 113 of file palmOneCameraCommon.h.

#define kCamLibCtrlExposureGet 0x41

Gets the exposure. Parameter is CamLibExposureType*.

Definition at line 120 of file palmOneCameraCommon.h.

#define kCamLibCtrlExposureQuery 0x42

Checks the exposure values available. Parameter is CamLibExposureType*.

Definition at line 121 of file palmOneCameraCommon.h.

#define kCamLibCtrlExposureSet 0x40

Sets the exposure. Parameter is CamLibExposureType*.

Definition at line 119 of file palmOneCameraCommon.h.

#define kCamLibCtrlHardwareSettingsDlg 0x03

Displays the hardware camera settings dialog. No parameter.

Definition at line 82 of file palmOneCameraCommon.h.

#define kCamLibCtrlLightingGet 0x34

Gets the current lighting setting. Parameter is CamLibLightingType*.

Definition at line 108 of file palmOneCameraCommon.h.

#define kCamLibCtrlLightingQuery 0x35

Queries the lighting settings available. Parameter is CamLibLightingType*.

Definition at line 109 of file palmOneCameraCommon.h.

#define kCamLibCtrlLightingSet 0x33

Sets the lighting setting. Parameter is CamLibLightingType*.

Definition at line 107 of file palmOneCameraCommon.h.

#define kCamLibCtrlPowerOff 0x02

Powers off the camera module. No parameter.

Definition at line 81 of file palmOneCameraCommon.h.

#define kCamLibCtrlPowerOn 0x01

Powers on and initialize the camera module. No parameter.

Definition at line 80 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewAreaGet 0x27

Gets the preview area. Parameter is RectangleType*. Low-res value.

Definition at line 103 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewAreaSet 0x26

Sets the preview area. Parameter is RectangleType*. Low-res value.

Definition at line 102 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewRectGet 0x24

Gets the preview rectangle. Parameter is RectangleType*. Low-res value.

Definition at line 101 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewRectSet 0x23

Sets the preview rectangle. Parameter is RectangleType*. Low-res value.

Definition at line 100 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewSizeGet 0x21

Gets the preview size. Parameter is CamLibImageSizeType*.

Definition at line 98 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewSizeQuery 0x22

Queries the preview sizes available. Parameter is CamLibImageSizeType*.

Definition at line 99 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewSizeSet 0x20

Sets the preview size. Parameter is CamLibImageSizeType*.

Definition at line 97 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewStart 0x04

Starts the camera preview mode. No parameter.

Definition at line 83 of file palmOneCameraCommon.h.

#define kCamLibCtrlPreviewStop 0x05

Stops the camera preview mode. No parameter.

Definition at line 84 of file palmOneCameraCommon.h.

#define kCamLibCtrlSaturationGet 0x3D

Gets the current saturation level. Parameter is CamLibSaturationType*.

Definition at line 117 of file palmOneCameraCommon.h.

#define kCamLibCtrlSaturationQuery 0x3E

Queries the saturation range. Parameter is CamLibSaturationType*.

Definition at line 118 of file palmOneCameraCommon.h.

#define kCamLibCtrlSaturationSet 0x3C

Sets the saturation level. Parameter is CamLibSaturationType*.

Definition at line 116 of file palmOneCameraCommon.h.

#define kCamLibCtrlSharpnessGet 0x47

Gets the sharpness. Parameter is CamLibSharpnessType*.

Definition at line 126 of file palmOneCameraCommon.h.

#define kCamLibCtrlSharpnessQuery 0x48

Queries the sharpness range. Parameter is CamLibSharpnessType*.

Definition at line 127 of file palmOneCameraCommon.h.

#define kCamLibCtrlSharpnessSet 0x46

Sets the sharpness. Parameter is CamLibSharpnessType*.

Definition at line 125 of file palmOneCameraCommon.h.

#define kCamLibCtrlShutterSpeedGet 0x6A

Gets the Shutter Speed. Parameter is CamLibShutterSpeedType*.

Definition at line 148 of file palmOneCameraCommon.h.

#define kCamLibCtrlShutterSpeedQuery 0x6B

Queries for the Shutter Speed. Parameter is CamLibShutterSpeedType*.

Definition at line 149 of file palmOneCameraCommon.h.

#define kCamLibCtrlShutterSpeedSet 0x69

Sets the Shutter Speed. Parameter is CamLibShutterSpeedType*.

Definition at line 147 of file palmOneCameraCommon.h.

#define kCamLibCtrlStatusGet 0x08

Used to determine if a certain camera status is currently in effect. Parameter is CamLibStatusType*.

Definition at line 87 of file palmOneCameraCommon.h.

#define kCamLibCtrlStatusQuery 0x09

Used to determine if a certain camera status is available. Parameter is CamLibStatusType*.

Definition at line 88 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamBufNumGet 0x61

Gets the number of video frame buffers. Parameter is CamLibBufNumType*.

Definition at line 139 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamBufNumQuery 0x62

Queries the number of video frame buffer range. Parameter is CamLibBufNumType*.

Definition at line 140 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamBufNumSet 0x60

Sets the number of video frame buffers. Parameter is CamLibBufNumType*.

Definition at line 138 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamFormatGet 0x51

Gets the video stream format. Parameter is CamLibCaptureFormatType*.

Definition at line 129 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamFormatQuery 0x52

Queries the video stream formats available. Parameter is CamLibCaptureFormatType*.

Definition at line 130 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamFormatSet 0x50

Sets the video stream format. Parameter is CamLibCaptureFormatType*.

Definition at line 128 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamPreviewGet 0x64

Gets the stream preview status (on or off). Parameter is CamLibStreamPreviewType*.

Definition at line 142 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamPreviewQuery 0x65

Queries the stream preview available. Parameter is CamLibStreamPreviewType*.

Definition at line 143 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamPreviewSet 0x63

Sets the stream preview on or off. Parameter is CamLibStreamPreviewType*.

Definition at line 141 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamSizeGet 0x54

Gets the video stream size. Parameter is CamLibCaptureSizeType*.

Definition at line 132 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamSizeQuery 0x55

Queries the video stream sizes available. Parameter is CamLibCaptureSizeType*.

Definition at line 133 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamSizeSet 0x53

Sets the video stream size. Parameter is CamLibCaptureSizeType*.

Definition at line 131 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamStart 0x56

Starts the video stream capture. Parameter is CamLibStreamType*.

Definition at line 134 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamStop 0x57

Stops the video stream capture. Parameter is CamLibStreamType*.

Definition at line 135 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamUnlockFrame 0x59

Unlocks a video frame. Parameter is CamLibStreamType*.

Definition at line 137 of file palmOneCameraCommon.h.

#define kCamLibCtrlStreamWaitForFrame 0x58

Waits and locks a video frame. Parameter is CamLibStreamType*.

Definition at line 136 of file palmOneCameraCommon.h.

#define kCamLibCtrlWhiteBalanceGet 0x31

Gets the current white balance. Parameter is CamLibWhiteBalanceType*.

Definition at line 105 of file palmOneCameraCommon.h.

#define kCamLibCtrlWhiteBalanceQuery 0x32

Queries the white balances available. Parameter is CamLibWhiteBalanceType*.

Definition at line 106 of file palmOneCameraCommon.h.

#define kCamLibCtrlWhiteBalanceSet 0x30

Sets the white balance. Parameter is CamLibWhiteBalanceType*.

Definition at line 104 of file palmOneCameraCommon.h.

#define kCamLibCtrlZoomGet 0x37

Gets the current zoom value. Parameter is CamLibZoomType*.

Definition at line 111 of file palmOneCameraCommon.h.

#define kCamLibCtrlZoomQuery 0x38

Queries the zoom range. Parameter is CamLibZoomType*.

Definition at line 112 of file palmOneCameraCommon.h.

#define kCamLibCtrlZoomSet 0x36

Sets the zoom value. Parameter is CamLibZoomType*.

Definition at line 110 of file palmOneCameraCommon.h.

#define kCamLibEffectsBlackWhite 0x04

Balck & white effect

Definition at line 362 of file palmOneCameraCommon.h.

#define kCamLibEffectsBluish 0x10

Bluish effect

Definition at line 364 of file palmOneCameraCommon.h.

#define kCamLibEffectsNegative 0x20

Negative effect

Definition at line 365 of file palmOneCameraCommon.h.

#define kCamLibEffectsNormal 0x02

No special effects

Definition at line 361 of file palmOneCameraCommon.h.

#define kCamLibEffectsSepia 0x08

Sepia effect

Definition at line 363 of file palmOneCameraCommon.h.

#define kCamLibErrAllFramesLocked (kCamLibErrorClass | 0x09)

All video frames are locked.

Definition at line 72 of file palmOneCameraCommon.h.

#define kCamLibErrBadParam (kCamLibErrorClass | 0x01)

Invalid parameter.

Definition at line 64 of file palmOneCameraCommon.h.

#define kCamLibErrInternal (kCamLibErrorClass | 0x05)

Internal error.

Definition at line 68 of file palmOneCameraCommon.h.

#define kCamLibErrNoMemory (kCamLibErrorClass | 0x02)

Memory error.

Definition at line 65 of file palmOneCameraCommon.h.

#define kCamLibErrNoPower (kCamLibErrorClass | 0x08)

Camera not powered.

Definition at line 71 of file palmOneCameraCommon.h.

#define kCamLibErrNotCompatible (kCamLibErrorClass | 0x07)

Bad Version.

Definition at line 70 of file palmOneCameraCommon.h.

#define kCamLibErrNotOpen (kCamLibErrorClass | 0x03)

Library is not open.

Definition at line 66 of file palmOneCameraCommon.h.

#define kCamLibErrNotSupported (kCamLibErrorClass | 0x06)

Unsupported function.

Definition at line 69 of file palmOneCameraCommon.h.

#define kCamLibErrorClass (oemErrorClass + 0x100)

Definition at line 63 of file palmOneCameraCommon.h.

#define kCamLibErrStillOpen (kCamLibErrorClass | 0x04)

Returned from CamLibClose() if the library is still open.

Definition at line 67 of file palmOneCameraCommon.h.

#define kCamLibExposureAuto 0x02

Sets the exposure level automatically.

Definition at line 317 of file palmOneCameraCommon.h.

#define kCamLibExposureManual 0x01

Sets the exposure level manually through an additional passed parameter with kCamLibCtrlExposureSet. For manual values, all values are x1000 of real exposure i.e. exp 1.5 is 1500.

Definition at line 314 of file palmOneCameraCommon.h.

#define kCamLibFtrCaptureVersion 0

Feature id for capture h/w.

Definition at line 53 of file palmOneCameraCommon.h.

#define kCamLibFtrVersionNum 0

Feature version if camera is present.

Definition at line 55 of file palmOneCameraCommon.h.

#define kCamLibImageSizeCIF 0x40

354 x 288 High Resolution.

Definition at line 277 of file palmOneCameraCommon.h.

#define kCamLibImageSizeQCIF 0x20

177 x 144 High Resolution.

Definition at line 276 of file palmOneCameraCommon.h.

#define kCamLibImageSizeQQVGA 0x02

160 x 120 High Resolution.

Definition at line 272 of file palmOneCameraCommon.h.

#define kCamLibImageSizeQVGA 0x04

320 x 240 High Resolution.

Definition at line 273 of file palmOneCameraCommon.h.

#define kCamLibImageSizeSXGA 0x10

1280x 960 High Resolution.

Definition at line 275 of file palmOneCameraCommon.h.

#define kCamLibImageSizeSXGA1024 0x80

1280x 1024 High Resolution.

Definition at line 285 of file palmOneCameraCommon.h.

#define kCamLibImageSizeSXGA960 0x10

1280x 960 High Resolution.

Definition at line 284 of file palmOneCameraCommon.h.

#define kCamLibImageSizeVGA 0x08

640 x 480 High Resolution.

Definition at line 274 of file palmOneCameraCommon.h.

#define kCamLibLightingLow 0x04

The camera is set for low light.

Definition at line 351 of file palmOneCameraCommon.h.

#define kCamLibLightingNormal 0x02

The camera is set for normal light.

Definition at line 350 of file palmOneCameraCommon.h.

#define kCamLibName "CameraLib-camL"

Camera Manager library name

Definition at line 35 of file palmOneCameraCommon.h.

#define kCamLibSaturationManual 0x01

Sets the saturation level manually

Definition at line 375 of file palmOneCameraCommon.h.

#define kCamLibSharpnessManual 0x01

Sets the sharpness level manually.

Definition at line 385 of file palmOneCameraCommon.h.

#define kCamLibShutterSpeedAuto 0x02

Sets the shutter speed automatically.

Definition at line 416 of file palmOneCameraCommon.h.

#define kCamLibShutterSpeedManual 0x01

Sets the shutter speed manually through an additional passed parameter with kCamLibCtrlShutterSpeedSet.

Definition at line 414 of file palmOneCameraCommon.h.

#define kCamLibStatusInPreview 0x02

Is the camera in preview mode?

Definition at line 163 of file palmOneCameraCommon.h.

#define kCamLibStatusInStillCapture 0x04

Is the camera in still capture?

Definition at line 164 of file palmOneCameraCommon.h.

#define kCamLibStatusInVideoCapture 0x08

Is the camera in video capture?

Definition at line 165 of file palmOneCameraCommon.h.

#define kCamLibStatusPoweredOn 0x01

Is the camera powered on?

Definition at line 162 of file palmOneCameraCommon.h.

#define kCamLibStreamPreviewOff 0x02

Stream preview off.

Definition at line 396 of file palmOneCameraCommon.h.

#define kCamLibStreamPreviewOn 0x01

Stream preview on.

Definition at line 395 of file palmOneCameraCommon.h.

#define kCamLibTrapControl (sysLibTrapCustom + 1)

Definition at line 441 of file palmOneCameraCommon.h.

#define kCamLibTrapGetVersion (sysLibTrapCustom + 0)

Definition at line 440 of file palmOneCameraCommon.h.

#define kCamLibType 'libr'

Default library type

Definition at line 33 of file palmOneCameraCommon.h.

#define kCamLibVersion kCamLibVersion3

Definition at line 45 of file palmOneCameraCommon.h.

#define kCamLibVersion1 sysMakeROMVersion(1, 0, 0, sysROMStageRelease, 0)

Definition at line 42 of file palmOneCameraCommon.h.

#define kCamLibVersion2 sysMakeROMVersion(2, 0, 0, sysROMStageRelease, 0)

Definition at line 43 of file palmOneCameraCommon.h.

#define kCamLibVersion3 sysMakeROMVersion(3, 0, 0, sysROMStageRelease, 0)

Definition at line 44 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceAuto 0x02

Automatically determines the correct white balance for capturing and previewing images.

Definition at line 295 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceCloudy 0x20

Sets the white balance for cloudy lighting during capture and preview of images

Definition at line 302 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceExtra 0x10

Sets the white balance for flourescent indoor capturing and previewing of images

Definition at line 300 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceFluorescent 0x10

Sets the white balance for flourescent indoor capturing and previewing of images

Definition at line 301 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceIncandescent 0x04

Sets the white balance for indoor capturing and previewing of images

Definition at line 297 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceIndoor 0x04

Sets the white balance for indoor capturing and previewing of images

Definition at line 296 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceOutdoor 0x08

Sets the white balance for outdoor capturing and previewing of images

Definition at line 298 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceShade 0x40

Sets the white balance for shady lighting during capture and preview of images

Definition at line 303 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceSunny 0x08

Sets the white balance for outdoor capturing and previewing of images

Definition at line 299 of file palmOneCameraCommon.h.

#define kCamLibWhiteBalanceTwilight 0x80

Sets the white balance for twilight lighting during capture and preview of images

Definition at line 304 of file palmOneCameraCommon.h.

#define kCamLibZoomManual 0x01

Sets the zoom value manually. All values here are x1000 of real zoom i.e. x2 is 2000.

Definition at line 339 of file palmOneCameraCommon.h.

## Typedef Documentation

typedef struct CamLibSettingTag CamLibApertureValueType

See also:
  CamLibSettingTag

Definition at line 434 of file palmOneCameraCommon.h.

typedef struct CamLibBitmapInfoTag CamLibBitmapInfoType

Bitmap info structure for every format except PalmBMPV4. Data starts after the parameters.

typedef struct CamLibSettingTag CamLibBufNumType

See also:
  CamLibSettingTag

Definition at line 225 of file palmOneCameraCommon.h.

typedef Err CamLibCaptureCallbackFunc(void *bufP, UInt32 size, void *userDataP)

Image capture callback function pointer.

Parameters:

  | bufP | I/O Pointer to the image buffer
  | size | IN Size of the buffer
  | userDataP | OUT Pointer to the user data

Returns:
  Error code or zero if no error occurs

Definition at line 197 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibCaptureFormatType

See also:
  CamLibSettingTag

Definition at line 266 of file palmOneCameraCommon.h.

typedef struct CamLibCaptureTag CamLibCaptureType

Capture settings structure. The callback is called with userDataP passed.

typedef struct CamLibColorSpaceTag CamLibColorSpaceType

Color Space structure.

typedef struct CamLibSettingTag CamLibContrastType

See also:
  CamLibSettingTag

Definition at line 333 of file palmOneCameraCommon.h.

typedef UInt16 CamLibControlType

Camera Manager library control structure

Definition at line 156 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibEffectsType

See also:
  CamLibSettingTag

Definition at line 369 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibExposureType

See also:
  CamLibSettingTag

Definition at line 321 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibImageSizeType

See also:
  CamLibSettingTag

Definition at line 289 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibLightingType

See also:
  CamLibSettingTag

Definition at line 355 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibSaturationType

See also:
  CamLibSettingTag

Definition at line 379 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibSettingType

Settings Capabilities structure. For settings without manual values, only type is used.

typedef struct CamLibSettingTag CamLibSharpnessType

See also:
  CamLibSettingTag

Definition at line 389 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibShutterSpeedType

See also:
  CamLibSettingTag

Definition at line 420 of file palmOneCameraCommon.h.

typedef struct CamLibStatusTag CamLibStatusType

Container for the camera status kCamLibStatus*.

typedef struct CamLibSettingTag CamLibStreamPreviewType

See also:
  CamLibSettingTag

Definition at line 400 of file palmOneCameraCommon.h.

typedef struct CamLibStreamTag CamLibStreamType

Video stream structure. Used for capturing a video stream.

When used with WaitfForFram, bufP will contain the full frame buffer.

typedef struct CamLibSettingTag CamLibWhiteBalanceType

See also:
  CamLibSettingTag

Definition at line 308 of file palmOneCameraCommon.h.

typedef struct CamLibSettingTag CamLibZoomType

See also:
  CamLibSettingTag

Definition at line 344 of file palmOneCameraCommon.h.

Top | Palm Developer Network © 2004-2008, Palm, Inc. All rights reserved. Generated on Fri Jun 13 10:07:46 2008 for Palm API Guide