/xojo-ATSApplicationFontsPath

Use fonts in your app that are not installed on the user’s system.

Primary LanguageXojo

Use ATSApplicationFontsPath in your Xojo app

You can use fonts in your app that are not installed on the user’s system, with no need to require the user to install them manually (or for them to be installed at all).

Information Property List Key Reference

Property List Key - ATSApplicationFontsPath

First, add a copy step to your build process (to run AFTER the build step) and copy the font files into your app’s Resources directory. (I like to have a "Fonts" subdirectory within the Resources directory, but it’s not essental.)

Then you add a script step to run after the copy step.

This step uses PlistBuddy (provided with Apple’s Xcode install) to add an ATSApplicationFontsPath option to the newly built app’s Info.plist file.

var path as String = CurrentBuildLocation + "/" + CurrentBuildAppName.ReplaceAll( " ", "\ " )

var result as String = DoShellCommand( "/usr/libexec/PlistBuddy -c ""Add ::ATSApplicationFontsPath string Fonts/"" " + path + ".app/Contents/Info.plist" )

if result <> "" then print( result )

As you can see, error checking is pretty minimal.

CurrentBuildLocation is already escaped for command line use, CurrentBuildAppName is NOT escaped, so you need to create a final fully escaped version of the whole path.

You pass this in to PlistBuddy, specifying the Fonts subdirectory.

Now when you run your app, it has access to any fonts that are in that folder.

The simple project file uses the demo font in the Paint event of the main app window to draw some text. Nothing terribly elaborate or clever. But this technique comes in to its own when including dingbats or other symbol or special fonts and then referencing them from within your app.

Sub Paint(g As Graphics, areas() As REALbasic.Rect) Handles Paint

    g.FontName = "ChicagoFLF"

    g.FontSize = 72

    g.DrawText( "Hello!", ( g.Width - g.TextWidth( "Hello!" ) ) / 2, g.Height / 2 )

End Sub

(The only slight wrinkle is that sometimes you have to experiment to find the correct name of the font. Or just install on it your system, use FontBook, and test it out in Xojo directly. And then uninstall it once more.)

The demo font included with the project is "ChicagoFLF", which is a public domain font, created and made available by Robin Casady, based on the original Apple Chicago system typeface designed by Susan Kare.

https://fontlibrary.org/en/font/chicagoflf

https://en.wikipedia.org/wiki/Chicago_(typeface)

Note that PlistBuddy must be installed on your computer. The easiest way to achieve this is to simply install Xcode.

But at the end of the day, the Info.plist file is just text, so there would be plenty of other ways of doing the same thing ...