| /* |
| * This file is part of FFmpeg. |
| * |
| * FFmpeg is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU Lesser General Public |
| * License as published by the Free Software Foundation; either |
| * version 2.1 of the License, or (at your option) any later version. |
| * |
| * FFmpeg is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| * Lesser General Public License for more details. |
| * |
| * You should have received a copy of the GNU Lesser General Public |
| * License along with FFmpeg; if not, write to the Free Software |
| * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
| */ |
| |
| #ifndef AVUTIL_DETECTION_BBOX_H |
| #define AVUTIL_DETECTION_BBOX_H |
| |
| #include "rational.h" |
| #include "avassert.h" |
| #include "frame.h" |
| |
| typedef struct AVDetectionBBox { |
| /** |
| * Distance in pixels from the left/top edge of the frame, |
| * together with width and height, defining the bounding box. |
| */ |
| int x; |
| int y; |
| int w; |
| int h; |
| |
| #define AV_DETECTION_BBOX_LABEL_NAME_MAX_SIZE 64 |
| |
| /** |
| * Detect result with confidence |
| */ |
| char detect_label[AV_DETECTION_BBOX_LABEL_NAME_MAX_SIZE]; |
| AVRational detect_confidence; |
| |
| /** |
| * At most 4 classifications based on the detected bounding box. |
| * For example, we can get max 4 different attributes with 4 different |
| * DNN models on one bounding box. |
| * classify_count is zero if no classification. |
| */ |
| #define AV_NUM_DETECTION_BBOX_CLASSIFY 4 |
| uint32_t classify_count; |
| char classify_labels[AV_NUM_DETECTION_BBOX_CLASSIFY][AV_DETECTION_BBOX_LABEL_NAME_MAX_SIZE]; |
| AVRational classify_confidences[AV_NUM_DETECTION_BBOX_CLASSIFY]; |
| } AVDetectionBBox; |
| |
| typedef struct AVDetectionBBoxHeader { |
| /** |
| * Information about how the bounding box is generated. |
| * for example, the DNN model name. |
| */ |
| char source[256]; |
| |
| /** |
| * Number of bounding boxes in the array. |
| */ |
| uint32_t nb_bboxes; |
| |
| /** |
| * Offset in bytes from the beginning of this structure at which |
| * the array of bounding boxes starts. |
| */ |
| size_t bboxes_offset; |
| |
| /** |
| * Size of each bounding box in bytes. |
| */ |
| size_t bbox_size; |
| } AVDetectionBBoxHeader; |
| |
| /* |
| * Get the bounding box at the specified {@code idx}. Must be between 0 and nb_bboxes. |
| */ |
| static av_always_inline AVDetectionBBox * |
| av_get_detection_bbox(const AVDetectionBBoxHeader *header, unsigned int idx) |
| { |
| av_assert0(idx < header->nb_bboxes); |
| return (AVDetectionBBox *)((uint8_t *)header + header->bboxes_offset + |
| idx * header->bbox_size); |
| } |
| |
| /** |
| * Allocates memory for AVDetectionBBoxHeader, plus an array of {@code nb_bboxes} |
| * AVDetectionBBox, and initializes the variables. |
| * Can be freed with a normal av_free() call. |
| * |
| * @param out_size if non-NULL, the size in bytes of the resulting data array is |
| * written here. |
| */ |
| AVDetectionBBoxHeader *av_detection_bbox_alloc(uint32_t nb_bboxes, size_t *out_size); |
| |
| /** |
| * Allocates memory for AVDetectionBBoxHeader, plus an array of {@code nb_bboxes} |
| * AVDetectionBBox, in the given AVFrame {@code frame} as AVFrameSideData of type |
| * AV_FRAME_DATA_DETECTION_BBOXES and initializes the variables. |
| */ |
| AVDetectionBBoxHeader *av_detection_bbox_create_side_data(AVFrame *frame, uint32_t nb_bboxes); |
| #endif |