Difference between revisions of "PixelDisplay.print"
Jump to navigation
Jump to search
(added example) |
(added "medium" font and fixed kerning value of "small" font) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 15: | Line 15: | ||
| ''color'' || string || null || color to draw in (defaults to PixelDisplay.color) | | ''color'' || string || null || color to draw in (defaults to PixelDisplay.color) | ||
|- | |- | ||
| − | | ''fontName'' || string || "normal" || "small", "normal", or "large" | + | | ''fontName'' || string || "normal" || "small", "medium", "normal", or "large" |
|} | |} | ||
=== Usage Notes === | === Usage Notes === | ||
By default this method uses the same font seen in a [[TextDisplay]], | By default this method uses the same font seen in a [[TextDisplay]], | ||
| − | but you may get a larger or smaller font using the ''fontName'' parameter. | + | but you may get a larger or smaller font using the ''fontName'' parameter. The font characters have the following dimensions: |
| + | |||
| + | {| class="wikitable" | ||
| + | |- | ||
| + | ! Font Name !! Character Height !! Character Width !! Kerning || Character Spacing | ||
| + | |- | ||
| + | | "small" || 14 || 10 || 2 || 8 <ref>This was 9 prior to Mini Micro v1.1.</ref> | ||
| + | |- | ||
| + | | "medium" || 19 || 13 || 2 || 11 | ||
| + | |- | ||
| + | | "normal" || 24 || 16 || 2 || 14 | ||
| + | |- | ||
| + | | "large" || 32 || 24 || 4 || 20 | ||
| + | |} | ||
| + | |||
| + | <references/> | ||
| + | |||
| + | To calculate the width of a string, multiply its <c>[[len]]</c> by the last column (Character Spacing) in the table above. | ||
== Example == | == Example == | ||
Latest revision as of 22:47, 3 December 2023
PixelDisplay.print draws some text to the pixel display.
Arguments
| Parameter Name | Type | Default Value | Meaning |
|---|---|---|---|
| str | string | "" | string to draw |
| x | number | 0 | horizontal position at which to start drawing |
| y | number | 0 | vertical position of bottom of string drawn |
| color | string | null | color to draw in (defaults to PixelDisplay.color) |
| fontName | string | "normal" | "small", "medium", "normal", or "large" |
Usage Notes
By default this method uses the same font seen in a TextDisplay, but you may get a larger or smaller font using the fontName parameter. The font characters have the following dimensions:
| Font Name | Character Height | Character Width | Kerning | Character Spacing |
|---|---|---|---|---|
| "small" | 14 | 10 | 2 | 8 [1] |
| "medium" | 19 | 13 | 2 | 11 |
| "normal" | 24 | 16 | 2 | 14 |
| "large" | 32 | 24 | 4 | 20 |
- ↑ This was 9 prior to Mini Micro v1.1.
To calculate the width of a string, multiply its len by the last column (Character Spacing) in the table above.
Example
gfx.print "Hello world!", 600, 400
gfx.print "Hello world!", 600, 350, color.aqua
gfx.print "Hello world!", 600, 300, color.aqua, "small"
gfx.print "Hello world!", 600, 250, color.aqua, "large"
