Skip to content

tiovxisp

Rahul T R edited this page Jun 26, 2023 · 12 revisions

TIOVX ISP

tiovxisp Image Signal Processing using the TIOVX Modules API.

Hierarchy

GObject
 +----GInitiallyUnowned
       +----GstObject
             +----GstElement
                   +----GstTIOVXSimo
                         +----GstTIOVXISP

Pad templates

src_%u

Capabilities:

video/x-raw
           format: { (string)GRAY8, (string)GRAY16_LE, (string)NV12, (string)I420 }
            width: [ 1, 8192 ]
           height: [ 1, 8192 ]
        framerate: [ 0/1, 2147483647/1 ]

Availability – On request

Direction – src

Object type – GstTIOVXPad

Pad Properties

pool-size : Size of the buffer pool
            flags: readable, writable
            Unsigned Integer. Range: 2 - 16 Default: 2 

sink

Capabilities:

video/x-bayer
           format: { (string)bggr, (string)gbrg, (string)grbg, (string)rggb, (string)bggr16, (string)gbrg16, (string)grbg16, (string)rggb16 }
            width: [ 1, 8192 ]
           height: [ 1, 8192 ]
        framerate: [ 0/1, 2147483647/1 ]

Availability – Always

Direction – sink

Object type – GstTIOVXPad

Pad Properties

pool-size : Size of the buffer pool
            flags: readable, writable
            Unsigned Integer. Range: 2 - 16 Default: 2 

Properties

ae-disabled

Flag to set if the auto exposure algorithm is disabled.

Flags : Read / Write / Changeable only in NULL or READY state

Boolean. Default value : FALSE

ae-num-skip-frames

To indicate the AE algorithm how often to process frames, 0 means every frame.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 9

analog-gain

Analog gain.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 1000

awb-disabled

Flag to set if the auto white balance algorithm is disabled.

Flags : Read / Write / Changeable only in NULL or READY state

Boolean. Default value : FALSE

awb-num-skip-frames

Flag to set if the auto white balance algorithm is disabled.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 9

color-temperature

Color temperature.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 5000

dcc-2a-file

TIOVX DCC tuning binary file for the given image sensor.

Flags : Read / Write / Changeable only in NULL or READY state

String. Default value : NULL

dcc-isp-file

TIOVX DCC tuning binary file for the given image sensor.

Flags : Read / Write / Changeable only in NULL or READY state

String. Default value : NULL

exposure-time

Exposure time.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 33333

format-msb

Flag indicating which is the most significant bit that still has data.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 7

lines-interleaved

Flag to indicate if lines are interleaved.

Flags : Read / Write / Changeable only in NULL or READY state

Boolean. Default value : FALSE

meta-height-after

Number of lines at the end of the frame that have metadata.

Flags : Read / Write / Changeable only in NULL or READY state

Integer. Default value : 0

meta-height-before

Number of lines at the beggining of the frame that have metadata.

Flags : Read / Write / Changeable only in NULL or READY state

Integer. Default value : 0

name

The name of the object.

Flags : Read / Write

String. Default value : "tiovxisp0"

num-exposures

Number of exposures for the incoming raw image.

Flags : Read / Write / Changeable only in NULL or READY state

Integer. Default value : 1

parent

The parent of the object

Flags : Read / Write

GstObject. Default value : N/A

sensor-dcc-id

Numerical ID that identifies the image sensor to capture images from.

Flags : Read / Write / Changeable only in NULL or READY state

Unsigned Integer. Default value : 219

sensor-id

TIOVX camera sensor string ID.

Flags : Read / Write / Changeable only in NULL or READY state

String. Default value : "SENSOR_SONY_IMX390_UB953_D3"

target

TIOVX target to use by this element.

Flags : Read / Write / Controllable

Enum "GstTIOVXISPTarget". Default value : 0 ("VPAC_VISS1")

(0): VPAC_VISS1 - VPAC_VISS1

Pipeline examples

Single output

INPUT_FILE="/opt/imaging/imx219/raw8_1920x1080_1.raw"
WIDTH=1920
HEIGHT=1080
FORMAT="rggb"
FORMAT_BPP=1
FORMAT_MSB=7
INPUT_FILE_BLOCK_SIZE=$((${WIDTH}*${HEIGHT}*${FORMAT_BPP}))
DCC_ISP_FILE="/opt/imaging/imx219/dcc_viss.bin"
DCC_2A_FILE="/opt/imaging/imx219/dcc_2a.bin"
OUTPUT_FILE="/tmp/output_image.yuv"

GST_DEBUG=tiovxsimo:4,tiovxisp:4 gst-launch-1.0 filesrc location=$INPUT_FILE blocksize=$INPUT_FILE_BLOCK_SIZE ! \
video/x-bayer,width=$WIDTH,height=$HEIGHT,format=$FORMAT,framerate=30/1 ! \
tiovxisp dcc-isp-file=$DCC_ISP_FILE sink_0::dcc-2a-file=$DCC_2A_FILE format-msb=$FORMAT_MSB ! video/x-raw,format=NV12 ! \
filesink location=$OUTPUT_FILE -e

# Resultant image could be opened with Vooya:
WIDTH=1920
HEIGHT=1080
OUTPUT_FILE="output_image.yuv"
vooya -w $WIDTH -h $HEIGHT $OUTPUT_FILE