API/v1/colors

/v1/colors.json

HTTP-Methode

GET

Format

JSON

API-Version

Version 1

Gibt eine Liste der im Spiel implementierten Farben und Details zurück. Die Umrechnung der HSL-Farbcodes nach RGB hat ArenaNet-Programmierer Cliff Spradlin anhand eines Beispiels gezeigt.

Parameter

Optionale Parameter

• lang – Sprachenkürzel: de, en, es, fr (Standard: en)

Antwort

Die Antwort besteht aus einem Objekt, welches ein weiteres colors enthält, in welchem weitere Objekte nach der color_id zugeordnet sind, und die folgende Eigenschaften besitzen:

• 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

https://api.guildwars2.com/v1/colors.json?lang=de

{
  "colors": {
    "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 ]
      }
    },
    ...
  }
}