Main Content

Set ROI

Draw over specified region of video frame stored in external memory

Since R2023a

Add-On Required: This feature requires the Vision HDL Toolbox Support Package for Xilinx Zynq-Based Hardware add-on.

  • Set ROI block

Libraries:
YOLO v2 Vehicle Detector with Live Camera Input on Zynq-Based Hardware example

Description

The Set ROI block overwrites one or more rectangular regions of a video frame stored in external memory. For instance, you can use this block to display score labels on identified objects. Use this block only in a software interface model connected to an FPGA board that is using the RGB with DL Processor reference design. The block uses the processor-FPGA interface and the memory map of this reference design to read and modify the specified pixels in the frame.

You can use this block only once per model. Your design should provide the ROI coordinates and replacement values and set valid to true once video frames are available in memory. The YOLO v2 Vehicle Detector with Live Camera Input on Zynq-Based Hardware example shows how to use this block in the postprocessing model that is targeted to the ARM® processor.

Ports

Input

expand all

Specify the coordinates of the ROIs as an N-by-2 matrix of the form [x y], where N is the number of ROIs, and x y are coordinates of the top-left corner of each rectangle.

Data Types: single | double | uint32

Specify the replacement pixel values as a matrix of N-by-width-by-height. All the ROIs must be the same size.

Data Types: single | double | uint32

When this input is true (1), the block modifies all frames found in memory. Your design should provide the StartPos and ROI values and set valid to true once video frames are available in memory.

Data Types: Boolean

Parameters

expand all

This block assumes the frame is stored in memory in row-major order. If your design stores the frame in column-major order, clear this checkbox.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using Simulink® Coder™.

Version History

Introduced in R2023a