Lijnstijl: dikte en streepjes

A line chart draws every series one pixel wide and solid. chls sets the width of the line in pixels, and turns a solid line into a dashed one.

Wat chls regelt

chls takes one group of up to three numbers per series, in the order the series appear in chd, separated by |: chls=<thickness>,<dash_length>,<space_length>. Only the thickness is required.

  • thickness is the width of the line in pixels. A series with no group of its own is drawn one pixel wide.
  • dash_length is the length of each dash, in pixels. Leave it out, or set it to 0, and the line stays solid.
  • space_length is the gap between two dashes, in pixels. Leave it out and the gap matches the dash length, so chls=2,8 draws eight pixel dashes separated by eight pixel gaps.

De syntaxis is die van Google Image Charts, dus een chls-waarde die uit een oude chart.googleapis.com-URL is gekopieerd, levert hier dezelfde lijn op.

Lijndikte

Eén getal per reeks bepaalt de dikte en laat de lijn doorlopend. Hieronder chls=1|4|8 tekent de drie reeksen op één, vier en acht pixels.

https://image-charts.com/chart?cht=lc&chd=a:10,14,12,18,22,20%7C30,34,32,38,42,40%7C50,54,52,58,62,60&chco=1F3B99,00A550,E8622A&chls=1%7C4%7C8&chs=700x280&chxt=x,y&chdl=chls%3D1%7Cchls%3D4%7Cchls%3D8&chdlp=b&chtt=Line+thickness

Lijngrafiek met drie reeksen, getekend op één, vier en acht pixels dik
De legenda onder de grafiek noemt de chls waarde die voor elke reeks is gebruikt.

Gestreepte lijnen

Het tweede getal maakt van de lijn een gestreepte lijn, en het derde bepaalt de tussenruimte. chls=2,6,3 is een lijn van twee pixels, getekend als streepjes van zes pixels met tussenruimtes van drie pixels.

https://image-charts.com/chart?cht=lc&chd=a:10,14,12,18,22,20%7C30,34,32,38,42,40%7C50,54,52,58,62,60&chco=1F3B99,00A550,E8622A&chls=2%7C2,6,3%7C2,14,6&chs=700x280&chxt=x,y&chdl=solid%7C6+and+3%7C14+and+6&chdlp=b&chtt=Dash+patterns

Lijngrafiek die een doorlopende lijn vergelijkt met twee streeppatronen van verschillende lengte
Alle drie de reeksen zijn twee pixels dik. Alleen de streep- en tussenruimtelengtes verschillen, dus het patroon onderscheidt ze in plaats van de dikte.

Streepjes zijn de gebruikelijke manier om een reeks te markeren die de lezer anders moet lezen, een prognose of een drempel in plaats van een meting. De gestreepte reeks even dik houden als de doorlopende houdt hem leesbaar zonder dat hij schreeuwt.

Welke grafiektypen chls lezen

De drie typen lijngrafieken accepteren allemaal chls, en ze verschillen in wat ze rond de lijn tekenen.

Typen lijngrafieken en hun standaardassen
cht-waardeWat het tekent
lcEen lijngrafiek met punten die gelijkmatig over de x-as verdeeld zijn. Aslijnen worden standaard getekend.
lsDezelfde grafiek zonder aslijnen, en dat is precies wat een sparkline is. Handig wanneer de grafiek inline in een tabel of een e-mail staat.
lxyEen lijngrafiek waarbij u beide coördinaten van elk punt opgeeft in plaats van alleen de y-waarden, als afwisselende x- en y-reeksen.

Het toevoegen van :nda aan een daarvan, zoals in cht=lc:nda, verbergt de aslijnen, zelfs wanneer chxt erom vroeg.

https://image-charts.com/chart?cht=lxy&chd=a:5,20,40,70,90%7C10,35,25,60,50&chls=3&chco=1F3B99&chs=700x260&chxt=x,y&chtt=cht%3Dlxy

Een lxy-lijngrafiek met x- en y-coördinaten per punt, getekend met een dikte van drie pixels
Een lxy grafiek leest de coördinaten als paren van reeksen, eerst x, dan y. chls geldt daarvoor precies zoals voor lc.

Kleur, markeringen en de curve

chls regelt de dikte en de streepjes en verder niets. Lijnkleuren komen van chco, en de vormen die bij elk datapunt worden getekend komen van chm.

De curve is niet instelbaar. Image-Charts past bij elk datapunt op elke lijngrafiek dezelfde lichte afronding toe, en geen enkele queryparameter verandert daar iets aan, dus een verzoek om perfect rechte segmenten of om een sterk afgevlakte spline valt niet in de URL uit te drukken. De referentiedocumentatie somt elke parameter op die de API accepteert.

Een lijngrafiek opmaken

Een grafiek bouwen