Fullscreen++

じ☆ve冰风

Fullscreen++ is now compatible with RMXP!
Fullscreen++ is a script to add a new fullscreen mode to your game, now using famous emulators shaders to upscale it.

Download
https://www.dropbox.com/scl/fi/smfb...reen.zip?rlkey=rucjau31n5k9osakm8o6qjuao&dl=1​

Installation
Copy the scripts above Main as usual, first Zeus Module.rb then Fullscreen++.rb.​
Copy Fullscreen.dll into the game folder or into its System subfolder.​
If your game is released on Steam you can also copy steam_api.dll.​
This allows better integration by pausing the game while the Steam overlay is displayed.​
You can also set the app ID at the beginning of the script to activate Steam’s DRM.​

Keyboard Shortcuts
F11 : toggle fullscreen​
Shift + F11 : switch aspects (stretch - keep ratio - integer)​
Ctrl  + F11 : switch shaders​

Configuration
To be placed in the Game.ini:​
                Code:       

1. [Fullscreen++]
2. Fullscreen=true
3. VSync=true
4. BlackFrame=false
5. KeepAspect=1
6. Overscan=0.0
7. BackEffect=Blur()
8. BackAspect=2
9. EffectId=2
10. Effect0=RAA() SimpleScale()
11. Effect1=MMPX() SimpleScale()
12. Effect2=ScaleFX() SimpleScale()
13. Effect3=FSR() SimpleScale()

复制代码

Fullscreen = true or false : enable fullscreen at game start.​
VSync = true or false : enable/disable vertical sync to prevent screen tearing.​
BlackFrame = true or false : enable/disable BFI mode, reduces motion blur.​
KeepAspect = 0, 1, or 2 : stretch, keep ratio, or integer scaling.​
Overscan = -0.5 à +0.5 : zoom in/out inside the game window.​
BackEffect = string : defines the background when the game image doesn’t fill the window.​

•    If string is empty : black background.
  
•    If string is a filename : displays an image from Graphics/Pictures or the game folder.
  
•    If string is Blur() : shows a blurred version of the game image, with optional parameters that I will describe after.
  

BackAspect = x : defines how the background image is displayed.​

•    0 : stretch to full window (interpolation depends on last SimpleScale settings).
  
•    1 : keeping aspect ratio (fit in), uncovered areas are black.
  
•    2 : keeping aspect ratio (fit out).
  
•    3 : center without scaling, uncovered areas are black.
  
•    4 : tile the image without scaling.
  

EffectId = x : id of the active effect.​
EffectN = shaders : list of shaders applied in order, the last must be SimpleScale.​
At least one effect must be defined (Effect0). There is no max limit, but cycling through 1000 effects with Ctrl+F11 would be painful,​
so better keep it reasonable.​

Script Commands
Graphics.fullscreen = true or false​
Graphics.vsync = true or false​
Graphics.black_frame = true or false​
Graphics.keep_aspect = 0, 1, or 2​
Graphics.overscan = -0.5 à +0.5​
Graphics.background[0] = "BackEffect"​
Graphics.background[1] =  BackAspect​
Graphics.effect_id = x​
Graphics.effects = ["Effect0", ...]​
Graphics.load_settings(filename) : optional filename, defaults to Game.ini​
Graphics.save_settings(filename) : optional filename, defaults to Game.ini​

Shaders
The formatting must be: ShaderName(option1:x, option2:y, option3:z)​
Parameter order can’t be changed, but parameter names may be omitted: ShaderName(x, y, z)​
All parameters must be present or may be omitted entirely: ShaderName()​
Therefore it will use default parameters which are listed below.​

SimpleScale(scale:0, interpolation:1)
scale: > 0 = fixed value, 0 = auto fit to window, -1 = auto integer scale, -2 = auto power of 2, -3 = auto power of 3​
interpolation: 0 = none (nearest neighbor), 1 = bilinear, 2 = bicubic​



