3. Interface and Function Description

3.1. Online Tuning Interface and Function Description

3.1.1. Tuning Structure Interface

After opening the CviPQ tool for online operation, the tuning table panel on the left side of the tool displays the tunable items of all modules. The structure is shown in Fig. 3.1.

_images/Interf002.png

Fig. 3.1 The structure of the left side of the tool

Click the tunable items of these modules, and the corresponding tuning page of the module will be displayed in the tuning area on the right side of the tool, providing users with adjustment parameters, as shown in Fig. 3.2.

_images/Interf003.png

Fig. 3.2 Tuning page

3.1.2. Register / Algorithm Parameter Adjustment

Each item in the list on the left side of the tool interface is the “register / algorithm parameters” tuning page. The tuning interface corresponding to these pages is shown in Fig. 3.3. All parameters in the debugging page corresponding to each module will be divided into several groups according to different functions.

_images/Interf004.png

Fig. 3.3 Tuning page of register / algorithm parameters (take YNR as an example)

3.1.2.1. View and Modify Register / Algorithm Parameters

Each group contains registers and algorithm parameters, in which the parameters marked with “ Interf049 ”are read-write and the parameters marked with “ Interf050 ”are read-only. Parameters are divided into the following categories according to their properties and value ranges, which are presented in different forms of controls, as shown in Table 3.1 .

Table 3.1 Tuning item types of register algorithm parameters

Type

Description

Control Operation

Boole

either-or

Set and view through the check box:

_images/image23.png

Neumerical Value

Real number with a certain range of values

Use the following controls to adjust and view values:

_images/image24.png

The values can be adjusted in the following wa

1.Enter the value directly in the text box

2.Click the small arrow on the right side of the text box to fine tune up and down

3.Drag the right slider

Enumeration

Multiple choice

Set and view values through the drop-down box:

_images/image25.png

Matrix

Multibyte Sequence

The tuning page will display a button to edit the matrix. If the matrix is read-only, the button to view the matrix will be displayed.

_images/image26.png

Click the button to open a dialog box, in which the corresponding matrix values are displayed in the form of a table. The user can modify the values in the table. If the matrix is read-only, it can only be viewed.

Users can click Import / Export to import and export matrix values, and only the “Export” button is available for read-only matrix.

_images/image27.png

3.1.2.2. Read Data from Board End

When the tool is connected to the board end, click the read button（Interf051）on the rightmost side of each module page. The tool will read the value of each parameter on the current board and update it to the interface.

3.1.2.3. Write Parameters to the Board End

When the tool has been connected to the board, click the write button（Interf052），on the far right of each module page, and the tool will write each writable parameter on the module page to the board.

3.1.2.4. Parameter Temporary Storage and Recovery

The tool provides four groups of data temporary storage space for each tuning group. The user can use the “To Set” button to save the adjusted values of parameters, and then use the “Load Set” button to restore and compare. The detailed operation instructions are shown in Fig. 3.4 . Please refer to the following instructions.

  1. When this icon is selected, the quick buttons of parameter temporary storage and recovery can be displayed

  2. Click the “To Set” button to save the current parameters temporarily. Different values can be stored in different Sets temporarily for quick recovery later.

  3. Click the “Load Set” button to restore the previously stored value. Take Fig. 3.4 as an example: If the user has stored “Set1” and “Set2” two groups of values temporarily, “Load Set1” or “Load set2” button can be used to quickly recover and compare them.

_images/Interf010.png

Fig. 3.4 Parameter temporary storage operation interface (taking 3DNR as an example)

3.1.3. Batch Reading and Writing and Automatic Writing of Tuning Data

When open the tuning tool and enter the main interface, you can see the data read / write control interface on the far right, as shown in Fig. 3.5.

_images/Interf011.png

Fig. 3.5 Data read / write control interface

To operate the read / write console, you need to connect the tool to the board first, with the following specific functions:

  • Read All Button：When this button is clicked, the tool will read the current value of all module page parameter items on the board. It is suggested that before opening the tool for tuning or after importing the Bin file, all read operations should be performed once.

  • Write All Button：When this button is clicked, the tool will write the values of all module page parameter items to the board.

  • Auto Write Switch：When this option is checked, the tool will write the new value of the parameter to the board each time a writable parameter item is adjusted. It is recommended to open this item during tuning to ensure that the adjustment value can take effect immediately.

  • Write Button：When this button is clicked, the tool will write the values of all parameter items in the currently opened module page to the board end.

3.1.4. Curve Visualized Tuning

3.1.4.1. General Curve Function Description

The generic curve in the tool is shown in Fig. 3.6. For example, in the 3DNR debug page, click the Edit this Curve button to enter the curve window.

_images/Interf012.png

Fig. 3.6 3DNR page curve operation example diagram

