Enum ConvertLayout 

enum ConvertLayout {
    Nv12,
    P010,
    Yuv444P10,
}

The 4:2:0 convert that replaces NVENC’s own, because the hardware’s fixed-function conversion weights the two columns of a block 3:1 instead of averaging them, leaving half the color of a subpixel-antialiased glyph edge in the chroma plane where the software and VA-API converts leave none. It follows the matrix the session declares (gpu_hardware_conversion_matches_the_declared_matrix), so only the siting is at stake, and 4:4:4 — which subsamples nothing — keeps it.

The kernels ship as PTX the driver JIT-compiles (cuModuleLoadData), so the only library involved is the libcuda NVENC already needs — nothing to install, and no runtime compiler. They read the session’s packed ARGB surface, or a texture over an array-typed dmabuf import, and write the NV12 surface NVENC then encodes, averaging each block’s RGB before the matrix as the host convert does. The surface a ChromaConvert writes for NVENC: NV12 for an 8-bit 4:2:0 session, and for a 10-bit one P010 or planar 4:4:4, whose samples the kernel computes from the 8-bit RGB at 10 bits. NVENC upconverts an 8-bit surface itself, but from samples already rounded to eight: a 4:4:4 HEVC session coded that way measured 41.6 dB against its 8-bit 45.5 at one quantizer on an RTX 3060, its luma half a level low.

Variants

Nv12

P010

Yuv444P10

Implementations

impl ConvertLayout

fn of(fullcolor: bool, bit_depth: u32) -> Option<Self>

The layout a session of this chroma and depth converts into; None for 8-bit 4:4:4, which subsamples nothing and keeps NVENC’s own conversion.

fn kernels(self) -> (&'static CStr, &'static CStr)

The kernels reading a linear surface and a texture.

fn extent(self, width: u32, height: u32) -> (usize, usize)

The bytes a row and the rows a widthxheight picture take: a luma plane and half as many rows of interleaved chroma, or three whole planes.

fn format(self) -> NV_ENC_BUFFER_FORMAT

Trait Implementations

impl Clone for ConvertLayout

fn clone(&self) -> ConvertLayout

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ConvertLayout

impl Debug for ConvertLayout

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ConvertLayout

impl PartialEq for ConvertLayout

fn eq(&self, other: &ConvertLayout) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ConvertLayout