ntk 3.8.0 → 3.9.0

package/lib/window.js

@@ -1099,6 +1099,39 @@ export default class Window extends Drawable {
     });
   }
 
+  /**
+   * Write a property — the counterpart of getProperty, and the general form
+   * of setTitle/setClass/setSizeHints. Strings are written as UTF8_STRING,
+   * arrays of numbers as 32-bit lists; `type` names the property type atom
+   * ('ATOM', 'CARDINAL', 'WINDOW', 'UTF8_STRING', 'STRING'), which is what
+   * EWMH properties are picky about.
+   *
+   *   wnd.setProperty('_NET_WM_NAME', 'a title');
+   *   wnd.setProperty('_NET_CLIENT_LIST', ids, { type: 'WINDOW' });
+   *
+   * @param {string} name atom name of the property
+   * @param {string|number[]|Buffer} value
+   * @param {object} [options] `{ type, format }`
+   */
+  async setProperty(name, value, options = {}) {
+    const isList = Array.isArray(value);
+    const { type = isList ? 'CARDINAL' : 'UTF8_STRING', format = isList ? 32 : 8 } =
+      options;
+    const [property, typeAtom] = await Promise.all([this.atom(name), this.atom(type)]);
+    let data = value;
+    if (isList) {
+      const words = new Uint32Array(value);
+      data = Buffer.from(words.buffer, words.byteOffset, words.byteLength);
+    } else if (typeof value === 'string') {
+      data = Buffer.from(value, type === 'STRING' ? 'latin1' : 'utf8');
+    }
+    if (this._destroyed) return this;
+    safeRelease(this.X, () => {
+      this.X.ChangeProperty(0, this.id, property, typeAtom, format, data);
+    });
+    return this;
+  }
+
   /**
    * Intern an atom by name. node-x11 caches them per connection, so asking
    * again for one already interned costs no round trip.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ntk",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "description": "Desktop UI toolkit for X11 with canvas-like 2d and OpenGL rendering",
   "author": "Andrey Sidorov <sidorares@yandex.ru>",
   "license": "MIT",