hi_mpi_sys_set_chn_csc_matrix

Applicability

Function Description

Sets the CSC parameters after the corresponding image or video processing channel is created if the CSC parameters need to be adjusted in the conversion between YUV and RGB before images or videos are processed. If this API is not called to set CSC parameters, the CSC matrix parameters complying with the BT.601 wide standard are used by default.

If the default CSC parameters are not applicable, the sequence of calling related APIs varies according to the modification method.

• If the default CSC parameters are not applicable, they need to be modified only once for all other tasks in the channel. You can call this API to set CSC parameters after the corresponding image or video processing channel is created. After that, call the specific image or video processing API, and then call the API that obtains the image or video processing result.
• If the default CSC parameters are not applicable and different CSC parameters are used for different tasks, modify the parameters for multiple times after the corresponding image or video processing channel is created, after the previous task is complete, and before the next task is executed. (If this API is called again before the previous task is complete, the task processing result may be incorrect.) After that, call the specific image or video processing API, and then call the API that obtains the image or video processing result.

  The call sequence is as follows:

  1. hi_mpi_sys_set_chn_csc_matrix (Modifying CSC Parameters for the First Time)
  2. hi_mpi_vpc_crop (Image Cropping)
  3. hi_mpi_vpc_get_process_result (Waiting for the End of the Image Cropping Task)
  4. hi_mpi_sys_set_chn_csc_matrix (Modifying CSC Parameters for the Second Time)
  5. hi_mpi_vpc_resize (Scaling)
  6. hi_mpi_vpc_get_process_result (Waiting for the Scaling Task to End)

Prototype

hi_s32 hi_mpi_sys_set_chn_csc_matrix(hi_mod_id mode, hi_s32 chn, hi_csc_matrix csc_matrix, hi_csc_coefficient *csc_coefficient)

Parameters

Returns

• 0: success
• Other values: failure. For details, see Common Return Codes.