STATE Variables

Display Zoom Percent
Corresponds to Zoom In/Out buttons on the DevWare toolbar. Value is zoom factor * 100. The following settings are special cases: 12 will be 12.5% (1/8 exactly), 6 will be 6.25% (1/16 exactly) and 3 will be 3.125% (1/32 exactly).

3 to 1600 (default = 100)

Filter
Corresponds to Filter selection on the Data Interpretation page.

Note that the value(s) presented on the Data Interpretation page change depending on the output format in use. For example, Bayer as compared to YCBCR as compared to SuperCell - all will have a different list of possible Filter choices.
This in turn changes the corresponding value for the "Filter" state.

The method of determining the state value is to use DevWare to set the output format that you're using, and then go to the "Data Interpretation" dialog in the "Control" dialog.
Starting at 0, count down until you find the filter that you want to apply.

For example, if your output format is Bayer, selecting a Filter state of "Bayer Grayscale" would be 3.

Note; the set of Filters can be set via the "CFA Pattern" STATE command, listed below.

0 to n

X Offset
Sets the Bayer pattern horizontal offset. 0 means first column is G1/B, 1 means R/G2. Corresponds to Horizontal skip checkmark on the Data Interpretation page.

0 or 1

Y Offset
Sets the Bayer pattern vertical offset. 0 means first row is G1/R, 1 means B/G2. Corresponds to Vertical skip checkmark on the Data Interpretation page.

0 or 1

Auto Offset
Set X Offset and Y Offset automatically. Corresponds to Automatic checkmark on the Data Interpretation page.

0 or 1

Gb-B Swap
Swap Gb and B pixels in a Bayer image.

0 or 1

Byte Swap
Swap adjacent bytes in the input image.

0 or 1

True Black Scale
Usually either 1024 or 4096, indicates whether True Black Level is expressed as a 10-bit or 12-bit value.

Integer

ALTM Enable
Enable Adaptive Local Tone Mapping algorithm. This intelligently reduces an HDR image of 16 bits or more to 12 bits for the software color pipeline.

Note; use "HDR" version of STATE variables when ALTM is enabled. For example, "HDR Black Correct" instead of "Black Correct".

Duplicated per-context.

ALTM Min Percent
Minimum percentile.

Duplicated per-context.

ALTM Peak Percent
Maximum percentile.

Duplicated per-context.

ALTM Sharp S
Sharpening strength.

Duplicated per-context.

ALTM Lo Gamma
Low light region Gamma.

Duplicated per-context.

ALTM Hi Gamma
High light region Gamma.

Duplicated per-context.

ALTM Min Factor
Minimum factor.

Duplicated per-context.

ALTM Dark Floor
Minimum dark factor.

Duplicated per-context.

ALTM Smooth Level
Normally less than 1.0.

Duplicated per-context.

Companding
Set the custom companding table.  Provide a string with the required format and appropriate values;

Bits_in [in_knee_point_1 in_knee_point_2 in_knee_point_n] Bits_out [out_knee_point_1 out_knee_point_2 out_knee_point_n]

• Bits_out maximum is 24.
• Max number of knee points is 16.
• Knee points must be increasing in value.
• Number of Knee points must be the same for Bits_in and Bits_out.
• In cases where the original depth is shifted (e.g. 20->16), account for this by shifting the knee point values.
• Use the STATE command "Compress, 3" to enable companding.

Issuing the STATE command with no data will reset/disable the custom companding table.

Example: STATE = Companding, 12 [2048 3040 4000] 20 [2048 65536 1048576]

Deinterlace Mode
Sets de-interlacing method when displaying the output from an interlaced sensor. 0 means don't de-interlace, 1 means top field comes out first, 2 means bottom field comes out first, 3 means automatically determine appropriate mode. Corresponds to De-Interlacing controls on the Data Interpretation page.

0, 1, 2 or 3

Auto Luma Range
Enable automatic determination of the range of Y values in the YCbCr output of the sensor. Corresponds to the Automatic checkmark under Luma Range on the Data Interpretation page.

0 or 1

Luma Lo
Value to use as the black Y value when automatic luma range is off. Corresponds to the Black value on the Data Interpretation Page.

0 to 255

Luma Hi
Value to use as the white Y value when automatic luma range is off. Corresponds to the White value on the Data Interpretation Page.

0 to 255

Dynamic Range LSB
The least significant bit of the input data to use when limiting the dynamic range used in the image processing.

