[FFmpeg-cvslog] doc/ffmpeg: Document opencl for -init_hw_device

[Mark Thompson]

ffmpeg | branch: master | Mark Thompson <sw at jkqxz.net> | Sun Nov 26 15:35:27 2017 +0000| [37c57df18e7c46436fa791abf40f4c3031ab56f4] | committer: Mark Thompson

doc/ffmpeg: Document opencl for -init_hw_device

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=37c57df18e7c46436fa791abf40f4c3031ab56f4
---

 doc/ffmpeg.texi | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/doc/ffmpeg.texi b/doc/ffmpeg.texi
index d767e48c44..ba1e62f06f 100644
--- a/doc/ffmpeg.texi
+++ b/doc/ffmpeg.texi
@@ -757,6 +757,43 @@ If not specified, @samp{auto_any} is used.
 platform-appropriate subdevice (@samp{dxva2} or @samp{vaapi}) and then deriving a
 QSV device from that.)
 
+ at item opencl
+ at var{device} selects the platform and device as @emph{platform_index.device_index}.
+
+The set of devices can also be filtered using the key-value pairs to find only
+devices matching particular platform or device strings.
+
+The strings usable as filters are:
+ at table @option
+ at item platform_profile
+ at item platform_version
+ at item platform_name
+ at item platform_vendor
+ at item platform_extensions
+ at item device_name
+ at item device_vendor
+ at item driver_version
+ at item device_version
+ at item device_profile
+ at item device_extensions
+ at item device_type
+ at end table
+
+The indices and filters must together uniquely select a device.
+
+Examples:
+ at table @emph
+ at item -init_hw_device opencl:0.1
+Choose the second device on the first platform.
+
+ at item -init_hw_device opencl:,device_name=Foo9000
+Choose the device with a name containing the string @emph{Foo9000}.
+
+ at item -init_hw_device opencl:1,device_type=gpu,device_extensions=cl_khr_fp16
+Choose the GPU device on the second platform supporting the @emph{cl_khr_fp16}
+extension.
+ at end table
+
 @end table
 
 @item -init_hw_device @var{type}[=@var{name}]@@@var{source}