Measuring and wrapping text in OpenSCAD

cults3d

OpenSCAD does not have built-in functions for measuring text size and word wrapping text. This library provides these. Make sure you have fontmetricsdata.scad and fontmetrics.scad in your current directory and that you start your code with use <fontmetrics.scad>; Public modules: * drawWrappedText(text,font="Liberation Sans",size=10,spacing=1,linespacing=1,indent=0,width=800,halign="left"): wrap text to the specified width; you can have multiple paragraphs separated by \n, and you can choose "left", "right", and "justify" as the alignment * drawText(): a partial clone (minus the language, script and only good for left-to-right) of the built-in text(), but with greater rendering fidelity at small font sizes Public functions: * measureText(text,font="Liberation Sans",size=10.,spacing=1.): measure the width of text; this is, technically, the x-advance of the text, so the text--especially in italics--may stick out the right hand side * measureTextBounds(text,font="Liberation Sans",size=10.,spacing=1.,valign="baseline",halign="left"): returns [[leftX,bottomY],[width,height]] of the rectangle taken up by the actual text; curves near edges may slightly spill out * measureWrappedText(text,font="Liberation Sans",size=10,spacing=1,linespacing=1,indent=0,width=800,halign="left"): same as measureTextBounds() except that it measures the text as rendered by drawWrappedText() instead of drawText()/text(). * measureTextAscender(text,font="Liberation Sans",size=10.,valign="baseline"): measures the ascenders of the single-line text (height above baseline) * measureTextDescender(text,font="Liberation Sans",size=10.,valign="baseline"): measures the bottom of the single-line text relative to the baseline (typically negative) * measureLeftBearing(text,font="Liberation Sans",size=10.): measures the distance from the left of the beginning of the shape of the first glyph in text (single line) * measureRightBearing(text,font="Liberation Sans",size=10.): measures the distance from the right-advance of the text to the right-hand-side of the shape of the last glyph in text (single line) * ascender(font="Liberation Sans",size=10.): the ascender size reported by the font * descender(font="Liberation Sans",size=10.): the descender size reported by the font The library includes metrics and kerning information for the OpenSCAD built-in Liberation fonts plus all the text fonts in the Microsoft Core Fonts package. It won't work with other fonts, unless you use my Python scripts to generate more font information. Updates: * 08/22/2019: Bug fixes * 07/18/2018: Webdings support * 07/17/2018: tweak side-bearing and ascender and descender measurement; change return format for bounds; add text wrapping