Unswizzle Mode
Sets the unswizzling operation to be performed on the data coming from the demo board. Swizzling refers to rearrangement of the data bits on most headboards. 0 means no unswizzling, 1 means unswizzle on the camera if possible, 2 means unswizzle in software on the host, and 3 means set the best mode automatically. Corresponds to the Bayer Bit-Unswizzling controls on the Data Interpretation page.

0, 1, 2 or 3

Output Channel
Strip all but the specified color channel from the final RGB image so the user can see the red, green or blue channels in isolation. 0 means show all channels (normal mode), 1 means show red only, 2 means show green only, 3 means show blue only. Corresponds to Display Color Channel control on Data Interpretation page.

0, 1, 2 or 3

Output BwColor
Convert the final RGB image to black & white. Useful when used in conjunction with the Output Channel feature. 0 means color, 1 means black & white. Corresponds to the control on the Data Interpretation page.

0 or 1

Color Correction
Enable color correction and gamma correction for Bayer data. This must be enabled for White Balance to work. Corresponds to the Color Correction and White Balance check on the SW Color Correction page.

Duplicated per-context.

0 or 1

Gamma Correction
Gamma correction value for Bayer data * 100. 45 means 0.45. Corresponds to Gamma control on SW Color Correction page.
Note; when ALTM is enabled, "Gamma Correction" is ignored - use "HDR Gamma Correction" instead.

Duplicated per-context.

1 to 125 (default = 45)

Black Correct
Sets a black correction amount, for Bayer data, that darkens the blacks in the image for a better appearance. Corresponds to Black Correction control on SW Color Correction page.
Note; when ALTM is enabled, "Black Correct" is ignored - use "HDR Black Correct" instead.

Duplicated per-context.

0 to 20

Contrast
Sets contrast enhancement factor for Bayer data * 20. A factor of 1.0 (contrast = 20) means no enhancement. 25 means a factor of 1.25. Corresponds to Contrast control on SW Color Correction page.

Note; when ALTM is enabled, "Contrast" is ignored - use "HDR Contrast" instead.

20 to 40 (default = 25)

Saturation
Set saturation enhancement factor for Bayer data * 10. A factor of 1.0 (saturation = 10) means no saturation boost. 0 means black & white image. Corresponds to Saturation Correction control on SW Color Correction page.

Duplicated per-context.

0 to 20

Aperture Enable
Enable software aperture correction (sharpening) on Bayer data. Corresponds to Aperture Correction checkmark on SW Color Correction page.

Duplicated per-context.

0 or 1

Aperture
Set aperture correction (sharpening) amount for Bayer data. Corresponds to Aperture Correction slider on SW Color Correction page.

Duplicated per-context.

-4 to 16

All HW Gain
Returns a list of all gain values supported by the device. Useful for gain sweeps.

All Global Gain
Returns a list of all gain values supported by the device. Useful for gain sweeps.

Software Gain
Gain applied to Bayer data * 1000. Corresponds to Software Gain control on Exposure page.

1000 to 100000 (default = 1000)

Show Min Gain As 1 
Show minimum recommended gain as 1.0. This will change the gain values shown below to be relative to the recommended minimum gain.

Gain Table 
Set tuning registers for the gain and the gain register, and optionally up to 12 tuning addresses and tuning data values.
You can only set whole registers with that table (not bitfields).

"gain" = double float
All others are integers

Master Clock
Inform DevWare of the sensor's pixel array clock frequency, in Hz. Setting this variable does not change the actual clock. This value must be set correctly for the frame rate computations, exposure controls and software auto exposure features to work properly. Normally DevWare can detect the clock rate automatically via the DEMO2 board. Corresponds to the Sensor Array Clock Speed value on the Options dialog.

Integer

Detect Master Clock
Set to 1 to trigger DevWare to re-detect the sensor array clock frequency, it returns to 0 by itself after the detection. The detection won't work if the sensor is not putting out images, so you may want to set this trigger at the end of the [Demo Initialization] section of an INI file if the sensor was brought out of a standby or non-streaming state. Corresponds to the Detect button on the Options dialog.

1

Pixel Clock Polarity
Specify which edge of PIXCLK to sample the data. Corresponds to PIXEL_CLOCK_POLARITY setting from the sensor data (.xsdat or .sdat) file No UI.

0 (falling) or 1 (rising)

