API/v2/colors

Aus Guild Wars 2 Wiki
< API‎ | v2
Wechseln zu: Navigation, Suche
/v2/colors
HTTP-Methode
GET
Format
JSON
API-Version
Version 2


Gibt Informationen über die im Spiel implementierten Farben zurück. Die Umrechnung der HSL-Farbcodes nach RGB hat ArenaNet-Programmierer Cliff Spradlin anhand eines Beispiels gezeigt.

Parameter[Bearbeiten]

Antwort[Bearbeiten]

Wenn der Endpunkt ohne Parameter abgefragt wird (/v2/colors), wird eine Liste aller verfügbaren Farben-IDs zurückgegeben. Wenn mehrere Farben mit dem Parameter ids angefordert werden, wird ein Array mit mehreren Objekten entsprechend der Anfrage zurückgegeben. Für jede Farbe wird ein Objekt zurückgegeben, welches folgende Eigenschaften besitzt:

  • id (number) – die ID der Farbe
  • name (string) – der Name der Farbe
  • base_rgb (list) – die RGB-Basiswerte
  • cloth (object) – Detailinformationen über das Aussehen auf Rüstungsteilen aus Stoff
  • leather (object) – Detailinformationen über das Aussehen auf Rüstungsteilen aus Leder
  • metal (object) – Detailinformationen über das Aussehen auf Rüstungsteilen aus Metall

Die Objekte mit den Detailinformationen besitzen folgende Eigenschaften:

  • brightness (number) – Helligkeit
  • contrast (number) – Kontrast
  • hue (number) – der Farbton im HSL-Farbraum
  • saturation (number) – die Farbsättigung im HSL-Farbraum
  • lightness (number) – die Helligkeit im HSL-Farbraum
  • rgb (array) – ein Array mit vorberechneten Werten im RGB-Farbraum

Beispiel[Bearbeiten]

https://api.guildwars2.com/v2/colors/126?lang=de

{
    "id": 126,
    "name": "Echt scharfes Pink",
    "base_rgb": [128, 26, 26],
    "cloth": {
        "brightness": 14,
        "contrast": 1.21094,
        "hue": 340,
        "saturation": 0.820313,
        "lightness": 1.44531,
        "rgb":[169, 54, 94]
    },
    "leather": {
        "brightness": 14,
        "contrast": 1.21094,
        "hue": 340,
        "saturation": 0.703125,
        "lightness": 1.44531,
        "rgb": [160, 62, 96]
    },
    "metal": {
        "brightness": 14,
        "contrast": 1.21094,
        "hue": 340,
        "saturation": 0.585938,
        "lightness": 1.44531,
        "rgb": [151, 69, 98]
    }
}