You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: FAQ.md
+1-69Lines changed: 1 addition & 69 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,72 +2,4 @@
2
2
3
3
---
4
4
5
-
### > I'm seeing black only
6
-
7
-
Make sure you're using __Windows 10, version 2004__ (build 19041) or __Windows 11__.
8
-
9
-
---
10
-
11
-
### > Can I use it with Reshade?
12
-
13
-
While there is no special support for it, you can inject Reshade into ShaderGlass just like into any other DirectX 11 app and stack Reshade shaders on top.
14
-
15
-
---
16
-
17
-
### > I see yellow border around captured screen/window
18
-
19
-
#### Windows 10
20
-
21
-
Unfortunately yellow border is enforced on Windows 10 and there's no way to remove it. There are some ways to avoid it, for example:
22
-
* start up your game in Windowed mode
23
-
* in ShaderGlass choose Input -> Window -> choose your game's window
24
-
* click onto your game window to give it focus
25
-
* press Ctrl+Shift+G to make ShaderGlass fullscreen
26
-
27
-
#### Windows 11
28
-
29
-
It's possible to disable yellow border but only on Windows 11. If you are using Windows 11 and still seeing the border,
30
-
open Windows Settings app and search for "screenshot borders". Make sure all the options and ShaderGlass are allowed to
31
-
remove the border per below:
32
-
33
-

34
-
35
-
---
36
-
37
-
### > I can't capture using OBS
38
-
39
-
OBS can capture ShaderGlass but only as a Game Capture source (not Window Capture nor Desktop Capture). Use "Capture specific window" within
40
-
Game Capture to select ShaderGlass window only.
41
-
42
-

