SightLine Applications Command, Control, and Script API  v3.4
List of all members
SLASetAcquisitionParameters_t Struct Reference

Description

Configure video input for digital camera interfaces.

typedef struct {
u8 cameraIndex;
u8 cameraType;
u16 high;
u16 wide;
u8 bitDepth;
u16 vertFrontPorch;
u16 horzFrontPorch;
u16 flags;
u8 frameStep;
u8 reserved;
u16 validRow;
u16 validCol;
u16 validHigh;
u16 validWide;
SVPLenString_t optArgs;
u16 bigHigh;
u16 bigWide;
u16 bigVertFrontPorch;
u16 bigHorzFrontPorch;
u8 camSwitchIndex;

See EAN-Digital-Video-Configuration.pdf for more information.
See also camera configuration table for detailed parameter settings.
See also SLAAdvancedCaptureParameters_t.

NOTE1: For changes to the acquisition settings to take effect, a board reboot should be performed, by issuing SLASaveParameters_t (0x25) and SLAResetAllParameters_t (0x01) (Reset Type = 2, reboot) messages. SLACameraSwitch_t can change cameras on the fly for some custom systems.
NOTE2: Systems cannot support different analog video formats on different analog ports. For example, when one analog video port is set to NTSC, all of the analog video ports are set to NTSC. You also can't have one port as NTSC/PAL and the other port as None.
NOTE3: Image Height, Width, and Bit Depth are ignored except in Generic Digital Mode

Camera initialization routine

Assuming the appropriate adapter board or communication signals are connected, the VideoTrack software will try to configure the camera with the specified values or other known settings. This is done in order to improve the user experience by removing the need for the customer to preconfigure the camera. For example, the FLIR TAU is set to CMOS mode and 8 - bit output. See also SLACommandPassThrough_t.

Camera Type

Type IDDescriptionHardware Support
0NoneIndicates that there is no adapter board present.
NOTE: Setting a valid camera adapter board to None will result in default mode settings for that camera, not None, after a restart.
1NTSCNTSC video mode. Sets all analog camera ports the same (see NOTE2 above).
1500: Automatically detect NTSC or PAL, defaults to NTSC if no analog camera is connected. Also sets analog video display to NTSC or the auto detected mode. See NOTE1 above and SLAVideoDisplay_t.
3000/4000: Set analog video input to NTSC mode. See SLAVideoDisplay_t to control analog video output
NTSC Image Size: The analog video decoder hardware captures non-"square pixel" 720 wide by 480 high digital images. Capture snapshots are this 720x480 size and objects will appear slightly stretched horizontally.
The captured images are resampled horizontally into 640x480 images before Analyze, Render and Display. This creates a "square pixel" image. Objects will not appear stretched.
Network video output and Display snapshots are 640x480 and all other processing (such as tracking) is based on the 640x480 image size.
It is possible (though not usually recommended) to modify the horizontal resampling with SLAAdvancedCaptureParameters_t.
2Generic DigitalGeneric Digital Interface. Uses high, wide, bitDepth, vertFrontPorch, horzFrontPorch, and flags
3 - 6Reserved
7HD-SDI 720P50/601500: Sony FCB-EH 6000 / 3000 series
3000/4000: HD-SDI 720P
8HD-SDI 1080P1500: Sony FCB-EH 6000 series
3000/4000: HD-SDI 1080P
9Reserved
10FLIR TAU 640 8 BitUse for 1500 connection to 640 Tau, otherwise use Generic Digital with InitQuark/Tau. See EAN-FLIR-Cameras.pdf
11FLIR TAU 640 14 BitUse for 1500 connection to 640 Tau, otherwise use Generic Digital with InitQuark/Tau
12Reserved
13PALForce analog video input to PAL mode. Sets all analog camera ports to PAL (see NOTE2 above).
1500: Also forces analog video display to PAL mode. Set NOTE1 above and SLAVideoDisplay_t.
3000/4000: see SLAVideoDisplay_t to control analog video output
PAL Image Size: The analog video decoder hardware captures non-"square pixel" 720 wide by 576 high digital images. Capture snapshots are this 720x576 size and objects will appear slightly squished horizontally.
The captured images are resampled horizontally into 768x576 images before Analyze, Render and Display. This creates a "square pixel" image. Objects will not appear squished.
Network video output and Display snapshots are 768x576 and all other processing (such as tracking) is based on the 768x576 image size.
14Reserved
15Hitachi 720 PHitachi DI-SC120R color block camera. See EAN-Hitachi-Block.pdf
16DRS Tam 640 8 bit DRS Tamarisk 640x480. See EAN-DRS-Tamarisk-Camera.pdf.
17DRS Tam 640 14 bit DRS Tamarisk 640x480
18DRS Tam 320 8 bit DRS Tamarisk 320x240
19DRS Tam 320 14 bit DRS Tamarisk 320x240
20Alticam Barracuda 600PAlticam Barracuda 800x600
21Reserved
22NTSC VBINTSC camera with VBI data
23Sony FCB-EV 720PSony(1) FCB-EV 7000 / 5000 series. See EAN-Sony-Block-Cameras.pdf
24Sony FCB-EV 1080PSony(1) FCB-EV 7000 series
25FLIR TAU 320 8 BitUse for 1500 connection to 320 Tau, otherwise use Generic Digital with InitQuark/Tau. See EAN-FLIR-Cameras.pdf
26FLIR TAU 320 14 BitUse for 1500 connection to 320 Tau, otherwise use Generic Digital with InitQuark/Tau
27Reserved
28Special3000 only
29BT.656 NTSCDigital NTSC 29.97 Hz
30BT.656 PALDigital PAL 25 Hz
31 - 32*Reserved*
33Sony FCB-EH 720PFCB-EH 6000 / 3000 series. See EAN-Sony-Block-Cameras.pdf
34Sony FCB-EH 1080PFCB-EH 6000 series
35IP Camera3000 only. Receives IP video camera input. See EAN-Decoder.pdf for more information. New 2.25
36USB3 Vision4000 only. Cameras compatible with the USB3 Vision Standard Specification. New 3.0
37USB Webcam4000 only. USB Video Device Class (UVC) compatible webcams. Use optArgs to set internal format and frame rate settings. New 3.0
132Test Pattern LogoTest patterns may take significant time to render, affecting system performance.
NOTE: 1500 only allows test patterns on cameras 0 and 1 and a test pattern on 1 only with a test pattern on 0.
136Test Pattern Car
137Test Pattern Still
141Test Pattern Multi Car
143Test Pattern Landing Aid
145Test Pattern Color Bar
146Test Pattern Low Contrast Boxes
  1. Sony FCB-EV 7000 / 5000 series cameras require a power cycle when changing between 720 and 1080 resolutions.

Digital Video Flags

Note
On 1500, these flags only apply to camera index 2.
BitsDescription
0 - 2Input data mode
0Grayscale
1YUV color
28 bit grayscale, but input as 16 bit
3Bayer color in RGGB order
415 bit grayscale plus 1 bit "laser" indicator in the msb
5 - 7*Reserved*
30 = progressive(default), 1 = interlaced
NOTE: ROI is not supported on 4000 for interlaced cameras like NTSC/PAL.
4Vertical Sync Polarity(0 = negative, 1 = positive for Sony 7500, etc.)[default 0]
5Horizontal Sync Polarity(0 = negative, 1 = positive for Sony 7500, etc.)[default 0]
6 - 9Camera Initialization Routine. Called with parameters specified above in this message.
0No Initialization Routine(InitNoop)[default]
1InitSony / VISCA(resolution(high)). See EAN-Sony-Block-Cameras.pdf
2InitDRS(bitDepth). See EAN-DRS-Tamarisk-Camera.pdf.
3InitQuark / Tau(bitDepth). See EAN-FLIR-Cameras.pdf
1500: Quark
3000/4000: Quark and Tau
4InitPhoton(bitDepth)
5InitCameraLinkLowSpeed(bitDepth)
6InitTau(bitDepth). See EAN-FLIR-Cameras.pdf
1500: Direct Connect, TAU - FFC Rev A
7Reserved
8InitAR0134CS – Airborne Innovations AGS720p, FPGA Version 10. See EAN-Airborne-Innovations-Cameras.pdf
9InitCameraLink
10InitBoson. See EAN-FLIR-Cameras.pdf
10 - 11Sync / Crop Option(3000/4000)
0None[default]
1use Data Valid signal
2use Embedded Sync
3use Hardware Crop
12Reserved
132x Hardware Binning(4000)
14Byte Swap(3000/4000)
15Reserved Special(3000)

Message ID 0x37

Byte Offset Name Description
4cameraIndexCamera index – please refer to the Hardware ICD for additional information about video ports and capabilities
Board Camera Index 0 Camera Index 1 Camera Index 2 Camera Index 3
1500 Analog 0 Analog 1 Digital 2 NA
3000 J3/Vin 0 J3/Vin 0 (when used as two 8-bit inputs) J4/Vin 1 NA
4000 J1 Digital Input Adapter J6 MIPI B USB 0 USB 1
5cameraTypeCamera Type
6-7highImage Height (0 for default)
8-9wideImage Width (0 for default)
10bitDepthBit Depth (0 for default, 8 to 16)
NOTE: For 1500/3000 and a high bit depth camera with all 16 bits active, it is necessary to set this value to 16 to prevent image overflow issues. If the camera has more than 8, but less than 16 active bits, it is ok to set it to 15 or less.
11-12vertFrontPorchVertical Front Porch in lines (0 for default)
13-14horzFrontPorchHorizontal Front Porch in pixels (0 for default)
15-16flagsDigital Video Flags – on 1500 these flags only apply to camera index 2.
17frameStepFrame Step – step between captured frames; 0 = ignore, 2 = every other (default 1)
18reservedReserved
19-20validRowValid ROI row – valid ROI specifies a dynamically changeable subregion of the complete acquired image frame. Unlike other parameters in this message, the valid ROI parameters take effect immediately, rather than require a system restart.
NOTE: Not supported on 4000 for interlaced cameras like NTSC/PAL.
21-22validColValid ROI column
23-24validHighValid ROI height - Minimum 120, Maximum 1080 (2160 on 4000) (0 - use image size).
25-26validWideValid ROI width - Minimum 160, Maximum 1920 (3840 on 4000) (0 - use image size).
27 optArgs.len string length
28-...optArgs.str

Comma separated optional arguments for camera setup. Specify with name1=value1[, name2=value2]. Example: fmt=UYVY, fps=60

PlatformCameraNameDescriptionExample
4000USB Webcam (UVC)fpsFrame rate in frames per second. System will choose the closest supported frame rate.fps=30
4000USB Webcam (UVC)fmtImage format: MPEG2, MPEG4, H264, H265, MJPEG, NV12, YUYV, UYVY, YUV420
NOTE: The system will look for a format in the above order and will not capture if given an invalid format
List formats with: v4l2-ctl –list-formats-ext -d /dev/videoN (N is 0 to 10)
fmt=MJPEG
4000Mipi Board CameramipiCam1 only mipi driver name. Options:
imx219 - Raspberry Pi Camera Module V2.0
imx296 - VC MIPI IMX296
imx412 - VC MIPI IMX412
imx412_2lane - VC MIPI IMX412 2 lane mipi operation (slower, 15 pin cable)
ov5647 - Raspberry Pi Camera Module V1.0
ov9281 - VC MIPI OV9281
mipi=imx412
4000Sony FCB-ER 8000 seriesmipiCam1 only mipi driver name. Options:
lt6911 - Sony FCB-ER 8000 series
mipi=lt6911
4000Sony FCB-ER 8000 seriesfpsFrame rate in frames per second. System will choose the closest supported frame rate. Valid options:
720: 50, 60 (default 60)
1080: 24, 25, 30, 50, 60 (default 30)
2160p: 24, 25, 30 (default 24)
fps=30
4000HDMIfpsFrame rate in frames per second. For 1080p, can be set to 60 (default 30)fps=60
4000Advancedmipi_txlMipi Transmit Lanes 1,2,4mipi_txl=4
4000Advancedmipi_clkMipi Receiver clock rate Mhz
This affects both the MIPI CSI frequency and the TSettle count
See EAN-4000-OEM-MIPI-Cameras
mipi_clk=200
4000Advancedfpgaprefix of fpga files (.iea,.ied) to loadfpga=GEN_HD

Specific Camera Examples:

CameraExampleDescription
e-con See3Cam_CU30fmt=UYVY, fps=30Send raw (at 30 fps) instead of default MJPEG (at ~21 fps)
Raspberry-Pi V2mipi=imx219Raspberry-Pi V2 uses the imx219 driver

variesbigHighJPEG Big Snapshot High
variesbigWideJPEG Big snapshot Wide
variesbigVertFrontPorchJPEG Big Vertical Front Porch in lines
variesbigHorzFrontPorchJPEG Big Horizontal Front Porch in pixels
variescamSwitchIndexcamera switch index used for on the fly camera switch