mirror of
https://github.com/obsproject/obs-studio.git
synced 2024-07-14 15:24:07 +00:00
docs: Clarify only DMA-BUFs with a single modifier are supported
The gs_texture_create_from_dmabuf function is a wrapper for eglCreateImageKHR, which can set a different modifier for each plane. The documentation should advice against that, since this should be rejected by the driver. While DMA-BUFs started to have one modifier per plane, this decision was rolled back to having one modifier for the whole buffer / all planes. While some apis like EGL were designed with a modifier per plane, drivers are expected to reject any request using different modifiers per plane.
This commit is contained in:
parent
ed5749e466
commit
f50c178951
|
@ -980,6 +980,9 @@ Texture Functions
|
||||||
careful to always try and match the formats correctly, otherwise textures
|
careful to always try and match the formats correctly, otherwise textures
|
||||||
can fail to be created or rendered.
|
can fail to be created or rendered.
|
||||||
|
|
||||||
|
All modifiers passed in the modifiers array must be equal. Passing different
|
||||||
|
modifiers for each plane is unsupported.
|
||||||
|
|
||||||
:param width: Width of the texture
|
:param width: Width of the texture
|
||||||
:param height: Height of the texture
|
:param height: Height of the texture
|
||||||
:param drm_format: DRM format of the DMA-BUF buffer
|
:param drm_format: DRM format of the DMA-BUF buffer
|
||||||
|
|
Loading…
Reference in a new issue