Detailed Description

Defines FrameCapture module for performing capture of currently bound GL frame buffer.

Data Structures
struct	dwFrameCaptureParams
	Initialization parameters for the frame capture module. More...

Typedefs
typedef struct dwFrameCaptureObject *	dwFrameCaptureHandle_t
	Handle to a Frame Capture module object. More...

Enumerations
enum	dwFrameCaptureMode { DW_FRAMECAPTURE_MODE_SCREENCAP = 1 << 0 , DW_FRAMECAPTURE_MODE_SERIALIZE = 1 << 1 }
	Enables FrameCapture functionalities. These can be set as a logical OR between the two modes. Choosing a mode means that the resources needed by that feature will be allocated. More...

Functions
DW_API_PUBLIC dwStatus	dwFrameCapture_appendAllocationAttributes (dwImageProperties *imgProps, dwFrameCaptureHandle_t framecapture)
	Append the allocation attribute to create images that work with other NvSci based modules. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrame (const dwImageHandle_t img, dwFrameCaptureHandle_t framecapture)
	Append a dwImageHandle frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameAsync (const dwImageHandle_t img, dwFrameCaptureHandle_t framecapture)
	Asynchronously append a dwImageHandle frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameCUDA (const dwImageCUDA *img, dwFrameCaptureHandle_t framecapture)
	Append a dwImageCUDA frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameCUDAAsync (const dwImageCUDA *img, dwFrameCaptureHandle_t framecapture)
	Asynchronously append a dwImageCUDA frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameGL (const dwImageGL *img, dwFrameCaptureHandle_t framecapture)
	Append a dwImageGL frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameGLAsync (const dwImageGL *img, dwFrameCaptureHandle_t framecapture)
	Asynchronously append a dwImageGL frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameNvMedia (const dwImageNvMedia *img, dwFrameCaptureHandle_t framecapture)
	Append a dwImageNvMedia frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_appendFrameNvMediaAsync (const dwImageNvMedia *img, dwFrameCaptureHandle_t framecapture)
	Asynchronously append a dwImageNvMedia frame to the capture and it's serialized. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_fillSyncAttributes (NvSciSyncAttrList syncAttrList, dwFrameCaptureHandle_t framecapture)
	Fill the sync attributes for the encoder to signal EOF fences. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_initialize (dwFrameCaptureHandle_t obj, const dwFrameCaptureParams params, dwSALHandle_t sal, dwContextHandle_t ctx)
	Create a new frame capture module. More...

DW_API_PUBLIC dwStatus	dwFrameCapture_insertFence (NvSciSyncFence *syncFence, dwFrameCaptureHandle_t framecapture)
	Insert fence to wait on completed operations. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_release (dwFrameCaptureHandle_t framecapture)
	Releases the frame capture module. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_screenCapture (const dwImageGL **imageGL, const dwRect roi, dwFrameCaptureHandle_t framecapture)
	It grabs what is currently rendered on the current frame buffer and returns a dwImageGL out of it For example, it permits to serialize additional information, such as bounding boxes, labels, etc., that are rendered on top of the current GL frame. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_screenCaptureCustom (dwImageGL *imageGL, const dwRect roi, dwFrameCaptureHandle_t framecapture)
	It grabs what is currently rendered on the current frame buffer and blits onto the input dwImageGL. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_setSyncObject (NvSciSyncObj syncObj, dwFrameCaptureHandle_t framecapture)
	Set the sync obj to which the encoder will wait on SOF fences. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_start (dwFrameCaptureHandle_t framecapture)
	Starts frame capture. More...

DW_VIZ_API_PUBLIC dwStatus	dwFrameCapture_stop (dwFrameCaptureHandle_t framecapture)
	Stops frame capture. More...

Data Structure Documentation

◆ dwFrameCaptureParams

struct dwFrameCaptureParams

Data Fields
bool	captureCustom	The frameCaptured image is returned as a dwImageGL. By default (false) the resources for the dwImageGL are allocated automatically and the image received through the call dwFrameCapture_screenCapture. If true, then no resource will be allocated and the dwImageGL will have to be allocated by with dwImage_createGL()/dwImage_getGL and the frameCapture will return the image through dwFrameCapture_screenCaptureCustom()
uint32_t	height	Height of the GL window / image.
uint32_t	mode	Logic OR of the dwFrameCaptureMode. Can be either or all. Useful for not allocating useless resources.
dwSerializerParams	params	SensorSerializer parameters, see SensorSerializer.h.
bool	serializeGL	Boolean, if true it serializes DW_IMAGE_GL only, otherwise all other serializations (CUDA/CPU on X86, CUDA/NVMEDIA on Drive)
bool	setupForDirectCameraOutput	Boolean, if it is true and MUST use dwFrameCapture_appendAllocationAttributes to append nvsciBufAttrList to image's nvsciBufAttrLists, this image must be the output of camera with isp-mode=yuv420-bl then dwFrameCapture_appendFrame will append it without copyconvert overhead.
uint32_t	width	Width of the GL window / image.

