cuda.bindings._v2.driver.array_get_plane#

cuda.bindings._v2.driver.array_get_plane(intptr_t h_array, unsigned int plane_idx) → intptr_t#

Gets a CUDA array plane from a CUDA array.

Returns in p_plane_array a CUDA array that represents a single format plane of the CUDA array h_array. If plane_idx is greater than the maximum number of planes in this array or if the array does not have a multi-planar format e.g: CU_AD_FORMAT_NV12, then CUDA_ERROR_INVALID_VALUE is returned. Note that if the h_array has format CU_AD_FORMAT_NV12, then passing in 0 for plane_idx returns a CUDA array of the same size as h_array but with one channel and CU_AD_FORMAT_UNSIGNED_INT8 as its format. If 1 is passed for plane_idx, then the returned CUDA array has half the height and width of h_array with two channels and CU_AD_FORMAT_UNSIGNED_INT8 as its format.

Parameters:

h_array (intptr_t) – Multiplanar CUDA array.
plane_idx (unsigned int) – Plane index.

Returns:

Returned CUDA array referenced by the plane_idx.

Return type:

intptr_t