UFONTHEIGHT: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
(Add availability)
No edit summary
Line 1: Line 1:
{{DISPLAYTITLE:_UFONTHEIGHT}}
{{DISPLAYTITLE:_UFONTHEIGHT}}
The [[_UFONTHEIGHT]] function returns the true font height of a font handle created by [[_LOADFONT]].
The '''_UFONTHEIGHT''' function returns the true font height of a font loaded by [[_LOADFONT]].
 


{{PageSyntax}}
{{PageSyntax}}
:{{Parameter|pixelHeight&}} = [[_UFONTHEIGHT]][({{Parameter|fontHandle&}})]
: {{Parameter|pixelHeight&}} = [[_UFONTHEIGHT]][({{Parameter|fontHandle&}})]
 


{{PageParameters}}
{{PageParameters}}
* {{Parameter|fontHandle&}} is an optional font handle.
* {{Parameter|fontHandle&}} is an optional font handle.


{{PageDescription}}
{{PageDescription}}
Line 12: Line 15:
* If no font is set, it returns the current screen mode's text block height.
* If no font is set, it returns the current screen mode's text block height.
* This is different from [[_FONTHEIGHT]] as it may return larger values when using scalable fonts.
* This is different from [[_FONTHEIGHT]] as it may return larger values when using scalable fonts.


{{PageAvailability}}
{{PageAvailability}}
<!-- QB64 = a version or none, QBPE = a version or all, Platforms = yes or no -->
<!-- QB64 = a version or none, QBPE = a version or all, Platforms = yes or no -->
<gallery widths="48px" heights="48px" mode="nolines">
<gallery widths="48px" heights="48px" mode="nolines">
File:Qb64.png|'''no'''
File:Qb64.png|'''none'''
File:Qbpe.png|'''v3.7.0'''
File:Qbpe.png|'''v3.7.0'''
File:Apix.png
File:Apix.png
Line 24: Line 28:
</gallery>
</gallery>
<!-- additional availability notes go below here -->
<!-- additional availability notes go below here -->


{{PageExamples}}
{{PageExamples}}
''Example:'' [[_UFONTHEIGHT]] vs. [[_FONTHEIGHT]].
;Example:Show the difference of '''_UFONTHEIGHT''' vs. [[_FONTHEIGHT]].
{{CodeStart}}
{{CodeStart}}
{{Cl|DIM}} fh {{Cl|AS}} {{Cl|LONG}}: fh = {{Cl|_LOADFONT}}({{Text|<nowiki>"LHANDW.TTF"</nowiki>|#FFB100}}, {{Text|23|#F580B1}})
{{Cl|DIM}} fh {{Cl|AS}} {{Cl|LONG}}: fh = {{Cl|_LOADFONT}}({{Text|<nowiki>"LHANDW.TTF"</nowiki>|#FFB100}}, {{Text|23|#F580B1}})
Line 33: Line 38:
{{Cl|PRINT}} {{Text|<nowiki>"_UFONTHEIGHT ="</nowiki>|#FFB100}}; {{Cl|_UFONTHEIGHT}}(fh)
{{Cl|PRINT}} {{Text|<nowiki>"_UFONTHEIGHT ="</nowiki>|#FFB100}}; {{Cl|_UFONTHEIGHT}}(fh)
{{CodeEnd}}
{{CodeEnd}}
{{OutputStartBG0}}
{{OutputStartBG0}}
{{Ot|<nowiki>_FONTHEIGHT = 23</nowiki>|#a9a9a9|}}
{{Ot|<nowiki>_FONTHEIGHT = 23</nowiki>|#a9a9a9}}
{{Ot|<nowiki>_UFONTHEIGHT = 32</nowiki>|#a9a9a9|}}
{{Ot|<nowiki>_UFONTHEIGHT = 32</nowiki>|#a9a9a9}}
{{OutputEnd}}
{{OutputEnd}}


{{PageSeeAlso}}
{{PageSeeAlso}}
Line 44: Line 49:
* [[_PRINTWIDTH]], [[_PRINTSTRING]]
* [[_PRINTWIDTH]], [[_PRINTSTRING]]
* [[SCREEN]], [[_LOADFONT]]
* [[SCREEN]], [[_LOADFONT]]
* [[Text Using Graphics]] (Demo)
* [[Text Using Graphics]]
 


{{PageNavigation}}
{{PageNavigation}}

Revision as of 21:03, 2 May 2023

The _UFONTHEIGHT function returns the true font height of a font loaded by _LOADFONT.


Syntax

pixelHeight& = _UFONTHEIGHT[(fontHandle&)]


Parameters

  • fontHandle& is an optional font handle.


Description

  • Returns the height of the last font used if a handle is not designated.
  • If no font is set, it returns the current screen mode's text block height.
  • This is different from _FONTHEIGHT as it may return larger values when using scalable fonts.


Availability


Examples

Example
Show the difference of _UFONTHEIGHT vs. _FONTHEIGHT.
DIM fh AS LONG: fh = _LOADFONT("LHANDW.TTF", 23)

PRINT "_FONTHEIGHT ="; _FONTHEIGHT(fh)
PRINT "_UFONTHEIGHT ="; _UFONTHEIGHT(fh)
_FONTHEIGHT = 23
_UFONTHEIGHT = 32


See also



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link