Cinema Shader Pack

HLSL shaders for projection corrections and dual-projector 3D/HDR.

Table of contents

1. How to use
2. Shader categories
3. HDR tutorial
4. Licence

1. How to use

Copy the contents of the Shaders folder to the Shaders folder of a media player that supports HLSL, like MPC-HC. Go to the shader settings and add the selected ones as post-resize shaders.

Some shaders can be configured. Open them with any text editor and modify the values under Configuration if it's present.

2. Shader categories

The supplied shaders can be grouped by the order they should be applied on the video. Only use the selected shaders in the order they appear here. Each group has different usage rules. Any group can be skipped.

1. Splitters
   Splitters create an image pair that can be dual-projected. Only one splitter can be applied in the shader chain.
   • HDR to SDR + overexposure: Try to get the SDR part of HDR content with overexposure as SBS 3D
   • Resolution demo: Shows half resolution 4:2:0, 4:4:4, full resolution 4:2:0, and 4:4:4 in order
2. Split state corrections
   These shaders process already split videos like 3D content, for multiple properties.
   • Dual projector convergence - OU: Simple projector convergence for over-under dual projection (3D or HDR)
   • Dual projector convergence - SBS: Simple projector convergence for side-by-side dual projection (3D or HDR)
   • Flip eyes - OU: Flip left/right eye image for over-under 3D content
   • Flip eyes - SBS: Flip left/right eye image for side-by-side 3D content
   • Parallax - OU: Parallax correction for over-under 3D content
   • Parallax - SBS: Parallax correction for side-by-side 3D content
3. Mergers
   Mergers combine split images. Only one merger for the given source and target format can be applied in the shader chain.
   • 3D to 2D - OU: Left eye retain for half-size over-under 3D content
   • 3D to 2D - SBS: Left eye retain for half-size side-by-side 3D content
   • Anaglyph 3D - OU to red-blue: Prepare over-under 3D content for red-blue glasses
   • Anaglyph 3D - OU to red-cyan: Prepare over-under 3D content for red-cyan glasses
   • Anaglyph 3D - OU to red-green: Prepare over-under 3D content for red-green glasses
   • Anaglyph 3D - OU to trioscopic: Prepare over-under 3D content for trioscopic glasses
   • Anaglyph 3D - SBS to red-blue: Prepare side-by-side 3D content for red-blue glasses
   • Anaglyph 3D - SBS to red-cyan: Prepare side-by-side 3D content for red-cyan glasses
   • Anaglyph 3D - SBS to red-green: Prepare side-by-side 3D content for red-green glasses
   • Anaglyph 3D - SBS to trioscopic: Prepare side-by-side 3D content for trioscopic glasses
4. Corrections
   Single-projector or merged image corrections for multiple properties.
   • Black bar filler: Fill black bars by cylindrically warping the image
   • Bottomizer: Move wide content to the bottom of the frame
   • HDR to SDR: Try to get the SDR part of HDR content
   • HDR to SDR (vibrant): HDR to SDR with a different, sometimes better looking compressor
   • HDR to SDR (S-Log): Try to get the SDR part of S-Log HDR content
   • Gamma correction: Simple gamma correction
   • Reframe: Keep content in the screen's largest given area by ratio
   • Screen file: 6-point single projector geometry correction
   • Spot correction: Corrects spots with incorrect colors
5. Warpers
   Specific splitters for special setups, including triple projection.
   • ScreenXizer - Cinerama: Warp screen edges to side screens with cylinder wrapping
   • ScreenXizer - Cubemap: Warp screen edges to side screens with cube wrapping

3. HDR tutorial

The HDR to SDR shader works for both SDR conversion and limited to full HDR content display. The default configuration values are fine for regular displays, but you can set it up to actual HDR light values, even to luminance levels not supported by today's standards, making this shader future-proof. To get the most out of your screen, push the light output to the maximum and set the peak luminance accordingly. If you don't have a luminance meter, just set it to the largest value where the shadows look right.

4. Licence

The source code is given to you for free, but without any warranty. It is not guaranteed to work, and the developer is not responsible for any damages from the use of the software. You are allowed to make any modifications, and release them for free. If you release a modified version, you have to link this repository as its source. You are not allowed to sell any part of the original or the modified version. You are also not allowed to show advertisements in the modified software. If you include these code or any part of the original version in any other project, these terms still apply.