text-to-svg
Convert text to SVG path without native dependence.
const TextToSVG = ;const textToSVG = TextToSVG; const attributes = fill: 'red' stroke: 'black';const options = x: 0 y: 0 fontSize: 72 anchor: 'top' attributes: attributes; const svg = textToSVG; console;
Installation
$ npm install --save text-to-svg
Constructor
An example for loading default font synchronously. The default font is IPA font. ** This method only works on Node.js. **
const textToSVG = TextToSVG;const svg = textToSVG;console;
An example for loading font synchronously. ** This method only works on Node.js. **
// Argument is file path (NOT URL)const textToSVG = TextToSVG;const svg = textToSVG;console;
An example for loading font asynchronously.
// First argument is URL on web browsers, but it is file path on Node.js.TextToSVG;
API
TextToSVG.getD(text, options = {})
Get the path data for d
attribute of path
.
text
: Text to convert to SVG path.
Options is an optional object containing:
x
: Horizontal position of the beginning of the text. (default:0
)y
: Vertical position of the baseline of the text. (default:0
)fontSize
: Size of the text (default:72
).kerning
: iftrue
takes kerning information into account (default:true
)letterSpacing
: letter-spacing value inem
.tracking
: tracking value. (em / 1000)anchor
: Anchor of object in coordinate. (default:'left baseline'
)- (
left
,center
,right
) + (baseline
,top
,middle
,bottom
)
- (
Return value example
M5.27-54.07L10.62-54.07L10.62-34.00Q15.86-39.23 21.02-39.23Q26.89-39.23 29.60-34.07Q31.11-31.15 31.11-27L31.11-3.66L25.77-3.66L25.77-25.42Q25.77-34.14 20.18-34.14Q16.42-34.14 13.57-31.39Q10.62-28.44 10.62-24.64L10.62-3.66L5.27-3.66L5.27-54.07ZM67.68-14.27Q64.55-2.25 54.07-2.25Q47.57-2.25 43.77-7.66Q40.32-12.62 40.32-20.74Q40.32-28.51 43.56-33.47Q47.36-39.23 54-39.23Q66.97-39.23 67.82-19.65L45.74-19.65Q46.16-7.07 54.14-7.07Q60.47-7.07 62.05-14.27L67.68-14.27M62.05-24.26Q60.89-34.42 54-34.42Q47.36-34.42 45.95-24.26L62.05-24.26ZM92.81-11.53Q92.81-8.44 95.77-8.44Q98.19-8.44 101.07-9L101.07-3.62Q96.82-3.02 94.82-3.02Q87.19-3.02 87.19-10.51L87.19-54.07L92.81-54.07L92.81-11.53ZM128.81-11.53Q128.81-8.44 131.77-8.44Q134.19-8.44 137.07-9L137.07-3.62Q132.82-3.02 130.82-3.02Q123.19-3.02 123.19-10.51L123.19-54.07L128.81-54.07L128.81-11.53ZM162.07-39.23Q168.68-39.23 172.44-33.40Q175.68-28.55 175.68-20.74Q175.68-14.87 173.74-10.44Q170.16-2.21 161.93-2.21Q155.57-2.21 151.77-7.63Q148.32-12.59 148.32-20.74Q148.32-29.53 152.30-34.56Q156.09-39.23 162.07-39.23M161.93-34.21Q158.06-34.21 155.88-30.16Q153.95-26.61 153.95-20.74Q153.95-15.33 155.53-11.92Q157.71-7.24 162-7.24Q165.94-7.24 168.12-11.29Q170.05-14.84 170.05-20.67Q170.05-26.75 168.05-30.23Q165.90-34.21 161.93-34.21Z
TextToSVG.getPath(text, options = {})
Get the path
element of SVG.
text
: Text to convert to SVG path.
Options is an optional object containing:
x
: Horizontal position of the beginning of the text. (default:0
)y
: Vertical position of the baseline of the text. (default:0
)fontSize
: Size of the text (default:72
).kerning
: iftrue
takes kerning information into account (default:true
)letterSpacing
: letter-spacing value inem
.tracking
: tracking value. (em / 1000)anchor
: Anchor of object in coordinate. (default:'left baseline'
)- (
left
,center
,right
) + (baseline
,top
,middle
,bottom
)
- (
attributes
: Key-Value pairs of attributes ofpath
element.
Return value example
TextToSVG.getSVG(text, options = {})
Get the SVG.
text
: Text to convert to SVG path.
Options is an optional object containing:
x
: Horizontal position of the beginning of the text. (default:0
)y
: Vertical position of the baseline of the text. (default:0
)fontSize
: Size of the text (default:72
).kerning
: iftrue
takes kerning information into account (default:true
)letterSpacing
: letter-spacing value inem
.tracking
: tracking value. (em / 1000)anchor
: Anchor of object in coordinate. (default:'left baseline'
)- (
left
,center
,right
) + (baseline
,top
,middle
,bottom
)
- (
attributes
: Key-Value pairs of attributes ofpath
element.
Return value example
TextToSVG.getMetrics(text, option = {})
Measure text size.
text
: Text to measure size.
Options is an optional object containing:
x
: Horizontal position of the beginning of the text. (default:0
)y
: Vertical position of the baseline of the text. (default:0
)fontSize
: Size of the text (default:72
).kerning
: iftrue
takes kerning information into account (default:true
)letterSpacing
: letter-spacing value inem
.tracking
: tracking value. (em / 1000)anchor
: Anchor of object in coordinate. (default:'left baseline'
)
An example of return value.
License
MIT
Credits
text-to-svg depends on the following softwares. I thank great authors a lot.
- opentype.js: Copyright (c) 2015 Frederik De Bleser
- commander: Copyright (c) 2011 TJ Holowaychuk tj@vision-media.ca
These are released under the MIT license