Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Set font family to use.

Component Version macOS Windows Linux Server iOS SDK
GraphicsMagick 10.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "GMImage.SetFontFamily"; ImageRef )   More


Parameter Description Example
ImageRef The image reference number. 1


Returns OK or error.


Set font family to use.
The plugin will look through the list to find best match for combination of family, style, stretch and weight.
You can use either GMImage.SetFontFamily or GMImage.SetFont, but not both.
Setting font family clears font.

In v10.4 the selected font must resolve to one font file and may not work if multiple font faces are in one folder.


Set font family and other properties:

Set Variable [ $r ; Value: MBS("GMImage.SetFontPointsize"; $ref; 40) ]
Set Variable [ $r ; Value: MBS("GMImage.SetFontStyle"; $ref; "Italic") ]
Set Variable [ $r ; Value: MBS("GMImage.SetFontFamily"; $ref; "Times") ]
Set Variable [ $r ; Value: MBS("GMImage.SetFontStretch"; $ref; "Normal") ]
Set Variable [ $r ; Value: MBS("GMImage.SetFontWeight"; $ref; 800) ]

See also

Release notes

Blog Entries

This function checks for a license.

Created 27th August 2020, last changed 18th September 2020

GMImage.SetFont - GMImage.SetFontPointsize