Typedef Documentation

◆ dwFrameCaptureHandle_t

typedef struct dwFrameCaptureObject* dwFrameCaptureHandle_t

Handle to a Frame Capture module object.

Definition at line 63 of file FrameCapture.h.

Enumeration Type Documentation

◆ dwFrameCaptureMode

enum dwFrameCaptureMode

Enables FrameCapture functionalities. These can be set as a logical OR between the two modes. Choosing a mode means that the resources needed by that feature will be allocated.

Enumerator
DW_FRAMECAPTURE_MODE_SCREENCAP	Screencapture mode allocates GL resources that enable the capture of the current rendering Window via dwFrameCapture_screenCapture. Will not work if no GL context exists.
DW_FRAMECAPTURE_MODE_SERIALIZE	Serialize enables the creation of the serializer which allows the calls to dwFrameCapture_appendFrameX. The specific resources will depend on the properties passed to the FrameCapture but they will be at least the dwSensorSerializer and usually one ImageStreamer.

Definition at line 66 of file FrameCapture.h.

Function Documentation

◆ dwFrameCapture_appendAllocationAttributes()

DW_API_PUBLIC dwStatus dwFrameCapture_appendAllocationAttributes	(	dwImageProperties *	imgProps,
		dwFrameCaptureHandle_t	framecapture
	)

Append the allocation attribute to create images that work with other NvSci based modules.

Parameters

[in,out]	imgProps	Image properties
[in]	framecapture	FrameCapture handle.

Note: The imgProps are read and used to generate the allocation attributes needed by the driver. The allocation attributes are stored back into imgProps.meta.allocAttrs. Applications do not need to free or alter the imgProps.meta.allocAttrs in any way. The imgProps.meta.allocAttrs are only used by DriveWorks as needed when the given imgProps are used to allocate dwImages. If the application alters the imgProps after calling this API, the imgProps.meta.allocAttrs may no longer be applicable to the imgProps and calls related to allocating images will fail.; if imgProps.meta.allocAttrs does not have allocated Memory, this would be allocated by DW and will be owned by DW context until context is destroyed and should be used wisely as it the space is limited.

Returns: DW_NVMEDIA_ERROR - if underlying camera driver had an NvMedia error.
DW_INVALID_HANDLE - if given handle is not valid.
DW_NOT_IMPLEMENTED - if the method for this image type is not implemented by given camera.
DW_SUCCESS

◆ dwFrameCapture_appendFrame()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrame	(	const dwImageHandle_t	img,
		dwFrameCaptureHandle_t	framecapture
	)

Append a dwImageHandle frame to the capture and it's serialized.

Parameters

[in]	img	dwImageHandle to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameAsync()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameAsync	(	const dwImageHandle_t	img,
		dwFrameCaptureHandle_t	framecapture
	)

Asynchronously append a dwImageHandle frame to the capture and it's serialized.

Parameters

[in]	img	dwImageHandle to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameCUDA()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameCUDA	(	const dwImageCUDA *	img,
		dwFrameCaptureHandle_t	framecapture
	)

Append a dwImageCUDA frame to the capture and it's serialized.

Parameters

[in]	img	dwImageCUDA to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameCUDAAsync()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameCUDAAsync	(	const dwImageCUDA *	img,
		dwFrameCaptureHandle_t	framecapture
	)

Asynchronously append a dwImageCUDA frame to the capture and it's serialized.

Parameters

[in]	img	dwImageCUDA to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameGL()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameGL	(	const dwImageGL *	img,
		dwFrameCaptureHandle_t	framecapture
	)

Append a dwImageGL frame to the capture and it's serialized.

Parameters

[in]	img	dwImageGL to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameGLAsync()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameGLAsync	(	const dwImageGL *	img,
		dwFrameCaptureHandle_t	framecapture
	)

Asynchronously append a dwImageGL frame to the capture and it's serialized.

Parameters

[in]	img	dwImageGL to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameNvMedia()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameNvMedia	(	const dwImageNvMedia *	img,
		dwFrameCaptureHandle_t	framecapture
	)

Append a dwImageNvMedia frame to the capture and it's serialized.

Parameters

[in]	img	dwImageNvMedia to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_appendFrameNvMediaAsync()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_appendFrameNvMediaAsync	(	const dwImageNvMedia *	img,
		dwFrameCaptureHandle_t	framecapture
	)

Asynchronously append a dwImageNvMedia frame to the capture and it's serialized.

Parameters

[in]	img	dwImageNvMedia to serialize
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_fillSyncAttributes()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_fillSyncAttributes	(	NvSciSyncAttrList	syncAttrList,
		dwFrameCaptureHandle_t	framecapture
	)

Fill the sync attributes for the encoder to signal EOF fences.

Note that multiple calls on the same syncAttrList will append attributes on the same

Parameters

[out]	syncAttrList	The sync attributes list to be filled
[in]	framecapture	The frame capture handle

