Uborder shaders

[Hyllian]

Uborder shaders

Latest release: Uborder-v0.0.6

– Added some crt shaders to be compatible with uborder-bezel-reflections:

• dot and lcd-grid-v2 for handhelds;
• crt-guest-advanced;
• crt-guest-advanced-hd;
• crt-guest-advanced-ntsc;

– Old reflection was a bit anemic. New code is stronger;

– Added integer scaling to uborder-bezel-reflections.

---

What’s this?

It’s a simple and fast alternative to more complex bezel shaders like Mega Bezel or Koko-aio.

Why?

I really appreciate the features offered by Mega Bezel and, more recently, by Koko-aio shaders. Being complex shaders, they tend to require a powerful machine to run. This made me wonder if it might be possible to create something simpler that could still provide some of their impressive features, like reflections, in a fast way. As a result, I came up with this first release.

How to use it?

1. Update your Retroarch shaders online to get a vanilla version of uborder inside ‘shaders_slang’;
2. On Retroarch, choose ‘FULL’ aspect ratio;
3. In Quick Menu, choose Core Options->Vertical Mode an turn OFF, so that vertical games will rotate correctly.
4. Enjoy.

For now, there are four types of presets you can load:

1. ambient-light-crt.slangp
2. uborder.slangp
3. uborder-reflections.slangp
4. uborder-bezel-reflections.slangp

Some compatible content-shaders:

• crt-nobody (default)
• crt-geom (get content_shaders_pack to have it.)

crt-nobody is a modified version to support interlaced signal (test psx games like SH or Tekken3 and you’ll see how it behaves). To use crt-geom, edit the main presets ‘ambient-light-crt.slangp’, ‘uborder.slangp’ or ‘uborder-reflections.slangp’, commenting the crt-nobody line and uncommenting the crt-geom line. Doing that, all presets will load the correct crt shader. I’ll probably add other known shaders in the future. Other crt shaders may be included in the latest pack.

Optional: to use extra shaders and presets, download uborder_packs here: some extra packs.

Can I prepend shaders to it?

YES! Some great shaders can be prepended to this one. I have tested ntsc-adaptive and it worked prepended out of the box! Though by doing this you’re adding a layer of complexity and may slow the results.

Can I use my own background?

YES! It’s called Uborder for a reason, it’s easy to add your own background.

To add your own background, create a folder inside ‘shaders/uborder_packs’ Retroarch directory, similar to the ‘Spooky TVs’ folder. Copy the ‘Spooky.slangp’ file into your folder and rename it as desired. Within the preset file, update the BORDER texture to reference your background image. Then, run the preset and use the user parameters in Retroarch to adjust the frame and reflections to fit your image. Once done, save it as a simple preset and copy the parameters back into your preset file to ensure it loads correctly next time.

---

Optional packs compatibility

There are several packs of overlays/borders made by the community through the years to work with several different emulators. Most of them are compatible with Retroarch overlay and shaders framework (most are made for Mega Bezel).

Uborder is a fast alternative to mimic some of the features of Mega Bezel and Koko-aio. And as this, uborder is easy to be integrated with available packs of overlays. The way packs are delivered, they may be separated between the overlay itself (the image file, png or jpg) and the presets/shaders/configs that load them as planned.

In the case of packs already made to be compatible with Megal Bezel and/or Koko-aio, most packs are hundreds of MB or even GB in size. In order to save space, I decided that uborder won’t demand a copy of the images into another folder. So, if you have some of the packs already installed to work with Mega Bezel or Koko-aio, you won’t need to redownload those packs, you just need the uborder presets that point to them.

So, to get the Uborder Presets that point to community packs, you found them inside ‘shaders/uborder_packs’ Retroarch root directory.

If you don’t have the packs already installed, get them in these places:

Orionsangel-Original-Console pack: Orionsangel-Original-Console pack

Duimon-Mega-Bezel-Potato pack: Duimon-Mega-Bezel-Potato

“Hgoda90 - OrionsAngel’s Overlay + Preset Packs - Candy Cab” (Mega Bezel edition) pack: Hgoda’s thread

These Community Packs only work if they’re installed here: ‘shaders/Mega_Bezel_Packs/’

For ‘retropie-overlays-arcade-artwork’, you should get the overlays from: https://github.com/cosmo0/retropie-overlays-arcade-artwork (Download it zipped), and unzip them in this folder: ‘Retroarch/overlays’, so that the final path where the pngs are located is here: ‘Retroarch/overlays/retropie-overlays-arcade-artwork/overlays/config/’

