DSB/Fonts - Revision history

Kaypy: fix formatting

2023-12-31T08:26:11Z

fix formatting

← Older revision		Revision as of 08:26, 31 December 2023
Line 52:		Line 52:
	The single argument form of the method loads fonts from the current directory or other standard locations, with whatever file extension works:		The single argument form of the method loads fonts from the current directory or other standard locations, with whatever file extension works:

	dsb_get_font("FONTNAME")		dsb_get_font("FONTNAME")

	The two argument form loads from a specific path and filename, and completely ignores the first argument:		The two argument form loads from a specific path and filename, and completely ignores the first argument:

	dsb_get_font("THISDOESNTDOANYTHING","path/to/file/with/extension.pcx")		dsb_get_font("THISDOESNTDOANYTHING","path/to/file/with/extension.pcx")

	== Using fonts ==		== Using fonts ==

Kaypy: check for typos before uploading

2023-12-31T08:25:49Z

check for typos *before* uploading

← Older revision		Revision as of 08:25, 31 December 2023
Line 50:		Line 50:
	sys_font = dsb_get_font("AAASYSFONT", "path/to/font/mysysfont.bmp")		sys_font = dsb_get_font("AAASYSFONT", "path/to/font/mysysfont.bmp")

	The single argument form of the method loads fonts from the current directory or other standard locations, with whatever file ~~extention~~ works:		The single argument form of the method loads fonts from the current directory or other standard locations, with whatever file extension works:

	dsb_get_font("FONTNAME")		dsb_get_font("FONTNAME")

Kaypy: /* Loading fonts */

2023-12-31T08:25:03Z

Loading fonts

← Older revision		Revision as of 08:25, 31 December 2023
Line 49:		Line 49:
	gfx.scroll_font = dsb_get_font("SCROLLFONT", "path/to/font/myscrollfont.bmp")		gfx.scroll_font = dsb_get_font("SCROLLFONT", "path/to/font/myscrollfont.bmp")
	sys_font = dsb_get_font("AAASYSFONT", "path/to/font/mysysfont.bmp")		sys_font = dsb_get_font("AAASYSFONT", "path/to/font/mysysfont.bmp")

			The single argument form of the method loads fonts from the current directory or other standard locations, with whatever file extention works:

			dsb_get_font("FONTNAME")

			The two argument form loads from a specific path and filename, and completely ignores the first argument:

			dsb_get_font("THISDOESNTDOANYTHING","path/to/file/with/extension.pcx")

	== Using fonts ==		== Using fonts ==

Kaypy at 08:18, 31 December 2023

2023-12-31T08:18:03Z

← Older revision		Revision as of 08:18, 31 December 2023
Line 58:		Line 58:

	See [[DSB/Exposed functions]] for more details.		See [[DSB/Exposed functions]] for more details.

			== Troubleshooting ==

			As of DSB 0.80, error messages do not distinguish between failing to find a font file and failing to parse it correctly. Even if you don't use it for making fonts, the examples included with FontEd above may be useful as a known-good file for sanity checking

Gambit37: /* Font structure */

2018-12-20T16:32:19Z

Font structure

← Older revision		Revision as of 16:32, 20 December 2018
Line 12:		Line 12:
	[[File:Sample_DSB_font.png]]		[[File:Sample_DSB_font.png]]

	The font must ~~have three colours, and~~ be arranged in a specific way:		The font must be arranged in a specific way:

	* A single, solid background colour that starts at 0,0 and wraps the entire image		* A single, solid background colour that starts at 0,0 and wraps the entire image

Gambit37: /* Using fonts */

2018-12-20T11:04:13Z

Using fonts

← Older revision		Revision as of 11:04, 20 December 2018
Line 52:		Line 52:
	== Using fonts ==		== Using fonts ==

	DSB has two functions for creating text on screen: '''dsb_write()''' and '''dsb_bitmap_textout()'''. ~~Both these functions take a~~ font ~~as a parameter, so you~~ can be ~~in complete control of which fonts~~ to ~~use for different~~ parts of the ~~screen~~. See [[DSB/Exposed functions]] for more details.		DSB has two functions for creating text on screen: '''dsb_write()''' and '''dsb_bitmap_textout()'''.

			* '''dsb_write()''' renders text in the console/message area at the bottom of the screen. It always uses the system font (sys_font) and this can't be changed.
			* '''dsb_bitmap_textout()''' is used to add text to all the other parts of the interface. You can override any of DSBs original rendering functions if you want to change the fonts that are used, as this function takes a font as a parameter.

			See [[DSB/Exposed functions]] for more details.

