Css3-Verläufe als Grafik exportieren

Der Export von Verläufen aus Grafiken in Css3 ist dank Tools wie dem Ultimate CSS Gradient Generator ein Kinderspiel. Manchmal besteht jedoch die Notwendigkeit, diesen Prozess umzukehren und einen Css3-Verlauf in eine Grafik umzuwandeln. Bislang kannte ich nur zwei Möglichkeiten, dies zu bewerkstelligen:

  • Einen Screenshot des Verlaufs anfertigen. Diese Methode ist jedoch ungeeignet, wenn der Verlauf Transparenzen enthält.
  • Den Verlauf in Photoshop/ dem Grafikprogramm der Wahl nachbauen. Bei Verläufen mit vielen color stops und Transparenzen ist das allerdings ein Heidenaufwand und auch ziemlich langweilig monoton

Darum habe ich mich etwas schlau gemacht und eine unglaublich einfache Methode gefunden, bei der die Art des Verlaufs (viele color stops, Transparenzen) keine Rolle spielt und die außerdem noch sehr schnell geht.

tl;dr

In Kurzform: Mit dem PhantomJS-Task rasterize wird der in einer separaten Datei liegende Verlauf gerendert und der Output als .png-Datei abgespeichert.

PhantomJS unter Mac OS X installieren

PhantomJS bezeichnet sich selbst als headless WebKit scriptable with a JavaScript API. Dahinter steckt eine über das Terminal bedienbare Webkit-Engine ohne GUI, mit der beispielsweise Tasks für Tests oder Screenshots automatisiert werden können.

Die Installation ist schnell erledigt: Gemäß Anleitung PhantomJS and Mac OS X wird ein Zip-Archiv heruntergeladen, entpackt und die ausführbare PhantomJS-Datei in den Ordner /usr/bin/local/ ($PATH) verschoben.
Da PhantomJS für seine Tasks auf JavaScript- oder Coffeescript-Dateien zurückgreift und ich diese nicht in /usr/bin/local/ rumliegen lassen wollte, habe ich einen anderen Ordner als Speicherort gewählt und einen auf /usr/bin/local/ verweisenden Symlink erstellt.

$ sudo ln -s /Pfad/zu/PhantomJS /usr/local/bin/

Eine Website rendern und den Output als .png speichern

Im extrahierten Zip-Archiv befindet sich auch ein examples-Verzeichnis, in dem die Datei rasterize.js liegt. Diese beinhaltet den benötigten PhantomJS-Task, der eine Website rendert und den Output in einem definierbaren Dateiformat speichert (mehr dazu auf der Seite Screen Capture im PhantomJS-Wiki).
Um nun allein den Verlauf abzuspeichern, muss dieser in vanilla Css in einer Beispiel-Html-Datei eingebunden werden. Ich habe mir dazu eine Datei gradient2image.html erstellt, die lediglich folgenden Code beinhaltete:

<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8" />
    <title>gradient2image</title>
    <style>
      html,
      body {
        margin: 0;
        padding: 0;
        width: 100%;
        height: 100%;
        background: -webkit-linear-gradient(top, rgba(0,0,0,0) 0%,rgba(0,0,0,0.5) 45px,rgba(0,0,0,0.75) 60px,rgba(0,0,0,0.85) 75px,rgba(0,0,0,0.95) 90px,rgba(0,0,0,1) 135px,rgba(0,0,0,1) 100%);
       background: linear-gradient(to bottom, rgba(0,0,0,0) 0%,rgba(0,0,0,0.5) 45px,rgba(0,0,0,0.75) 60px,rgba(0,0,0,0.85) 75px,rgba(0,0,0,0.95) 90px,rgba(0,0,0,1) 135px,rgba(0,0,0,1) 100%);
      }
    </style>
  </head>
  <body></body>
</html>

Zu beachten ist dabei, dass PhantomJS eine vollwertige Webkit-Engine mit allen Stärken und Schwächen ist- daher müssen auch vendor prefixes angegeben werden, da es ansonsten vorkommen kann dass der Verlauf nicht angezeigt wird.

Nachdem die Datei angelegt ist, wird der rasterize-Task vom entsprechenden Ordner mit der Option, den Output als .png-Datei zu speichern, ausgeführt.

