Dokumentation
IPS_GetIcons
array IPS_GetIcons ()
Rückgabewert
Ein Array mit den Icons, gruppiert nach Skin. Der Aufbau ist in der Beschreibung aufgeführt.
Beschreibung
Diese Funktion ist nur für den internen Gebrauch vorgesehen und kann sich jederzeit ohne Ankündigung ändern oder entfallen.
Die Funktion liefert alle verfügbaren Icons in einem Aufruf. Die Schlüssel des Arrays sind die Namen der Skins, die Werte jeweils ein Array, welches den Namen jedes Icons auf den Base64-kodierten Dateiinhalt abbildet.
| Schlüssel | Inhalt |
|---|---|
| "" (leer) | Die Icons von Symcon als Base64-kodierte SVG-Dateien. Die Unter-Icons adaptiver Icons (Name mit "-") sind nicht enthalten |
| Name des Skin | Die Icons des installierten Skins als Base64-kodierte PNG-Dateien |
Die Funktion ist für den Abruf über die JSON-RPC Schnittstelle vorgesehen, z.B. für die Anzeige in der Konsole. In PHP-Skripten steht sie nicht zur Verfügung.
Fehlt die Kern Instanz "Skin Control" oder "Util Control", schlägt die Funktion mit "Cannot find skin control" bzw. "Cannot find util control" fehl. Können die Icons eines Skins nicht gelesen werden, schlägt sie mit "Cannot load Icons for Skin ...: ..." fehl.
Beispiel
// Anzahl der Icons je Skin über die JSON-RPC Schnittstelle anzeigen
$rpc = new JSONRPC("http://user:password@127.0.0.1:3777/api/");
foreach ($rpc->IPS_GetIcons() as $skin => $icons) {
printf("%s: %d Icons\n", $skin == '' ? 'Symcon' : $skin, count($icons));
}
/* liefert z.B.:
Symcon: 165 Icons
*/