Gambit37: /* Font structure */

2018-12-20T10:50:33Z

Font structure

← Older revision		Revision as of 10:50, 20 December 2018
Line 2:		Line 2:
	== Font structure ==		== Font structure ==

	DSB ~~can only use~~ fonts ~~that are created~~ in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. ~~You CAN'T use~~ TrueType fonts or other standard font formats in DSB.		DSB uses fonts in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. TrueType fonts or other standard font formats can't be used directly in DSB.

	Fonts can be created by hand in your graphics package of choice, or you can use a tool like FontEd[http://members.allegro.cc/miran/fonted.html] which allows you to generate the correct format from a TrueType font.		Fonts can be created by hand in your graphics package of choice, or you can use a tool like FontEd[http://members.allegro.cc/miran/fonted.html] which allows you to generate the correct format from a TrueType font.

Gambit37: /* Font format */

2018-12-20T10:46:19Z

Font format

@@ Line 1: / Line 1: @@
-== Font format ==
+== Font structure ==
 DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType fonts or other standard font formats in DSB.
@@ Line 8: / Line 8: @@
 An Allegro bitmap font is usually arranged on a 16 x 8 grid, which represents the standard ASCII symbols numbered 0-127[http://www.asciitable.com/]. Each position of the grid should therefore contain the correct ASCII symbol for that position.
-[[File:Example.jpg]]
+Here is a sample font, created using the FontEd tool.

Gambit37: /* Font format */

2018-12-20T10:05:10Z

Font format

← Older revision		Revision as of 10:05, 20 December 2018
Line 2:		Line 2:
	== Font format ==		== Font format ==

	DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType fonts or other standard font formats in DSB. Fonts can be created by hand in your graphics package of choice, or you can use a tool like FontEd[http://members.allegro.cc/miran/fonted.html] which allows you to generate the correct format from a TrueType font.		DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType fonts or other standard font formats in DSB.

			Fonts can be created by hand in your graphics package of choice, or you can use a tool like FontEd[http://members.allegro.cc/miran/fonted.html] which allows you to generate the correct format from a TrueType font.

	An Allegro bitmap font is usually arranged on a 16 x 8 grid, which represents the standard ASCII symbols numbered 0-127[http://www.asciitable.com/]. Each position of the grid should therefore contain the correct ASCII symbol for that position.		An Allegro bitmap font is usually arranged on a 16 x 8 grid, which represents the standard ASCII symbols numbered 0-127[http://www.asciitable.com/]. Each position of the grid should therefore contain the correct ASCII symbol for that position.

			[[File:Example.jpg]]

Gambit37: Created page with " == Font format == DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType..."

2018-12-20T10:04:35Z

Created page with " == Font format == DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType..."

New page

== Font format ==

DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType fonts or other standard font formats in DSB. Fonts can be created by hand in your graphics package of choice, or you can use a tool like FontEd[http://members.allegro.cc/miran/fonted.html] which allows you to generate the correct format from a TrueType font.

An Allegro bitmap font is usually arranged on a 16 x 8 grid, which represents the standard ASCII symbols numbered 0-127[http://www.asciitable.com/]. Each position of the grid should therefore contain the correct ASCII symbol for that position.

DSB/Fonts - Revision history

Kaypy: fix formatting

Kaypy: check for typos *before* uploading

Kaypy: /* Loading fonts */

Kaypy at 08:18, 31 December 2023

Gambit37: /* Font structure */

Gambit37: /* Using fonts */

Gambit37: /* Font structure */

Gambit37: /* Font format */

Gambit37: /* Font format */

Gambit37: Created page with " == Font format == DSB can only use fonts that are created in the Allegro bitmap font format[https://www.allegro.cc/manual/5/al_grab_font_from_bitmap]. You CAN'T use TrueType..."

Kaypy: check for typos before uploading