Auto Exposure
Enable software auto exposure algorithm used for Bayer sensors that don't have built-in AE. The following variables control the software AE. This variable corresponds to the Auto Exposure check marks on the Exposure and Auto Exposure pages.

0 or 1

Auto Exposure Target
Relative image brightness that auto exposure should "aim for." When auto exposure is on, this is a brightness control. Corresponds to Target control on Auto Exposure page.

1 to 100 (default = 50)

Auto Exposure Stability
Hysteresis window around Target. Corresponds to Stability control on Auto Exposure page.

0 to 40 (default = 5)

Auto Exposure Speed
Sets how long it should take, in 1/10ths of seconds, for the AE to settle. 30 means three seconds. No UI.

Default = 30

Auto Exposure Minimum FPS
Reciprocal of maximum exposure time. 0 means allow any exposure time up to the maximum supported by the sensor. Corresponds to Exposure Limit control on Auto Exposure page.

0 to 30

Auto Exposure Flicker Filter
Enable anti-flicker in AE and set frequency. 0 means off. 60 means constrain exposure time to multiples of 1/120 second. 50 means constrain exposure time to multiples of 1/100 second. Corresponds to Flicker Filter control on Auto Exposure page.

0, 50 or 60

Auto Exposure Soft Limit
Try to keep exposure time below 1/softlimit (or frame readout time, whichever is greater) unless doing so would require more than Soft Gain Limit gain. No UI.

Integer (default = 33)

Auto Exposure Soft Gain Limit
Maximum gain AE should use before slowing down the frame rate * 10. Corresponds to Soft Gain Limit control on Auto Exposure page.

10 to 100 (default = 40)

Auto Exposure Software Gain Limit
Set the maximum allowed software gain that the AE will use * 10. Default is 100. Corresponds to Software Gain Limit control on Auto Exposure page.

10 to 150 (default = 100)

Auto Exposure Gain Limit
Set the maximum per-channel hardware gain that AE will use * 10. Non-HDR modes.

Auto Exposure Minimum Gain
Set the minimum per-channel hardware gain that AE will use * 10. Non-HDR modes.

Auto Exposure Minimum Global Gain
Set the minimum global hardware gain that the AE will use * 10. Non-HDR modes.

Auto Exposure Freeze Gains
1 means AE will not change the analog gains. 0 means it may. Corresponds to Freeze Gains checkmark on Exposure page.

0 or 1

Auto Exposure Fade Saturation
Automatically reduce saturation in high gain situation to reduce appearance of image noise. Corresponds to Fade Saturation checkmark on Auto Exposure page.

0 or 1

Auto Exposure Fade Aperture
Automatically reduce sharpening in high gain situation to reduce appearance of image noise. Corresponds to Fade Aperture Correction checkmark on Auto Exposure page.

0 or 1

Auto Exposure Fade Target
Automatically reduce brightness target in high gain situation to prevent excessive gain. Corresponds to Fade Exposure Target checkmark on Auto Exposure page.

0 or 1

HDR Gamma Correction
HDR Gamma correction value for Bayer data * 100. 45 means 0.45. For use with HDR tone mapping.
Note: when ALTM is disabled, "HDR Gamma Correction" is ignored - use "Gamma Correction" instead.

Duplicated per-context.

1 to 125 (default = 45)

HDR Contrast
Sets contrast enhancement factor for Bayer data * 20. A factor of 1.0 (contrast = 20) means no enhancement. 25 means a factor of 1.25. For use with HDR tone mapping.
Note: when ALTM is disabled, "HDR Contrast" is ignored - use "Contrast" instead.

Duplicated per-context.

20 to 40 (default = 25)

HDR Black Correct
Sets a black correction amount, for Bayer data, that darkens the blacks in the image for a better appearance. For use with HDR tone mapping.
Note: when ALTM is disabled, "HDR Black Correct" is ignored - use "Black Correct" instead.

Duplicated per-context.

0 to 20

MEC Mode
Set the Multiple Exposure Combination (MEC) mode.
1 = Weighted Channel Combination
6 = Digital Lateral Overflow (DLO)
3 = Smooth Combination
7 = Smooth Combination with DLO Regions
11 = Smooth Combination with Color Channel Check

MEC T1_S3
MEC T1_S4
MEC T2_S1
MEC T2_S2
MEC T2_S3
MEC T2_S4
MEC T3_S1
MEC T3_S2
MEC T3_S3
MEC T3_S4
MEC T4_S1
MEC T4_S2