In the figure, 1 is the horizontal coordinate of the curve, 2 is the vertical coordinate of the curve, corresponding to the 4 points in the curve, modify their values, and the points on the curve will change accordingly; you can also drag the points on the curve by the mouse, corresponding to the horizontal and vertical coordinate values change with it.

Current ISO: drop-down option to select different ISO values and view their corresponding curves.

Switch: mode switch button, click in curve mode, enter the following table mode, the first 4 lines of the table are horizontal coordinate values, the last 4 lines are vertical coordinate values, the table can be edited.

_images/Interf013.png

Import:import parameters from the file.

Export:export parameters to the file.

3.1.4.2. Gamma Visual Tuning

Click Gamma page on the left list of tuning tools to enter Gamma visual tuning page, as shown in Fig. 3.7.

_images/Interf014.png

Fig. 3.7 Gamma Tuning Page

The following is the specific parameter description and usage:

  • Gamma

  • Enable parameter, set it to enable Gamma.

    • Mode parameter, represents the curve adjustment mode, when GAMMA_DEFAULT/GAMMA_sRGB is chosen, the curve will be reset to the default curve, and the user can’t adjust the curve manually. When GAMMA_USER_DEFINE is chosen, the the curve will be reset to a straight line with the starting point of (0,0) and the ending point of the maximum value of X / Y axis. The user can manually adjust the direction of the curve.

  • GammaCOEFFI parameter, restore the current curve to a standard gamma curve (coefficient range 0.01 to 20.0) by entering a value in the text box or dragging the slider.

  • SlopeAtZero parameter, adjust the slope of gamma curve at zero point (the slope range is 0.01 to 20.0) by inputting a value in the text box or dragging the slider.

  • Control Points Num, When GAMMA_USER_DEFINE/GAMMA_AUTO is selected, by adjusting this parameter, the user can set the number of control points that can be operated.

  • Auto Gamma （gamma mode set to GAMMA_AUTO is valid ）

    • Table Choice , select gamma table 0 ~ 5 according to light value, currently using the first 4 groups.

    • Table Number, number of tables currently in use.

    • Table0~4 LV, corresponds to 5 light value valves (LV:-5~15).

  • Reference Set

    Curve data temporary storage area, the tool provides three sets of temporary storage space from set1 to set3, the user clicks the save button the current curve data will be saved to the selected set, and the user clicks the use button the temporary stored data can be restored to the curve interface. By default, the use button is grayed out and unclickable when no temporary storage operation is performed.

  • Reset

    Reset is the reset button. After clicking, the curve will be reset to a straight line with the starting point of (0,0) and the ending point of the maximum value of X / Y axis.

  • Load&Sav

    • Click the “Load” button to read the curve data from the file, write it back to the tool data cache, and refresh the display curve at the same time.

    • Click the “Save” button to save the current curve data to the local text file. The tool supports two formats of data files：Cvitek Json file and Other text file

  • Click the “Read” button of the page read / write control interface, the tool will read the curve data from the board end and refresh the curve display.

  • Click the “Write button”, and the tool will write the data of the current curve to the board end.

  • If “Auto Write” is checked, when the curve is adjusted, the data of the curve will be automatically written to the board end to take effect.

3.1.4.3. VO Gamma

Click VO Gamma in the left list of tuning tool to enter the VO Gamma visual tuning page, as shown in Fig. 3.8.

_images/Interf015.png

Fig. 3.8 VO Gamma tuning page

Parameters description：

  • Gamma

  • Enable, set it to enable VO Gamma

    • OSD Apply, display watermark switch.

    • GammaCOEFFI parameter, restore the current curve to a standard gamma curve (coefficient range 0.01 to 20.0) by entering a value in the text box or dragging the slider.

    • SlopeAtZero parameter, adjust the slope of gamma curve at zero point (the slope range is 0.01 to 20.0) by inputting a value in the text box or dragging the slider.

    • Control Points Num, when GAMMA_USER_DEFINE/GAMMA_AUTO is selected, by adjusting this parameter, the user can set the number of control points that can be operated.

  • Reference Set

    Curve data temporary storage area, the tool provides three sets of temporary storage space from set1 to set3, the user clicks the save button the current curve data will be saved to the selected set, and the user clicks the use button the temporary stored data can be restored to the curve interface. By default, the use button is grayed out and unclickable when no temporary storage operation is performed.

  • Reset

    Reset is the reset button. After clicking, the curve will be reset to a straight line with the starting point of (0,0) and the ending point of the maximum value of X / Y axis.

  • Load&Sav

    • Click the “Load” button to read the curve data from the file, write it back to the tool data cache, and refresh the display curve at the same time.

    • Click the “Save” button to save the current curve data to the local text file. The tool supports two formats of data files：Cvitek Json file and Other text file

  • Click the “Read” button of the page read / write control interface, the tool will read the curve data from the board end and refresh the curve display.

  • Click the “Write button”, and the tool will write the data of the current curve to the board end.

  • If “Auto Write” is checked, when the curve is adjusted, the data of the curve will be automatically written to the board end to take effect.

