From patchwork Sun Jun 2 22:57:01 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Mark Thompson X-Patchwork-Id: 13386 Return-Path: X-Original-To: patchwork@ffaux-bg.ffmpeg.org Delivered-To: patchwork@ffaux-bg.ffmpeg.org Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org [79.124.17.100]) by ffaux.localdomain (Postfix) with ESMTP id 2044F44986A for ; Mon, 3 Jun 2019 01:57:11 +0300 (EEST) Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 087D068994E; Mon, 3 Jun 2019 01:57:11 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-wr1-f54.google.com (mail-wr1-f54.google.com [209.85.221.54]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id D48D26806B6 for ; Mon, 3 Jun 2019 01:57:04 +0300 (EEST) Received: by mail-wr1-f54.google.com with SMTP id b18so10039643wrq.12 for ; Sun, 02 Jun 2019 15:57:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jkqxz-net.20150623.gappssmtp.com; s=20150623; h=to:from:subject:message-id:date:user-agent:mime-version :content-language:content-transfer-encoding; bh=1q1qDmZLdvTVQctqWyPmR8AYZXpF/4HP56T3LqCbFNA=; b=DAdY0EJ2HWtenSAIIutawd+tq4OLsrPuULgg5F4gk4FuCxj2QzQnJcFBasu0ExPxMm ahVLamUlkWwuDnUxhI2UrwC7vWn/j4p/gkELhROMW3EphabvPKZDRRjGOU772FXjW+AM xmXTScpQxyA7bYJ/8ybRX2D/8DUHsRs+Jfz+52kwypOsdQ8Nm/jhC6faKWZo7Mjbgimz Iv0pv/nbjddZ3VOioZwzeywc38w6GJFknYDhtS+p+TpaQTN8rJOWD2Hd2n9iay0Zw7xy c9bOBpGAbi6UiALQbXLlMDeNzz90wdS9AjTyHxIcOQZo5dcm9E5j4jKeALS9HhinCmLL NQAA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:to:from:subject:message-id:date:user-agent :mime-version:content-language:content-transfer-encoding; bh=1q1qDmZLdvTVQctqWyPmR8AYZXpF/4HP56T3LqCbFNA=; b=LW27dSKRJMfhinTBmEsOrfLtOcy++w1LHuli6FIYlcB6yIsQ5p7TcQ38wvumL9mp0T Z8Gh5TQX/vT6gnb/d8IHMksOh6LC3t+MgDrpNRkejQkhtrIF3U4+yjYEGLKeaVErpJxy NCLTePQdkDPoWoeLTuIdOfIRIkIv2ibf61+ayVP9mr42MHl+FDadufKhB52iwEDyRtTZ uwUqyphxJNQm4qc8XpJqqBTCTDI1hPuG933vfdlTaKFXyU/q75GP/aZrOTG7+RYsIiWn O1gP2IJ4S46yecdCxa3IZRbRvvaSRX7B72MCR6x3aywcjL0DI5NOZu40eS6OwWuCQ8wl D2jw== X-Gm-Message-State: APjAAAWtN8qsYA09+Z+j4xpok5yl3IeV54FImO8Q3potqLGMj7Y4yAhy lFJN1D4ACFr9SO2gH/+x7/KeIQS32KU= X-Google-Smtp-Source: APXvYqxYDBygop8/mX/U7k16X8+ddEg8zav69mFHlHUVoja+q6kIVwTfvU3T/TlbxuzM19/vknFptw== X-Received: by 2002:a5d:4803:: with SMTP id l3mr13842459wrq.148.1559516223999; Sun, 02 Jun 2019 15:57:03 -0700 (PDT) Received: from [192.168.0.10] (cpc91242-cmbg18-2-0-cust650.5-4.cable.virginm.net. [82.8.130.139]) by smtp.gmail.com with ESMTPSA id 95sm28785740wrk.70.2019.06.02.15.57.03 for (version=TLS1_3 cipher=AEAD-AES128-GCM-SHA256 bits=128/128); Sun, 02 Jun 2019 15:57:03 -0700 (PDT) To: FFmpeg development discussions and patches From: Mark Thompson Message-ID: <618521bf-0807-13a8-2530-12ff7a980dcf@jkqxz.net> Date: Sun, 2 Jun 2019 23:57:01 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.7.0 MIME-Version: 1.0 Content-Language: en-US Subject: [FFmpeg-devel] [PATCH] doc/ffmpeg: Document VAAPI device creation options X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" --- doc/ffmpeg.texi | 28 ++++++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi index cd35eb49c8..ccd490d1a7 100644 --- a/doc/ffmpeg.texi +++ b/doc/ffmpeg.texi @@ -950,8 +950,32 @@ device type: @item vaapi @var{device} is either an X11 display name or a DRM render node. -If not specified, it will attempt to open the default X11 display (@emph{$DISPLAY}) -and then the first DRM render node (@emph{/dev/dri/renderD128}). +If not specified, it will attempt to open the first usable DRM render node +(@emph{/dev/dri/renderD128}, @emph{/dev/dri/renderD129}, etc.). If no render +node is found then it will try the default X11 display (@emph{$DISPLAY}). + +Some options are also supported to guide the selection: +@table @option +@item connection_type +Explicitly specify the connection type to use - @samp{x11} or @samp{drm}. +@item kernel_driver +Only consider DRM render nodes using the named kernel driver. +@item driver +Select the VA driver to load after the connection is open. This does not +affect the selection of the device itself. +@end table + +Examples: +@table @emph +@item -init_hw_device vaapi:/dev/dri/renderD129 +Choose the device on the second DRM render node. +@item -init_hw_device vaapi:,connection_type=drm,kernel_driver=amdgpu +Choose a device on a DRM render node using the @emph{amdgpu} kernel driver, +as found on most current AMD graphics devices. +@item -init_hw_device vaapi:,kernel_driver=i915,driver=iHD +Choose a device using the @emph{i915} kernel driver, and load the @emph{iHD} +VA driver to use with it. +@end table @item vdpau @var{device} is an X11 display name.