Lens Correction Enable
Enable software lens correction of Bayer data. Corresponds to Enable Lens Correction checkmark on Lens Correction page.

0 or 1

Lens Correction Falloff
Set lens correction calibration desired falloff as a percentage of the center brightness 100 means no falloff. Corresponds to Allowed Falloff control on Lens Correction page.

1 to 100 (default = 100)

Lens Correction Coeff Prec
Set the bit precision of the floating point polynomial lens correction coefficients when calibrating lens correction for devices that use the polynomial algorithm. Includes a 5-bit exponent and sign bit. Corresponds to Coeff. Precision control on Lens Correction page.

7 to 16 (default = 16)

Lens Correction Center X
Lens Correction Center Y
Position of lens optical center on the sensor. Normally computed automatically during lens correction calibration.

Pixel coordinate

Lens Center Overlay
Show the lens center position on the video display. Corresponds to the Center Overlay checkmark.

0 or 1

Lens Center Red X
Lens Center Red Y
Lens Center Green1 X
Lens Center Green1 Y
Lens Center Green2 X
Lens Center Green2 Y
Lens Center Blue X
Lens Center Blue Y
Positions of per-channel optical centers. Normally computed automatically during lens correction calibration. No UI.

Pixel coordinates

Lens Sim Sensor
When DevWare has an image loaded, it can simulate the hardware lens correction of certain sensors. This selects which sensor to simulate. Corresponds to the selection on the LC Simulation page.

mi_sensor_types (midlib.h) A-2010SOCJ = 16
A-5100 = 22
A-2020SOC = 23
A-3120 = 25
A-2020 = 27
A-8130 = 33

Lens Sim Sensor Rev
The rev of the simulated sensor. Corresponds to the selection on the LC Simulation page.

Integer

Lens Sim Enable Pwq
Enable simulation of hardware lens correction block for simulations that use the non-polynomial algorithm. Corresponds to Enable Lens Correction checkmark on LC Simulation -> Adjustment page.

0 or 1

Lens Sim Enable Poly
Enable simulation of hardware lens correction block for simulations that use the polynomial algorithm. Corresponds to Enable Lens Correction checkmark on LC Simulation -> Polynomial.

0 or 1

Noise Removal
Sets software noise reduction algorithm(s). Corresponds to checkmarks on Noise and Defects page.

0, 1, 2, 4, or combination
1 = High/Low
2 = Average-Near
4 = Adapting Average-Near
8 = Flat Region Filter

Noise Removal Level
Sets noise removal threshold. Corresponds to Aggressiveness slider on Noise and Defects page.

Integer (default = 25)

Defect Enable
Enable defect correction algorithm. Corresponds to Enable checkmark on Noise and Defects page.

0 or 1

Defect Max
Maximum number of defects to store. Corresponds to Maximum Defects value on Noise and Defects page.

Integer (default = 1000)

Defect Auto Defect Correction
Enable automatic re-evaluation of the defect map. Corresponds to Auto Update Defect Map on Noise and Defects page.

0

Optical Black

The software can do black level adjustment if black row and/or black column readout is enabled on the sensor. 1 enables global black level calculation and subtraction. 2 enables column-wise black level correction (based on black rows). 4 enables row-wise black level correction (based on black columns).

0, 1, 2, 4 or combination

Optical Black Level Rect

If Optical Black is 1 then use this rectangle to calculate the black level.

Four integers defining a rectangle; x1, y1, x2, y2

Optical Black 1 Row Start

Optical Black 1 Row End

Optical Black 2 Row Start

Optical Black 2 Row End

Optical Black 1 Column Start

Optical Black 1 Column End

Optical Black 2 Column Start

Optical Black 2 Column End

Identify the optical black rows and black columns in the image, for use by the optical black correction algorithms. Two sets of black rows can be defined (usually at the top and bottom of the image), and two sets of black columns can be defined (usually at the left and right of the image). This only applies if the black rows or black columns readout is enabled on the sensor.

integer

Update Sensor FPS
Trigger DevWare to re-compute the sensor FPS. Only needed on SOCs with auto-exposure. No UI.

1

Allow Update Sensor FPS
Don't re-compute sensor FPS. Re-computing the FPS requires register access transactions which affect performance. Corresponds to Allow Sensor FPS Polling checkmark on the Options dialog.

0 or 1

