Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/image-charts/javascript
⚡️Official Image-charts JavaScript/NodeJS library
https://github.com/image-charts/javascript
api chart chart-image chart-library charts image javascript-charting javascript-charts
Last synced: 3 months ago
JSON representation
⚡️Official Image-charts JavaScript/NodeJS library
- Host: GitHub
- URL: https://github.com/image-charts/javascript
- Owner: image-charts
- Created: 2020-05-09T14:22:48.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2023-12-16T09:24:07.000Z (about 1 year ago)
- Last Synced: 2024-09-19T02:53:53.319Z (5 months ago)
- Topics: api, chart, chart-image, chart-library, charts, image, javascript-charting, javascript-charts
- Language: JavaScript
- Homepage: https://www.image-charts.com/
- Size: 347 KB
- Stars: 46
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- my-awesome-list - javascript - charts JavaScript/NodeJS library | image-charts | 46 | (JavaScript)
README
[](#getting-started)
[](https://www.npmjs.org/package/image-charts)
Official [Image Charts](https://image-charts.com/) API client.
Generate URLs of static image charts.
Embed them everywhere in emails, pdf reports, chat bots...!
### Getting started
#### 1. Install Image-Charts [npm](https://www.npmjs.com/package/image-charts) Package
```bash
npm install image-charts --save
```
#### 2. Import Image-Charts library
> CommonJS
```javascript
const ImageCharts = require('image-charts');
```
> ES6
```javascript
import ImageCharts from 'image-charts';
```
#### 3. Generate a chart image
```js
const pie = ImageCharts().cht('p').chd('a:2.5,5,8.3').chs('100x100');
pie.toURL(); // String: https://image-charts.com/chart?chd=a%3A2.5%2C5%2C8.3&chs=600x300&cht=p
pie.toFile('/path/to/chart.png'); // Promise<()>
pie.toDataURI(); // Promise : data:image/png;base64,iVBORw0KGgo...
pie.toBuffer(); // Promise : Buffer 89 50 4e 47 0d 0a 1a 0a 00 00 00 ...
```
-----------------------------------------------------------------------
### Table of Contents
- __[Enterprise support](#enterprise-support)__
- __[On-Premise support](#on-premise-support)__
- __[Constructor](#constructor)__
- __[Options](#options)__
- __[Methods](#methods)__
- __[toURL()](#tourl)__
- __[toFile()](#tofile)__
- __[toBuffer()](#tobuffer)__
- __[toDataURI()](#todatauri)__
- __[cht(value) - Chart type](#cht)__
- __[chd(value) - chart data](#chd)__
- __[chds(value) - data format with custom scaling](#chds)__
- __[choe(value) - QRCode data encoding](#choe)__
- __[chld(value) - QRCode error correction level and optional margin](#chld)__
- __[chxr(value) - Axis data-range](#chxr)__
- __[chof(value) - Image output format](#chof)__
- __[chs(value) - Chart size (<width>x<height>)](#chs)__
- __[chdl(value) - Text for each series, to display in the legend](#chdl)__
- __[chdls(value) - Chart legend text and style](#chdls)__
- __[chg(value) - Solid or dotted grid lines](#chg)__
- __[chco(value) - series colors](#chco)__
- __[chtt(value) - chart title](#chtt)__
- __[chts(value) - chart title colors and font size](#chts)__
- __[chxt(value) - Display values on your axis lines or change which axes are shown](#chxt)__
- __[chxl(value) - Custom string axis labels on any axis](#chxl)__
- __[chxs(value) - Font size, color for axis labels, both custom labels and default label values](#chxs)__
- __[chm(value) - compound charts and line fills](#chm)__
- __[chls(value) - line thickness and solid/dashed style](#chls)__
- __[chl(value) - bar, pie slice, doughnut slice and polar slice chart labels](#chl)__
- __[chlps(value) - Position and style of labels on data](#chlps)__
- __[chma(value) - chart margins](#chma)__
- __[chdlp(value) - Position of the legend and order of the legend entries](#chdlp)__
- __[chf(value) - Background Fills](#chf)__
- __[chbr(value) - Bar corner radius. Display bars with rounded corner.](#chbr)__
- __[chan(value) - gif configuration](#chan)__
- __[chli(value) - doughnut chart inside label](#chli)__
- __[icac(value) - image-charts enterprise `account_id`](#icac)__
- __[ichm(value) - HMAC-SHA256 signature required to activate paid features](#ichm)__
- __[icff(value) - Default font family for all text from Google Fonts. Use same syntax as Google Font CSS API](#icff)__
- __[icfs(value) - Default font style for all text](#icfs)__
- __[iclocale(value) - localization (ISO 639-1)](#iclocale)__
- __[icretina(value) - retina mode](#icretina)__
- __[icqrb(value) - Background color for QR Codes](#icqrb)__
- __[icqrf(value) - Foreground color for QR Codes](#icqrf)__
----------------------------------------------------------------------------------------------
### Constructor
> Create an instance, the argument within [ ] is optional. See [usage](#usage)
```javascript
ImageCharts( [ Object opt ] )
// or
new ImageCharts( [ Object opt ] )
```
#### Options
> Default options are listed below.
```javascript
opt = {
/*
* Request timeout (in millisecond) when calling toBuffer() or toDataURI()
*/
timeout: 5000,
/*
* (Enterprise and Enterprise+ subscription only) SECRET_KEY
*/
secret: null,
/*
* (Enterprise, Enterprise+ and On-Premise subscription only) custom domain
*/
host: 'image-charts.com',
/*
* (On-Premise subscription only) custom protocol
*/
protocol: 'https',
/*
* (On-Premise subscription only) custom port
*/
port: 443,
/*
* (On-Premise subscription only) custom pathname
*/
pathname: '/chart'
}
```
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
### Methods
----------------------------------------------------------------------------------------------
> Get the full Image-Charts API url (signed and encoded if necessary)
##### Usage
```javascript
import ImageCharts from 'image-charts';
const chart_url = ImageCharts()
.cht('bvg') // vertical bar chart
.chs('300x300') // 300px x 300px
.chd('a:60,40') // 2 data points: 60 and 40
.toURL(); // get the generated URL
console.log(chart_url); // https://image-charts.com/chart?cht=bvg&chs=300x300&chd=a%3A60%2C40
```
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `toFile(file)` : `Promise<()>`
> Creates a file containing generated chart image and yield a promise.
> When `file` is a filename, asynchronously writes data to the file, replacing the file if it already exists.
> When `file` is a file descriptor, the behavior is similar to calling fs.write() directly (which is recommended).
##### Usage
```javascript
import ImageCharts from 'image-charts';
const chart_path = '/tmp/chart.png';
ImageCharts()
.cht('bvg') // vertical bar chart
.chs('300x300') // 300px x 300px
.chd('a:60,40') // 2 data points: 60 and 40
.toFile(chart_path)
.then(() => console.log('Image chart written at %s', chart_path))
```
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `toBuffer()` : [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise)<[`Buffer`](https://nodejs.org/api/buffer.html)>
> Do a request to Image-Charts API with current configuration and yield a promise of a NodeJS buffer
##### Usage
```javascript
import ImageCharts from 'image-charts';
const chart_url = ImageCharts()
.cht('bvg') // vertical bar chart
.chs('300x300') // 300px x 300px
.chd('a:60,40') // 2 data points: 60 and 40
.toBuffer(); // download chart image as a buffer
console.log(chart_url); //
#### `toDataURI()` : `String`
> Do a request to Image-Charts API with current configuration and yield a promise of a base64 encoded [data URI](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs)
##### Usage
```javascript
import ImageCharts from 'image-charts';
const chart_url = ImageCharts()
.cht('bvg') // vertical bar chart
.chs('300x300') // 300px x 300px
.chd('a:60,40') // 2 data points: 60 and 40
.toDataURI(); // download chart image and generate a data URI string
console.log(chart_url); // "data:image/png;base64,iVBORw0KGgo...
```
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### Enterprise Support
Image-Charts Enterprise and Enterprise+ subscriptions remove the watermark and enable advanced features like custom-domain, high-resolution charts, custom fonts, multiple axis and mixed charts.
- [Pricing and plan comparison](https://www.image-charts.com/pricing)
- [Enterprise documentation](https://documentation.image-charts.com/enterprise/)
##### Usage
Once subscribed to a plan you will receive an `ACCOUNT_ID` and a `SECRET_KEY`.
These two parameters are mandatory to sign your request and remove the watermark.
Replace both values in the code example below:
```javascript
import ImageCharts from 'image-charts';
const chart_url = ImageCharts({secret: 'SECRET_KEY'})
.icac('ACCOUNT_ID')
.cht('p3') // pie chart
.chs('700x190') // 700px x 190px
.chd('t:60,40') // 2 data points: 60 and 40
.chl('Hello|World') // 1 label per pie slice : "Hello" and "World"
.chf('ps0-0,lg,45,ffeb3b,0.2,f44336,1|ps0-1,lg,45,8bc34a,0.2,009688,1') // 1 gradient per pie slice
.icretina('1') // enable paid-only features like high-resolution charts
.toURL(); // get the whole (HMAC signed) URL
console.log(chart_url);
// https://image-charts.com/chart?chd=t%3A60%2C40&chf=ps0-0%2Clg%2C45%2Cffeb3b%2C0.2%2Cf44336%2C1%7Cps0-1%2Clg%2C45%2C8bc34a%2C0.2%2C009688%2C1&chl=Hello%7CWorld&chs=700x190&cht=p3&icac=documentation&icretina=1&ichm=122242bb700d825d69b3fafe4ec67193b45dcfe0ed93fcca307e0d0a84b73ea2
```
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### On-Premise Support
Image-Charts virtual appliance can be deployed anywhere inside a customer network.
```javascript
import ImageCharts from 'image-charts';
const chart_url = ImageCharts({
secret: 'SECRET_KEY',
// override the host with your own endpoint
host: 'custom-domain.tld'
})
.icac('ACCOUNT_ID')
.cht('p3') // pie chart
.chs('700x190') // 700px x 190px
.chd('t:60,40') // 2 data points: 60 and 40
.chl('Hello|World') // 1 label per pie slice : "Hello" and "World"
.chf('ps0-0,lg,45,ffeb3b,0.2,f44336,1|ps0-1,lg,45,8bc34a,0.2,009688,1') // 1 gradient per pie slice
.icretina('1') // enable paid-only features like high-resolution charts
.toURL(); // get the whole (HMAC signed) URL
console.log(chart_url);
// https://custom-domain.tld/chart?chd=t%3A60%2C40&chf=ps0-0%2Clg%2C45%2Cffeb3b%2C0.2%2Cf44336%2C1%7Cps0-1%2Clg%2C45%2C8bc34a%2C0.2%2C009688%2C1&chl=Hello%7CWorld&chs=700x190&cht=p3&icac=documentation&icretina=1&ichm=122242bb700d825d69b3fafe4ec67193b45dcfe0ed93fcca307e0d0a84b73ea2
```
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `cht( value )` : [`ImageCharts`](#constructor)
> Chart type
> [Reference](https://documentation.image-charts.com/reference/chart-type/)
##### Allowed values:
.cht("bvs")
.cht("bvg")
.cht("bhs")
.cht("bhg")
.cht("bvo")
Other allowed values are:
p | p3 | pc | pd | ls | lc | lxy | ls:nda | lc:nda | lxy:nda | pa | bb | gv | gv:dot | gv:neato | gv:circo | gv:fdp | gv:osage | gv:twopi | qr | r
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chd( value )` : [`ImageCharts`](#constructor)
> chart data
> [Reference](https://documentation.image-charts.com/reference/data-format/)
##### Usage
.chd("a:-100,200.5,75.55,110")
.chd("t:10,20,30|15,25,35")
.chd("s:BTb19_,Mn5tzb")
.chd("e:BaPoqM2s,-A__RMD6")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chds( value )` : [`ImageCharts`](#constructor)
> data format with custom scaling
> [Reference](https://documentation.image-charts.com/reference/data-format/#text-format-with-custom-scaling)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `choe( value )` : [`ImageCharts`](#constructor)
> QRCode data encoding
> [Reference](https://documentation.image-charts.com/qr-codes/#data-encoding)
##### Allowed values:
.choe("UTF-8")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chld( value )` : [`ImageCharts`](#constructor)
> QRCode error correction level and optional margin
> [Reference](https://documentation.image-charts.com/qr-codes/#error-correction-level-and-margin)
##### Usage
.chld("L|4")
.chld("M|10")
.chld("Q|5")
.chld("H|18")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chxr( value )` : [`ImageCharts`](#constructor)
> Axis data-range
> [Reference](https://documentation.image-charts.com/reference/chart-axis/#axis-range)
##### Usage
.chxr("0,0,200")
.chxr("0,10,50,5")
.chxr("0,0,500|1,0,200")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chof( value )` : [`ImageCharts`](#constructor)
> Image output format
> [Reference](https://documentation.image-charts.com/reference/output-format/)
##### Usage
.chof(".png")
.chof(".svg")
.chof(".gif")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chs( value )` : [`ImageCharts`](#constructor)
> Chart size (<width>x<height>)
> [Reference](https://documentation.image-charts.com/reference/chart-size/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chdl( value )` : [`ImageCharts`](#constructor)
> Text for each series, to display in the legend
> [Reference](https://documentation.image-charts.com/reference/legend-text-and-style/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chdls( value )` : [`ImageCharts`](#constructor)
> Chart legend text and style
> [Reference](https://documentation.image-charts.com/reference/legend-text-and-style/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chg( value )` : [`ImageCharts`](#constructor)
> Solid or dotted grid lines
> [Reference](https://documentation.image-charts.com/reference/grid-lines/)
##### Usage
.chg("1,1")
.chg("0,1,1,5")
.chg("1,1,FF00FF")
.chg("1,1,1,1,CECECE")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chco( value )` : [`ImageCharts`](#constructor)
> series colors
> [Reference](https://documentation.image-charts.com/bar-charts/#examples)
##### Usage
.chco("FFC48C")
.chco("FF0000,00FF00,0000FF")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chtt( value )` : [`ImageCharts`](#constructor)
> chart title
> [Reference](https://documentation.image-charts.com/reference/chart-title/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chts( value )` : [`ImageCharts`](#constructor)
> chart title colors and font size
> [Reference](https://documentation.image-charts.com/reference/chart-title/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chxt( value )` : [`ImageCharts`](#constructor)
> Display values on your axis lines or change which axes are shown
> [Reference](https://documentation.image-charts.com/reference/chart-axis/#visible-axes)
##### Usage
.chxt("y")
.chxt("x,y")
.chxt("x,x,y")
.chxt("x,y,t,r,t")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chxl( value )` : [`ImageCharts`](#constructor)
> Custom string axis labels on any axis
> [Reference](https://documentation.image-charts.com/reference/chart-axis/#custom-axis-labels)
##### Usage
.chxl("0:|Jan|July|Jan")
.chxl("0:|Jan|July|Jan|1|10|20|30")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chxs( value )` : [`ImageCharts`](#constructor)
> Font size, color for axis labels, both custom labels and default label values
> [Reference](https://documentation.image-charts.com/reference/chart-axis/#axis-label-styles)
##### Usage
.chxs("1,0000DD")
.chxs("1N*cUSD*Mil,FF0000")
.chxs("1N*cEUR*,FF0000")
.chxs("2,0000DD,13,0,t")
.chxs("0N*p*per-month,0000FF")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chm( value )` : [`ImageCharts`](#constructor)
> compound charts and line fills
> [Reference](https://documentation.image-charts.com/reference/compound-charts/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chls( value )` : [`ImageCharts`](#constructor)
> line thickness and solid/dashed style
> [Reference](https://documentation.image-charts.com/line-charts/#line-styles)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chl( value )` : [`ImageCharts`](#constructor)
> bar, pie slice, doughnut slice and polar slice chart labels
> [Reference](https://documentation.image-charts.com/reference/chart-label/)
##### Usage
.chl("label1|label2")
.chl("multi
line
label1|label2")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chlps( value )` : [`ImageCharts`](#constructor)
> Position and style of labels on data
> [Reference](https://documentation.image-charts.com/reference/chart-label/#positionning-and-formatting)
##### Usage
.chlps("align,top|offset,10|color,FF00FF")
.chlps("align,top|offset,10|color,FF00FF")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chma( value )` : [`ImageCharts`](#constructor)
> chart margins
> [Reference](https://documentation.image-charts.com/reference/chart-margin/)
##### Usage
.chma("30,30,30,30")
.chma("40,20")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chdlp( value )` : [`ImageCharts`](#constructor)
> Position of the legend and order of the legend entries
> [Reference](https://documentation.image-charts.com/reference/legend-text-and-style/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chf( value )` : [`ImageCharts`](#constructor)
> Background Fills
> [Reference](https://documentation.image-charts.com/reference/background-fill/)
##### Usage
.chf("b0,lg,0,f44336,0.3,03a9f4,0.8")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chbr( value )` : [`ImageCharts`](#constructor)
> Bar corner radius. Display bars with rounded corner.
> [Reference](https://documentation.image-charts.com/bar-charts/#rounded-bar)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chan( value )` : [`ImageCharts`](#constructor)
> gif configuration
> [Reference](https://documentation.image-charts.com/reference/animation/)
##### Usage
.chan("1200")
.chan("1300|easeInOutSine")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `chli( value )` : [`ImageCharts`](#constructor)
> doughnut chart inside label
> [Reference](https://documentation.image-charts.com/pie-charts/#inside-label)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `icac( value )` : [`ImageCharts`](#constructor)
> image-charts enterprise `account_id`
> [Reference](https://documentation.image-charts.com/enterprise/)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `ichm( value )` : [`ImageCharts`](#constructor)
> HMAC-SHA256 signature required to activate paid features
> [Reference](https://documentation.image-charts.com/enterprise/)
##### Usage
.ichm("0785cf22a0381c2e0239e27c126de4181f501d117c2c81745611e9db928b0376")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `icff( value )` : [`ImageCharts`](#constructor)
> Default font family for all text from Google Fonts. Use same syntax as Google Font CSS API
> [Reference](https://documentation.image-charts.com/reference/chart-font/)
##### Allowed values:
.icff("ABeeZee")
.icff("Abel")
.icff("Abhaya Libre")
.icff("Abril Fatface")
.icff("Aclonica")
Other allowed values are:
Acme | Actor | Adamina | Advent Pro | Aguafina Script | Akronim | Aladin | Aldrich | Alef | Alegreya | Alegreya SC | Alegreya Sans | Alegreya Sans SC | Aleo | Alex Brush | Alfa Slab One | Alice | Alike | Alike Angular | Allan | Allerta | Allerta Stencil | Allura | Almarai | Almendra | Almendra Display | Almendra SC | Amarante | Amaranth | Amatic SC | Amethysta | Amiko | Amiri | Amita | Anaheim | Andada | Andika | Angkor | Annie Use Your Telescope | Anonymous Pro | Antic | Antic Didone | Antic Slab | Anton | Arapey | Arbutus | Arbutus Slab | Architects Daughter | Archivo | Archivo Black | Archivo Narrow | Aref Ruqaa | Arima Madurai | Arimo | Arizonia | Armata | Arsenal | Artifika | Arvo | Arya | Asap | Asap Condensed | Asar | Asset | Assistant | Astloch | Asul | Athiti | Atma | Atomic Age | Aubrey | Audiowide | Autour One | Average | Average Sans | Averia Gruesa Libre | Averia Libre | Averia Sans Libre | Averia Serif Libre | B612 | B612 Mono | Bad Script | Bahiana | Bahianita | Bai Jamjuree | Baloo | Baloo Bhai | Baloo Bhaijaan | Baloo Bhaina | Baloo Chettan | Baloo Da | Baloo Paaji | Baloo Tamma | Baloo Tammudu | Baloo Thambi | Balthazar | Bangers | Barlow | Barlow Condensed | Barlow Semi Condensed | Barriecito | Barrio | Basic | Battambang | Baumans | Bayon | Be Vietnam | Belgrano | Bellefair | Belleza | BenchNine | Bentham | Berkshire Swash | Beth Ellen | Bevan | Big Shoulders Display | Big Shoulders Text | Bigelow Rules | Bigshot One | Bilbo | Bilbo Swash Caps | BioRhyme | BioRhyme Expanded | Biryani | Bitter | Black And White Picture | Black Han Sans | Black Ops One | Blinker | Bokor | Bonbon | Boogaloo | Bowlby One | Bowlby One SC | Brawler | Bree Serif | Bubblegum Sans | Bubbler One | Buda | Buenard | Bungee | Bungee Hairline | Bungee Inline | Bungee Outline | Bungee Shade | Butcherman | Butterfly Kids | Cabin | Cabin Condensed | Cabin Sketch | Caesar Dressing | Cagliostro | Cairo | Calligraffitti | Cambay | Cambo | Candal | Cantarell | Cantata One | Cantora One | Capriola | Cardo | Carme | Carrois Gothic | Carrois Gothic SC | Carter One | Catamaran | Caudex | Caveat | Caveat Brush | Cedarville Cursive | Ceviche One | Chakra Petch | Changa | Changa One | Chango | Charm | Charmonman | Chathura | Chau Philomene One | Chela One | Chelsea Market | Chenla | Cherry Cream Soda | Cherry Swash | Chewy | Chicle | Chilanka | Chivo | Chonburi | Cinzel | Cinzel Decorative | Clicker Script | Coda | Coda Caption | Codystar | Coiny | Combo | Comfortaa | Coming Soon | Concert One | Condiment | Content | Contrail One | Convergence | Cookie | Copse | Corben | Cormorant | Cormorant Garamond | Cormorant Infant | Cormorant SC | Cormorant Unicase | Cormorant Upright | Courgette | Cousine | Coustard | Covered By Your Grace | Crafty Girls | Creepster | Crete Round | Crimson Pro | Crimson Text | Croissant One | Crushed | Cuprum | Cute Font | Cutive | Cutive Mono | DM Sans | DM Serif Display | DM Serif Text | Damion | Dancing Script | Dangrek | Darker Grotesque | David Libre | Dawning of a New Day | Days One | Dekko | Delius | Delius Swash Caps | Delius Unicase | Della Respira | Denk One | Devonshire | Dhurjati | Didact Gothic | Diplomata | Diplomata SC | Do Hyeon | Dokdo | Domine | Donegal One | Doppio One | Dorsa | Dosis | Dr Sugiyama | Duru Sans | Dynalight | EB Garamond | Eagle Lake | East Sea Dokdo | Eater | Economica | Eczar | El Messiri | Electrolize | Elsie | Elsie Swash Caps | Emblema One | Emilys Candy | Encode Sans | Encode Sans Condensed | Encode Sans Expanded | Encode Sans Semi Condensed | Encode Sans Semi Expanded | Engagement | Englebert | Enriqueta | Erica One | Esteban | Euphoria Script | Ewert | Exo | Exo 2 | Expletus Sans | Fahkwang | Fanwood Text | Farro | Farsan | Fascinate | Fascinate Inline | Faster One | Fasthand | Fauna One | Faustina | Federant | Federo | Felipa | Fenix | Finger Paint | Fira Code | Fira Mono | Fira Sans | Fira Sans Condensed | Fira Sans Extra Condensed | Fjalla One | Fjord One | Flamenco | Flavors | Fondamento | Fontdiner Swanky | Forum | Francois One | Frank Ruhl Libre | Freckle Face | Fredericka the Great | Fredoka One | Freehand | Fresca | Frijole | Fruktur | Fugaz One | GFS Didot | GFS Neohellenic | Gabriela | Gaegu | Gafata | Galada | Galdeano | Galindo | Gamja Flower | Gayathri | Gentium Basic | Gentium Book Basic | Geo | Geostar | Geostar Fill | Germania One | Gidugu | Gilda Display | Give You Glory | Glass Antiqua | Glegoo | Gloria Hallelujah | Goblin One | Gochi Hand | Gorditas | Gothic A1 | Goudy Bookletter 1911 | Graduate | Grand Hotel | Gravitas One | Great Vibes | Grenze | Griffy | Gruppo | Gudea | Gugi | Gurajada | Habibi | Halant | Hammersmith One | Hanalei | Hanalei Fill | Handlee | Hanuman | Happy Monkey | Harmattan | Headland One | Heebo | Henny Penny | Hepta Slab | Herr Von Muellerhoff | Hi Melody | Hind | Hind Guntur | Hind Madurai | Hind Siliguri | Hind Vadodara | Holtwood One SC | Homemade Apple | Homenaje | IBM Plex Mono | IBM Plex Sans | IBM Plex Sans Condensed | IBM Plex Serif | IM Fell DW Pica | IM Fell DW Pica SC | IM Fell Double Pica | IM Fell Double Pica SC | IM Fell English | IM Fell English SC | IM Fell French Canon | IM Fell French Canon SC | IM Fell Great Primer | IM Fell Great Primer SC | Iceberg | Iceland | Imprima | Inconsolata | Inder | Indie Flower | Inika | Inknut Antiqua | Irish Grover | Istok Web | Italiana | Italianno | Itim | Jacques Francois | Jacques Francois Shadow | Jaldi | Jim Nightshade | Jockey One | Jolly Lodger | Jomhuria | Jomolhari | Josefin Sans | Josefin Slab | Joti One | Jua | Judson | Julee | Julius Sans One | Junge | Jura | Just Another Hand | Just Me Again Down Here | K2D | Kadwa | Kalam | Kameron | Kanit | Kantumruy | Karla | Karma | Katibeh | Kaushan Script | Kavivanar | Kavoon | Kdam Thmor | Keania One | Kelly Slab | Kenia | Khand | Khmer | Khula | Kirang Haerang | Kite One | Knewave | KoHo | Kodchasan | Kosugi | Kosugi Maru | Kotta One | Koulen | Kranky | Kreon | Kristi | Krona One | Krub | Kumar One | Kumar One Outline | Kurale | La Belle Aurore | Lacquer | Laila | Lakki Reddy | Lalezar | Lancelot | Lateef | Lato | League Script | Leckerli One | Ledger | Lekton | Lemon | Lemonada | Lexend Deca | Lexend Exa | Lexend Giga | Lexend Mega | Lexend Peta | Lexend Tera | Lexend Zetta | Libre Barcode 128 | Libre Barcode 128 Text | Libre Barcode 39 | Libre Barcode 39 Extended | Libre Barcode 39 Extended Text | Libre Barcode 39 Text | Libre Baskerville | Libre Caslon Display | Libre Caslon Text | Libre Franklin | Life Savers | Lilita One | Lily Script One | Limelight | Linden Hill | Literata | Liu Jian Mao Cao | Livvic | Lobster | Lobster Two | Londrina Outline | Londrina Shadow | Londrina Sketch | Londrina Solid | Long Cang | Lora | Love Ya Like A Sister | Loved by the King | Lovers Quarrel | Luckiest Guy | Lusitana | Lustria | M PLUS 1p | M PLUS Rounded 1c | Ma Shan Zheng | Macondo | Macondo Swash Caps | Mada | Magra | Maiden Orange | Maitree | Major Mono Display | Mako | Mali | Mallanna | Mandali | Manjari | Mansalva | Manuale | Marcellus | Marcellus SC | Marck Script | Margarine | Markazi Text | Marko One | Marmelad | Martel | Martel Sans | Marvel | Mate | Mate SC | Maven Pro | McLaren | Meddon | MedievalSharp | Medula One | Meera Inimai | Megrim | Meie Script | Merienda | Merienda One | Merriweather | Merriweather Sans | Metal | Metal Mania | Metamorphous | Metrophobic | Michroma | Milonga | Miltonian | Miltonian Tattoo | Mina | Miniver | Miriam Libre | Mirza | Miss Fajardose | Mitr | Modak | Modern Antiqua | Mogra | Molengo | Molle | Monda | Monofett | Monoton | Monsieur La Doulaise | Montaga | Montez | Montserrat | Montserrat Alternates | Montserrat Subrayada | Moul | Moulpali | Mountains of Christmas | Mouse Memoirs | Mr Bedfort | Mr Dafoe | Mr De Haviland | Mrs Saint Delafield | Mrs Sheppards | Mukta | Mukta Mahee | Mukta Malar | Mukta Vaani | Muli | Mystery Quest | NTR | Nanum Brush Script | Nanum Gothic | Nanum Gothic Coding | Nanum Myeongjo | Nanum Pen Script | Neucha | Neuton | New Rocker | News Cycle | Niconne | Niramit | Nixie One | Nobile | Nokora | Norican | Nosifer | Notable | Nothing You Could Do | Noticia Text | Noto Sans | Noto Sans HK | Noto Sans JP | Noto Sans KR | Noto Sans SC | Noto Sans TC | Noto Serif | Noto Serif JP | Noto Serif KR | Noto Serif SC | Noto Serif TC | Nova Cut | Nova Flat | Nova Mono | Nova Oval | Nova Round | Nova Script | Nova Slim | Nova Square | Numans | Nunito | Nunito Sans | Odor Mean Chey | Offside | Old Standard TT | Oldenburg | Oleo Script | Oleo Script Swash Caps | Open Sans | Open Sans Condensed | Oranienbaum | Orbitron | Oregano | Orienta | Original Surfer | Oswald | Over the Rainbow | Overlock | Overlock SC | Overpass | Overpass Mono | Ovo | Oxygen | Oxygen Mono | PT Mono | PT Sans | PT Sans Caption | PT Sans Narrow | PT Serif | PT Serif Caption | Pacifico | Padauk | Palanquin | Palanquin Dark | Pangolin | Paprika | Parisienne | Passero One | Passion One | Pathway Gothic One | Patrick Hand | Patrick Hand SC | Pattaya | Patua One | Pavanam | Paytone One | Peddana | Peralta | Permanent Marker | Petit Formal Script | Petrona | Philosopher | Piedra | Pinyon Script | Pirata One | Plaster | Play | Playball | Playfair Display | Playfair Display SC | Podkova | Poiret One | Poller One | Poly | Pompiere | Pontano Sans | Poor Story | Poppins | Port Lligat Sans | Port Lligat Slab | Pragati Narrow | Prata | Preahvihear | Press Start 2P | Pridi | Princess Sofia | Prociono | Prompt | Prosto One | Proza Libre | Puritan | Purple Purse | Quando | Quantico | Quattrocento | Quattrocento Sans | Questrial | Quicksand | Quintessential | Qwigley | Racing Sans One | Radley | Rajdhani | Rakkas | Raleway | Raleway Dots | Ramabhadra | Ramaraja | Rambla | Rammetto One | Ranchers | Rancho | Ranga | Rasa | Rationale | Ravi Prakash | Red Hat Display | Red Hat Text | Redressed | Reem Kufi | Reenie Beanie | Revalia | Rhodium Libre | Ribeye | Ribeye Marrow | Righteous | Risque | Roboto | Roboto Condensed | Roboto Mono | Roboto Slab | Rochester | Rock Salt | Rokkitt | Romanesco | Ropa Sans | Rosario | Rosarivo | Rouge Script | Rozha One | Rubik | Rubik Mono One | Ruda | Rufina | Ruge Boogie | Ruluko | Rum Raisin | Ruslan Display | Russo One | Ruthie | Rye | Sacramento | Sahitya | Sail | Saira | Saira Condensed | Saira Extra Condensed | Saira Semi Condensed | Saira Stencil One | Salsa | Sanchez | Sancreek | Sansita | Sarabun | Sarala | Sarina | Sarpanch | Satisfy | Sawarabi Gothic | Sawarabi Mincho | Scada | Scheherazade | Schoolbell | Scope One | Seaweed Script | Secular One | Sedgwick Ave | Sedgwick Ave Display | Sevillana | Seymour One | Shadows Into Light | Shadows Into Light Two | Shanti | Share | Share Tech | Share Tech Mono | Shojumaru | Short Stack | Shrikhand | Siemreap | Sigmar One | Signika | Signika Negative | Simonetta | Single Day | Sintony | Sirin Stencil | Six Caps | Skranji | Slabo 13px | Slabo 27px | Slackey | Smokum | Smythe | Sniglet | Snippet | Snowburst One | Sofadi One | Sofia | Song Myung | Sonsie One | Sorts Mill Goudy | Source Code Pro | Source Sans Pro | Source Serif Pro | Space Mono | Special Elite | Spectral | Spectral SC | Spicy Rice | Spinnaker | Spirax | Squada One | Sree Krushnadevaraya | Sriracha | Srisakdi | Staatliches | Stalemate | Stalinist One | Stardos Stencil | Stint Ultra Condensed | Stint Ultra Expanded | Stoke | Strait | Stylish | Sue Ellen Francisco | Suez One | Sumana | Sunflower | Sunshiney | Supermercado One | Sura | Suranna | Suravaram | Suwannaphum | Swanky and Moo Moo | Syncopate | Tajawal | Tangerine | Taprom | Tauri | Taviraj | Teko | Telex | Tenali Ramakrishna | Tenor Sans | Text Me One | Thasadith | The Girl Next Door | Tienne | Tillana | Timmana | Tinos | Titan One | Titillium Web | Trade Winds | Trirong | Trocchi | Trochut | Trykker | Tulpen One | Turret Road | Ubuntu | Ubuntu Condensed | Ubuntu Mono | Ultra | Uncial Antiqua | Underdog | Unica One | UnifrakturCook | UnifrakturMaguntia | Unkempt | Unlock | Unna | VT323 | Vampiro One | Varela | Varela Round | Vast Shadow | Vesper Libre | Vibes | Vibur | Vidaloka | Viga | Voces | Volkhov | Vollkorn | Vollkorn SC | Voltaire | Waiting for the Sunrise | Wallpoet | Walter Turncoat | Warnes | Wellfleet | Wendy One | Wire One | Work Sans | Yanone Kaffeesatz | Yantramanav | Yatra One | Yellowtail | Yeon Sung | Yeseva One | Yesteryear | Yrsa | ZCOOL KuaiLe | ZCOOL QingKe HuangYou | ZCOOL XiaoWei | Zeyada | Zhi Mang Xing | Zilla Slab | Zilla Slab Highlight
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `icfs( value )` : [`ImageCharts`](#constructor)
> Default font style for all text
> [Reference](https://documentation.image-charts.com/reference/chart-font/)
##### Allowed values:
.icfs("normal")
.icfs("italic")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `iclocale( value )` : [`ImageCharts`](#constructor)
> localization (ISO 639-1)
##### Allowed values:
.iclocale("fr")
.iclocale("de")
.iclocale("en")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `icretina( value )` : [`ImageCharts`](#constructor)
> retina mode
> [Reference](https://documentation.image-charts.com/reference/retina/)
##### Allowed values:
.icretina("0")
.icretina("1")
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `icqrb( value )` : [`ImageCharts`](#constructor)
> Background color for QR Codes
> [Reference](https://documentation.image-charts.com/qr-codes/#background-color)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
----------------------------------------------------------------------------------------------
#### `icqrf( value )` : [`ImageCharts`](#constructor)
> Foreground color for QR Codes
> [Reference](https://documentation.image-charts.com/qr-codes/#foreground-color)
##### Usage
- _[Back to Getting started](#getting-started)_
- _[Back to ToC](#table-of-contents)_