A SimpleScale must also be used as the final shader, the scale value will be ignored and set to 0.​
The interpolation value of the final SimpleScale will also be used for the background image if there is one.​
But nothing prevents you from using the shader multiple times, for example to do what’s called sharp bilinear: SimpleScale(-1, 0) SimpleScale(0, 1)​

CAS(scale:0, sharpness:0.9, preset:0)
scale: > 0 = fixed value, 0 = auto fit to window, -1 = auto integer scale, -2 = auto power of 2, -3 = auto power of 3​
sharpness: 0.0 = off, 1.0 = max​
preset: 0 = fast, 1 = balanced, 2 = slow​



CAS = Contrast Adaptative Sharpening, it can upscale, but it can also be used as a simple sharpening filter by setting scale to 1.​

FSR(scale:0, sharpness:0.9)
scale: > 0 = fixed value, 0 = auto fit to window, -1 = auto integer scale, -2 = auto power of 2, -3 = auto power of 3​
sharpness: 0.0 = off, 1.0 = max​



FSR = FideltyFX Super Resolution, unlike CAS, it's not recommended to use FSR with scale set to 1, it's not designed for that.​

RAA(scale:0, interpolation:1, sharpness:1.0)
scale: > 0 = fixed value, 0 = auto fit to window, -1 = auto integer scale, -2 = auto power of 2, -3 = auto power of 3​
interpolation: 0 = none (nearest neighbor), 1 = bilinear, 2 = bicubic​
sharpness: 0.0 = off, 1.0 = max​



RAA = Reverse Anti Aliasing, as the name may (not) imply, it's very effective at upscaling already smoothed elements such as texts.​
It tends to leave pixel art mostly intact (though if you zoom in you’ll see it still affects it slightly).​
This filter only upscales by integer values, if the target scale is not an integer, an additional SimpleScale shader will be applied to reach the final size using the chosen interpolation.​

MMPX(scale:0, interpolation:1, threshold:0.2, RAA_Sharpness:0.0)
scale: > 0 = fixed value, 0 = auto fit to window, -1 = auto integer scale, -2 = auto power of 2, -3 = auto power of 3​
interpolation: 0 = none (nearest neighbor), 1 = bilinear, 2 = bicubic​
threshold: 0.0 = off, 1.0 = max, allows tolerance in color comparisons.​
RAA_Sharpness: 0.0 = off, 1.0 = max, useful when your game mixes pixel art and smooth images, it applies RAA to non–pixel-art elements.​



MMPX is a filter specialized in pixel-art upscaling with the goal of preserving the original style.​
Because of that, it's extremely sensitive to even the smallest color variations, heavy fog or transparency effects will break it.​
This filter only upscales by x2, if the upscale value is greater than 2, the filter will be applied repeatedly until the target scale is reached,​
and if it is not a power of 2, an additional SimpleScale shader is applied using the chosen interpolation.​

ScaleFX(scale:0, interpolation:1, filterAA:false, filterCorners:true, threshold:0.5, RAA_Sharpness:0.0)
scale: > 0 = fixed value, 0 = auto fit to window, -1 = auto integer scale, -2 = auto power of 2, -3 = auto power of 3​
interpolation: 0 = none (nearest neighbor), 1 = bilinear, 2 = bicubic​
filterAA: true or false, allows ScaleFX to process AA elements, not as good as RAA but preserves pixel art better (avoid enabling both).​
filterCorners: true or false, ScaleFX tends to round corners, disable this to keep perfectly square corners (may false detect some corners though).​
threshold: 0.0 = off, 1.0 = max, tolerance in color comparisons.​
RAA_Sharpness: 0.0 = off, 1.0 = max, useful when your game mixes pixel art and smooth images, it applies RAA to non–pixel-art elements.​



ScaleFX is the Rolls Royce of pixel-art upscalers with advanced handling of curves and oblique lines, where other upscalers create jaggies.​
This filter only upscales by x3, if the upscale value is greater than 3, the filter will be applied repeatedly until the target scale is reached,​
and if it is not a power of 3, an additional SimpleScale shader is applied using the chosen interpolation.​

SMAA(preset:3, colorEdgeDetection:true, localContrastAdapt:2.0, threshold:0.8)
preset: 0 = low, 1 = medium, 2 = high, 3 = ultra​
colorEdgeDetection: true ou false, SMAA has two edge detection modes, luminance-based or color-based, color-based is better.​
localContrastAdapt: x > 1, ignores edges with contrast above x.​
threshold: 0.0 = off, 1.0 = max, avoids smoothing edges that are already smooth.​



SMAA = Subpixel Morphological Anti-Aliasing, the best post-processing AA.​
Like MMPX, it is sensitive to color variations and can shimmer easily.​

Blur(mode:0, quality:5, radius:1.0, angle:0.0, centerX:0.5, centerY:0.5, downscale:0)
mode: 0 = regular blur, 1 = linear blur, 2 = spin blur, 3 = zoom blur, 4 = spiral blur​
quality: 1 = min, 9 = max, number of passes, higher = better but heavier.​
radius: 0.0 = min, 100.0 = max, higher radius requires higher quality to remain smooth.​
angle: x, angle for linear blur, for spin/zoom/spiral blurs indicates direction: -1 = counterclockwise/unzoom, 0 = bidirectional, +1 = clockwise/zoom.​
centerX, centerY: x, coordinates of the blur origin (percentage).​
downscale: 0 = auto, > 1 = fixed value, downscales the image before blurring for better performance.​
​
The direct use of this shader is limited, maybe for transitions?​
It's mainly used by the Glow shader and for window background effects.​

Glow(blendMode:8, blendOpacity,:1.0 lumaThreshold:0.0, thresholdSoftness:0.0, intensityR:0.5, intensityG:0.5, intensityB:0.5, blurMode:0, blurQuality:5, blurRadius:1.0, blurAngle:0.0, blurCenterX:0.5, blurCenterY:0.5)
blendMode:    0 = normal linear , 1 = normal srgb,​
2 = multiply linear , 3 = multiply srgb,​
4 = hard light linear, 5 = hard light srgb,​
6 = overlay linear , 7 = overlay srgb,​
8 = soft light linear , 9 = soft light srgb,​
10 = screen linear , 11 = screen srgb,​
12 = add linear   , 13 = add srgb​
blendOpacity: 0.0 = off, 10.0 = max, values can go above 100% (1.0) to increase the effect further.​
lumaThreshold: 0.0 = off, 1.0 = max, applies the filter only to pixels whose brightness exceeds the threshold.​
thresholdSoftness: 0.0 = off, 1.0 = max, -1.0 = max inverted, softens the on/off transition of the brightness mask, negative values invert the mask.​
intensityR, intensityG, intensityB: x < 1 = reduces color intensity, x > 1 = increase color intensity.​
blurMode, blurQuality, blurRadius, blurAngle, blurCenterX, blurCenterY: same as Blur shader.​

