Descriptors

Determining which Features can change in a Descriptor

All feature element inquiry registers (Offset 500h to 5FFh) use bit 2 to indicate if the feature can have different values in different descriptors as shown in the table below.

Feature Element Inquiry CSRs (Section 4.5 in the IIDC 1.31 Spec.)

 

Color Coding

The Color Coding Inquiry Register is slightly different.  It uses bit 31 to indicate if the color coding can change between descriptors.

Color Coding Inquiry CSR for Format_7 (Section 4.9 in the IIDC Spec.)

To delete a descriptor, reduce the number of descriptors in the descriptor configuration CSR.  The highest indexed descriptors will be deleted first.

typedef struct _DESCRIPTOR

{

const U16 wSize;              // Size of this structure (in bytes)

const U16 wVersion = 0x0002;  // Version of this structure

 

float fWhiteBalance;          // White Balance

float fSaturation;            // Saturation

float fBrightness;            // Brightness

float fShutter;               // Shutter

float fGain;                  // Gain

float fKneePoint[4];          // Extended Shutter Knee Point

 

#if FRAME_STRUCTURE

} DESCRIPTOR, *PDESCRIPTOR;

#else // !FRAME_STRUCTURE

// This section contains all settings that don’t change without

// the host’s knowledge

float fAutoExposure;          // Auto Exposure

float fSharpness;             // Sharpness

float fHue;                   // Hue

float fGamma;                 // Gamma

float fIris;                  // Iris

float fFocus;                 // Focus

float fTemperature;           // Temperature

float fTriggerParamter;       // Parameter for Trigger

float fTriggerDelay;          // Trigger Delay

float fZoom;                  // Zoom

float fPan;                   // Pan

float fTilt;                  // Tilt

float fOpticalFilter;         // Optical Filter

float fAutoROILeft;           // Auto ROI Left

float fAutoROITop;            // Auto ROI Top

float fAutoROIWidth;          // Auto ROI Width

float fAutoROIHeight;         // Auto ROI Height

 

float fFrameRate;             // Frame Rate

float fLeft;                  // ROI Left

float fTop;                   // ROI Top

float fWidth;                 // ROI Width

float fHeight;                // ROI Height

float fDecimation;            // Decimation

float fPixelFormat;           // Pixel Format

float fGpioParameter1[16];    // GPIO Parameter 1

float fGpioParameter2[16];    // GPIO Parameter 2

float fGpioParameter3[16];    // GPIO Parameter 3

U8 byGpioMode[16];            // GPIO Mode

U8 byGpioPolarity[16];        // GPIO Polarity

U8 byTriggerMode;             // Trigger Mode

U8 byTriggerPolarity;         // Trigger Polarity

U8 byTriggerType;             // Trigger Type

U8 byReserved;                // Padding to quadlet align

 

} DESCRIPTOR, *PDESCRIPTOR;

#endif // FRAME_STRUCTURE

typedef struct _DESCRIPTOR

{

const U16 wSize;              // Size of this structure (in bytes)

const U16 wVersion = 0x0003;  // Version of this structure

 

float fWhiteBalance;          // White Balance

float fSaturation;            // Saturation

float fBrightness;            // Brightness

float fShutter;               // Shutter

float fGain;                  // Gain

float fRedGain;               // Red Gain

float fGreenGain;             // Green Gain

float fBlueGain;              // Blue Gain

 

#if FRAME_STRUCTURE

} DESCRIPTOR, *PDESCRIPTOR;

#else // !FRAME_STRUCTURE

// This section contains all settings that don’t change without

// the host’s knowledge

float fAutoExposure;          // Auto Exposure

float fSharpness;             // Sharpness

float fHue;                   // Hue

float fGamma;                 // Gamma

float fIris;                  // Iris

float fFocus;                 // Focus

float fTemperature;           // Temperature

float fTriggerParamter;       // Parameter for Trigger

float fTriggerDelay;          // Trigger Delay

float fZoom;                  // Zoom

float fPan;                   // Pan

float fTilt;                  // Tilt

float fOpticalFilter;         // Optical Filter

float fAutoROILeft;           // Auto ROI Left

float fAutoROITop;            // Auto ROI Top

float fAutoROIWidth;          // Auto ROI Width

float fAutoROIHeight;         // Auto ROI Height

float fRotate;                // Angle of Rotation

 

float fFrameRate;             // Frame Rate

float fLeft;                  // ROI Left

float fTop;                   // ROI Top

float fWidth;                 // ROI Width

float fHeight;                // ROI Height

float fPixelAddressingValue;  // Pixel Addressing Value

float fPixelAddressinMode;    // Pixel Addressing Mode

float fPixelFormat;           // Pixel Format

float fKneePoint[4];          // Extended Shutter Knee Point

float fGPOParameter1[16];     // GPO Parameter 1

float fGPOParameter2[16];     // GPO Parameter 2

float fGPOParameter3[16];     // GPO Parameter 3

U8 byGPOMode[16];       // GPO Mode

U8 byGPOPolarity[16];         // GPO Polarity

U8 byTriggerMode;             // Trigger Mode

U8 byTriggerPolarity;         // Trigger Polarity

U8 byTriggerType;             // Trigger Type

U8 byReserved;                // Padding to quadlet align

 

} DESCRIPTOR, *PDESCRIPTOR;

#endif // FRAME_STRUCTURE