Docs » Autodocs » diskfont.library » SetDiskFontCtrlA
SetDiskFontCtrl -- Adjust disk font global settings (V45)
SetDiskFontCtrlA( tags ); A0 void SetDiskFontCtrlA( struct TagItem * ); void SetDiskFontCtrl( Tag, ... );
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_SYMSET default symbol set (unused) 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
SetDiskFontCtrl(DFCTRL_CACHE,TRUE,TAG_DONE); /* enable the AvailFonts cache. */
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.
<diskfont/diskfonttag.h>, <utility/tagitem.h>
|