Palette(paletteId:1, smooth:false, ditherMode:1, ditherAnime:0, ditherAmount:0, sharpness:0.4, customColors:[])
paletteId: 0 = Black & White, 1 = GB DMG, 2 = GB Light, 3 = Virtual Boy, 4 = LCD, 5 = Sepia, 6 = Pastel, 7 = Burning Sunset, 8 = Midnight Purple,​
9 = Inverted Matrix, 10 = CGA 1, 11 = CGA 2, 12 = Cocorico, 13 = Custom Colors, 14 = Macintosh, 15 = NES, 16 = 8 Bit Depth​
smooth: true or false, adds intermediate colors to the palette.​
ditherMode: 0 = off, 1 = Bayer Matrix 2x2, 2 = Bayer Matrix 4x4, 3 = Bayer Matrix 8x8, 4 = Bayer Matrix 16x16, 5 = Blue Noise (Gray), 6 = Blue Noise (RGB )​
ditherAnime: 0 = off, x = dithering animation frequency, every x frames.​
ditherAmount: 0.0 = auto, 1.0 = max​
sharpness: 0.0 = off, 10.0 = max, coarse sharpening filter that adds ringing but can help low-color palettes (creates outlines).​
customColors: [#RRGGBB, #RRGGBB, #RRGGBB, #RRGGBB], defines 4 hex colors for palette 13.​

Daltonize(anomaly:0, severity:1.0)
anomaly: 0 = Protanopia Simulation      , 1 = Deuteranopia Simulation      , 2 = Tritanopia Simulation,​
3 = Protanopia Correction      , 4 = Deuteranopia Correction      , 5 = Tritanopia Correction,​
6 = Protanopia Correction + Simulation, 7 = Deuteranopia Correction + Simulation, 8 = Tritanopia Correction + Simulation​
severity: 0.0 = off, 1.0 = max, severity of color blindness, red (Protanopia), green (Deuteranopia), or blue (Tritanopia).​
​
0 1 2 simulate what a color-blind person sees (for debug)​
3 4 5 are used to actually correct colors (for release)​
6 7 8 visualize the effectiveness of the correction (for debug)​

Tweaks(hue:0, saturation:1.0, brightness:1.0, contrast:1.0, luminosity:1.0, gamma:1.0, sharpness:0.0)
hue: 0.0 - 360.0, changes hue (HSB/HSV model).​
saturation: 0.0 - 10.0, < 1 reduces, > 1 increases saturation (HSB/HSV model).​
brightness: 0.0 - 10.0, < 1 reduces, > 1 increases brightness/value (HSB/HSV model).​
contrast:   0.0 - 10.0, < 1 reduces, > 1 increases contrast.​
luminosity: 0.0 - 10.0, < 1 reduces, > 1 increases luminosity.​
gamma:      0.0 - 10.0, < 1 reduces, > 1 increases gamma.​
sharpness: 0.0 = off, 10.0 = max​

EXE Version
I also provide an executable version that works with other applications.​
To use it, simply copy Fullscreen++.exe and .ini into the game directory and run it.​
Fullscreen++ will launch the game, capture its window, and redraw the upscaled content inside.​
It is preconfigured for RM2k3 but can be used for any software that renders its window using GDI.​
                Code:       

1. [Fullscreen++]
2. ApplicationPath=RPG_RT.exe
3. CommandLineArgs=NormalPlay ShowTitle Window
4. CreateWindow=false
5. CaptureRect=2, 2, 640, 480
6. ...
7. Effect0=SimpleScale(0.5, 0) RAA() SimpleScale()

复制代码

ApplicationPath = path to the executable to launch.​
CommandLineArgs = Fullscreen++ requires the game to be in windowed mode, these arguments force 2k3 into windowed mode.​
CreateWindow = creates a new window for Fullscreen++, not needed for 2k3 but useful for other software.​
CaptureRect = area of the window to capture (2k3 has a gray frame, so I remove it). Leave empty to capture the whole window.​
Effect0 = SimpleScale(0.5, 0)... Pixel-art upscalers need the game at x1 size to work properly. Since 2k3’s windowed mode is x2 by default, I downscale without interpolation to restore x1 before applying the other shaders.​



Examples with RM2k3 (integrated) and Kega Fusion (separate window).​




Notes
The VX Ace video player is not supported for now.​
Configuration can be a bit tedious, I will add a GUI in the next update.​
Shaders require DirectX 11, non-compatible PCs automatically fall back to the old Fullscreen++ version.​



本贴来自国际rpgmaker官方论坛作者:Zeus81处,因国际论坛即将永久关站,为了存档多年珍贵资料,署名转载到本论坛存档,由于官方帖子为英文原帖，需要中文翻译请点击论坛顶部切换语言为中文就可以将帖子翻译成中文浏览,方便大家随时查看,原文地址：https://forums.rpgmakerweb.com/threads/fullscreen.181367/