SetDiskFontCtrlA

Adjust disk font global settings. (V45)

SetDiskFontCtrl

varargs form of SetDiskFontCtrlA.

SetDiskFontCtrl adjusts the global settings passed in in the form of a tag list and installs them into the the diskfont internal database. This includes the base DPI X and Y values, the cache enable flag and the AvailFonts font sorting order.

tags

a tag list defining the global settings that are to be adjusted.

The following tag values are currently supported: (see diskfont/diskfonttag.h)

Font generator DPI settings:

DFCTRL_XDPI DFCTRL_YDPI X and Y dpi device resolution

DFCTRL_XDOTP DFCTRL_YDOTP X and Y dpi dot sizes.

DFCTRL_CACHE AvailFonts cache enable (BOOL)

DFCTRL_SORTMODE AvailFonts font sorting (LONG)

currently defined sort orders are:

DFCTRL_SORT_OFF don't sort DFCTRL_SORT_ASC localized ascending DFCTRL_SORT_DES localized descending

DFCTRL_CACHEFLUSH Flush the cache? (BOOL)

If TRUE, a cache flush is initiated.

The SetDiskFontCtrlA() function is the assembly language interface which takes the tag list pointer in A0. SetDiskFontCtrl() is the stack based wrapper for convenient C language calls.

This call is not semaphore protected. This means that several calls to this function and GetDiskFontCtrl() might cause inconsistent results. The function will not fail or crash, but the result might be near to useless in a multitasking system. This function should never be called by the average user. Its sole purpose is to allow the font preferences editor to adjust the diskfont internal data in a user friendly way. It should not be called for other purposes, especially, applications *MUST NOT* call this to enable or disable the cache setting. This should be left to the user by selecting the preferences.

Prior to V46, setting DFCTRL_XDOTP and/or DFCTRL_YDOTP to something else than the default (100) may result in the fact that diskfont.library is no longer able to create bitmap fonts from outline fonts since some font engines dont support an OT_DotSize different from the default and return an error. Since V46, the font generator now retries with OT_DotSize of 100% if the first try failed.

diskfont/diskfonttag.h, utility/tagitem.h