ExternalVideoFrame
- C++
更新时间
表示外部视频帧。
struct ExternalVideoFrame {
VIDEO_BUFFER_TYPE type;
VIDEO_PIXEL_FORMAT format;
void* buffer;
int stride;
int height;
int cropLeft;
int cropTop;
int cropRight;
int cropBottom;
int rotation;
long long timestamp;
void* eglContext;
EGL_CONTEXT_TYPE eglType;
int textureId;
long long fenceObject;
float matrix[16];
uint8_t* alphaBuffer;
bool fillAlphaBuffer;
ALPHA_STITCH_MODE alphaStitchMode;
void *d3d11Texture2d;
int textureSliceIndex;
ColorSpace colorSpace;
};属性
| 参数名 | 描述 |
|---|---|
type | 视频类型。详见 VIDEO_BUFFER_TYPE。 |
format | 像素格式。详见 VIDEO_PIXEL_FORMAT。 |
buffer | 视频帧缓冲区。 |
stride | 输入视频帧的行间距,单位为像素而非字节。对于纹理数据,该值为纹理的宽度。 |
height | 输入视频帧的高度。 |
cropLeft | 从左侧裁剪的像素数。默认值为 0。 |
cropTop | 从顶部裁剪的像素数。默认值为 0。 |
cropRight | 从右侧裁剪的像素数。默认值为 0。 |
cropBottom | 从底部裁剪的像素数。默认值为 0。 |
rotation | 视频帧的顺时针旋转角度。可设置为 0、90、180 或 270。默认值为 0。 |
timestamp | 输入视频帧的时间戳(毫秒)。时间戳错误会导致帧丢失或音视频不同步。 |
eglContext | 仅适用于 Texture 格式的视频数据。
|
eglType | 仅适用于 Texture 格式的视频数据。纹理上下文类型。 |
textureId | 仅适用于 Texture 格式的视频数据。视频帧的纹理 ID。 |
fenceObject | 仅适用于 Texture 格式的视频数据。与 |
matrix | 仅适用于 Texture 格式的视频数据。输入的 4×4 变换矩阵。典型值为单位矩阵。 |
alphaBuffer | 输出参数,通过人像分割算法输出的 Alpha 通道数据。该数据与视频帧大小一致,每个像素值范围为 [0, 255],其中 0 表示背景,255 表示前景(人像)。通过设置该参数,可以将视频背景渲染为透明、纯色、图像、视频等多种效果。 |
fillAlphaBuffer | 注: 对于 BGRA 或 RGBA 格式的视频数据,可以通过以下任一方式设置 Alpha 通道数据:
仅适用于 BGRA 或 RGBA 格式的视频数据。是否从视频帧中提取 Alpha 通道数据并自动填充到
|
alphaStitchMode | 当视频帧包含 Alpha 通道数据时,表示 |
d3d11Texture2d | 仅适用于 Windows Texture 格式的视频数据。指向 |
textureSliceIndex | 仅适用于 Windows Texture 格式的视频数据。表示视频帧在 |
colorSpace | 视频帧的色彩空间属性,默认采用 Full Range 和 BT.709 标准配置。详见 |
旧字段链接
以上锚点仅用于旧文档链接兼容,当前结构体字段列表不包含这两个预览字段。