>Psychtoolbox>PsychGLImageProcessing

remapCLUTId = PsychHelperCreateRGB111110RemapCLUTAMDDCE8;

Helper function for Psychtoolbox imaging pipeline, called by
PsychImaging(), not meant to be called by normal user code!

Build a 3 rows by 2048 texels RGBA8 lookup texture for mapping HDR RGB
pixel values in range 0-2047 (ie. 11 bpc resolution) to RGBA8 framebuffer
pixels which will be suitable to drive a BGR10-10-11 framebuffer scanout
engine (CRTC). If a graphics cards framebuffer scanout engine CRTC is
configured for 10-11-11 ~ 11 bpc framebuffer mode, this will make sure that
HDR pixel data is shown properly onscreen.

This texture is used as CLUT texture for the
RGBMultiLUTLookupCombine_FormattingShader.frag.txt in the final output
formatting chain of the imaging pipeline.

The expected pixel layout in 11bpc mode is: BGR101111, ie.:
R11 G11 B10 – That’s how a 32 bit pixel is interpreted for video
scanout. However the OpenGL system on all current OS with standard
drivers can only output A8R8G8B8 formatted pixels. We solve this via the
imaging pipeline: Screen() and OpenGL drawing ops go to the imaging
pipelines virtual framebuffer with 16bpc float or 32 bpc float precision.
At Flip time, our shader remaps that 0.0 - 1.0 values to the range 0-2047
ie. approx. 11 bpc, then uses the CLUT texture created with this function to
lookup corresponding ARGB8 color tuples for the framebuffer, combines
them into a single ARGB8 tuple by addition (logical OR), then writes that
ARGB tuple to the framebuffer. At display scanout time, the CRTC’s will
find 32 bit pixels properly formatted for BGR101111 scanout.

This requires a suitable graphics cards with an at least 11 bpc capable
display pipeline. This is the case for recent AMD gpu’s of the “Sea Islands”
and “Volcanic Islands” family with a DCE-8 or later display engine. Those are
said to have full 12 bpc pipelines.

History:
8-Jun-2014 Written - Derived from PsychHelperCreateARGB2101010RemapCLUT.m (MK).
25-May-2016 Fixed up for DCE-10 “Volcanic Islands” Radeon R9 380 Tonga Pro (MK).
Turns out they need very different formatting and our original
implementation on non-12 bpc capable gpu’s caused wrong test results.