Plug-ins
Ein Plug-in ist ein eigenständiges Programm, das mit Input.Observer zusammenarbeitet. Die meisten zeichnen etwas: Das Plug-in Styles, das mit Input.Observer geliefert wird, zeichnet die animierten Spurstile und die gestalteten Hinweise und Meldungen. Andere können Funktionen hinzufügen, die Skripte aufrufen, oder Aktionen ausführen, die in einer anderen Sprache geschrieben sind. Input.Observer startet, überwacht und beendet jedes Plug-in selbst; Sie starten nie ein Plug-in von Hand.
Diese Seite behandelt die Verwaltung von Plug-ins. Das Schreiben eines Plug-ins ist in der separaten Dokumentation für Plug-in-Entwickler beschrieben.
Modus „Erweitert“. Die Seite Plug-ins steht im Abschnitt Engine der Navigation, der im Modus „Einfach“ ausgeblendet ist. Plug-ins laufen im Modus „Einfach“ weiter, und die Seite Darstellung zeigt und steuert die Stile des Renderers in beiden Modi.
Änderungen auf dieser Seite wirken sofort. Sie gehören nicht zu den nicht gespeicherten Änderungen Ihrer Konfiguration: Anwenden ist nicht nötig, und Verwerfen macht sie nicht rückgängig. Plug-ins werden nie exportiert oder importiert.
Die Seite „Plug-ins“
| Name | Pfad | Fähigkeiten | Status | Aktionen |
|---|---|---|---|---|
| Input.Observer.Styles | C:\Program Files\Input.Observer\Input.Observer.Styles.exe | Stile | Funktionsfähig | Deaktivieren |
| Beispiel-Plug-in | D:\Tools\SamplePlugin.exe | Skriptfunktionen | Nicht verwendet | Als Renderer verwenden |
Die Seite listet jedes registrierte Plug-in auf ②, mit einem Suchfeld und einem Statusfilter (Alle Status, Funktionsfähig, Erfordert Aufmerksamkeit, Deaktiviert) über der Liste. Die Titelzeile zählt die registrierten und die funktionsfähigen Plug-ins.
| Spalte | Was sie zeigt |
|---|---|
| Name | Den Namen des Plug-ins. Die Zeile des Renderers trägt das Kennzeichen Renderer. Die Kopierschaltfläche kopiert den Namen genau, so wie ihn der Aufruf PluginSendMessage eines Skripts braucht. |
| Pfad | Die Programmdatei des Plug-ins. Die Schaltfläche am Ende öffnet den Datei-Explorer mit der ausgewählten Datei. |
| Fähigkeiten | Was das Plug-in bietet: Gestenspur, Hinweis, Bildschirmmeldung, Stile, Skriptbefehle, Skriptfunktionen, Skript-Engine, Einstellungen, Einstellungen hier. Ein Plug-in, das nicht läuft, zeigt, was es beim letzten Lauf angeboten hat. |
| Status | Siehe die Tabelle unten. |
| Aktionen | Die Schaltflächen, die gerade für dieses Plug-in gelten (siehe unten). |
| Status | Bedeutung |
|---|---|
| Funktionsfähig | Läuft und antwortet. |
| Wird gestartet… | Wird gestartet. Die Seite prüft jede Sekunde erneut, bis sich der Zustand einpendelt. |
| Nicht verwendet | Ein zeichnendes Plug-in, das nicht der Renderer ist, oder der Renderer, solange nichts auf ihn eingestellt ist. Es läuft nicht und belegt keinen Speicher (siehe „Nicht verwendet“ unten). |
| Reagiert nicht | Läuft, hat aber seit 10 Sekunden nicht geantwortet. Input.Observer startet es neu. |
| Deaktiviert | Mit Deaktivieren ausgeschaltet. |
| Automatisch deaktiviert -- Start fehlgeschlagen | Der Start ist mehrmals hintereinander fehlgeschlagen. Input.Observer hat aufgehört, es zu versuchen (siehe „Wenn ein Plug-in ausfällt“ unten). |
| Vom Plug-in geschlossen | Das Plug-in hat sich absichtlich selbst geschlossen. Es bleibt geschlossen, bis Sie Wiederholen wählen, es deaktivieren und wieder aktivieren oder Input.Observer neu starten. |
Die Schaltflächen unter Aktionen:
| Schaltfläche | Erscheint, wenn | Was sie tut |
|---|---|---|
| Als Renderer verwenden | Ein zeichnendes Plug-in eingeschaltet und nicht der Renderer ist | Macht es zum Renderer (siehe unten). |
| Einstellungen (Zahnrad) | Das Plug-in Einstellungen hat und läuft oder nicht verwendet wird | Öffnet seine Einstellungen (siehe unten). |
| Vorschau / Vorschau beenden | Das Plug-in eine Spur, einen Hinweis oder Meldungen zeichnet | Zeigt, was es zeichnet (siehe unten). |
| Wiederholen | Automatisch deaktiviert oder vom Plug-in geschlossen | Startet es erneut und setzt den Fehlerzähler zurück. |
| Rückrufe erlauben / Rückrufe blockieren | Das Plug-in Skriptfunktionen oder eine Skript-Engine bereitstellt | Siehe „Rückrufe“ unten. |
| Aktivieren / Deaktivieren | Immer | Startet oder beendet das Plug-in und lässt es registriert. |
| Entfernen | Immer | Beendet das Plug-in und vergisst es. Das Programm selbst wird nicht gelöscht. |
Deaktivieren und Entfernen fragen zuerst nach, wenn Skripte in Ihrer Konfiguration das Plug-in brauchen – Skripte, die in seiner Skript-Engine laufen oder seine Funktionen aufrufen –, und listen sie auf. Diese Skripte funktionieren nicht, solange das Plug-in fehlt.
Ein Plug-in hinzufügen
- Wählen Sie Plug-in hinzufügen… ①, und wählen Sie das Programm des Plug-ins (
.exe). - Input.Observer startet das Programm einmal, um nach seinem Namen zu fragen, startet es dann erneut und prüft, ob es sich verbindet und antwortet. Das dauert einige Sekunden.
- Besteht es die Prüfung, wird das Plug-in oben in der Liste hinzugefügt und läuft weiter. Zeichnet es Spuren, Hinweise oder Meldungen, wird es außerdem der Renderer, und ein Hinweis „Renderer gewechselt“ sagt das.
Besteht das Plug-in die Prüfung nicht, erklärt „Plug-in konnte nicht hinzugefügt werden“, warum: Die Datei ist nicht vorhanden, das Programm hat nicht oder falsch geantwortet (es ist vielleicht kein Input.Observer-Plug-in), es hat zu lange gedauert, sein Name wird bereits von einem anderen registrierten Plug-in verwendet, oder seine Skriptfunktionen oder seine Skript-Engine verwenden Namen, die ein anderes Plug-in bereits verwendet. In jedem Fall wird nichts hinzugefügt.
Input.Observer speichert den Pfad des Plug-ins relativ zum eigenen Ordner, wenn das Plug-in darin liegt; ein neben Input.Observer installiertes Plug-in funktioniert also weiter, wenn Input.Observer verschoben wird.
Einem Plug-in vertrauen
- Ein Plug-in hinzuzufügen führt es aus. Schritt 2 startet das Programm sofort, mit Ihren Berechtigungen, und von da an startet Input.Observer es bei jedem eigenen Start. Input.Observer prüft nicht, wer ein Plug-in erstellt hat oder ob es signiert ist. Fügen Sie nur Programme aus Quellen hinzu, denen Sie vertrauen, wie bevor Sie irgendein Programm ausführen.
- Ein Plug-in läuft als eigenes Programm. Es läuft nie innerhalb von Input.Observer, und Input.Observer wartet bei der Verarbeitung Ihrer Maus- und Tastatureingaben nie auf ein Plug-in; ein langsames oder defektes Plug-in kann Ihre Eingaben also nicht verzögern.
- Ein zeichnendes Plug-in erhält Ihre Gestenstriche und den Text von Hinweisen und Meldungen, damit es sie zeichnen kann.
- Ein Plug-in mit Skriptfunktionen erhält die Werte, die Skripte an diese Funktionen übergeben.
Der Renderer
Der Renderer ist das eine Plug-in, das für Input.Observer zeichnet: die Spurstile sowie Hinweise und Meldungen, wenn diese auf der Seite Darstellung auf Passend zum Stil stehen. Es ist immer nur ein Plug-in der Renderer. Eine Standardinstallation registriert das Styles-Plug-in als Renderer.
Um ein anderes zeichnendes Plug-in zum Renderer zu machen, wählen Sie in seiner Zeile Als Renderer verwenden. Die Engine wechselt sofort: Der neue Renderer startet, der vorherige stoppt und zeigt Nicht verwendet, und Spur, Hinweise und Meldungen, die das neue Plug-in zeichnen kann, werden ihm zugewiesen. Ihre Auswahlen auf der Seite Darstellung entscheiden dann, was es zeichnet (Darstellung). Ein Plug-in, das keine Stile anbietet, erscheint in der Galerie als einzelne Kachel unter seinem eigenen Namen; seine eigenen Einstellungen entscheiden, wie es zeichnet.
Wird der Renderer deaktiviert oder entfernt, gibt es keinen Renderer: Die klassische Spur, das klassische Hinweisfenster und das klassische Meldungsfenster von Input.Observer zeichnen, bis Sie einen anderen wählen.
Nicht verwendet
Input.Observer führt kein Plug-in aus, das nichts zu tun hat. Ein zeichnendes Plug-in läuft nur, solange es der Renderer ist und etwas auf der Seite Darstellung auf es eingestellt ist. Ein Plug-in, das Skriptfunktionen oder eine Skript-Engine bereitstellt, läuft immer, solange es aktiviert ist.
Ein nicht verwendetes Plug-in wird kurz gestartet, wenn Sie seine Einstellungen öffnen oder eine Vorschau
ansehen, und kehrt danach zu Nicht verwendet zurück. Das Styles-Plug-in stoppt etwa eine Minute nach
Ihrer letzten Änderung an seinen Einstellungen. Der Aufruf PluginSendMessage eines Skripts an ein
zeichnendes Plug-in, das nicht läuft, schlägt mit einem entsprechenden Fehler fehl; er startet das
Plug-in nicht.
Plug-in-Einstellungen
Das Zahnrad in der Zeile eines Plug-ins öffnet seine Einstellungen:
- Ein mit Einstellungen hier gekennzeichnetes Plug-in zeigt seine Einstellungen in einem Fenster, das das Konfigurationsfenster zeichnet, mit einer Abschnittsliste links. Die des Styles-Plug-ins sind unter Gestenspuren beschrieben.
- Jedes andere Plug-in mit Einstellungen öffnet sein eigenes Einstellungsfenster.
Ein Plug-in, das nicht läuft, wird zuerst gestartet, daher kann das Fenster einige Sekunden zum Füllen brauchen. Änderungen wirken sofort und werden vom Plug-in selbst gespeichert, in seiner eigenen Datei neben Ihrer Konfigurationsdatei; sie warten nicht auf Anwenden, und Verwerfen macht sie nicht rückgängig. Standardwerte wiederherstellen setzt den ausgewählten Abschnitt auf die Standardwerte des Plug-ins zurück. Lässt sich eine Änderung nicht vornehmen, sagt ein Hinweis im Fenster, warum: Das Plug-in ist nicht gestartet oder bietet diese Einstellungen nicht an, hat nicht rechtzeitig geantwortet, hat die Änderung abgelehnt oder sie vorgenommen, aber nicht speichern können.
Vorschau
Vorschau zeigt, was ein zeichnendes Plug-in zeichnen würde, ohne echte Geste: eine Spur, die Ihrem Mauszeiger folgt, einen Beispielhinweis und eine Beispielmeldung. Klicken Sie mit der rechten Maustaste, um das Ende der Spur und einen Neubeginn zu sehen; der Rechtsklick öffnet während der Vorschau nichts.
Während eine Vorschau läuft, sind Gesten überall pausiert, und ein Banner auf der Seite sagt das. Die Vorschau endet, wenn Sie Esc drücken, Vorschau beenden wählen, die Seite Plug-ins verlassen oder das Plug-in stoppt. Eine Vorschau kann nicht starten, während eine Makroaufzeichnung oder ein Gestentraining läuft.
Wenn ein Plug-in ausfällt
Input.Observer prüft jedes laufende Plug-in alle 5 Sekunden.
- Ein Plug-in, das 10 Sekunden lang nicht antwortet (zwei verpasste Prüfungen), zeigt Reagiert nicht und wird neu gestartet.
- Ein Plug-in, das unerwartet beendet wird, wird 10 Sekunden später neu gestartet.
- Ein Plug-in, dessen Start fehlschlägt, wird nach 2, 5 und 10 Sekunden erneut versucht. Nach dem dritten Fehlversuch ist es Automatisch deaktiviert -- Start fehlgeschlagen, und Input.Observer lässt es in Ruhe, auch über Neustarts hinweg, bis Sie Wiederholen wählen. Der Fehlerzähler wird auf null zurückgesetzt, sobald ein Plug-in 5 Minuten lang problemlos gelaufen ist.
- Ein Plug-in, das sich absichtlich selbst schließt, zeigt Vom Plug-in geschlossen und wird erst neu gestartet, wenn Sie Wiederholen wählen, es deaktivieren und wieder aktivieren oder Input.Observer neu starten.
Solange der Renderer ausgefallen ist, zeichnen die klassische Spur, das klassische Hinweisfenster und das klassische Meldungsfenster von Input.Observer an seiner Stelle, und die Seite Darstellung sagt das mit einer Schaltfläche Neu starten. Jedes Mal, wenn das geschieht, wird eine Zeile in den Bereich System der Konsole geschrieben (Konsole).
Beim Start von Input.Observer startet es jedes Plug-in, das etwas zu tun hat, und wartet auf jedes bis zu etwa 5 Sekunden; der Startbildschirm nennt das Plug-in, das gerade geladen wird. Ein Plug-in, das diese Zeit verpasst, wird etwas später übernommen. Beim Beenden von Input.Observer schließt es jedes Plug-in, und ein Plug-in kann nie weiterlaufen, nachdem Input.Observer beendet wurde. Im abgesicherten Modus wird kein Plug-in gestartet (Problembehandlung).
Rückrufe
Ein Plug-in, das Skriptfunktionen oder eine Skript-Engine bereitstellt, kann darum bitten, Input.Observer-Skript auszuführen, während es einen Aufruf bearbeitet. Das ist blockiert, außer Sie wählen in seiner Zeile Rückrufe erlauben und bestätigen. Erlauben Sie es nur für ein Plug-in, dem Sie vertrauen: Seine Anfragen können dann alles tun, was ein Skript hier kann – Tasten drücken, Fenster verschieben und schließen, Programme ausführen –, auch in Fenstern, die als Administrator laufen und die das Plug-in selbst nicht erreichen kann. Rückrufe blockieren entzieht die Berechtigung wieder.