Instabiles Wayland-Modul

Dieses Modul ist ab Version 0.62.0 verfügbar.

Dieses Modul stellt Hilfsfunktionen zum Auffinden von Wayland-Protokoll-XMLs und zur Generierung von .c- und .h-Dateien mithilfe von wayland-scanner bereit.

Hinweis: Dieses Modul ist instabil. Es wird nur als Technologievorschau bereitgestellt. Seine API kann sich zwischen den Versionen beliebig ändern oder es könnte ganz aus Meson entfernt werden.

Schnelle Verwendung

project('hello-wayland', 'c')

wl_dep = dependency('wayland-client')
wl_mod = import('unstable-wayland')

xml = wl_mod.find_protocol('xdg-shell')
xdg_shell = wl_mod.scan_xml(xml)

executable('hw', 'main.c', xdg_shell, dependencies : wl_dep)

Methoden

find_protocol

xml = wl_mod.find_protocol(
  'xdg-decoration',
  state : 'unstable',
  version : 1,
)

Diese Funktion erfordert ein positionelles Argument: den Basisnamen des Protokolls.

Es nimmt die folgenden Schlüsselwortargumente entgegen:

  • state Optionales Argument, das den aktuellen Status des Protokolls angibt. Entweder 'stable', 'staging oder 'unstable'. Der Standardwert ist 'stable'.
  • version Die abwärtskompatible Versionsnummer als ganze Zahl. Erforderlich für Staging und Instabil, aber nicht erlaubt für Stabil.

Gibt zurück: eine Datei, die an scan_xml übergeben werden kann.

scan_xml

generated = wl_mod.scan_xml(
  'my-protocol.xml',
  client : true,
  server : true,
  public : false,
  include_core_only : true,
)

Diese Funktion akzeptiert ein oder mehrere Argumente vom Typ String oder Datei.

Es nimmt die folgenden Schlüsselwortargumente entgegen:

  • public Optionales Argument, das den Geltungsbereich des generierten Codes angibt. Der Standardwert ist false.
  • client Optionales Argument, das angibt, ob eine Client-seitige Header-Datei generiert wird. Der Standardwert ist true.
  • server Optionales Argument, das angibt, ob eine Server-seitige Header-Datei generiert wird. Der Standardwert ist false.
  • include_core_only Optionales Argument, das angibt, dass die generierten Header nur wayland-<client|server>-core.h anstelle von wayland-<client|server>.h enthalten. Der Standardwert ist true. Seit 0.64.0.

Gibt zurück: eine Liste von custom_tgt in der Reihenfolge Quelle, Client-seitiger Header, Server-seitiger Header. Generierte Header-Dateien haben den Namen <name>-<client|server>-protocol.h.

Die Ergebnisse der Suche sind