About This File
This script is for other script authors to use in order to have custom Unicode based "fonts" in their scripts.
This script allows you to:
Convert plain text strings to Unicode fonts.
Export LUA code to use a font in your script.
Customize font settings like letter spacing, word spacing and adding letter and word brackets.
Create your own custom fonts from scratch.
Modify the included fonts.
The script itself can also be included in your script to use multiple fonts in one script and use random fonts.
-----------------------------------------
--Usage for exported lua--
-----------------------------------------
--Remove the gg.alert() from the end of exported file then copy
--and paste the code to the top of your script
--wrap any text you want to style like this
--style_text("Your text string")
----------------------------------------------------------------------------------
----------------------------------------------------------------------------------
-------------------------------------------------------------------------------------------------
--Usage When Including The Entire Script--
-------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--style_text(string,style,letter_wrap,word_wrap,letter_space,word_space,letter_wrap_space,word_wrap_space)
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--parameters:
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
----string (Required): The string of text to style.
--Example: "Your string of text"
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
----style (Optional): The style table name or the style_array index number to convert text to.
--Example 1 Table Name: style_sans_serif_bold
--Example 2 style_array Index: 4
--Using either of the above for the style parameter will yeild the same result
--Returns random style if nil.
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--letter_wrap (Optional but Requires all other parameters): The wraps_array index for the bracket style you wish to wrap Letters in.
--Example: 7
--Sets letter brackets style to ⦃L⦄⦃e⦄⦃t⦄⦃t⦄⦃e⦄⦃r⦄⦃s⦄
--Set to 1 for no letter brackets
--Set word_wrap to 1 if using this
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--word_wrap (Optional but Requires all other parameters): The wraps_array index for the bracket style you wish to wrap Words in.
--Example: 7
--Sets word bracket style to ⦃Word⦄
--Set to 1 for no word brackets
--Set letter_wrap to 1 if using this
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--letter_space (Optional but Requires all other parameters): The space between letters in Narrow No-Break Spaces.
--Range 0-10
--Example: 2
--Sets letters T H I S far apart.
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--word_space (Optional but Requires all other parameters): The space between word in Hair Spaces.
--Range 0-20
--Example: 10
--Sets words this far apart.
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
--letter_wrap_space (Optional but Requires all other parameters): The space between brackets and Letters in Narrow No-Break Spaces.
--Range 0-10
--Example: 1
--Sets this much space betwean ⦃ L ⦄⦃ e ⦄⦃ t ⦄⦃ t ⦄⦃ e ⦄⦃ r ⦄⦃ s ⦄ and brackets.
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
----word_wrap_space (Optional but Requires all other parameters): The space between brackets and Words in Narrow No-Break Spaces.
--Range 0-10
--Example: 2
--Sets this much space between ⦃ Words ⦄ and brackets.
--------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------
---------------------------------------------------------------------------------
--Usage example with style_array index specified
---------------------------------------------------------------------------------
--style_text("Your string of text",3)
--Result
--𝒀𝒐𝒖𝒓 𝒔𝒕𝒓𝒊𝒏𝒈 𝒐𝒇 𝒕𝒆𝒙𝒕
---------------------------------------------------------------------------------
--Usage example with style table name specified
---------------------------------------------------------------------------------
--style_text("Your string of text",style_x_4)
--Result
--𝗬𝗼𝘂𝗿 𝘀𝘁𝗿𝗶𝗻𝗴 𝗼𝗳 𝘁𝗲𝘅𝘁
---------------------------------------------------------------------------------
--Usage example with all parameters specified
---------------------------------------------------------------------------------
--style_text("Your string of text",4,1,4,1,10,0,3)
--Result
--⦗ 𝗬 𝗼 𝘂 𝗿 ⦘ ⦗ 𝘀 𝘁 𝗿 𝗶 𝗻 𝗴 ⦘ ⦗ 𝗼 𝗳 ⦘ ⦗ 𝘁 𝗲 𝘅 𝘁 ⦘
------------------------------------------------------
--Usage example with random style
------------------------------------------------------
----style_text("Your string of text")
--Result
--Random style