$ phantomjs rasterize.js /Pfad/zur/gradient2image.html /gewünschter/Output-Pfad/für/rasterize-output.png

Et voilà- da ist er, der Verlauf. Sauber exportiert von Css3 in eine .png-Datei.

color stops in Verläufen an der selben Position bei unterschiedlich hohen Elementen

Das Problem

In einem aktuellen Projekt kann auf Unterseiten einer Website ein Hintergrundverlauf zugeschaltet werden, der von transparent zu schwarz übergeht. Das ist erst einmal kein Problem, immerhin können mittlerweile sowohl kreisförmige als auch lineare Verläufe mit Css umgesetzt werden. Der Ultimate CSS Gradient Generator ist ein wunderbares Tool zur Umsetzung solcher Verläufe. Der benötigte lineare Verlauf sieht so aus:

background: linear-gradient(to bottom, rgba(0,0,0,0) 0%,rgba(0,0,0,0.5) 15%,rgba(0,0,0,0.75) 20%,rgba(0,0,0,0.85) 25%,rgba(0,0,0,0.95) 30%,rgba(0,0,0,1) 45%,rgba(0,0,0,1) 100%);

Der Verlauf wird dadurch einwandfrei gezeichnet- aber es gibt ein Problem: Auf unterschiedlich hohen Seiten sind die color stops zwar prozentual an der selben Position, nicht aber wenn es um die tatsächliche Position in Pixeln vom Beginn der Seite geht. 15% von 1000 Pixel entspricht natürlich einem anderen Wert als 15% von 833 Pixel. Ich habe eine Demo-Seite gebaut, auf der das Problem grafisch aufbereitet gezeigt wird.

Die Lösung(en)

Es gibt mindestens zwei Lösungswege für dieses Problem. Der eine besteht darin, dem Verlauf eine Größe zuzuweisen, während die andere Lösung mit Pixelwerten für die Position der color stops arbeitet.

Die Größe des Hintergrunds begrenzen

Mit der background-size-Eigenschaft kann die Größe eines Hintergrunds angegeben werden. Da ich in meinem Fall die Höhe des Verlaufs auf 650 Pixel begrenzen wollte, habe ich folgendes probiert:

background: linear-gradient(to bottom, rgba(0,0,0,0) 0%,rgba(0,0,0,0.5) 15%,rgba(0,0,0,0.75) 20%,rgba(0,0,0,0.85) 25%,rgba(0,0,0,0.95) 30%,rgba(0,0,0,1) 45%,rgba(0,0,0,1) 100%);
background-size: 100% 650px;

Dadurch wird gewährleistet, dass der Verlauf sich nicht mehr der Seitenhöhe anpasst, sondern exakt 650 Pixel in der Höhe annimmt. Das bringt allerdings ein neues Problem mit sich: Sobald die Seite höher als 650 Pixel ist, fehlt ab dieser Position der Hintergrund. Der Verlauf hört eiskalt auf und bleibt von 651 Pixel bis (beliebig hohe Zahl < 651 Pixel) transparent. Das Hinzufügen einer Hintergrundfarbe mittels background-color funktioniert leider nicht, da diese ansonsten den (semi-)transparenten oberen Teil des Verlaufs überlagert.
Daher schied diese Lösung leider aus und ein anderer Versuch musste unternommen werden, den Verlauf auf die gewünschte Art und Weise zeichnen zu lassen.

Pixelwerte in der Verlaufs-Eigenschaft

Beim Herumexperimentieren mit der Größe des Verlaufs entwickelte sich eine Idee: Wäre es nicht auch möglich, die Position der color stops Pixel zu definieren? Damit sollten die color stops auch bei verschieden hohen Verläufen an der selben Position stehen. Gesagt, getan:

background: linear-gradient(to bottom, rgba(0,0,0,0) 0%,rgba(0,0,0,0.5) 98px,rgba(0,0,0,0.75) 163px,rgba(0,0,0,0.85) 195px,rgba(0,0,0,0.95) 228px,rgba(0,0,0,1) 293px,rgba(0,0,0,1) 100%);

Wie auf der Demo-Seite ersichtlich ist, funktioniert diese Methode ausgezeichnet und löst das Problem.