Usage：

  1. Tool is connected to the board end normally, and the board end is connected to the display to output images normally.

  2. Use the “GammaCOEFFI”, “SlopeAtZero”, “Control Points Num” functions to adjust a desired curve.

  3. Select enable for “Enable” and click write.

  4. Observe the display and the image brightness will change.

3.1.5. Exposure Data Status and Parameter Setting

3.1.5.1. Exposure Data Status

The Exposure Info page can display the current exposure data status, including exposure time, gain, ISO, etc. As shown in Fig. 3.9.

_images/Interf016.png

Fig. 3.9 Exposure data status page

3.1.5.2. Exposure Parameter Setting

The Exposusre Attr page can set the exposure related parameters, including exposure time, gain, ISO, etc. As shown in Fig. 3.10.

_images/Interf017.png

Fig. 3.10 Exposure parameter setting page

3.1.6. White Balance Data Status and Parameter Setting

3.1.6.1. White Balance Data Status

WB info page can display the current white balance data status, including gain, color temperature, etc. As shown in Fig. 3.11.

_images/Interf018.png

Fig. 3.11 White balance data status page

3.1.6.2. White Balance Parameter Setting

WB attr page can be set white balance related parameters, including gain, color temperature, etc. As shown in Fig. 3.12.

_images/Interf019.png

Fig. 3.12 White balance parameter setting page

3.1.7. WDR Exposure Parameter Setting and Local-Tone Switch

For detailed description of WDR and DRC parameters, please refer to section WDR and section DRC from “ISP Tuning Guide”.

3.1.7.1. WDR Exposure Parameter Setting

WDR Exposusre Attr page can be set wide dynamic exposure related parameters, including exposure ratio, etc. As shown in Fig. 3.13.

_images/Interf021.png

Fig. 3.13 WDR exposure parameter setting page

3.1.7.2. Local-tone Switch

Local-tone can be turned on or off on the DRC page. When the [LocalToneEn] parameter is set to enable, it means that the Local-tone is turned on. When the [LocalToneEn] parameter is set to disable, it means that the Local-tone is turned off, as shown in Fig. 3.14.

_images/Interf022.png

Fig. 3.14 DRC Local-tone switch

3.1.8. 3DNR and YNR Noice Reduction Tuning

The tuning parameters related to noise reduction can be found in 3DNR and YNR pages. For detailed description of noise reduction parameters, please refer to section 3DNR and section YNR in “ISP Tuning Guide”.

_images/Interf023.png

Fig. 3.15 3DNR page

_images/Interf024.png

Fig. 3.16 YNR page

3.1.9. Y Sharpen Sharpening and Edge Enhancement Tuning

Y Shapren page contains parameters related to sharpening and edge enhancement. Please refer to section Sharpen of “ISP Tuning Guide” for detailed description of sharpening and edge enhancement parameters.

_images/Interf025.png

Fig. 3.17 Y Sharpen page

3.1.10. Top Page

The Top page includes ViPipe and ViChn parameters. If there are two sensors on the board end, Vipipe can be used to switch the tuning parameters of different sensors. In addition, Vichn can be used to switch the image of the sensor to be displayed on the screen.

_images/Interf026.png

Fig. 3.18 Top page

3.1.11. VPSS Adjustment Page

The VPSS Adustment page is used to tune vpss-related parameters, and the following points should be noted in the tuning process.

  1. During tuning with pqtool, the scene id and vpss grp id are one-to-one, that is, the parameters of scene0 will be written to grp 0；

  2. When App is actually used, it should call CVI_VPSS_SetGrpParamfromBin after each load pq bin to set the binding relationship between scene and vpss grp id, and the vpss parameters in pq bin will take effect at the same time. Otherwise, the vpss parameters tuned with pqtool will not take effect after load pq bin.

Note: the reason for this design is that it is not possible to predict which vpss grp id the app will actually use during tuning of the pq parameters, so the tuning is done one by one, and the mapping relationship needs to be specified according to the actual scenario when the app uses the pq bin generated by tuning.

3.1.12. LDC Page

The LDC page is used for tuning VI and VPSS LDC module related parameters, and the following points should be noted in the usage process:

  1. Read all and Write all do not include read/write operations on the LDC page. Therefore, if the LDC page is set to read or write, a separate operation (click the Read or Write button) must be performed on this page to make it effective.

  2. Currently, the LDC operation is performed at the board end and its computation is large and time consuming. It takes about 2 minutes to complete a computation operation and the PQtool needs to wait in the meantime before the next effective operation can be performed on the PQtool.