43
-
44
-
---
45
-
46
-
## > Text/letters are all blurry or pixelated
47
-
48
-
For maximum sharpness set Input -> Pixel Size -> x1 but note that a lot of shaders expect pixelated input so set this option accordingly to each scenario.
49
-
50
-
---
51
-
52
-
## > Can I save a profile?
53
-
54
-
Yes, you can save shader profiles as files, access from Recent Profiles menu and even load them on startup via a command line parameter. See [README](README.md) for details.
55
-
56
-
---
57
-
58
-
## > I don't see my favourite RetroArch shader
59
-
60
-
ShaderGlass includes majority of RetroArch repository at time of release, but some shaders had to be excluded because of features SG doesn't yet support (for example HDR).
61
-
Differences vs RA repository are tracked in [this PR](https://github.com/mausimus/slang-shaders/pull/1).
62
-
63
-
---
64
-
65
-
## > ShaderGlass can't capture some windows
66
-
67
-
Unfortunately some old-style rendering windows are not supported by modern Windows Capture API. Please use Desktop mode to capture those.
68
-
69
-
---
70
-
71
-
## > Can I...
72
-
73
-
Please read through [README](README.md) to find functionality you are looking for.
5
+
FAQ is now part of the [Online Manual](https://mausimus.github.io/ShaderGlass/MANUAL.html).
<li><p><strong>Use Flip Mode</strong> - uses DXGI Flip Presentation mode (as opposed to BitBlt) which is faster but a little unstable (especially on Windows 10)</p></li>
67
72
<li><p><strong>Allow Tearing</strong> - removes explicit V-Sync, required for VRR to work</p></li>
68
73
<li><p><strong>Max Capture Rate</strong> - remove capture frame limit of WGC, only supported since Windows 11 24H2</p></li>
74
+
<li><p><strong>Use HDR</strong> - use HDR-compatible RGBAf capture and display formats (experimental)</p></li>
69
75
</ul>
70
76
<li><p><strong>Load/Save/Recent Profiles</strong> - you can save ShaderGlass' configuration into a profile file and load later</p></li>
71
77
<li><p><strong>Set as default/Remove default</strong> - make current settings the default when starting up</p></li>
@@ -76,10 +82,10 @@ <h4 id="input">Input</h4>
76
82
<ul><li><p><strong>Lock Current Area</strong> - always capture current area even if ShaderGlass window is moved</p></li></ul>
77
83
<li><p><strong>Window</strong> - captures the selected window, defaults to Clone mode</p></li>
78
84
<ul>
79
-
<li><p><strong>Rescan</strong> - refresh the list of open windows</p></li>
80
85
<li><p><strong>Crop</strong> - remove border around captured window, if your emulator has a toolbar for example</p></li>
81
86
</ul>
82
-
<li><p><strong>File</strong> - load a .png or .jpg file as input</p></li>
87
+
<li><p><strong>Device</strong> - captures an external/USB device (webcam or capture card)</p></li>
88
+
<li><p><strong>File</strong> - load a .png/.jpg/.gif file as input</p></li>
83
89
<li><p><strong>Pixel Size</strong> - indicates the size of input pixels (pre-scaling), i.e. if you run a game in x3 scaling mode set this to x3 as well so that ShaderGlass can tell the original resolution</p></li>
84
90
<ul>
85
91
<li>
@@ -89,10 +95,16 @@ <h4 id="input">Input</h4>
89
95
</p>
90
96
</li>
91
97
</ul>
92
-
<li><p><strong>Capture Cursor</strong> - whether to include mouse cursor in capture</p></li>
98
+
<li>
99
+
<divclass="break"></div>
100
+
<p>
101
+
<strong>Capture Cursor</strong> - whether to include mouse cursor in capture; this will not work 100% of the time unfortunately, it will only hide system cursors but not custom cursors some games set;
102
+
see FAQ for workarounds
103
+
</p>
104
+
</li>
93
105
<li><p><strong>Remove Yellow Border</strong> - disables yellow frame around captured area (forced security feature); currently only supported on Windows 11</p></li>
<li><p><strong>Choose from Library</strong> - open Shader Browser to switch the current shader:</p></li>
128
140
<ul>
@@ -137,11 +149,11 @@ <h4 id="shader">Shader</h4>
137
149
<li><p><strong>Import custom</strong> - load and compile an external .slangp/.slang shader</p></li>
138
150
<li><p><strong>Parameters</strong> - show and modify active shader's parameters</p></li>
139
151
</ul>
140
-
<pstyle="page-break-before: always;"> </p>
141
152
<p>
142
153
You can save and load profile files which will store all the options. It's also possible to pass profile file path on the command
143
154
line and ShaderGlass will load it on startup.
144
155
</p>
156
+
<p>If you associate ShaderGlass with .sgp extension in Windows (double-click .sgp file and choose ShaderGlass) you will be able to start it up by double-clicking a profile file.</p>
and/or aspect ratio correction in ShaderGlass and enjoy the game.
195
215
</p>
196
216
<p><br/></p>
217
+
<divclass="break"></div>
197
218
<h2id="parameters">Importing Custom Shaders</h2>
198
219
<p>
199
220
ShaderGlass comes with a large built-in library of shaders, but you can also import custom ones
@@ -255,10 +276,42 @@ <h3 id="-textletters-are-all-blurry-or-pixelated">> Text/letters are all blur
255
276
<p>For maximum sharpness set Input -> Pixel Size -> x1 but note that a lot of shaders expect pixelated input so set this option accordingly to each scenario.</p>
256
277
<h3id="-i-dont-see-my-favourite-retroarch-shader">> I don't see my favourite RetroArch shader</h3>
257
278
<p>
258
-
ShaderGlass includes majority of RetroArch repository at time of release, but some shaders had to be excluded because of features SG doesn't yet support (for example HDR).<br/>
279
+
ShaderGlass includes majority of RetroArch repository at time of release, but some shaders had to be excluded because of features SG doesn't yet support.
280
+
Differences versus upstream RetroArch shader repository are tracked <ahref="https://github.com/mausimus/slang-shaders/pull/1">in this PR</a>.
259
281
</p>
260
-
<h3id="-shaderglass-cant-capture-some-windows">> ShaderGlass can't capture some windows</h3>
282
+
<h3id="-shaderglass-cant-capture-some-windows"style="page-break-before: always;">> ShaderGlass can't capture some windows</h3>
261
283
<p>Unfortunately some old-style rendering windows are not supported by modern Windows Capture API. Please use Desktop mode to capture those.</p>
This is the case when a Windows-native game sets a custom cursor shape; ShaderGlass cannot override such cursors so they will remain visible. There are two possible workarounds:
287
+
<ul>
288
+
<li>
289
+
Use Window Clone mode - if you have another display, run your game in a window on that display and ShaderGlass on another display.
290
+
<ol>
291
+
<li>
292
+
Use Input -> Window with Capture Cursor enabled, and move mouse over to the game window, while watching the result in ShaderGlass window.
293
+
294
+
</li>
295
+
</ol>
296
+
<li>
297
+
Use a Virtual Display - install an open-source virtual monitor driver and run the game on there; then in ShaderGlass use Display Clone mode to see the game with mouse cursor properly captured:
298
+
<ol>
299
+
<li>Download and install <ahref="https://github.com/VirtualDrivers/Virtual-Display-Driver">Virtual Display Driver</a></li>
300
+
<li>Configure the virtual display to the same resolution and refresh rate as your main display using Windows Display Settings</li>
301
+
<li>Start up your game in borderless fullscreen and use Win+Shift+Arrow keys to position it on the virtual display</li>
302
+
<li>Set Input -> Desktop to the virtual display in ShaderGlass</li>
303
+
<li>Set Output -> Mode -> Clone in ShaderGlass</li>
304
+
<li>Make sure Capture Cursor is ticked</li>
305
+
<li>Go to Fullscreen in ShaderGlass (Ctrl+Shift+G)</li>
306
+
<li>Move mouse over to the virtual display and play the game</li>
307
+
</ol>
308
+
Virtual Display Driver can also be used to capture popup windows like menus or notifications that normally ShaderGlass cannot get in front of.
309
+
</li>
310
+
</ul>
311
+
</p>
312
+
<h3id="-mouse-cursor">> A different issue...</h3>
313
+
<p>
314
+
Check <ahref="https://github.com/mausimus/ShaderGlass/issues?q=is%3Aissue">Issues section on GitHub</a> for known problems and workarounds.
0 commit comments