video_frame.h
Este archivo incluye la definición del tipo de un fotograma de vídeo, junto con varias declaraciones de funciones útiles para trabajar con ellos.
Estructuras de datos: otc_video_frame_planar_memory_callbacks
Incluye: unistd.h, base.h, config.h
typedef otc_video_frame
Definición del tipo de fotograma de vídeo.
typedef struct otc_video_frame otc_video_frame;
typedef otc_video_frame_memory_release_callback
Definición de tipo para la función de llamada de retorno de liberación de memoria del fotograma de vídeo.
Se trata de un puntero a la función de devolución de llamada que se invoca cuando la aplicación debe liberar la memoria que ocupa un fotograma de vídeo.
typedef void(*) otc_video_frame_memory_release_callback(const uint8_t *buffer, void *arg)(const uint8_t *buffer, void *arg);
typedef video_transform_callback
Nota: Esta funcionalidad solo es aplicable al SDK para macOS de la Video API de Vonage. No funciona en el SDK para Linux de la Video API de Vonage.
typedef void(*) video_transform_callback(void *user_data, struct otc_video_frame *frame)(void *user_data, struct otc_video_frame *frame);
enumeración otc_video_frame_format
Enumeración de formatos de vídeo por fotograma.
Esta enumeración recoge varios formatos de fotogramas de vídeo.
| Nombre | Valor | Descripción |
|---|---|---|
OTC_VIDEO_FRAME_FORMAT_UNKNOWN |
0 |
Valor desconocido de la enumeración del formato de fotograma de vídeo. |
OTC_VIDEO_FRAME_FORMAT_YUV420P |
1 |
Valor de la enumeración del formato de fotograma de vídeo YUV420P. |
OTC_VIDEO_FRAME_FORMAT_NV12 |
2 |
Valor de la enumeración del formato de fotograma de vídeo NV12. |
OTC_VIDEO_FRAME_FORMAT_NV21 |
3 |
Valor de la enumeración del formato de fotograma de vídeo NV21. |
OTC_VIDEO_FRAME_FORMAT_YUY2 |
4 |
Valor de la enumeración del formato de fotograma de vídeo YUY2. |
OTC_VIDEO_FRAME_FORMAT_UYVY |
5 |
Valor de la enumeración del formato de fotograma de vídeo UYVY. |
OTC_VIDEO_FRAME_FORMAT_ARGB32 |
6 |
Valor de la enumeración del formato de fotograma de vídeo ARGB32. |
OTC_VIDEO_FRAME_FORMAT_BGRA32 |
7 |
Valor de la enumeración del formato de fotograma de vídeo BGRA32. |
OTC_VIDEO_FRAME_FORMAT_RGB24 |
8 |
Valor de la enumeración del formato de fotograma de vídeo RGB24. |
OTC_VIDEO_FRAME_FORMAT_ABGR32 |
9 |
Valor de la enumeración del formato de fotograma de vídeo ABGR32. |
OTC_VIDEO_FRAME_FORMAT_MJPEG |
10 |
Valor de la enumeración del formato de fotograma de vídeo MJPEG. |
OTC_VIDEO_FRAME_FORMAT_RGBA32 |
11 |
Valor de la enumeración del formato de fotograma de vídeo RGBA. |
OTC_VIDEO_FRAME_FORMAT_MAX |
Valor máximo. | |
OTC_VIDEO_FRAME_FORMAT_COMPRESSED |
255 |
Valor de la enumeración del formato de fotograma de vídeo comprimido. |
enumeración otc_video_frame_plane
Enumeración de fotogramas y planos de vídeo.
| Nombre | Valor | Descripción |
|---|---|---|
OTC_VIDEO_FRAME_PLANE_Y |
0 |
Valor de la enumeración del plano Y del fotograma de vídeo. |
OTC_VIDEO_FRAME_PLANE_U |
1 |
Valor de la enumeración del plano de fotogramas de vídeo U. |
OTC_VIDEO_FRAME_PLANE_V |
2 |
Valor de la enumeración del plano de fotogramas de vídeo V. |
OTC_VIDEO_FRAME_PLANE_PACKED |
0 |
Valor de enumeración empaquetado en el plano de fotogramas de vídeo. |
OTC_VIDEO_FRAME_PLANE_UV_INTERLEAVED |
1 |
Valor de enumeración de planos de fotogramas de vídeo entrelazados en coordenadas UV. |
OTC_VIDEO_FRAME_PLANE_VU_INTERLEAVED |
1 |
Valor de enumeración del plano de fotogramas de vídeo intercalado (VU). |
Funciones
| Nombre | Descripción |
|---|---|
otc_video_frame_get_native_handle(frame) → {void *} |
|
otc_video_frame_new(format, width, height, buffer) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo con el formato indicado. |
otc_video_frame_delete(frame) → {otc_status} |
Recursos gratuitos relacionados con el marco. |
otc_video_frame_new_I420(width, height, y_plane, y_stride, u_plane, u_stride, v_plane, v_stride) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo con formato I420. |
otc_video_frame_new_MJPEG(width, height, buffer, size) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo en formato MJPEG. |
otc_video_frame_new_compressed(width, height, buffer, size) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo comprimido. |
otc_video_frame_new_from_planes(format, width, height, planes, strides) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo con un formato determinado a partir de sus planos. |
otc_video_frame_new_I420_from_planes_with_format(input_format, width, height, planes, strides) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo en formato I420 a partir de una lista de planos. |
otc_video_frame_new_contiguous_memory_wrapper(format, width, height, is_shallow_copyable, buffer, size, callback, arg) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo a partir de los datos de un búfer de memoria contiguo. |
otc_video_frame_new_planar_memory_wrapper(format, width, height, is_shallow_copyable, callbacks) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo a partir de un envoltorio de memoria planar. |
otc_video_frame_new_I420_wrapper(width, height, y_plane, y_stride, u_plane, u_stride, v_plane, v_stride) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo en formato I420 a partir de datos YUV. |
otc_video_frame_new_NV21_wrapper(width, height, y_plane, y_stride, uv_plane, uv_stride) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo con un contenedor NV21. |
otc_video_frame_new_NV12_wrapper(width, height, y_plane, y_stride, uv_plane, uv_stride) → {otc_video_frame *} |
Crea un nuevo fotograma de vídeo con un contenedor NV12. |
otc_video_frame_get_buffer(frame) → {const uint8_t *} |
Obtiene un puntero al búfer que contiene los datos del fotograma de vídeo. |
otc_video_frame_get_buffer_size(frame) → {size_t} |
Obtiene el tamaño del búfer que contiene los datos de los fotogramas de vídeo. |
otc_video_frame_get_timestamp(frame) → {int64_t} |
Obtiene la marca de tiempo de un fotograma de vídeo en milisegundos desde la época. |
otc_video_frame_set_timestamp(frame, timestamp) |
Establece la marca de tiempo de un fotograma de vídeo en milisegundos desde la época. |
otc_video_frame_get_width(frame) → {int} |
Obtiene la anchura de un fotograma de vídeo, en píxeles. |
otc_video_frame_get_height(frame) → {int} |
Obtiene la altura de un fotograma de vídeo, en píxeles. |
otc_video_frame_get_number_of_planes(frame) → {size_t} |
Obtiene el número de planos de un fotograma de vídeo. |
otc_video_frame_get_format(frame) → {enum otc_video_frame_format} |
Obtiene el formato de vídeo de un fotograma de vídeo. |
otc_video_frame_set_format(frame, format) |
Establece el formato de vídeo de un fotograma de vídeo. |
otc_video_frame_get_plane_binary_data(frame, plane) → {const uint8_t *} |
Obtiene los datos binarios de uno de los planos de un fotograma de vídeo. |
otc_video_frame_get_plane_size(frame, plane) → {size_t} |
Obtiene el tamaño de un plano en un fotograma de vídeo. |
otc_video_frame_get_plane_stride(frame, plane) → {int} |
Obtiene la amplitud de paso de un plano determinado en un fotograma de vídeo. |
otc_video_frame_get_plane_width(frame, plane) → {int} |
Obtiene la anchura de un plano en un fotograma de vídeo. |
otc_video_frame_get_plane_height(frame, plane) → {int} |
Obtiene la altura de un plano en un fotograma de vídeo. |
otc_video_frame_copy(frame) → {otc_video_frame *} |
Copia un fotograma de vídeo determinado. |
otc_video_frame_mutable_copy(frame) → {otc_video_frame *} |
Crea una copia modificable de un fotograma de vídeo determinado. |
otc_video_frame_convert(format, frame) → {otc_video_frame *} |
Convierte un fotograma determinado. |
otc_video_frame_convert_inplace(format, planes, strides, input_frame) → {otc_status} |
Convierte un fotograma determinado sin moverlo de su posición. |
otc_video_frame_is_packed(frame) → {otc_bool} |
Comprueba si un fotograma de vídeo está comprimido o no. |
otc_video_frame_is_contiguous(frame) → {otc_bool} |
Comprueba si un fotograma de vídeo es contiguo o no. |
otc_video_frame_get_native_handle(frame) → {void *}
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * |
Devoluciones:
void *
otc_video_frame_new(formato, ancho, alto, búfer) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo con el formato indicado.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
format |
enumeración otc_video_frame_format | El formato deseado. |
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
buffer |
const uint8_t * | Un puntero a un búfer que contiene datos de fotogramas de vídeo. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_delete(frame) → {otc_status}
Recursos gratuitos relacionados con el marco.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
otc_video_frame * | Un puntero a una instancia de fotograma de vídeo. |
Véase: : - otc_error_code
Devoluciones:
Valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.
otc_video_frame_new_I420(anchura, altura, plano_y, paso_y, plano_u, paso_u, plano_v, paso_v) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo con formato I420.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
y_plane |
const uint8_t * | Un puntero a un búfer que contiene datos del plano Y. |
y_stride |
int | Y zancada. |
u_plane |
const uint8_t * | Un puntero a un búfer que contiene datos del plano U. |
u_stride |
int | U stride. |
v_plane |
const uint8_t * | Un puntero a un búfer que contiene datos del plano V. |
v_stride |
int | Zancada V. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_MJPEG(anchura, altura, búfer, tamaño) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo en formato MJPEG.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
buffer |
const uint8_t * | Un puntero a un búfer que contiene datos de fotogramas de vídeo. |
size |
size_t | El tamaño del fotograma de vídeo en la memoria. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_compressed(anchura, altura, búfer, tamaño) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo comprimido.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
buffer |
const uint8_t * | Un puntero a un búfer que contiene datos de fotogramas de vídeo. |
size |
size_t | El tamaño del fotograma de vídeo en la memoria. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_from_planes(formato, anchura, altura, planos, pasos) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo con un formato determinado a partir de sus planos.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
format |
enumeración otc_video_frame_format | El formato deseado. |
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
planes |
const uint8_t * * | Un puntero a un puntero al búfer que contiene los planos del fotograma de vídeo. |
strides |
int * | Pasos. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_I420_from_planes_with_format(formato_de_entrada, ancho, alto, planos, pasos) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo en formato I420 a partir de una lista de planos.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
input_format |
enumeración otc_video_frame_format | El formato del fotograma de vídeo pasado como entrada. |
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
planes |
const uint8_t * * | Un puntero a un puntero al búfer que contiene los planos del fotograma de vídeo. |
strides |
int * | Pasos. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_contiguous_memory_wrapper(formato, anchura, altura, se_puede_copiar_superficialmente, búfer, tamaño, llamada_de_retorno, argumento) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo a partir de los datos de un búfer de memoria contiguo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
format |
enumeración otc_video_frame_format | El formato del fotograma de vídeo pasado como parámetro. |
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
is_shallow_copyable |
otc_bool | Si es posible realizar una copia superficial del marco. |
buffer |
const uint8_t * | Un puntero al búfer que contiene los datos del fotograma. |
size |
size_t | El tamaño de los datos de la trama. |
callback |
otc_video_frame_memory_release_callback | La función de llamada de retorno para la liberación de la memoria de fotogramas de vídeo. |
arg |
void * | Un puntero a argumentos adicionales. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_planar_memory_wrapper(formato, ancho, alto, is_shallow_copyable, callbacks) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo a partir de un envoltorio de memoria planar. El otc_video_frame_planar_memory_callbacks La estructura, que se pasa como parámetro, define las funciones de devolución de llamada que se invocan cuando se solicitan datos de fotogramas de vídeo y de paso.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
format |
enumeración otc_video_frame_format | El formato del fotograma de vídeo pasado como parámetro. |
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
is_shallow_copyable |
otc_bool | Si es posible realizar una copia superficial del marco. |
callbacks |
struct otc_video_frame_planar_memory_callbacks * | Un puntero a la estructura que contiene las funciones de llamada de retorno del fotograma de vídeo. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_I420_wrapper(anchura, altura, plano_y, paso_y, plano_u, paso_u, plano_v, paso_v) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo en formato I420 a partir de datos YUV.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
y_plane |
const uint8_t * | Un puntero en el plano Y. |
y_stride |
int | La zancada en «Y». |
u_plane |
const uint8_t * | Un puntero en el plano U. |
u_stride |
int | La zancada en «U». |
v_plane |
const uint8_t * | Un puntero en el plano V. |
v_stride |
int | La zancada en «V». |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_NV21_wrapper(anchura, altura, plano_y, paso_y, plano_uv, paso_uv) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo con un contenedor NV21.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
y_plane |
const uint8_t * | Un puntero en el plano Y. |
y_stride |
int | La zancada en «Y». |
uv_plane |
const uint8_t * | Un puntero al plano UV. |
uv_stride |
int | El paso UV. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_new_NV12_wrapper(anchura, altura, plano_y, paso_y, plano_uv, paso_uv) → {otc_video_frame *}
Crea un nuevo fotograma de vídeo con un contenedor NV12.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
width |
int | El ancho del vídeo, en píxeles. |
height |
int | La altura del vídeo, en píxeles. |
y_plane |
const uint8_t * | Un puntero en el plano Y. |
y_stride |
int | La zancada en «Y». |
uv_plane |
const uint8_t * | Un puntero al plano UV. |
uv_stride |
int | El paso UV. |
Devoluciones:
Un puntero a una instancia de fotograma de vídeo. Puede ser nulo si se produce un error.
otc_video_frame_get_buffer(frame) → {const uint8_t *}
Obtiene un puntero al búfer que contiene los datos del fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo del que se va a obtener el búfer. |
Devoluciones:
Un puntero al búfer que contiene los datos de los fotogramas de vídeo.
otc_video_frame_get_buffer_size(frame) → {size_t}
Obtiene el tamaño del búfer que contiene los datos de los fotogramas de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo del que se va a obtener el tamaño del búfer. |
Devoluciones:
El tamaño del búfer que contiene los datos de los fotogramas de vídeo.
otc_video_frame_get_timestamp(frame) → {int64_t}
Obtiene la marca de tiempo de un fotograma de vídeo en milisegundos desde la época.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
La marca de tiempo del fotograma del vídeo.
otc_video_frame_set_timestamp(fotograma, marca de tiempo)
Establece la marca de tiempo de un fotograma de vídeo en milisegundos desde la época.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
timestamp |
int64_t | El valor de la marca de tiempo. |
otc_video_frame_get_width(frame) → {int}
Obtiene la anchura de un fotograma de vídeo, en píxeles.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
El ancho del marco indicado, en píxeles.
otc_video_frame_get_height(frame) → {int}
Obtiene la altura de un fotograma de vídeo, en píxeles.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
La altura del fotograma indicado, en píxeles.
otc_video_frame_get_number_of_planes(frame) → {size_t}
Obtiene el número de planos de un fotograma de vídeo. Normalmente, devuelve 3 para un fotograma YUV y 1 para un fotograma RGBA/BGRA.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
El número de aviones.
otc_video_frame_get_format(frame) → {enum otc_video_frame_format}
Obtiene el formato de vídeo de un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Véase: : - otc_video_frame_format
Devoluciones:
El formato de fotograma del vídeo.
otc_video_frame_set_format(frame, format)
Establece el formato de vídeo de un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
format |
enumeración otc_video_frame_format | El formato de fotograma del vídeo. |
Véase: : - otc_video_frame_format
otc_video_frame_get_plane_binary_data(frame, plane) → {const uint8_t *}
Obtiene los datos binarios de uno de los planos de un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
plane |
enumeración otc_video_frame_plane | El plano de vídeo del que se van a obtener los datos. |
Devoluciones:
Un puntero a un búfer que contiene los datos del plano. Puede ser nulo si se produce un error.
otc_video_frame_get_plane_size(frame, plane) → {size_t}
Obtiene el tamaño de un plano en un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
plane |
enumeración otc_video_frame_plane | El plano de vídeo del que se va a obtener el tamaño. |
Devoluciones:
Tamaño del avión.
otc_video_frame_get_plane_stride(frame, plane) → {int}
Obtiene la amplitud de paso de un plano determinado en un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
plane |
enumeración otc_video_frame_plane | El plano de vídeo del que se va a extraer la zancada. |
Devoluciones:
Zancada.
otc_video_frame_get_plane_width(frame, plane) → {int}
Obtiene la anchura de un plano en un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
plane |
enumeración otc_video_frame_plane | El plano de vídeo del que se va a obtener la anchura. |
Devoluciones:
Con.
otc_video_frame_get_plane_height(frame, plane) → {int}
Obtiene la altura de un plano en un fotograma de vídeo.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
plane |
enumeración otc_video_frame_plane | El plano del vídeo a partir del cual se obtiene la altura. |
Devoluciones:
Altura.
otc_video_frame_copy(frame) → {otc_video_frame *}
Copia un fotograma de vídeo determinado.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
Un puntero a la nueva instancia de fotograma de vídeo.
otc_video_frame_mutable_copy(frame) → {otc_video_frame *}
Crea una copia modificable de un fotograma de vídeo determinado.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
Un puntero a la nueva instancia de fotograma de vídeo.
otc_video_frame_convert(formato, fotograma) → {otc_video_frame *}
Convierte un fotograma determinado. Todos los fotogramas de vídeo proporcionados por las funciones de devolución de llamada del SDK están vinculados a esta función. Si tienes pensado guardar el fotograma para utilizarlo más adelante, tendrás que copiarlo. Además, si deseas convertir un fotograma de vídeo a un formato diferente, también deberás utilizar esta función. Si el formato de destino es el mismo que el de origen, se realizará una copia superficial (copia de n búferes) siempre que sea posible.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
format |
enumeración otc_video_frame_format | El formato del fotograma de vídeo que se devolverá. Esta función puede convertir fotogramas a los siguientes formatos: OTC_VIDEO_FRAME_FORMAT_ARGB32, OTC_VIDEO_FRAME_FORMAT_BGRA32, OTC_VIDEO_FRAME_FORMAT_ABGR32, OTC_VIDEO_FRAME_FORMAT_RGBA32 y OTC_VIDEO_FRAME_FORMAT_YUV420P. |
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Véase: : - otc_video_frame_format
Devoluciones:
Una copia del fotograma del vídeo en el formato especificado. Puede ser nulo si se produce un error. Ten en cuenta que tendrás que eliminar este fotograma tú mismo más adelante.
otc_video_frame_convert_inplace(formato, planos, pasos, fotograma_de_entrada) → {otc_status}
Convierte un fotograma determinado sin modificarlo. Esto cambia los datos del fotograma de entrada.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
format |
enumeración otc_video_frame_format | El formato del fotograma de vídeo. Esta función permite convertir fotogramas a los siguientes formatos: OTC_VIDEO_FRAME_FORMAT_ARGB32, OTC_VIDEO_FRAME_FORMAT_BGRA32, OTC_VIDEO_FRAME_FORMAT_ABGR32y OTC_VIDEO_FRAME_FORMAT_YUV420P. |
planes |
uint8_t * * | Un puntero a un puntero a los planos de fotogramas del vídeo. |
strides |
const int * | Un puntero a un puntero al paso de fotograma del vídeo. |
input_frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Véase: : - otc_error_code - otc_video_frame_format
Devoluciones:
Un valor de retorno que indica si se ha producido un error o si la operación se ha realizado correctamente.
otc_video_frame_is_packed(frame) → {otc_bool}
Comprueba si un fotograma de vídeo está comprimido o no.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
Un valor booleano con el resultado.
otc_video_frame_is_contiguous(frame) → {otc_bool}
Comprueba si un fotograma de vídeo es contiguo o no.
Parámetros:
| Nombre | Tipo | Descripción |
|---|---|---|
frame |
const otc_video_frame * | Un puntero a la instancia del fotograma de vídeo. |
Devoluciones:
Un valor booleano con el resultado.