---

Screenshots:

Some pictures from the arcade games using the auto preset:

---

Credits to @Duimon for the awesome available overlay packs.

Credits to Orionsangel for the permission to point the presets to his overlays.

Credits to @hgoda90 for his works on Orionsangel’s Candy Cab presets for Mega Bezel.

Credits to TreyM for the default background image: https://github.com/TreyM/classic-crt-collection/tree/master/CRT

Thanks to guest.r for his g-sharp2_resamplers and crt-guest-advanced shaders.

Thanks to hunterk for the image border and ambilight shader codes.

Thanks to HyperspaceMadness and kokoko3k for their awesome shaders that inspired me to work on this one.

And, since the beginning, thanks to cgwg, maister and DOLLS for the original curvature code.

And to all libretro shader coders and overlay artists, of course!

---

Feedbacks are welcomed!

[kokoko3k]

Very nice Hyllian!

Lately I was wondering if I could strip down mine from some bloat or made specific lighter versions, but I guess we’re covered there now!

If you have time, please, take a look to mine Ambilight code, I think it is very light, so you can include it as well

Another quick tip for grainy look on the reflections, the same HSM gave me, is to displace reflections sampling coords via pseudo-random numbers.

[Hyllian]

@kokoko3k

Lately I was wondering if I could strip down mine from some bloat or made specific lighter versions, but I guess we’re covered there now!

If you have time, please, take a look to mine Ambilight code, I think it is very light, so you can include it as well

Yes, it’s very lightweight not only to run. It loads very instantaneously.

I surely will look into your ambilight code. I just didn’t have the time to concentrate on it, because I was fixing bugs on this first release.

I’ll just not add any feature that deviates from the main objectives: simple and fast shaders. (I measure it by looking at my GPU temperature, if it’s below 63º C, then it’s ok.)

For a full-featured bezel/overlay shaders, I recommend using yours or Mega Bezel.

[Cyber]

@Hyllian

I surely will look into your ambilight code. I just didn’t have the time to concentrate on it, because I was fixing bugs on this first release.

I’ll just not add any feature that deviates from the main objectives: simple and fast shaders. (I measure it by looking at my GPU temperature, if it’s below 63º C, then it’s ok.)

I agree, keep it lean and mean, especially for the folks who want reflections and borders/overlays/bezels. Anything else, you can probably create additional shaders or versions for those like the way we have multiple variations of CRT-Guest-Advanced.

Great job, I asked the universe for this and you answered!

Screenshots are looking really good!

How would I go about integrating this with my existing Sony Megatron Presets? I tried prepending the uborder-reflections.slangp but that already includes scanlines and Sony Megatron already includes scanlines so everything looked weird and ran slowly. Also, Sony Megatron applied scanlines and mask to the whole screen, including the overlay.

[Hyllian]

@Cyber

How would I go about integrating this with my existing Sony Megatron Presets? I tried prepending the uborder-reflections.slangp but that already includes scanlines and Sony Megatron already includes scanlines so everything looked weird and ran slowly. Also, Sony Megatron applied scanlines and mask to the whole screen, including the overlay.

IT’s not that easy as you may think. The only crt shaders compatible for now are the ones I provided: crt-nobody and crt-geom, because they’re single pass (easy to work with). Each one I had to make some changes for them to work with the framework.

Sony Megatron is a multipass shader, so it’s much more complex to tweak it to work and achieve what you want. For now I only converted single pass crt shaders.

I’m not saying it’ impossible, though. It’s just not plug’nplay.

When I mentioned the prepend option, it was for shaders that work to prepare the input for another shader (the crt shader). So, you can easily prepend ntsc or dithering shaders. CRT Shaders aren’t these types of shaders.

[Hyllian]

I have good and bad news for you!

Firstly the good: I got Sony Megatron working. The bad news: no NTSC presets yet, and looks like this crt isn’t very good at small screens, because it is plagued by moiré if you curve the screen, so, it’s recommended only for higher resolutions, which means at least windows of 1080 vertical resolutions. The default jpg isn’t suitable for it, you need to use another background with a big window. Other than that, it isn’t good for non-integer scalings too, so, beware of it.

Here you can grab it: uborder-v0.1-special edition with partial sony megatron support

Screenshot of “crt-sony-megatron-viewsonic-A90f±sdr.slangp” on my small 1080p monitor (see the moiré):

You can load the presets inside 'base_presets/hdr/" directly. Or you can load the main uborder-reflections preset. I didn’t create presets for ambilight or uborder only, though.

[Hari-82]

Great job!

I give it a try and is super fast!

I think this will be very useful for a lot of people/rigs!

Also the sharder choice is nice, no moire to be noticed and with just prepending ntsc adaptive it can be a very viable choice!

[Hyllian]

Nice usage of spooky tv. Which game is that?

I put that to play some survival horrors. If you turn the lights out, it gives the perfect feeling. I have some other weird tv backgrounds here, it’s fun to use with the right games.

[Hari-82]

@Hyllian

Which game is that?

Splatterhouse - Wanpaku Graffiti for Famicom, is a SD version of splatterhouse!

@Hyllian

I put that to play some survival horrors. If you turn the lights out, it gives the perfect feeling. I have some other weird tv backgrounds here, it’s fun to use with the right games

Yeah, spooky tv looks very nice!

[Hyllian]

I don’t intend to go any further in this Sony Megatron stuff, to tell the truth. I made that because I thought you were trying to achieve something with it and I could help. That’s just some side work of this and won’t be integrated in the main line, because,well, the objective here is to keep it simple and fast. Nothing against it, though. Sony Megatron is a great shader if you have the right hardware with hdr, but I don’t see how it’s necessary for this project.

[md2mcb]

Hyllian delivering as usual! I never thought those reflection shaders could be made fast, but here we are again. I tested the presets for about an hour and, so far, they’re great. I don’t have the optionals, since I don’t use them, so I couldn’t test everything, but the essential parts are working and they’re working good. Feedback is always hard with your shaders, as you tend to get things polished from the get-go, so I will need to test it further to see if I can find something that needs improvement.

Anyway, as an initial suggestion, I could only think of:

1. You could add a night preset of your own, to pair it with default uborder.
2. Perhaps the viewport for uborder is a bit small. While it’s expected for this kind of shader to not have a full vertical viewport, it could be somewhat larger, just like the ambient-light-crt variant, which has a pleasant size.

Once again, I congratulate you for your continuous hard work and achievements.

[Hyllian]

@Cyber

Understood. I was just hoping that this shader was the start of liberating reflective borders/bezels so that they might be easier to use with other shaders in addition to being simple and fast.

It’s easier to integrate than Mega Bezel or Koko-aio, but not plug n’play as you expect. It needs some carefull coding to port another crt inside it. And some crt shaders do not ‘like’ curvature code.

@Cyber

I also felt Sony Megatron Color Video Monitor might have been a good fit since its simple and fast as well, thus keeping within the framework and goals of the project. Besides that, it’s what I use so of course I would want to be able to just add these awesome overlays and reflections to what I currently use and have done already.

As I said, it isn’t a good fit because its masks are very strong and produce moiré easily, being very visible at small resolutions. And without curvature you can only use it with flat tv backgrounds. Besides, it needs higher resolutions to work at non integer scalings. So, it isn’t a good fit for this project if it has so many conditions to work properly.

@Cyber

You mentioned that you got one of the Sony Megatron Color Video Monitor default presets to work but not NTSC so I just suggested the example of my presets as an alternative method of adding the NTSC component (and possibly other components to see if that would have assisted in integration).

I didn’t even try to port the ntsc, because the short time, but it can be done. Your presets wouldn’t be of help in this case because they’re just pointing to Sony Megatron, they’re not part of it. I can try to port the ntsc IF you intend to use, but I won’t integrate to the main line for the reasons I explained.

@Cyber

You mentioned that you got one of the Sony Megatron Color Video Monitor default presets to work but not NTSC

I got all that aren’t ntsc. Try loading the ones inside ‘base-presets/hdr’ I provided to you in that zip. They all work, except the ones with ntsc.

@Cyber

I just suggested the example of my presets as an alternative method of adding the NTSC component (and possibly other components to see if that would have assisted in integration). This is also why I made the suggestion of following Mega Bezel’s lead in order to not have to reinvent the wheel because integrated stuff like this seems to have been done already.

An easier way to use ntsc is just using the presets in the zip I provided to you , load a working preset and prepend ntsc-adaptive.

@Cyber

if that were corrected/eliminated

It can’t, without some massive work inside Sony Megatron code. Something I won’t do, because not my priority.

@Cyber

Things like support for additional mask patterns and BGR subpixel layout displays come to mind.

