Skip to content

Repository files navigation

CSP Grayscale Viewer

English | 繁體中文 | 简体中文 | 日本語

CSP Grayscale Viewer demo

CSP Grayscale Viewer is a lightweight grayscale preview helper for Clip Studio Paint and other drawing applications on Windows. It overlays a click-through grayscale preview on top of the target app, so you can quickly check values without changing your artwork.

Why This Approach

  • No DLL injection, no hooks, no memory patching: The app does not inject code into Clip Studio Paint, hook its rendering pipeline, or modify its process memory.
  • Non-invasive by design: CSP keeps rendering normally. The grayscale preview is drawn by a separate overlay window.
  • Lower crash risk for your drawing app: Because the tool runs out-of-process and avoids touching CSP internals, renderer failures should not take CSP down with it.
  • Made for drawing flow: The overlay is click-through, so pen strokes, mouse input, shortcuts, and canvas interaction continue to go to CSP.
  • Live preview while drawing: The preview updates while you paint, making it useful for checking values during normal work instead of exporting or duplicating layers.
  • Efficient native implementation: Built in C++20 with Win32, Qt, Windows Magnification, and an experimental D3D11 backend.

Features

  • Target-aware overlay: The grayscale preview is only active when a configured target application, such as CLIPStudioPaint.exe, is focused.
  • Global hotkey: Toggle grayscale with a customizable shortcut. The default key is F9.
  • Focus-only hotkey mode: Prevents the shortcut from being captured while you are working in other applications.
  • Two renderer backends:
    • Magnification: Stable compatibility mode based on the Windows Magnification API.
    • Experimental Direct3D: GPU-based renderer for smoother preview and future effects.
  • Click-through overlay: Mouse and pen input pass through to the drawing app.
  • Modern Qt tray app: Runs quietly in the system tray with a small settings window.
  • Runtime log page: Inspect focus, hotkey, and renderer diagnostics from inside the app.

How It Works

The app tracks the foreground window and attaches an overlay to your configured target application. In Magnification mode, it uses the Windows Magnification API with a grayscale color matrix. In experimental Direct3D mode, it captures the desktop output, crops the target window area, applies a grayscale pixel shader, and presents the result through a DirectComposition overlay.

Installation

  1. Download the latest installer from Releases.
  2. Run CSP-Grayscale-Viewer_Setup.exe.
  3. Launch CSP Grayscale Viewer and configure your target applications and hotkey.

Usage

  1. Open Clip Studio Paint or another configured drawing app.
  2. Press the configured hotkey, default F9, to toggle grayscale preview.
  3. Open the tray app to adjust refresh rate, target applications, hotkey, startup behavior, and renderer backend.
  4. Use the Log page when diagnosing renderer or focus behavior.

Renderer Notes

Use Magnification mode when you want maximum compatibility. Use Experimental Direct3D mode when you want smoother rendering and are willing to test the newer backend.

The Direct3D backend is still experimental. It is intended as the foundation for future GPU effects such as contrast checks, gamma preview, LUTs, and color vision simulation.

Build

Requirements

  • Windows 10 / 11
  • Visual Studio 2022 with MSVC
  • CMake 3.20 or later
  • Qt 6.9.0 or later
  • Inno Setup 6, only required for installer packaging

Commands

cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_PREFIX_PATH="C:/path/to/Qt/6.9.0/msvc2022_64"
cmake --build build --config Release --parallel

New-Item -ItemType Directory -Force deploy
Copy-Item build/Release/CSP-Grayscale-Viewer.exe deploy/
Copy-Item build/Release/CSP-Grayscale-Viewer_Console.exe deploy/
windeployqt --release --no-translations --no-opengl-sw deploy/CSP-Grayscale-Viewer.exe

License

This project is released under the MIT License.

Qt is used through dynamic linking and is licensed under LGPL. Users may replace the Qt runtime DLLs in the installation directory when needed.

About

Grayscale viewer for ClipStudioPaint or any other apps, support hotkey.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages