Screentext - Revision history

NY00123: Update link to screentext.con

2023-06-16T08:40:23Z

Update link to screentext.con

← Older revision		Revision as of 01:40, 16 June 2023
Line 131:		Line 131:
	==Examples==		==Examples==

	[{{EDuke32 source\|~~source~~/~~duke3d~~/~~src/lunatic/test~~/screentext.con}} screentext.con]		[{{EDuke32 source\|package/sdk/samples/screentext.con}} screentext.con]

	[[File:Screentext preview color.png]]		[[File:Screentext preview color.png]]

NY00123: Rename TEXT_GAMETEXTNUMHACK -> TEXT_CONSTWIDTHNUMS as done when moving screentext into the engine: https://voidpoint.io/terminx/eduke32/-/commit/9f30ad1fc4c4359a1c2d755e4ad710d1980d69a1

2023-05-12T13:36:35Z

Rename TEXT_GAMETEXTNUMHACK -> TEXT_CONSTWIDTHNUMS as done when moving screentext into the engine: https://voidpoint.io/terminx/eduke32/-/commit/9f30ad1fc4c4359a1c2d755e4ad710d1980d69a1

← Older revision		Revision as of 06:36, 12 May 2023
Line 99:		Line 99:
	*<xbetween>: 0		*<xbetween>: 0
	*<ybetween>: 0		*<ybetween>: 0
	*<text flags>: ~~TEXT_GAMETEXTNUMHACK~~		*<text flags>: TEXT_CONSTWIDTHNUMS

	===[[minitext]]===		===[[minitext]]===

Fox at 00:39, 21 February 2020

2020-02-21T00:39:57Z

← Older revision		Revision as of 17:39, 20 February 2020
Line 58:		Line 58:
	\| the y-distance between lines. Can be zero or negative.		\| the y-distance between lines. Can be zero or negative.
	\|-		\|-
	\| <[[#Text ~~Properties Bitfield~~\|text flags]]>		\| <[[#Text flags\|text flags]]>
	\| is a [[bitfield]] describing properties of the text block (see entry)		\| is a [[bitfield]] describing properties of the text block (see entry)
	\|-		\|-

Fox: /* Text Properties Bitfield */

2020-02-20T08:17:09Z

Text Properties Bitfield

@@ Line 87: / Line 87: @@
 {{Orientation}}
-==Text Properties [[Bitfield]]==
+==Text flags==
-{| {{prettytable}}
+{{Template:Screentext flags}}
 ==Default settings replicating other text commands==

Fox at 07:53, 20 February 2020

2020-02-20T07:53:19Z

← Older revision		Revision as of 00:53, 20 February 2020
Line 40:		Line 40:
	\| can be from 0-255.		\| can be from 0-255.
	\|-		\|-
	\| <[[orientation]]>		\| <orientation>
	\| controls the way the sprite is drawn (see entry). Note: It is recommended that you always include bit 16 so that the characters will be placed correctly.		\| controls the way the sprite is drawn (see entry). Note: It is recommended that you always include bit 16 so that the characters will be placed correctly.
	\|-		\|-
Line 82:		Line 82:

	[[qstrdim]] can be helpful if you are designing complex text effects.		[[qstrdim]] can be helpful if you are designing complex text effects.

			== Orientation ==

			{{Orientation}}

	==Text Properties [[Bitfield]]==		==Text Properties [[Bitfield]]==

Fox: /* Text Properties Bitfield */

2020-02-20T05:22:28Z

Text Properties Bitfield

Show changes

Fox at 04:39, 20 February 2020

2020-02-20T04:39:55Z

← Older revision		Revision as of 21:39, 19 February 2020
Line 10:		Line 10:

	{\| {{prettytable}}		{\| {{prettytable}}
	\| <width return var>, <height return var>		\| <width return var><br /><height return var>
	\| are both [[gamevar]]s to which '''qstrdim''' will assign its results		\| are both [[gamevar]]s to which '''qstrdim''' will assign its results
	\|-		\|-

Fox at 04:32, 20 February 2020

2020-02-20T04:32:49Z

@@ Line 1: / Line 1: @@
 '''screentext''' <tilenum> <x> <y> <zoom> <block angle> <character angle> <quote> <shade> <pal> <orientation> <alpha> <xspace> <yline> <xbetween> <ybetween> <text flags> <x1> <y1> <x2> <y2>
 '''qstrdim''' <width return var> <height return var> <tilenum> <x> <y> <zoom> <block angle> <quote> <orientation> <xspace> <yline> <xbetween> <ybetween> <text flags> <x1> <y1> <x2> <y2>
-==Parameters==
+The art of HUD text can best be accomplished using the '''screentext''' command.
-<width return var> and <height return var> are both [[gamevar]]s to which '''qstrdim''' will assign its results
+'''qstrdim''' calculates the dimensions taken up by an equivalent call to screentext.
-<tilenum> is the start of the font range. The most common value is STARTALPHANUM (#2822). MINIFONT (#3072) can also work. By default, these tile ranges follow [http://www.asciitable.com/ ASCII order] and the tile number itself points to the '!' character.
+==Parameters==
-<[[#Text Properties Bitfield|text flags]]> is a [[bitfield]] describing properties of the text block (see entry)
+{| {{prettytable}}
-<x1>, <y1>, <x2>, and <y2> are boundaries on the screen that define where the text may be drawn. By far the two most common set of values for these fields are:
+ set X2 xdim
-*<code>0 0 [[xdim]]-1 [[ydim]]-1</code> (Covers the entire screen. Orientation bit 8 recommended.)
+  sub X2 1
- setvarvar xdimminus xdim
+  set Y2 ydim
-  subvar xdimminus 1
+  sub Y2 1
-  setvarvar ydimminus ydim
-  subvar ydimminus 1
+  // 0 0 X2 Y2
-  // 0 0 xdimminus ydimminus
+<code>[[windowx1]] [[windowy1]] [[windowx2]] [[windowy2]]</code> (Shrinks to match the [[screen_size|viewport]].)
-*<code>[[windowx1]] [[windowy1]] [[windowx2]] [[windowy2]]</code> (Shrinks to match the [[screen_size|viewport]].)
+|-
 ==Notes==

Hendricks266 at 10:36, 1 February 2017

2017-02-01T10:36:29Z

← Older revision		Revision as of 03:36, 1 February 2017
Line 220:		Line 220:
	==Examples==		==Examples==

	[{{EDuke32 source\|source/lunatic/test/screentext.con}} ~~source/lunatic/test/~~screentext.con]		[{{EDuke32 source\|source/duke3d/src/lunatic/test/screentext.con}} screentext.con]

	[[File:Screentext preview color.png]]		[[File:Screentext preview color.png]]

Hendricks266: /* Default settings replicating other text commands */

2014-03-18T19:43:28Z

Default settings replicating other text commands

← Older revision		Revision as of 12:43, 18 March 2014
Line 193:		Line 193:
	*<tilenum>: MINIFONT		*<tilenum>: MINIFONT
	*<xspace>: 4		*<xspace>: 4
	*<yline>: 8		*<yline>: 6
	*<xbetween>: 1		*<xbetween>: 1
	*<ybetween>: 0		*<ybetween>: 1
	*<text flags>: TEXT_UPPERCASE (unless your mod adds lowercase tiles to the MINIFONT set, in which case 0)		*<text flags>: TEXT_UPPERCASE (unless your mod adds lowercase tiles to the MINIFONT set, in which case 0)
			====regular expression====
			Find: minitext <nowiki>+([A-Za-z0-9_]+) +([A-Za-z0-9_]+) +([A-Za-z0-9_]+) +([A-Za-z0-9_]+) +([A-Za-z0-9_]+)</nowiki>
			Replace: screentext MINIFONT $1 $2 zoom blockangle charangle $3 $4 $5 orientation alpha 4 6 1 0 0x00002000 x1 y1 x2 y2

	===menutext===		===menutext===
	*<tilenum>: BIGALPHANUM		*<tilenum>: BIGALPHANUM