Would be nice to see at least the latter as I’m unable to use/view most of the masks properly due to my display’s BGR subpixel layout.

Anyway, let’s get back to the focus of this thread. I won’t be working to improve other crt shaders. I only port they as they are now. If they fit, ok, if don’t, I’ll just try another.

[Hyllian]

@md2mcb

You could add a night preset of your own, to pair it with default uborder.

It’s a good suggestion and can be done in a number of ways: dynamic background, static (multiple backgrounds), multiple presets or just a preset param. I’ll have to think further about it.

@md2mcb

Perhaps the viewport for uborder is a bit small. While it’s expected for this kind of shader to not have a full vertical viewport, it could be somewhat larger, just like the ambient-light-crt variant, which has a pleasant size.

Indeed. Though I would have to find an alternative for the default background. I’m not an artist and don’t have the skills to create an image of my own. And, it’s not an easy task to find a background that fit and is free to use in the Internet. So I accept contributions from artists in this regard.

[Cyber]

@Hyllian Is it possible to get img_mod.slangp to work with this shader?

I tried it and it failed to load. It would add a little polish to the pixels and allow me to fine crop, add some noise and more.

[Hyllian]

@Cyber

Is it possible to get img_mod.slangp to work with this shader?

As it has curvature code inside it, it’s necessary some coding to make it work without conflicting with uborder curvature one. I’ll put your suggestion in the TODO list.

[Cyber]

@Hyllian

As it has curvature code inside it, it’s necessary some coding to make it work without conflicting with uborder curvature one.

Thanks, not sure if this would make a difference but I use a customized version which only contains, the cropping (Overscan Mask), film grain, rounded corners and gamma correction, I think.

#version 450

//   Modular Image Adjustment
//   Author: hunterk
//   License: Public domain

layout(push_constant) uniform Push
{
	vec4 SourceSize;
	uint FrameCount;
	vec4 OutputSize;
} registers;

layout(std140, set = 0, binding = 0) uniform UBO
{
   mat4 MVP;
#include "../../include/img/param_floats.h"
} global;

#include "../../include/img/helper_macros.h"

/////////////////////////////// INCLUDES ////////////////////////////////
// comment the #include and corresponding line to remove functionality //
/////////////////////////////////////////////////////////////////////////

// Flip image vertically or horizontally
// #include "../../include/img/image_flip.h"

// Stretching, Zooming, Panning
// #include "../../include/img/stretch_zoom_pan.h"

// Film grain effect
#include "../../include/img/film_grain.h"

// Sharp, antialiased pixels; use with linear filtering
// #include "../../include/img/sharpening.h"

// Saturation and Luminance
//#include "../../include/img/sat_lum.h"
// #include "../../include/img/lum_chrom.h"

// Gamma correction
// exp_gamma is basic pow function 
//#include "../../include/img/exp_gamma.h"
#include "../../include/img/gamma_srgb.h"

// Mask edges to hide unsightly garbage
#include "../../include/img/border_mask.h"

// Change the whitepoint to warmer/cooler
// #include "../../include/img/white_point.h"

// Add a phosphor mask effect onto the image
// #include "../../include/img/subpx_masks.h"

// Force integer scaling and custom aspect ratio
//#include "../../include/img/int_ar.h"

// Vignette; Darkens image around edges
//#include "../../include/img/vignette.h"


// Black level
// uncomment only one of the next 2 lines to set black level method
//#include "../../include/img/black_lvl.h"
// #include "../../include/img/black_lvl_dogway.h"

// Brightness and Contrast control
// uncomment only one of the next 2 lines to set contract complexity;
// sigmoidal_con is advanced, bright_con is basic
// #include "../../include/img/sigmoidal_con.h"
//#include "../../include/img/bright_con.h"

// Adjust color balance and tint
// uncomment only one of the next 2 lines to set color channel complexity;
// color mangler is advanced, channel mixer is basic
//#include "../../include/img/col_mangler.h"
// #include "../../include/img/channel_mix.h"

// 2D screen curvature
//#include "../../include/img/gristle_warp.h"
//#include "../../include/img/lottes_warp.h"
// #include "../../include/img/cgwg_warp.h"

// Rounded corners
#include "../../include/img/corner.h"

////////////////////////////// END INCLUDES //////////////////////////////

#pragma stage vertex
layout(location = 0) in vec4 Position;
layout(location = 1) in vec2 TexCoord;
layout(location = 0) out vec2 vTexCoord;