Allow FAR Access
Let DevWare access registers on attached sensors. May interfere with firmware operation. Corresponds to Allow FAR Access checkmark on the Options dialog.

For the mobile ISP products (MT9F311, AP1301, AP1302), it is required to only allow addresses that return an ACK when accessed (known-good addresses). Use a value >1 will add that address to the known-good address list.
For all other parts, 0 will disallow all addresses and 1 will allow all addresses.

0 = allow known addresses
1 = allow all addresses
>1 = add address to known-good address list

sRGB Color Standard
Use sRGB coefficients for converting YCbCr data to RGB. Normally set automatically based on the register settings. No UI.

0 or 1

White Balance
Enable software white balance for Bayer data. Color Correction must be on for this to take effect. 0 means off (use identity color correction matrix, CCM), 1 means automatic, 2 means manual adjust based on WB Manual variables below, 3 means full custom CCM. Corresponds to controls on software White Balance page.

Duplicated per-context.

0, 1, 2, or 3

WB Speed
How long it should take for auto white balance (AWB) to settle, in 1/10ths of seconds. No UI.

Integer

WB Adjust Gains
Allow software AWB to adjust analog gains on the sensor. If this is off AWB will only adjust the CCM. Corresponds to Adjust Relative Gain checkmark on the White Balance page.

0 or 1

WB Apply Gains to CCM
Merge white balance gains into CCM.

WB Current
Returns the current AWB CCM.

Duplicated per-context.

Relative Red Gain
Ratio of red analog gain to green analog gain * 1000. Default depends on sensor, normally around 1000. No UI.

500 to 5000

Relative Blue Gain
Ratio of blue analog gain to green analog gain * 1000. Default depends on sensor, normally around 2000. No UI.

500 to 5000

WB Manual Position
Interpolation between Left and Right matrices on a scale from 0 to 100, with 0 corresponding to the Left matrix and 100 corresponding to the Right matrix. Corresponds to the Manual slider on the White Balance page.

Duplicated per-context.

0 to 100

WB Manual RedGreen
Extra red gain * 100. Corresponds to Relative Red control on White Balance page.

Duplicated per-context.

1 to 200 (default = 100)

WB Manual BlueGreen
Extra blue gain * 100. Corresponds to Relative Blue control on White Balance page.

Duplicated per-context.

1 to 200 (default = 100)

WB Custom
Color correction matrix to use in Custom white balance mode. Specify all nine values in row major order in floating point. Corresponds to Custom matrix on White Balance page.

Duplicated per-context.

Matrix (default =
1.0 0 0
0 1.0 0
0 0 1.0)

AWB Incandescent
Color correction matrix corresponding to Incandescent illumination. Specify all nine values in row major order in floating point.

Matrix

AWB Sun
Color correction matrix corresponding to solar illumination. Specify all nine values in row major order in floating point.

Matrix

AWB Incandescent Gain
Color correction red/green and blue/green gain values corresponding to incandescent illumination. Specify two values in floating point.

Two floating point values

AWB Sun Gain
Color correction red/green and blue/green gain values corresponding to solar illumination. Specify two values in floating point.

Two floating point values

CFA Pattern
Tells DevWare what kind of color filter array the sensor has. 0 means monochrome (no CFA), 1 means Bayer, 2 means Paired Bayer (used on MT9V125/A-0345SOC), 3 means RGBC (Bayer with Gr replaced with clear), 4 means Clarity+ (RCCB), 5 means AR0834AI (1/4 Bayer, 3/4 mono), 6 means RCCC (Bayer with only Red and clear), 7 means RGBC infrared 2x2, 8 means RGB-IR 4x4, 9 means SuperCell, 10 means RCCG, 11 means SuperCell 2x1, 12 means RYYCy, 13 means Radar 4x1, 14 means LiDAR

Note: once set, the list of individual filters available for the given pattern can be seen in DevWareX's "Data Interpretation" dialog and can be selected via the "Filter" STATE command.

0 to 10

Monochrome
Indicates sensor is a monochrome sensor. Corresponds to Monochrome sensor checkmark on Startup Wizard.

0 or 1

Pure Raw JPEG
A debug mode that forces DevWare to not try to interpret JPEG data from the sensor. The data is displayed as black&white pixels at one pixel per byte of data. Corresponds to the Pure Raw JPEG checkmark on the JPEG page.

0 or 1

