h6. [[ColourTrans]] h6(. » [[ColourTrans SWI Calls|SWI Calls]] h6((. » ColourTrans_ReturnFontColours h2. ColourTrans_ReturnFontColours h5. (SWI &4074E) |_<^{width:3em}. Entry | | |<^. R0|<^. Font handle, or 0 for current font | |<^. R1|<^. Background palette entry | |<^. R2|<^. Foreground palette entry | |<^. R3|<^. Maximum foreground colour offset (0-14) | |_<^{width:3em}. Exit || |<^. R0 |<^. Preserved| |<^. R1 |<^. Background logical colour (preserved if in 256 colour mode)| |<^. R2 |<^. Foreground logical colour| |<^. R3 |<^. Maximum sensible colour offset (up to R3 on entry)| h4. Use This purpose of this call is to return the maximum range of colour than can be sensibly used, given the background, foreground and number of anti-aliasing colour desired. h4. Notes For any given palette entries passed in R1 and R2, it finds the best fit in the current palette, and then inspects the other available colours to deduce the maximum possible amount of anti-aliasing up to the limit passed in R3. If anti-aliasing is desirable, R3 should equal 14 on entry, otherwise set to 0 for monochrome. The values in R – R3 on exit are suitable for passing to [[Font_SetFontColours]], or including in a font string in a command (18) sequence. In 256 colour modes only 16 colours can be set before previously returned information becomes invalid – this is the source of the 16 colour change limitation in [[Font_Paint]]. The 24-bit palette entries are in the &BBGGRR00 format. h4. See also * [[ColourTrans_ReturnColourNumber]] * [[ColourTrans_ReturnColourNumberForMode]] * [[ColourTrans_ReturnGCOL]] * [[ColourTrans_ReturnGCOLForMode]] * [[ColourTrans_SetFontColours]]