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

Description

Blend an EO(visible) and an IR camera with video scaling and shifting to align frames.

typedef struct {
u8 absOffZoom;
s8 vertical;
s8 horizontal;
u8 rotation;
u8 zoom;
u8 mode;
u8 amt;
u8 hue;
u8 flags;
u8 reset;
u8 reserved;
u8 warpIndex;
u8 fixedIndex;
u8 usePresetAlign;
u8 presetAlignIndex;
u8 hzoom;
u8 hotStart;
u8 coldEnd;

When both cameras are standard definition with similar fields of view, set Absolute Zoom Mode off to scale the EO camera to match the IR. When the warp camera is HD, Absolute Zoom Mode can be turned on for larger zoom factors. For example, if a 1280x720 HD camera is blending with a 640x480 camera where the horizontal fields of view match, pass zoom = 128 and zoom absolute = 1 to get a zoom factor of 0.5 which will scale the HD image to 640x360 before blending.
Requires SLAVideoDisplay_t be used to set Display Modes to Blend. See also SLASetMultipleAlignment_t, SLAFourAlignPoints_t and SLACurrentBlendParameters_t.
NOTE: 3000/4000 Only

Message ID 0x2F

Byte Offset Name Description
4absOffZoomOffset and zoom modes
BitDescription
0
  1. interpret vertical and horizontal as incremental offsets
  2. interpret as absolute offsets
1-3Zoom multiplier
0 - zoom (1..255) maps to (0.9..1.1) – useful when both cameras are SD or have matching pixel size on target
1-7 - zoom maps to N*(0.004..0.996) – useful when one camera is HD and the other is SD
4-7Reserved
5verticalShift warp camera index video position vertically.
6horizontalShift warp camera index video position horizontally
7rotationRotate warp camera index video; (1..255) maps to (-5..5) degrees; 0 = no change
8zoomScale warp camera index video. (1..255) maps to (0.9..1.1) or (0.004..0.996) depending on absOffZoom
9mode
ValueBlend ModeDescription
0 No change -
1 Frame Blend Warped EO Basic percentage (controlled by amt) blending of the warped EO and fixed IR images.
Optionally applies yellow hue from bright areas in the warped EO image to the output.
See flags below for optional histogram equalization
2 Thermal Blend Warped EO Blends hot pixels from the fixed IR camera (shown in red) with the warped EO image.
Typically used to highlight hot areas in a daytime EO image.
3 Night Blend Warped EO Blends bright areas from the warped EO camera (modify color with hue) with the fixed IR image.
Typically used to highlight bright lights in a night time IR image.
4 Color Blend Warped EO Percentage (controlled by amt) blending of the warped EO and fixed IR images.
Like Frame Blend, but the color from the warped EO image is also passed to the output (also controlled by hue).
5 Reserved -
6 Frame Blend Fixed EO Basic percentage (controlled by hue) blending of the fixed EO and warped IR images.
Optionally applies yellow hue from bright areas in the IR image to the output.
7 Thermal Blend Fixed EO Blends hot pixels from the fixed EO camera (shown in red) with the warped IR image.
Typically used to highlight hot areas in a daytime EO image.
See flags below for optional histogram equalization
8 Night Blend Fixed EO Blends bright areas from the fixed EO camera (modify color with hue) with the warped IR image.
Typically used to highlight bright lights in a night time IR image.
9 Color Blend Fixed EO Percentage (controlled by amt) blending of the fixed EO and warped IR images.
Like Frame Blend, but the color from the fixed EO image is also passed to the output (also controlled by hue).
10 Color IR Blend Fixed EO Percentage (controlled by amt) blending of the fixed EO and the user palette colored warped IR images.
Like Frame Blend, with the color from the fixed EO and user palette colored IR also blended. See SLASetUserPalette_t
11 Color IR Blend Warped EO Percentage (controlled by amt) blending of the warped EO and the user palette colored fixed IR images.
Like Frame Blend, with the color from the fixed EO and user palette colored IR also blended. See SLASetUserPalette_t
others Reserved -
10amtAmount of luminance information from the EO (visible) camera to include in the blended result.
0 = no change, (1..255) maps to (0..100%).
Applies to Frame Blend, Night Blend, Color Blend, Thermal Blend and Color IR Blend modes
11hueAmount of yellow hue to apply from bright areas of the EO camera.
0 = no change, 1 = no hue, 255 = full hue
12flags
BitsValueDescription
00Apply histogram equalization to infrared image in Thermal Blend modes (legacy/default behavior)
1Don't apply histogram equalization to infrared image in Thermal Blend modes New 3.2
1-7-Reserved
13resetCalibration reset (0 or 1). Resets the image warp calibration (zoom, rotate, shift up / down / left / right) back to default
14reservedReserved
15warpIndexWarp camera index – video from this camera is warped into the space of the other camera through the calibrations settings before blending
16fixedIndexFixed camera index – video from this camera is not warped before blending
17usePresetAlignImage alignment parameter index.
0 Use the alignment parameters in this message.
1 Use a preset alignment (defined by SLASetMultipleAlignment_t or SLAFourAlignPoints_t) and set index of preset alignment parameters to value of presetAlignIndex
18presetAlignIndexIndicate index of preset alignment parameters – ignored if usePresetAlign is 0.
Indexes 0..4 are used for alignment sets defined by SLASetMultipleAlignment_t.
Indexes 10..14 are used for alignment sets defined by SLAFourAlignPoints_t.
19hzoomHorizontal zoom scale applied to EO camera (1..255, 0=no change) on top of zoom. maps to (0.9..1.1)
Verical zoom = zoom
Horizontal zoom = hzoom * zoom
20hotStartPixel value to start hot pallet of Thermal Blend. Only applies to Thermal blend mode (ignored otherwise). Should be more than coldEnd.
21coldEndPixel value to end cold pallet of Thermal Blend. Only applies to Thermal blend mode (ignored otherwise). Should be less than hotStart.