NodeJS wrappers around Windows p-invoke/dll functions in user32, gdi32, etc. (based on node-ffi-napi)
npm install windows-ffiNodeJS wrappers around Windows p-invoke/dll functions in user32, gdi32, etc. (based on node-ffi-napi)
* 1\) Install ffi-napi in your project: npm i ffi-napi
* 1.1\) You may need to install the windows-build-tools first for ffi-napi to be able to build: npm install --global --production windows-build-tools
* 2\) Install: npm i windows-ffi
* 2.1\) If you're using windows-ffi in symlinked mode, supply the parent project's copy of the node-ffi libraries using the init code below:
``
// Make sure the code below runs before windows-ffi is imported! (example approach: https://stackoverflow.com/a/42817956)
import ffi from "ffi-napi";
import ref from "ref-napi";
import refStructDI from "ref-struct-di";
import {SupplyConfig} from "windows-ffi/Dist/@UserSupplied/PreImportConfig.js";
SupplyConfig({ffi, ref, refStructDI});
`
While this library is meant to gradually expand to cover more of the Windows API, it will never be 100%, because it's a "develop as you need it" sort of endeavor.
Some of the most common and/or noteworthy functionalities are shown below.
`typescript
import {VRect, CaptureScreenshot, GetForegroundWindowHandle} from "windows-ffi";
// First capture a screenshot of a section of the screen.
const screenshot = CaptureScreenshot({
windowHandle: GetForegroundWindowHandle(), // comment to screenshot all windows
rectToCapture: new VRect(0, 0, 800, 600),
});
// The image-data is now stored in the screenshot.buffer Buffer object.screenshot
// Access it directly (and cheaply) using the helper functions on .Pixel color at [${x}, 0] is:
for (let x = 0; x < 800; x++) {
console.log(, screenshot.GetPixel(x, 0).ToHex_RGB());`
}
Performance:
* Full-screen (2560x1440), all windows (ie. "desktop" window): ~80ms
* Full-screen (2560x1440), single window: ~20ms
* Region (700x200), all windows (ie. "desktop" window): ~50ms
* Region (700x200), single window: ~4ms
General:
* Create an accompanying library for Windows-specific functionalities that do not require the ffi-napi` dependency. (I've had pains with ffi-related building during NodeJS updates, so things that can be done without that dependency is beneficial to bundle separately)