slang-shaders/bezel/Mega_Bezel/resource/wildcard-examples/Readme.md
HyperspaceMadness 7cdc185f8c Mega Bezel V1.11.0_2023-02-25
Changes:
  * Guest Advanced updated to crt-guest-advanced-2023-02-25-release1
    * Improvements to the new Magic Glow feature
      * Turn Magic Glow on and Increase the Glow amount to see the effect
    * New Slot Mask Mitigation option to reduce moire
  * Added/Restored Guest's Raster Bloom as well as Overscan control
  * Updated Comments in presets to use # instead of // as per @hunterk's request
  * Added rotation option for Rotate CRT Tube:
    * -1 = 90 Degrees Clockwise (or 270 Counter Clockwise)
    * 0 = No Rotation
    * 1 = 90 Degrees Counter Clockwise
  * Added groundwork for the wildcard replacement feature so presets will auto rotate and not flip in the future
  * Added DREZ presets which keep the horizontal resolution
    * Helpful for applying to modern games, these two are good to try
        * `Presets\Base_CRT_Presets_DREZ\MBZ__3__STD__GDV__DREZ_X-VIEWPORT_Y-240p.slangp`
        * `Presets\Base_CRT_Presets_DREZ\MBZ__3__STD__GDV__DREZ_X-VIEWPORT_Y-480p.slangp`
    * Also looks good on MVC2, try `Presets\Base_CRT_Presets_DREZ\MBZ__3__STD__GDV__DREZ_X-VIEWPORT_Y-240p.slangp`
  * Updated preset capability and performance table
  * Added contrast for signal noise
  * Added some more Sinden presets for SCREEN-ONLY and POTATO
  * Added Screen Region to Resolution Debug text
    * Good for getting the screen region pixel coordinates if you need them
  * Adjusted Ambient Lighting Scaling when using the Inherit Zoom scale mode
    * Now when you zoom out it is much less likely to generate a black frame covering the outer parts of the background image
    * The minimum size of the lighting texture will be close to the height of the current viewport
    * This reduces the likelihood that we will see the cutoff
  * ScaleFx: Exposed more of the settings so they can be tweaked
    * Default Settings changed:
      * ScaleFx Threshold: now 0.43 (was 0.5)
      * ScaleFx Filter Corners: now 0 (was 1)
      * These settings result in a slighly clearer picture and less rounding of square corners
  * SMOOTH-ADV ntsc presets: ntsc_scale adjusted so it visually matches the regular ADV ntsc presets
2023-02-28 08:11:50 -05:00

3 KiB

Wildcard Path Replacement

When a simple preset loads, text wildcards which are found in paths inside the presets will be replaced with values coming from the current RetroArch context. The replacement will be executed on both texture paths and reference paths.

This would allow you to do things like have one preset which could be used with the entire list of images from the Bezel Project


Example:

/shaders/MyBackground_$VID-DRV$_$CORE$.png

would be replaced with

/shaders/MyBackground_glcore_YabaSanshiro.png

If no file found at the new path with the replacements, we revert to the original path

/shaders/MyBackground_$VID-DRV$_$CORE$.png


Possible wildcards/tokens to be replaced:


$CONTENT-DIR$ -> Content Directory of the game rom

$CORE$ -> Core name

$GAME$ -> Game file's name, E.G. ROM name

$VID-DRV$ -> Video Driver: Currently active driver, possible replacement values:

  • glcore
  • gl
  • vulkan
  • d3d11
  • d3d9_hlsl
  • N/A

$VID-DRV-SHADER-EXT$ -> Video Driver Shader File Extension: The extension of shaders type supported by the current video driver:

  • cg
  • glsl
  • slang

$VID-DRV-PRESET-EXT$ -> Video Driver Preset File Extension: The extension of shaders type supported by the current video driver:

  • cgp
  • glslp
  • slangp

$CORE-REQ-ROT$ -> Core Requested Rotation: Rotation the core is requesting, possible replacement values:

  • CORE-REQ-ROT-0
  • CORE-REQ-ROT-90
  • CORE-REQ-ROT-180
  • CORE-REQ-ROT-270

$VID-ALLOW-CORE-ROT$ -> Video Allow Core Rotation: Reflects Retroarch's setting allowing the core requested rotation to affect the final rotation:

  • VID-ALLOW-CORE-ROT-OFF
  • VID-ALLOW-CORE-ROT-ON

$VID-USER-ROT$ -> Video User Rotation: Rotation the core is requesting, possible replacement values, does not affect the UI:

  • VID-USER-ROT-0
  • VID-USER-ROT-90
  • VID-USER-ROT-180
  • VID-USER-ROT-270

$VID-FINAL-ROT$ -> Video Final Rotation: Rotation which is the sum of the user rotation and the core rotation if it has been allowed, does not affect the UI:

  • VID-FINAL-ROT-0
  • VID-FINAL-ROT-90
  • VID-FINAL-ROT-180
  • VID-FINAL-ROT-270

$SCREEN-ORIENT$ -> Screen Orientation: User adjusted screen orientation, will change windows from landscape to portrait, including the Retroarch UI:

  • SCREEN-ORIENT-0
  • SCREEN-ORIENT-90
  • SCREEN-ORIENT-180
  • SCREEN-ORIENT-270

$VIEW-ASPECT-ORIENT$ -> Viewport Aspect Orientation: Orientation of the aspect ratio of the RetroArch viewport

  • VIEW-ASPECT-ORIENT-HORZ
  • VIEW-ASPECT-ORIENT-VERT

$CORE-ASPECT-ORIENT$ -> Core Aspect Orientation: Orientation of the aspect ratio requested by the core

  • CORE-ASPECT-ORIENT-HORZ
  • CORE-ASPECT-ORIENT-VERT

$PRESET_DIR$ -> Preset directory's name

$PRESET$ -> Preset's name

If no wildcards are found within the path, or the path after replacing the wildcards does not exist on disk, the path returned will be unaffected.