A pure-Lua text rendering module for Corona SDK which can handle basic HTML, fonts, font-styles, and even basic font metrics.
I've made this library public in the hopes that we can fix the bugs and improve it. The documentation could be better, I know. Ask, and I will reply.
local params = {
text = mytext,
-- default text settings (overriden by styles)
font = "AvenirNext-Regular",
size = "12",
lineHeight = "16",
color = {0, 0, 0, 255},
opacity = "100%",
width = w, -- width of the column of text
textAlignment = "Left", -- default text alignment, note the initial capital letter
minCharCount = 5, -- Minimum number of characters per line. Start low.
targetDeviceScreenSize = screenW..","..screenH, -- Target screen size, may be different from current screen size
letterspacing = 0,
maxHeight = screenH - 50,
minWordLen = 2, - Minimum length of a word shown at the end of a line, e.g. don't end lines with "a".
textstyles = textStyles, -- styles table, loaded using funx.loadTextStyles
defaultStyle = "Normal", -- default style (from textstyles.txt) for text
cacheDir = cacheDir, -- Set to cache directory name to use json file caching (slow)
cacheToDB = true, -- default is true, set to false for no caching, uses sqlite3 caching (faster)
handler = handler, -- a function that will accept a 'tap' event
hyperlinkFillColor = hyperlinkFillColor, -- an RGBa color in a string, like this: "200,120,255,100"
isHTML = true, -- TRUE if the text is simplified HTML styled text
useHTMLSpacing = true, -- if TRUE, then change all returns and tabs and double-spaces to a single space
}
local t = textwrap.autoWrappedText(params)
Notes on the hyperlinking:
handler : a function that will use a 'tap' event. Note that event.target._attr contains the attributes
the hyperlink, e.g. href, style, class, whatever your throw in.
In the example, the function will get 'makeSound' as the href, and it can do the appropriate action.
You can pass any attribute you need, such as a page number or URL, of course.
Example: <a href="makeSound" style="font-size:24;">My Link</a>
Understanding the parts:
- textwrap.lua : the module that renders a piece of text. The text can have basic HTML coding (p, br, i, em, b, li, ol), as well as my built-in paragraph formatting. It will also read the 'class' attribute of HTML to figure out the style, then apply the style from the textstyles.txt file!
- HTML support: entities.lua, html.lua : these are open source modules I found and modified to handle HTML
- fontmetrics.lua, fontmetrics.txt, fontvariations.txt : this module and files let the textwrap module position type correctly on the screen. Normally, you can't position with baseline, but these modules let us do that.
- funx.lua : a large collection of useful functions