void main()
{ 
   vec4 pos = Position;
   
// apply axis flip
//   pos = flip_pos(pos);
   
   gl_Position = global.MVP * pos;
   
   vec2 coord = TexCoord.st;
   
// apply crop/zoom/pan
//   coord = crop_zoom_pan(TexCoord);
   
// apply integer scaling and aspect ratio
//   coord = int_ar(coord, registers.SourceSize, registers.OutputSize);
   
   vTexCoord = coord;
}

#pragma stage fragment
layout(location = 0) in vec2 vTexCoord;
layout(location = 0) out vec4 FragColor;
layout(set = 0, binding = 2) uniform sampler2D Source;

//////////////////////////////// LUTS ///////////////////////////////////
// Use either 1 or 2 color-grading LUTs
// uncomment only one of the next 2 lines
//#include "../../include/img/lut1.h"
//#include "../../include/img/lut2.h"
////////////////////////////// END LUTS /////////////////////////////////

void main()
{
// declare texture coordinates
   vec2 coord = vTexCoord.xy;
   
// apply sharpening to coords
//   coord = sharp(vTexCoord, registers.SourceSize);
   
// apply screen curvature
//   coord = warp(coord);

// sample the texture   
   vec3 res = texture(Source, coord).rgb;

// apply grain (expects to run in gamma space)
   res = luma_grain(res, vTexCoord.xy, ia_GRAIN_STR, registers.FrameCount);
// res = rgb_grain(res, vTexCoord.xy, ia_GRAIN_STR, registers.FrameCount);

// saturation and luminance (expects to run in gamma space)
//   res = sat_lum(res);
   
// contrast
//   res = cntrst(res);
   
// apply first gamma transform (linearize)
// (whether LUT or gamma should come first depends on LUT)
   res = gamma_in(res);
   
// apply LUT1
//   res = lut1(res);

// apply white point adjustment
//   res = white_point(res);

// black level
//   res = black_level(res);
   
// channel mix
//   res = channel_mix(res);
   
// overscan mask
   res = border_mask(res, coord.xy);
   
// apply LUT2 (whether LUT or gamma should come first depends on LUT)
//   res = lut2(res);
   
// apply gamma curve
   res = gamma_out(res);

// apply mask effect
//   res *= mask_weights(gl_FragCoord.xy, mask_strength, mask);
   
// apply vignette effect
//   res = vignette(res, vTexCoord.xy);
   
// apply rounded corners
   res *= corner(coord);
    
   FragColor = vec4(res, 1.0);
}

[HyperspaceMadness]

@Hyllian

I’ll just not add any feature that deviates from the main objectives: simple and fast shaders. (I measure it by looking at my GPU temperature, if it’s below 63º C, then it’s ok.)

Ah! But the Mega Bezel can keep you and your GPU warm at night!

Nice Stuff @Hyllian!!!

[Hari-82]

There is also this project by @Duimon that is very easy to use with Uborder, lots of nice overlays to add variety!

I used this parameters with the uborder-reflections.slangp if anybody is interested

ub_border_top = "1.000000"
box_scale = "3.680000"
in_res_x = "325.000000"
in_res_y = "244.000000"
geom_center_x = "-0.000000"
geom_center_y = "0.002000"
geom_curvature = "1.000000"
geom_R = "2.000000"
geom_d = "1.600000"
geom_cornersize = "0.011000"
geom_cornersmooth = "280.000000"
CN_SCAN_SIZE = "0.800000"
CN_BRIGHTBOOST = "1.080000"
CN_VIG_TOGGLE = "1.000000"
CN_VIG_BASE = "26.000000"
CN_VIG_EXP = "0.140000"
frame_w = "0.626001"
frame_h = "0.825001"
bezel_w = "0.024000"
bezel_h = "0.038000"
reflection_strength = "0.240000"
bezel_center_y = "-0.001000"

BORDER = "path/to/the/overlay.png"

two example

[Hyllian]

Very nice finding! You’ve got the spirit of this project! It’s very easy to point to other overlay packs and adjust the frame to the window, as well as the reflection bars to the bezels. I intend to release separate packs of some real and weird tvs along their presets.

[hunterk]

img_mod shader/components are meant to be modular. The shader itself is really just meant to be an example of how someone could pull in the various included functions and apply them, so if there are a few functions someone likes, they’re easy to pull into any other shader rather than using the actual img_mod shader.