Still Mode
Type of still image capture. 0 means use current image coming from sensor, 1 means switch sensor to full resolution mode or use still capture sequence on SOC, 4 means full resolution continuous mode on supported SOCs.
Corresponds to Capture control on Still Capture page.

0, 1 or 4

Still Hold
Enables a one-click option for still images; immediately goes back to Preview instead of holding the still image and displaying it in the Film Strip.

0 or 1

Num Capture Frames
Number of images to capture. Corresponds to Total Frames value on Still Capture page.

1 or more

Still Capture Average
Enables averaging all still images into one image. Corresponds to Average into One Frame checkmark on Still Capture page.

0 or 1

Still Capture Timeout
Set a timeout to give up if a valid still image frame does not arrive from the sensor, in seconds. Corresponds to Timeout (secs) value on Still Capture page.

Integer

Delay before snap
Delay before capturing still image, and between each image if Num Capture Frames is more than 1, in milliseconds. Corresponds to Delay (msec) value on Still Capture page.

Integer

Still Global Reset
Set whether to use Global Reset with still image capture. Global Reset exposes all pixels in the sensor simultaneously, instead of row sequentially (electronic rolling shutter, ERS). Normally it's necessary to use a mechanical shutter with Global Reset. Corresponds to Use Global Reset checkmark on Still Capture page.

0 or 1

Flash Lamp
Set whether to use a flash lamp with still image capture and what type of flash lamp is attached. 0 means no flash, 1 means Xenon flash, 2 means LED flash. Corresponds to Flash Lamp controls on Still Capture page.

0, 1 or 2

WB Custom Xenon
Color correction matrix to use when taking a Xenon flash still image. Specify all nine values in row major order in floating point. Only applies to A-0360SOC (MT9V111). Corresponds to controls on Still Capture page.

Matrix

WB Xenon Red Gain
WB Xenon Blue Gain
Ratios of red gain to green gain and blue gain to green gain to use when taking a Xenon flash still image * 1024. Corresponds to Flash Analog Gain Adj. controls on Still Capture page.

500 to 5000

WB Custom Led
Color correction matrix to use when taking an LED flash still image. Specify all nine values in row major order in floating point. Only applies to A-0360SOC (MT9V111). Corresponds to controls on Still Capture page.

Matrix

WB Led Red Gain
WB Led Blue Gain
Ratios of red gain to green gain and blue gain to green gain to use when taking an LED flash still image * 1024. Corresponds to Flash Analog Gain Adj. controls on Still Capture page.

500 to 5000

Mechanical Shutter Same
Set the mechanical shutter time equal to the electronic rolling shutter exposure time when taking a still image. Corresponds to Use Current Electronic Exposure Time control on Mech. Shutter page.

0 or 1

Mechanical Shutter Time
Sets the mechanical shutter time, when Mechanical Shutter Same is 0. Corresponds to Exposure Time control on Mech. Shutter page.

microseconds

Mechanical Shutter Delay
Value subtracted from Mechanical Shutter Time when computing the sensor register values, to allow for mechanical lag. Corresponds to Mechanical Delay control on Mech. Shutter page.

microseconds

Save RAW
Save unprocessed still image data as unformatted binary data. Corresponds to RAW checkmark on Save Options page.

0 or 1

Save RAW TIFF
Save unprocessed Bayer still image data in monochrome TIFF format. Corresponds to TIFF (raw) checkmark on Save Options page.

0 or 1

Save ITX
Save unprocessed still image data in ITX format, ASCII decimal values with a header. Corresponds to ITX checkmark on Save Options page.

0 or 1

Save CCR
Save unprocessed still image data in CCR format. Corresponds to CCR checkmark on Save Options page.

Save DXR
Save unprocessed still image data in DXR format. Corresponds to DXR checkmark on Save Options page.

Save RAW JPEG
Save JPEG compressed still image data unmodified from the JPEG compression module on the sensor, with a header added by DevWare. Corresponds to JPEG (raw) checkmark on Save Options page.

0 or 1

Save RAW PNG
Save unprocessed Bayer still image data in monochrome PNG format. Corresponds to PNG (raw) checkmark on Save Options page.

0 or 1

Save HEX
Save unprocessed still image data in ASCII text with tab-separated decimal (in spite of the fact the variable is called Save HEX) values, with a footer at the end. Corresponds to TAB (dec) checkmark on Save Options page.

0 or 1

Save 24bpp BMP
Save processed still image in Windows BMP 24 bits/pixel RGB format. Corresponds to BMP (24bpp) checkmark on Save Options page.

