GstCuda.CudaContext¶

Subclasses:: None

Methods¶

Inherited:: Gst.Object (29), GObject.Object (37)
Structs:: GObject.ObjectClass (5)

class	`find_dxgi_adapter_luid` (cuda_device)
class	`new` (device_id)
class	`new_wrapped` (handler, device)
class	`pop` (cuda_ctx)
	`can_access_peer` (peer)
	`get_handle` ()
	`get_texture_alignment` ()
	`push` ()

Virtual Methods¶

Inherited:: Gst.Object (1), GObject.Object (7)

Properties¶

Inherited:: Gst.Object (2)

Name	Type	Flags	Short Description
`cuda-device-id`	`int`	r/w/co	Set the GPU device to use for operations
`default-gpu-stack-size`	`int`	r/w	The initial stack size for GPU threads
`external-resource-interop`	`bool`	r	External resource interop API support
`os-handle`	`bool`	r	Whether OS specific handle is supported via virtual memory
`prefer-stream-ordered-alloc`	`bool`	r/w	Prefers stream ordered allocation
`stream-ordered-alloc`	`bool`	r	Device supports stream ordered allocation
`virtual-memory`	`bool`	r	Whether virtual memory management is supporte or not

Signals¶

Inherited:: Gst.Object (1), GObject.Object (1)

Fields¶

Inherited:: Gst.Object (1), GObject.Object (1)

Name	Type	Access	Description
object	`Gst.Object`	r

Class Details¶

class GstCuda.CudaContext(**kwargs)¶

Bases:: Gst.Object
Abstract:: No
Structure:: GstCuda.CudaContextClass

Added in version 1.22.

classmethod find_dxgi_adapter_luid(cuda_device)¶

Parameters:: cuda_device (int) – a CUDA device index
Returns:: The DXGI adapter LUID or 0 if not found or on non-Windows platforms
Return type:: int

Finds the DXGI adapter LUID corresponding to the given CUDA device. This is useful for matching CUDA devices with Direct3D adapters on Windows.

Added in version 1.28.2.

classmethod new(device_id)¶

Parameters:: device_id (int) – device-id for creating GstCuda.CudaContext
Returns:: a new GstCuda.CudaContext or None on failure
Return type:: GstCuda.CudaContext or None

Create GstCuda.CudaContext with given device_id

Added in version 1.22.

classmethod new_wrapped(handler, device)¶

Parameters:

handler (object) – A CUcontext to wrap
device (int) – A CUDevice to wrap

Returns:

A newly created GstCuda.CudaContext

Return type:

GstCuda.CudaContext or None

Note: The caller is responsible for ensuring that the CUcontext and CUdevice represented by handle and device stay alive while the returned GstCuda.CudaContext is active.

Added in version 1.22.

classmethod pop(cuda_ctx)¶

Parameters:: cuda_ctx (object)
Returns:: True if ctx was pushed without error.
Return type:: bool

Pops the current CUDA context from CPU thread

Added in version 1.22.

can_access_peer(peer)¶

Parameters:: peer (GstCuda.CudaContext) – a GstCuda.CudaContext
Returns:: True if self can access peer directly
Return type:: bool

Query whether self can access any memory which belongs to peer directly.

Added in version 1.22.

get_handle()¶

Returns:: the CUcontext of self
Return type:: object or None

Get CUDA device context. Caller must not modify and/or destroy returned device context.

Added in version 1.22.

get_texture_alignment()¶

Returns:: the CUcontext of self
Return type:: int

Get required texture alignment by device

Added in version 1.22.

push()¶

Returns:: True if self was pushed without error.
Return type:: bool

Pushes the given self onto the CPU thread’s stack of current contexts. The specified context becomes the CPU thread’s current context, so all CUDA functions that operate on the current context are affected.

Added in version 1.22.

Property Details¶

GstCuda.CudaContext.props.cuda_device_id¶

Name:: cuda-device-id
Type:: int
Default Value:: 0
Flags:: READABLE, WRITABLE, CONSTRUCT_ONLY

Set the GPU device to use for operations

GstCuda.CudaContext.props.default_gpu_stack_size¶

Name:: default-gpu-stack-size
Type:: int
Default Value:: 1024
Flags:: READABLE, WRITABLE

The default stack size for each GPU thread.

Added in version 1.26.

GstCuda.CudaContext.props.external_resource_interop¶

Name:: external-resource-interop
Type:: bool
Default Value:: False
Flags:: READABLE

External resource interop API support

Added in version 1.26.

GstCuda.CudaContext.props.os_handle¶

Name:: os-handle
Type:: bool
Default Value:: False
Flags:: READABLE

OS handle supportability in virtual memory management

Added in version 1.24.

GstCuda.CudaContext.props.prefer_stream_ordered_alloc¶

Name:: prefer-stream-ordered-alloc
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE

Prefers stream ordered allocation

Added in version 1.26.

GstCuda.CudaContext.props.stream_ordered_alloc¶

Name:: stream-ordered-alloc
Type:: bool
Default Value:: False
Flags:: READABLE

Device supports stream ordered allocation

Added in version 1.26.

GstCuda.CudaContext.props.virtual_memory¶

Name:: virtual-memory
Type:: bool
Default Value:: False
Flags:: READABLE

Virtual memory management supportability

Added in version 1.24.