3.2. ISP Calibration Tool

Please refer to “ISP Tuning Guide” to complete ISP calibration.

3.3. Advanced Functions

3.3.1. Export and Import of Parameters

The parameters of the tool can be imported and exported in the form of configuration files on the PC side, and the tool can also solidify the parameters to the board side.

3.3.2. Communication Log

After connecting with the board, all data interaction with the board will be recorded and displayed in the communication log window, as shown in Fig. 3.19 . When interacting with the board, the log contains the following information:

  • Communication time;

  • Communication mode and parameters;

  • Communication contents (such as tuning items currently read or written);

  • If communication error occurs, error message will be displayed.

_images/Interf027.png

Fig. 3.19 Communiction log window

3.4. Instructions for Other Auxiliary Tools

3.4.1. Instructions for Use of Capture Tool

The image data (YUV and Raw) at the board end can be captured and saved as a local file.

3.4.1.1. Tool Interface

Click the Capture button on the tuning tool menu bar to open the capture tool interface, as shown in Fig. 3.20.

_images/Interf028.png

Fig. 3.20 Capture tool interface

Save WDR LE and SE raws individually: when checked, LE raw and SE raw are stored separately; when unchecked, the two raw are stored together.

Capture raw tightly: the way of capturing raw is different, faster when it is checked and slower when it is unchecked.

Save BMP file: when checked a bmp image will be saved, the default is saved in jpg.

At the bottom of the image window, the x,y coordinates and r,g,b values of the point are displayed and change with mouse movement.

Dump all repeatedly: when checked, the dump all will be repeated at the Interval setting time (s).

3.4.1.2. Capture YUV Image Data

Steps to capture YUV data:

  1. In the “YUV image” group box, select the source location of YUV data to capture, that is, select VI / VPSS from the Capture from drop-down menu;

  2. Input the number of frames to capture in the Frames text input box;

  3. Click the Capture button, if the capture is successful, YUV data will be automatically stored in the path position displayed in “Open Save Path”, and YUV data will be displayed in the right image display area, which can be viewed frame by frame by clicking Previous / Next button;

—-Done

3.4.1.3. Capture Raw Image Data

Steps to capture Raw data:

1.Select the bits to capture Raw data in the “Raw Image” group box, that is, select 8bits / 10bits / 12bits / 16bits in the Bits drop-down menu;

2.Select the current mode as Linear, WDR or Auto from the Mode drop-down menu;

3.Input the number of frames to capture in the Frames text input box;

4.Click the “Capture” button, if the capture is successful, Raw and Raw Info data will be automatically stored in the path position displayed in “Open Save Path”, and Raw data will be displayed in the image display area on the right, which can be viewed frame by frame by clicking “Previous / Next” button.

—-Done

3.4.1.4. Dump All

Dump All can capture YUV, RAW images and log information, and capture files as follows:

_images/Interf029.png

Capture steps：

1.Set up the yuv capture information in the YUV Image.

2.Set up the raw capture information in the RAW Image.

3.Click the Capture button in Dump All, the tool will first capture and save the raw image and file, then capture and save the yuv image and file, the right image display area will show the raw image, which can be viewed frame by frame by clicking the Previous/Next button.

3.4.1.5. File Name Format Description of YUV Image and RAW Image

The following is the example of file name format of YUV image :

_images/Interf030.png

– 1920X1080 means 1920 in width and 1080 in height

– color=3 means BayerID=3 (0: BGGR, 1: GBRG, 2: GRBG, 3: RGGB)

– bits=12 indicates that the significant bits of the image are 12 bits

– frame=1 means that this file contains one YUV image

– 20211101105807 indicates the save time in the format of ”yyyymmddhhmmss”

The following is the example of file name of RAW image:

_images/Interf031.png

– 3840X1080 means 3840 in width and 1080 in height

– RGGB means ByaerID

– WDR is represented as a wide dynamic image

– color=3 means BayerID=3 (0: BGGR, 1: GBRG, 2: GRBG, 3: RGGB)

– bits=12 indicates that the effective bits of the image are 12 bits

– frame=1 means that this file contains one RAW image

– hdr=1 represents wide dynamic image

– 20211101111620 indicates the save time in the format of ”yyyymmddhhmmss”

The Raw here is decompressed and cropped to: size = width * height * 2 * frame；

3.4.1.6. File Format and Content Description of Raw Info File

An example of the RAW Info file name format is as follows:

_images/Interf032.png

The file name format of RAW Info is exactly the same as that of RAW image, except for the text file with the extension of TXT.

The following is an example of RAＷ Info file content:

_images/Interf033.png