◆ dwFrameCapture_initialize()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_initialize	(	dwFrameCaptureHandle_t *	obj,
		const dwFrameCaptureParams *	params,
		dwSALHandle_t	sal,
		dwContextHandle_t	ctx
	)

Create a new frame capture module.

Parameters

[out]	obj	Handle to the frame capture module being initialized.
[in]	params	Frame capture initialization parameters.
[in]	sal	Handle to current SAL interface
[in]	ctx	Handle to the current driveworks context.

Returns: DW_INVALID_ARGUMENT - if given arguments are invalid
DW_SUCCESS

Note: SAL may internally allocate memory during initialization and will be freed when the SAL is released.

◆ dwFrameCapture_insertFence()

DW_API_PUBLIC dwStatus dwFrameCapture_insertFence	(	NvSciSyncFence *	syncFence,
		dwFrameCaptureHandle_t	framecapture
	)

Insert fence to wait on completed operations.

Parameters

[out]	syncFence	The sync fence of the frame
[in]	framecapture	The frame capture handle

◆ dwFrameCapture_release()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_release ( dwFrameCaptureHandle_t framecapture )

Releases the frame capture module.

Parameters

[in] framecapture Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

Note: To clean up memory owned by SAL during initialize, SAL needs to be released as well. Please see dwFrameCapture_initialize for details.

◆ dwFrameCapture_screenCapture()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_screenCapture	(	const dwImageGL **	imageGL,
		const dwRect	roi,
		dwFrameCaptureHandle_t	framecapture
	)

It grabs what is currently rendered on the current frame buffer and returns a dwImageGL out of it For example, it permits to serialize additional information, such as bounding boxes, labels, etc., that are rendered on top of the current GL frame.

It is independent from the original source of the GL frame, i.e. video or camera, and platform, i.e. Linux or Drive platforms.

Parameters

[out]	imageGL	a pointer to a dwImageGL pointer containing the captured window
[in]	roi	Region of interest to be captured
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_screenCaptureCustom()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_screenCaptureCustom	(	dwImageGL *	imageGL,
		const dwRect	roi,
		dwFrameCaptureHandle_t	framecapture
	)

It grabs what is currently rendered on the current frame buffer and blits onto the input dwImageGL.

Parameters

[out]	imageGL	a pointer to a previously allocated dwImageGL
[in]	roi	Region of interest to be captured
[in]	framecapture	Handle to the frame capture module being released.

Returns: DW_INVALID_HANDLE - if given handle is invalid
DW_SUCCESS

◆ dwFrameCapture_setSyncObject()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_setSyncObject	(	NvSciSyncObj	syncObj,
		dwFrameCaptureHandle_t	framecapture
	)

Set the sync obj to which the encoder will wait on SOF fences.

The sync object is not reference counted

Parameters

[in]	syncObj	The sync object
[in]	framecapture	The frame capture handle

◆ dwFrameCapture_start()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_start ( dwFrameCaptureHandle_t framecapture )

Starts frame capture.

This method creates a new thread and begins the serialization loop.

Parameters

[in] framecapture Specifies the frame capture handle.

Returns: DW_NOT_AVAILABLE - serialization is not available at this moment.
DW_INVALID_HANDLE - if given handle is not valid.
DW_SUCCESS

◆ dwFrameCapture_stop()

DW_VIZ_API_PUBLIC dwStatus dwFrameCapture_stop ( dwFrameCaptureHandle_t framecapture )

Stops frame capture.

This method stops the thread and the serialization loop.

Parameters

[in] framecapture Specifies the sensor serializer handle.

Returns: DW_NOT_AVAILABLE - serialization is not available at this moment.
DW_INVALID_HANDLE - if given handle is not valid.
DW_SUCCESS

Detailed Description

Data Structures

Typedefs

Enumerations

Functions

Data Structure Documentation

◆ dwFrameCaptureParams

Typedef Documentation

◆ dwFrameCaptureHandle_t

Enumeration Type Documentation

◆ dwFrameCaptureMode

Function Documentation

◆ dwFrameCapture_appendAllocationAttributes()

◆ dwFrameCapture_appendFrame()

◆ dwFrameCapture_appendFrameAsync()

◆ dwFrameCapture_appendFrameCUDA()

◆ dwFrameCapture_appendFrameCUDAAsync()

◆ dwFrameCapture_appendFrameGL()

◆ dwFrameCapture_appendFrameGLAsync()

◆ dwFrameCapture_appendFrameNvMedia()

◆ dwFrameCapture_appendFrameNvMediaAsync()

◆ dwFrameCapture_fillSyncAttributes()

◆ dwFrameCapture_initialize()

◆ dwFrameCapture_insertFence()

◆ dwFrameCapture_release()

◆ dwFrameCapture_screenCapture()

◆ dwFrameCapture_screenCaptureCustom()

◆ dwFrameCapture_setSyncObject()

◆ dwFrameCapture_start()

◆ dwFrameCapture_stop()