Segmentation - Segmentation - 6.3 English - XD056

Vitis Video Analytics SDK (VVAS) 6.3 User Guide (XD056)

Document_ID
XD056
Release_Date
2026-09-24
Version
6.3 English

The following example shows a JSON configuration for a segmentation model.

{
  "config": {
    "mask-level": 0,
    "mask-alpha": 0.5,
    "classes": [
      { "name": "background",  "red": 0,   "green": 0,   "blue": 0   },
      { "name": "aeroplane",   "red": 128, "green": 0,   "blue": 0   },
      { "name": "bicycle",     "red": 0,   "green": 128, "blue": 0   },
      { "name": "bird",        "red": 128, "green": 128, "blue": 0   },
      { "name": "boat",        "red": 0,   "green": 0,   "blue": 128 },
      { "name": "bottle",      "red": 128, "green": 0,   "blue": 128 },
      { "name": "bus",         "red": 128, "green": 128, "blue": 128 },
      { "name": "car",         "red": 0,   "green": 128, "blue": 128 },
      { "name": "cat",         "red": 64,  "green": 0,   "blue": 0   },
      { "name": "chair",       "red": 192, "green": 0,   "blue": 0   },
      { "name": "cow",         "red": 64,  "green": 128, "blue": 0   },
      { "name": "diningtable", "red": 192, "green": 128, "blue": 0   },
      { "name": "dog",         "red": 64,  "green": 0,   "blue": 128 },
      { "name": "horse",       "red": 192, "green": 0,   "blue": 128 },
      { "name": "motorbike",   "red": 64,  "green": 128, "blue": 128 },
      { "name": "person",      "red": 192, "green": 128, "blue": 128 },
      { "name": "pottedplant", "red": 0,   "green": 64,  "blue": 0   },
      { "name": "sheep",       "red": 128, "green": 64,  "blue": 0   },
      { "name": "sofa",        "red": 0,   "green": 192, "blue": 0   },
      { "name": "train",       "red": 128, "green": 192, "blue": 0   },
      { "name": "tvmonitor",   "red": 0,   "green": 64,  "blue": 128 }
    ]
  }
}

The segmentation-specific configuration parameters are described in the following table.

Table 19 vvas_xmetaconvert Segmentation Parameters

Parameter

Expected Values

Description

classes

Array of {name, red, green, blue} objects

Position-based colour map for segmentation classes. The entry at array index N defines the overlay colour for class N in the segmentation output. The name field is for reference only and is not used during rendering. The number of entries must match the number of classes produced by the model.

mask-alpha

Float (0.0, 1.0]

Opacity of the segmentation colour overlay blended onto the output frame. Default is 0.5. Values of 0.0 or below fall back to the default; values above 1.0 are clamped to 1.0.

mask-level

Integer

Selects which inference tree level’s segmentation map to render. Default is 0, which renders the segmentation output from tree level 1 (the first inference level). Increase this value to render segmentation output from deeper levels in a cascaded pipeline.