On CIQ 5.1.0 devices, using a Graphics.FontDefinition (e.g., Graphics.FONT_MEDIUM) with the :font option only works if the target device provides a scalable version of that font.
For example:
-
On FR165,
getVectorFont( :font => Graphics.FONT_MEDIUM, :scale => 1.0 )returns a valid font object. -
On epix2pro47mm, the same call returns
null, since on that device the standard font is not scalable.
This behavior is currently undocumented and can lead to confusion or unexpected null-pointer errors. It would be helpful if the documentation:
-
Clearly stated that
getVectorFont()will returnnullwhen passed aFontDefinitionthat is not scalable on the target device. -
Clarified which fonts are scalable on a per-device basis. Currently, this can only be vaguely inferred from the font column in the device reference.