0 or 1

Save BMP Info
Append additional image information to the end of the BMP file. Not compatible with some applications. Corresponds to w/ Info checkmark on Save Options page.

0 or 1

Save 48bpp COLOR TIFF
Save processed still image in RGB TIFF format, 48bpp if original data is Bayer, 24bpp otherwise. Corresponds to TIFF (48bpp) or TIFF (24bpp) checkmark on Save Options page.

0 or 1

ICC Profile
Save an ICC profile in the RGB TIFF file. Corresponds to ICC Profile checkmark on Save Options page.

0 or 1

Save PNG
Save processed still image in PNG 24 bits/pixel RGB format. Corresponds to PNG (24bpp) checkmark on Save Options page.

0 or 1

Save JPEG
Save processed still image in JPEG format. DevWare will convert the processed RGB image to JPEG. Corresponds to JPEG (s/w) checkmark on Save Options page.

0 or 1

JPEG Quality (1-100)
Compression quality setting to use when compressing the still image to JPEG. Corresponds to the Quality value on the Save Options page.

0 to 100

Save Selection Rectangle
When saving a still image, whether to save the whole image or just the Mouse Selection Rectangle. 1 means save only the selection rectangle. Corresponds to Save Mouse Selection Rectangle only checkmark on the Save Options page.

0 or 1

Save TXT
Save a dump of all registers and DevWare STATE variables. Corresponds to TXT (registers) checkmark on the Save Options page.

0 or 1

VidCap Format
Video recording format. 0 = AVI; 1 = RAW; 2 = WMV. Corresponds to the Video File Format choice on the Video Record page.

0, 1, or 2

VidCap Play FPS
Playback frame rate for recorded video file. Corresponds to the playback frame rate box on the Video Record page.

fps * 1000

VidCap Auto Play FPS
Whether to set the playback frame rate automatically, or use VidCap Play FPS. Corresponds to the playback frame rate check boxk on the Video Record page.

0 or 1

Video Screen Capture
Whether to switch sensor to video capture mode before recording data. Corresponds to the Screen Capture Only checkmark on the Video Record page.

0 or 1

VidCap File
Name of video record file. Corresponds to the filename entry on the Video Record page.

filename

VidCap Filename Increment
Whether to add a sequence number to the filename. Corresponds to the Auto File Name Increment checkmark on the Video Record page.

0 or 1

RAM Capture
Whether to record video data to RAM buffers first before writing to a file. Doing so will improve capture performance, but only until the RAM is full. Corresponds to Capture to RAM checkmark on Video page.

0 or 1

RAM Capture MB
How many megabytes of RAM to allocate to video capture. Corresponds to RAM buffer size value on Video page.

Integer

RAM Capture Cycle
When capturing to RAM and the RAM buffers fill, whether to flush the buffers to disk and continue, flush the buffers to disk and stop recording, or cycle through the buffers again (circular buffer). Corresponds to the radio buttons on the Video page.

0 = flush and continue
1 = flush and stop
2 = circular buffer

Pixel Clock Polarity
Calls the midlib function setMode() MI_PIXCLK_POLARITY. Overrides the pixel clock polarity setting from the sensor data file.
0 for rising, 1 for falling. Equates to the "Sample data on" field in Sensor Control dialog for the demo headboard.

0 or 1

Sensor Power
Calls the midlib function setMode() MI_SENSOR_POWER. Turns off sensor head board power if the camera board supports it.

0 or 1

Sensor Reset
Calls the midlib function setMode() MI_SENSOR_RESET. Sets the sensor RESET pin.

0 or 1

Sensor Shutdown
Calls the midlib function setMode() MI_SENSOR_SHUTDOWN. Sets the sensor SHUTDOWN pin on headboards with this signal.

0 or 1

SHiP Speed
Calls the midlib function setMode() MI_SHIP_SPEED. Sets the I2C bus speed, in KHz.

100, 400, or 1000

Direct VAR Access
Calls the midlib function setMode() MI_DIRECT_VAR_ACCESS. Determines whether to use the direct or indirect method of accessing firmware variables on SOC devices that support both methods.

0 or 1

RX Type
Calls the midlib function setMode() MI_RX_TYPE. Sets the data connection between the sensor and the main board. Values 0 through 4 are Disabled, Parallel, CCP, MIPI, and HiSPI respectively.

