Jetson에서 surface 변환은 VIC 또는 GPU 경로를 선택할 수 있다.
어떤 연산 장치를 사용하는지 세션 설정으로 드러낸다.

환경과 호출 위치

samples/07_video_convert에 연결하는 변환 함수다.
NvBufSurface 입력과 출력을 먼저 할당하고 입력 생산자의 작업 완료를 확인한다.
코드 블록은 독립 main이 아니다.
예제의 사각형 설정은 batchSize 1과 numFilled 1인 프레임을 전제로 한다.
출력 픽셀 형식과 크기는 목적지 surface를 만들 때 정한다.

인수와 동작

compute_mode에 VIC를 지정하는 예제다.
gpu_id와 cuda_stream은 VIC 모드에서 사용하지 않는다.
모든 색 형식과 배율이 모든 장치에서 지원되는 것은 아니므로 실패 반환값을 확인한다.

적용할 코드

NvBufSurfTransform_Error configure_vic() {
    NvBufSurfTransformConfigParams config{};
    config.compute_mode = NvBufSurfTransformCompute_VIC;
    config.gpu_id = 0;
    config.cuda_stream = nullptr;
    return NvBufSurfTransformSetSessionParams(&config);
}

실제 transform을 수행할 실행 흐름에서 먼저 호출한다.
반환값을 NvBufSurfTransformError_Success와 비교한다.
오류 열거형이므로 -1 하나만 검사하는 것보다 성공값을 명시하는 편이 분명하다.

빌드 환경

nvbufsurftransform.h와 nvbufsurface.h는 설치된 R36 패키지에서 가져온다.
샘플 Makefile과 Rules.mk의 nvbufsurftransform 및 nvbufsurface 링크 설정을 사용한다.
비동기 함수는 제출 성공과 작업 완료를 분리해서 처리한다.

주의할 점

공유 세션의 동시 호출과 설정 변경을 피한다.
멀티스레드에서는 사용하는 R36 세부 버전의 알려진 문제와 세션 수명 조건을 확인한다.

기준은 Orin과 JetPack 6의 Jetson Linux R36.4이다.
설치된 nvidia-l4t-core와 Multimedia API 패키지 버전을 맞춘다.
다른 PC에서 컴파일되는 것과 Jetson에서 실제 장치가 동작하는 것은 별개다.

참고: NVIDIA R36.4 API 문서