# VO WBC Dump Demo

## Overview

This sample demonstrates how to use the WBC (White Balance Calibration) dump flow in the K230 VO (Video Output) module. WBC is used to calibrate display white balance and improve display quality.

## Functional Description

### WBC Functions

This sample demonstrates the following key WBC functions:

- white-balance calibration
- WBC data dump to file
- WBC parameter configuration
- calibration-quality evaluation

### WBC Characteristics

- automatic calibration support
- manual white-balance parameter adjustment
- temperature-related compensation
- calibration-data export

### Application Scenarios

- display quality optimization
- white-balance calibration
- display-effect testing
- production-line calibration

## Source Location

Demo source path: `src/rtsmart/examples/mpp/sample_vo_wbc_dump`

## Usage

### Build Method

In the `K230 RTOS SDK` root directory, run `make menuconfig`, enable the VO WBC dump sample, then rebuild the firmware.

### Run Example

```bash
./sample_vo_wbc_dump [options]
```

### Parameter Description

| Parameter | Description | Default |
| --- | --- | --- |
| `output_file` | output filename | `wbc_data.bin` |
| `calibrate` | whether to run calibration | `yes` |
| `dump_data` | whether to dump data | `yes` |

### Expected Result

After running, the sample will:

1. initialize the VO module
1. configure WBC
1. run white-balance calibration
1. dump WBC data to file
1. print calibration statistics

Example output:

```text
VO WBC Dump Demo
==================

Initializing VO module...
VO initialized successfully

Configuring WBC...
WBC module configured

Starting WBC calibration...
Calibrating white balance...
Channel R: Gain=1.2, Offset=10
Channel G: Gain=1.1, Offset=5
Channel B: Gain=1.15, Offset=8

Calibration completed!

Dumping WBC data...
Data size: 1024 bytes
Output file: wbc_data.bin

Calibration statistics:
R gain: 1.200
G gain: 1.100
B gain: 1.150
R offset: 10
G offset: 5
B offset: 8
Quality score: 95.5

Dump completed!
Press Ctrl+C to exit.
```

```{admonition} Tip
WBC calibration can significantly improve display quality. For VO APIs, refer to [Display Output API](../../api_reference/mpp/display.md).
```