Calls the midlib function setMode() MI_RX_LANES. Sets the number of data lanes between the sensor and the main board.

Calls the midlib function setMode() MI_RX_BIT_DEPTH. Sets the serial bit depth between the sensor and the main board.

Calls the midlib function setMode() MI_RX_MODE. Sets the HiSPI mode.

Calls the midlib function setMode() MI_RX_CLASS. Sets the CCP class.

Calls the midlib function setMode() MI_RX_SYNC_CODE. Sets the HiSPI sync codes.

Calls the midlib function setMode() MI_RX_EMBEDDED_DATA. Sets whether embedded data will be sent over the serial link.

Calls the midlib function setMode() MI_RX_VIRTUAL_CHANNEL. Sets the MIPI virtual channel.

Calls the midlib function setMode() MI_RX_MSB_FIRST. Sets the bit order for HiSPI transmission.

Calls the midlib function setMode() MI_RX_CCIR656. Sets whether the main board should interpret CCIR656 sync codes.

HW Red Gain
Not really a software variable, this sets the gain register on the sensor given a floating point gain value.

Floating-point value

HW Green1 Gain
Not really a software variable, this sets the gain register on the sensor given a floating point gain value.

Floating-point value

HW Green2 Gain
Not really a software variable, this sets the gain register on the sensor given a floating point gain value.

Floating-point value

HW Blue Gain
Not really a software variable, this sets the gain register on the sensor given a floating point gain value.

Floating-point value

HW Gain
Not really a software variable, this sets the gain register on the sensor given a floating point gain value.

Floating-point value

HW Exposure Time
Not really a software variable, this sets the integration time register on the sensor given a floating point time value, in seconds.

Floating-point value

Exposure Table
Creates a custom exposure table.  This structure is used for the user-defined gain table (mapping from gain value to register value).  Maximum of 8 tables, each with maximum 64 register/data pairs.

STATE= Exposure Table, index; reg0 data0; reg1 data1; ....

Calculate Focus
Disable/Enable the generation of the "Focus Assist" Focus Metric.

0 or 1

Calculate Focus Overlay
Disable/Enable the display overlay of the Focus Metric value and the portions of the display being used to generate it.

0 or 1

Focus
When Calculate Focus is enabled, the value of the Focus Metric.

Integer

Noise Results JSON
After the noise measurement is completed, this is the results in JSON format.

d = ap_GetStateStr(apbasedev, b'Noise Results JSON') 
d = json.loads(d)

Send to Viewer
When set, the next frame will be sent to Aptina Viewer. Automatically returns to 0.

Product Variant
Set the Product Variant string, which shows on the Info dialog. This can be any string value.

Also, if the string matches a known "CFA Pattern", that Color Filter Array will be enabled.
The "CFA Pattern" value is used with the following strings;
"MONO" = 0
"BAYER" = 1
"RGBC" = 3
"RCCB", "ClarityPlus" or "Clarity+" = 4
"RCCC" = 6
"RGBI" = 7  (RGB-IR 2x2)
"RGBI4" = 8  (RGB-IR 4x4)
"SuperCell" = 9
"RCCG" = 10
"SuperCell2" = 11
"RYYCy" = 12
"RADAR" = 13
"LIDAR" = 14

Note: only use the string value in quotes - the numbers listed after the string are supplied as a cross-reference to their associated "CFA Pattern" STATE command values.

"invoke" = invoke pipeline

"live" = show live images

"rgb" = show processed RGB images

"nir" = shows processed NIR images

RGBIR CCN
RGB-IR plugin use. IR Separation Matrix. 

Can be generated by SensorTune with the "IR Separation Matrix Calculation" option, and via the RGB-IR plug-in GUI.

RGBIR Denoise
RGB-IR plugin use. When 1, perform the Denoise function. When 0, do not. Default 0.

Note; this is compute intensive.

RGBIR Sat Pixel Threshold
RGB-IR plugin use. Pixel saturation % threshold. Default 85.

The plug-in skips the CCN processing where pixels are close to saturation.
You can avoid it by setting the saturated pixel threshold to 100 so all pixels are included in CCN processing.

A value of 101 is needed if you want to treat all pixels as non-"saturated". 100 still treats fully saturated pixels as "saturated". ("Saturated" pixels don't get the CCN matrix step.)

User Text Top Left
User Text Top Right
User Text Bottom Left
User Text Bottom Right
The supplied text string is placed at the specified location.