3.4.2. Video Player Instructions (VLC)

3.4.2.1. Steps to use VLC to play video stream on board

Step 1： Download the VLC player. You can download the install-free windows VLC player from the following address : (https://get.videolan.org/vlc/3.0.10/win32/vlc-3.0.10-win32.zip)

For other versions of VLC for other platforms can be downloaded from the VLC website.

Step 2：Open the tool, set VLC parameters, and save and restart VLC.

_images/Interf034.png

Fig. 3.21 VLC setting interface

Step 3：Use network cable to connect development board and computer. The development board and computer can be directly connected by network cable or connected by router.

_images/Interf035.png

Fig. 3.22 Schematic diagram of network port connection

Step 4：On the board, enter the file system through the serial port and start the CviISPTool program

_images/Interf036.png

The computer connected with development board needs to be set to the same IP network segment and after mutual ping, VLC can be started to play on the computer connected with development board. The following are some parameters of play setting. After setting, click the play button to see the Sensor screen.

_images/Interf037.png

Fig. 3.23 VLC playback parameters setting

_images/Interf038.png

Fig. 3.24 VLC playing video stream

3.4.3. Instructions for Auxiliary Focusing Tool

3.4.3.1. Tool Interface

On the tool home page, select Extra Utilities->Focus Assistant, and the auxiliary focusing interface is shown in the figure below:

_images/Interf039.png

The tool interface is mainly divided into three parts:

(1)Operation area: for various tool operations

(2)Image and interval display area: display the captured image, interval distribution and FV value of each interval (the Yellow value is the current FV value of the interval, and the blue value is the maximum historical FV value of the interval)

(3)FV change curve: display the change curve of global FV value. The point whose abscissa is 1 is the point represented by the nearest FV value. Each time FV value is refreshed, the previous value will be shifted to the right.

3.4.3.2. Use the Auxiliary Focusing Tool to Focus

Steps to focus with the auxiliary focusing tool are as follows:

Step1. Adjust the focal length of the lens to the most blurred state

Step2. Determine the AF interval configuration status of the current device: check grab AF statistics, and remove the check when the number of intervals in the image display area changes.

Step3. Select FV group: select V1 (vertical direction) and H1 (horizontal direction) in FV Item drop-down box.

Step4. Click in the image and interval display area to determine which intervals to focus on. A green circle will be displayed in the upper left corner of the region of interest. You can click “Select All Zones”on the left side of the tool to select all zones, and “Deselect All Zones” to cancel the selection of all zones for easy operation.

Step5. Check “Grab AF Statistics” again. At this time, the image display area and the lower graph begin to refresh continuously.

Step6. Adjust the focal length of the lens. At this time, the blue line of FV curve maximum value increases steadily.

Step7. When observed that the point of position 1 on the FV value curve begins to decline steadily, the position of the maximum blue line should not change (it can be considered that the blue line FV is the theoretical optimal focusing FV). At this time, focus in the opposite direction until the point on position 1 is infinitely close to the blue line position.

3.4.3.3. Focusing Auxiliary Operation

If the user needs to determine which region of the on-demand image belongs to in the focusing process, click “CaptureImage” to capture an image. After the image is displayed in the image area, it can be confirmed.

When “Grab AF statistics” is checked on the tool, the tool will obtain AF statistics from the board end at a fixed time interval. The user can modify the Interval value on the interface to change the interval. The change range is 100-1000 ms.

If the user does not need to view the current value and peak value of FV value between partitions, the show zone FV check box on the left can be unchecked. Remove the check and check again, the interval FV value will be displayed again.

If the user changes the interval configuration, the theoretical FV maximum will change. Users are advised to click the “Reset FV Chart” button at this time. After clicking, the historical global FV value in the lower right chart will be cleared, and the blue line of the maximum FV value will return to zero.

3.4.4. 3A Analyser Tool

3.4.4.1. Tool Interface

In the tool home page, select Extra Utilities -> 3A Analyser in the toolbar, the 3A Analyser interface is as follows：

_images/Interf040.png

3.4.4.2. Obtain Images and Statistics

  1. CviPQTool connects to the board side.

  2. On the main interface of the 3A Analysis tool, in the drop-down box after Capture Image from, select the image data source (currently the tool only supports acquiring image data from VI).

  3. Check the checkbox before Capture Image from. The tool will then automatically capture the data from the board side until the user unchecks the Capture Image from checkbox.

After successfully capturing data from the board side, the tool will display the image effect in the gray area below as shown in the figure below:

_images/Interf041.png

3.4.4.3. View AE Statistics

Click the AE button in the upper right corner of the 3A Analyser tool interface to open the AE statistics window as shown below:

_images/Interf042.png

At the same time, the image area of the main interface of 3A Analyser will be divided into intervals by yellow lines, and users can use the mouse The user can use the left mouse button to select the interval, as shown in the figure below.

_images/Interf043.png

Statistical information: The average value of the components of Global and Selected Zone can be viewed. When switching the selection zone in the main screen of 3A Analyser, the statistical information data of the selected zone will change.

3.4.4.4. View AWB Statistics

Click the AWB button in the upper right corner of the 3A Analyser interface to open the AWB statistics window as shown below.

_images/Interf044.png

At the same time, the image area of the main interface of 3A Analyser is also divided into intervals by yellow lines. The user can use the left mouse button to select the interval, as shown in the following figure.

_images/Interf045.png

The following are shown on the statistical chart.

Red-brown curve: Planck curve (plank.c).

Green point: the point on the Planck coordinate system corresponding to the global statistics.

Purple point: the point corresponding to the result of AWB calculation on the Planck coordinate system.

Blue point: the point on the Planck coordinate system corresponding to the statistical information of the subinterval.

Red point: the point on the Planck coordinate system corresponding to the selected zone of the image selected by the mouse.

Green curve: base white zone interval.

The area enclosed by the red lines at the top right and bottom left: the intervals excluded from the white zone to exclude purple and green interference, respectively, are related to CurveLLimit and CurveRLimit in the AWB parameters.

Show Statistics, ShowPlanckian Curve, and ShowWhite Zone above the image control the display and hiding of statistics, color temperature curves, and white zone intervals on the coordinate map, respectively.

3.4.5. Bracketing

Select Extra Utilities -> Bracketing in the toolbar and the Bracketing window is shown below.

_images/Interf046.png

LE/SE Max: Set long and short exposure maximum

LE/SE Min: Set long and short exposure minimum

LE/SE Step: Step length

Capture: Capture the raw of different exposure combinations set by LE/SE

AE 10 RAW: Capture 10 raw of a specific exposure

Save BMP file: Save BMP images, default save as JPG

Open Save Path: File saving directory

Calculation of the number of captured pictures.

LeNum = (LeMax - LeMin) / LeStep + 1;

SeNum = (SeMax - SeMin) / SeStep + 1;

wdr: TotalNum = LeNum * SeNum;

linear: TotalNum = LeNum

3.4.6. Continuous Raw Tool

Select Extra Utilities -> Continuous Raw in the toolbar and the Continuous Raw tool is shown below .

_images/Interf047.png

Preview: Preview the current screen

Captur: Click on “capture” to capture the yuv and display it in the right window；

ROI: Capture raw settings

Frames：Capture raw number of frames；

Width/Height：The width and height of the current screen；

CropX/CropY/CropW/CropH：Set the size and position of capturing raw；

Capture：Start capturing raw;

Save: Save settings

Open Save Path：Select the save path；

Save Location：Select save location, select local, raw file will be saved on pc side; select sd card, raw file will be saved on board side；

The capturing files are shown Fig. 3.25 :

_images/Interf048.png

Fig. 3.25 The capturing files

The raw image here is compressed and the size is calculated as follows:

  1. Full size raw

Size = (width * 6 / 8 + 15) / 16 * height * frame;

If Width > 2304, the compression mode is tile, Width needs to be added by 8.

  1. roi raw

Size = (CropW * 6 / 8 + 15) / 16 * CropH * frame;

If Width > 2304, CropW > 1536 and the compression mode is tile，CropW needs to be added by 8.

3.5. Detail Description of Parameters

The following is the description of API function reference of SDK corresponding to each module parameter on the tool interface, as shown in Table 3-2~ Table3-42.

Table 3.2 API corresponding to TOP settings

Function Module

Corresponding SDK API

Mode Handle

N/A

Bypass Setting

CVI_ISP_SetModuleControl

CVI_ISP_GetModuleControl

Fmw State

CVI_ISP_SetFMWState

CVI_ISP_GetFMWState

CTRL Param

CVI_ISP_SetCtrlParam

CVI_ISP_GetCtrlParam

Repeat

CVI_ISP_SetPipeRepeatMode

CVI_ISP_GetPipeRepeatMode

MOD Param

CVI_ISP_SetModParam

CVI_ISP_GetModParam
Table 3.3 API corresponding to PubAttr

Function Module

Corresponding SDK API

PubAttr

CVI_ISP_SetPubAttr

CVI_ISP_GetPubAttr
Table 3.4 API corresponding to ISPInfo

Function Module

Corresponding SDK API

ISPInfo

CVI_ISP_QueryInnerStateInfo
Table 3.5 API corresponding to ExposureAttr

Function Module

Corresponding SDK API

ExposureAttr

CVI_ISP_SetExposureAttr

CVI_ISP_GetExposureAttr
Table 3.6 API corresponding to WDRExposureAttr

Function Module

Corresponding SDK API

WDRExposureAttr

CVI_ISP_SetWDRExposureAttr

CVI_ISP_GetWDRExposureAttr
Table 3.7 API corresponding to ExposureInfo

Function Module

Corresponding SDK API

ExposureInfo

CVI_ISP_QueryExposureInfo
Table 3.8 API corresponding to AERoute

Function Module

Corresponding SDK API

AERoute

CVI_ISP_SetAERouteAttr

CVI_ISP_GetAERouteAttr

CVI_ISP_GetAERouteAttrEx

CVI_ISP_SetAERouteAttrEx
Table 3.9 API corresponding to WBAttr

Function Module

Corresponding SDK API

White Balance

CVI_ISP_SetWBAttr

CVI_ISP_GetWBAttr

AWBAttr

CVI_ISP_SetWBAttr

CVI_ISP_GetWBAttr

MWBAttr

CVI_ISP_SetWBAttr

CVI_ISP_GetWBAttr

AWB Calibration Data

CVI_ISP_GetWBCalibration

CVI_ISP_SetWBCalibration

AWBAttrEx

CVI_ISP_GetAWBAttrEx

CVI_ISP_SetAWBAttrEx
Table 3.10 API corresponding to WBInfo

Function Module

Corresponding SDK API

WBInfo

CVI_ISP_QueryWBInfo
Table 3.11 API corresponding to CCM

Function Module

Corresponding SDK API

CCM

CVI_ISP_SetCCMAttr

CVI_ISP_GetCCMAttr

ColorToneAttr

CVI_ISP_GetColorToneAttr

CVI_ISP_SetColorToneAttr
Table 3.12 API corresponding to CLUT

Function Module

Corresponding SDK API

CLUT Attr

CVI_MPI_ISP_SetCLutAttr

CVI_MPI_ISP_GetCLutAttr
Table 3.13 API corresponding to RadialShading

Function Module

Corresponding SDK API

RadialShading Attr

CVI_MPI_ISP_SetRadialShadingAttr

CVI_MPI_ISP_GetRadialShadingAttr

RadialShading Gain Lut

CVI_MPI_ISP_SetRadialShadingGainLutAttr

CVI_MPI_ISP_GetRadialShadingGainLutAttr
Table 3.14 API corresponding to Demosaic

Function Module

Corresponding SDK API

Demosaic

CVI_MPI_ISP_SetDemosaicAttr

CVI_MPI_ISP_GetDemosaicAttr

CVI_MPI_ISP_SetDemosaicDemoireAttr

CVI_MPI_ISP_GetDemosaicDemoireAttr

CVI_MPI_ISP_SetDemosaicFilterAttr

CVI_MPI_ISP_GetDemosaicFilterAttr

CVI_MPI_ISP_SetDemosaicEEAttr

CVI_MPI_ISP_GetDemosaicEEAttr
Table 3.15 API corresponding to AntiFalse

Function Module

Corresponding SDK API

AntiFalse

CVI_ISP_SetAntiFalseColorAttr

CVI_ISP_SetAntiFalseColorAttr
Table 3.16 API corresponding to 3DNR

Function Module

Corresponding SDK API

3DNR

CVI_ISP_GetTNRAttr

CVI_ISP_SetTNRAttr

CVI_ISP_GetTNRNoiseModelAttr

CVI_ISP_SetTNRNoiseModelAttr

CVI_ISP_GetTNRLumaMotionAttr

CVI_ISP_SetTNRLumaMotionAttr

CVI_ISP_GetTNRGhostAttr

CVI_ISP_SetTNRGhostAttr

CVI_ISP_GetTNRMtPrtAttr

CVI_ISP_SetTNRMtPrtAttr
Table 3.17 API corresponding to DRC

Function Module

Corresponding SDK API

DRC

CVI_ISP_SetDRCAttr

CVI_ISP_GetDRCAttr
Table 3.18 API corresponding to FSWDR

Function Module

Corresponding SDK API

FSWDR

CVI_ISP_SetFSWDRAttr

CVI_ISP_GetFSWDRAttr
Table 3.19 API corresponding to Crosstalk

Function Module

Corresponding SDK API

Crosstalk

CVI_ISP_GetCrosstalkAttr

CVI_ISP_SetCrosstalkAttr
Table 3.20 API corresponding to Dehaze

Function Module

Corresponding SDK API

Dehaze

CVI_ISP_SetDehazeAttr

CVI_ISP_GetDehazeAttr
Table 3.21 API corresponding to Shading

Function Module

Corresponding SDK API

Shading Attr

CVI_ISP_SetMeshShadingAttr

CVI_ISP_GetMeshShadingAttr

Shading Lut Attr

CVI_ISP_SetMeshShadingGainLutAttr

CVI_ISP_GetMeshShadingGainLutAttr
Table 3.22 API corresponding to DPC

Function Module

Corresponding SDK API

Dynamic Attribute

CVI_ISP_GetDPDynamicAttr

CVI_ISP_SetDPDynamicAttr

Static Attribute

CVI_ISP_GetDPStaticAttr

CVI_ISP_SetDPStaticAttr
Table 3.23 API corresponding to CAC

Function Module

Corresponding SDK API

CAC

CVI_ISP_SetCACAttr

CVI_ISP_GetCACAttr
Table 3.24 API corresponding to CNR

Function Module

Corresponding SDK API

CNR Attr

CVI_ISP_SetCNRAttr

CVI_ISP_GetCNRAttr
Table 3.25 API corresponding to DCI

Function Module

Corresponding SDK API

DCI

CVI_ISP_SetDCIAttr

CVI_ISP_GetDCIAttr
Table 3.26 API corresponding to Gamma

Function Module

Corresponding SDK API

Gamma

CVI_ISP_SetGammaAttr

CVI_ISP_GetGammaAttr
Table 3.27 API corresponding to DRC

Function Module

Corresponding SDK API

DRC

CVI_MPI_ISP_SetDRCAttr

CVI_MPI_ISP_GetDRCAttr
Table 3.28 API corresponding to FSWDR

Function Module

Corresponding SDK API

FSWDR

CVI_MPI_ISP_SetFSWDRAttr

CVI_MPI_ISP_GetFSWDRAttr
Table 3.29 API corresponding to HSV

Function Module

Corresponding SDK API

HSV Attr

CVI_ISP_GetHSVAttr

CVI_ISP_SetHSVAttr
Table 3.30 API corresponding to LUT 3D

Function Module

Corresponding SDK API

LUT 3D

TBD
Table 3.31 API corresponding to YNR

Function Module

Corresponding SDK API

YNR

CVI_ISP_SetYNRAttr

CVI_ISP_GetYNRAttr

CVI_ISP_SetYNRMotionNRAttr

CVI_ISP_GetYNRMotionNRAttr

CVI_ISP_SetYNRFilterAttr

CVI_ISP_GetYNRFilterAttr
Table 3.32 API corresponding to Y Sharpen

Function Module

Corresponding SDK API

Sharpen

CVI_ISP_GetSharpenAttr

CVI_ISP_SetSharpenAttr
Table 3.33 API corresponding to BLC

Function Module

Corresponding SDK API

Black Level

CVI_ISP_GetBlackLevelAttr

CVI_ISP_SetBlackLevelAttr
Table 3.34 API corresponding to BNR

Function Module

Corresponding SDK API

BNR

CVI_ISP_SetNRAttr

CVI_ISP_GetNRAttr

RLSC

CVI_ISP_SetRLSCAttr

CVI_ISP_GetRLSCAttr

Filter

CVI_ISP_SetNRFilterAttr

CVI_ISP_GetNRFilterAttr
Table 3.35 API corresponding to Saturation

Function Module

Corresponding SDK API

Saturation

CVI_ISP_GetSaturationAttr

CVI_ISP_SetSaturationAttr
Table 3.36 API corresponding to Statistics Config

Function Module

Corresponding SDK API

AE/AF/AWB Config

CVI_ISP_GetStatisticsConfig

CVI_ISP_SetStatisticsConfig
Table 3.37 API corresponding to DIS

Function Module

Corresponding SDK API

DIS Attr

CVI_ISP_GetDisAttr

CVI_ISP_GetDisAttr

DIS Config

CVI_ISP_GetDisConfig

CVI_ISP_SetDisConfig
Table 3.38 API corresponding to LDC

Function Module

Corresponding SDK API

VI LDC

CVI_VI_GetChnLDCAttr

CVI_VI_SetChnLDCAttr

VPSS LDC

CVI_VPSS_GetChnLDCAttr

CVI_VPSS_SetChnLDCAttr
Table 3.39 API corresponding to Mono

Function Module

Corresponding SDK API

Mono

CVI_ISP_GetMonoAttr

CVI_ISP_SetMonoAttr
Table 3.40 API corresponding to Y Contrast

Function Module

Corresponding SDK API

YContrast Attr

CVI_ISP_GetYContrastAttr

CVI_ISP_SetYContrastAttr
Table 3.41 API corresponding to Vpss Adjustment

Function Module

Corresponding SDK API

VPSS Adjustment

CVI_VPSS_GetGrpProcAmp

CVI_VPSS_SetGrpProcAmp
Table 3.42 API corresponding to Noise Profile

Function Module

Corresponding SDK API

NoiseProfile

CVI_ISP_GetNoiseProfileAttr

CVI_ISP_SetNoiseProfileAttr