NML:Realsprites - Revision history

Almostcthulhu: Grammatical error in "ALPHA" description

2020-06-06T14:12:59Z

Grammatical error in "ALPHA" description

← Older revision		Revision as of 14:12, 6 June 2020
Line 26:		Line 26:
	\| <code style="color:darkgreen">ALPHA</code> (default) or <code style="color:darkgreen">NOALPHA</code>		\| <code style="color:darkgreen">ALPHA</code> (default) or <code style="color:darkgreen">NOALPHA</code>
	\| {{nml\|0.4}} Warn about semi-transparent pixels (1% - 99% alpha) in 32bpp sprites.		\| {{nml\|0.4}} Warn about semi-transparent pixels (1% - 99% alpha) in 32bpp sprites.
	This can be used to check whether sprites have sharp edges, as for example required for ground sprites.		This can be used to check whether sprites have sharp edges as, for example, required for ground sprites.
	\|-		\|-
	\| <code style="color:darkgreen">NOWHITE</code> (default) or <code style="color:darkgreen">WHITE</code>		\| <code style="color:darkgreen">NOWHITE</code> (default) or <code style="color:darkgreen">WHITE</code>

Frosch: /* Empty / Dummy sprite */

2016-07-13T17:01:13Z

Empty / Dummy sprite

← Older revision		Revision as of 17:01, 13 July 2016
Line 80:		Line 80:
	[]		[]
	[]		[]
⚫	[1, 1, 53, 14, -25, -10]
	[]		[]
	[]		[]
	[]		[]
	[]		[]
		⚫	[1, 1, 53, 14, -25, -10]
	[]		[]
	}		}

Frosch: /* Real sprites */

2016-07-07T17:23:17Z

Real sprites

@@ Line 67: / Line 67: @@
 <pre style="color:blue">
  [0, 0, 64, 31, -31, 0, NOCROP]
 </pre>

Frosch: better example

2014-11-07T18:39:21Z

better example

← Older revision		Revision as of 18:39, 7 November 2014
Line 36:		Line 36:
	When sprites are converted to 8bpp via some external graphics program, usage of animated colours is usually unintentional.		When sprites are converted to 8bpp via some external graphics program, usage of animated colours is usually unintentional.
	\|}		\|}
	Multiple flags are combined using '<code style="color:darkgreen">\|</code>', for example '<code style="color:darkgreen">~~CROP~~ \| ~~ALPHA \| NOWHITE \| NOANIM~~</code>'.		Multiple flags are combined using '<code style="color:darkgreen">\|</code>', for example '<code style="color:darkgreen">NOCROP \| ANIM</code>'.

	filename is a literal (quoted) string that specifies the file containing the sprite. If not specified, the default filename of the block containing the real sprite is used. If this is not specified either, it is an error.		filename is a literal (quoted) string that specifies the file containing the sprite. If not specified, the default filename of the block containing the real sprite is used. If this is not specified either, it is an error.

Frosch: add new warning flags ALPHA, WHITE, ANIM

2014-11-07T18:38:30Z

add new warning flags ALPHA, WHITE, ANIM

← Older revision		Revision as of 18:38, 7 November 2014
Line 15:		Line 15:
	offset_x and offset_y are used to position the sprite. All sprites have a certain origin, e.g. for (full-length) vehicles this is the center of the vehicle. offset_x and offset_y define the position of the top-left corner of the sprite relative to this origin. Values are often negative.		offset_x and offset_y are used to position the sprite. All sprites have a certain origin, e.g. for (full-length) vehicles this is the center of the vehicle. offset_x and offset_y define the position of the top-left corner of the sprite relative to this origin. Values are often negative.

			flags can be a combination of the following:
	As of NML r1654 the 'flags' have only two possible values. When omitted the default value is used.

	{\| class="t"		{\| class="t"
	! Name		! Name
	! Description		! Description
	\|-		\|-
	\| CROP (default) or NOCROP		\| <code style="color:darkgreen">CROP</code> (default) or <code style="color:darkgreen">NOCROP</code>
	\| Whether to crop the sprites when the -c command line option is set.		\| Whether to crop the sprites when the -c command line option is set.
			<code style="color:darkgreen">NOCROP</code> is required for building sprites with childsprites in [[NML:Spritelayout\|sprite layouts]].
			\|-
			\| <code style="color:darkgreen">ALPHA</code> (default) or <code style="color:darkgreen">NOALPHA</code>
			\| {{nml\|0.4}} Warn about semi-transparent pixels (1% - 99% alpha) in 32bpp sprites.
			This can be used to check whether sprites have sharp edges, as for example required for ground sprites.
			\|-
			\| <code style="color:darkgreen">NOWHITE</code> (default) or <code style="color:darkgreen">WHITE</code>
			\| {{nml\|0.4}} Warn about pure-white pixels in 8bpp sprites.
			Usually white pixels indicate an error in the sprite coordinates.
			\|-
			\| <code style="color:darkgreen">NOANIM</code> (default) or <code style="color:darkgreen">ANIM</code>
			\| {{nml\|0.4}} Warn about palette-animated pixels in 8bpp sprites.
			When sprites are converted to 8bpp via some external graphics program, usage of animated colours is usually unintentional.
	\|}		\|}
			Multiple flags are combined using '<code style="color:darkgreen">\|</code>', for example '<code style="color:darkgreen">CROP \| ALPHA \| NOWHITE \| NOANIM</code>'.

	filename is a literal (quoted) string that specifies the file containing the sprite. If not specified, the default filename of the block containing the real sprite is used. If this is not specified either, it is an error.		filename is a literal (quoted) string that specifies the file containing the sprite. If not specified, the default filename of the block containing the real sprite is used. If this is not specified either, it is an error.

Hirundo: /* Real sprites */ Add info on [x, y] mask format

2012-03-04T15:46:17Z

Real sprites: Add info on [x, y] mask format

← Older revision		Revision as of 15:46, 4 March 2012
Line 44:		Line 44:
	\| ["mask-filename", x_left, y_upper]		\| ["mask-filename", x_left, y_upper]
	\| Filename containing the mask sprite, and the x and y-coordinates of the sprite within that file.		\| Filename containing the mask sprite, and the x and y-coordinates of the sprite within that file.
			\|-
			\| [x_left, y_upper]
			\| x and y-coordinates of the sprite within the mask file. The mask filename is taken from the alternative_sprites block.
	\|}		\|}

Hirundo: /* Templates */ Include something about usage

2012-03-03T21:01:49Z

Templates: Include something about usage

← Older revision		Revision as of 21:01, 3 March 2012
Line 62:		Line 62:
	...		...
	}		}

			To use this template, simply include the following as if it were a real sprite:

			templatename(<parameters>)

			with <parameters> being a comma-seperated list of parameter values.

	For an example see the [[NML:Spritegroup\|spritegroup]].		For an example see the [[NML:Spritegroup\|spritegroup]].

Hirundo: /* Real sprites */ Update with all the newly added (32bpp) features

2012-03-03T20:59:22Z

Real sprites: Update with all the newly added (32bpp) features

@@ Line 3: / Line 3: @@
 == Real sprites ==
-Several features will need to reference actual graphics from files you created. You can provide real sprites in many different formats, all detailed below. There is a lot of information you'll need to provide. Most important are the filename and the location of the sprite in that file. Since most blocks that reference realsprites will allow you to specify a default filename, you don't often need to give a filename for every separate sprite.
+Several features will need to reference actual graphics from files you created. There is a lot of information you'll need to provide, some of which is optional. Most important are the filename, the location of the sprite in that file and the offset used to position the sprite. Since blocks that reference realsprites will you to specify a default filename, you don't often need to give a filename for every separate sprite.
- [left_x, upper_y, width, height, offset_x, offset_y]
+ [(left_x, upper_y, width, height, )offset_x, offset_y(, flags)(, filename)(, mask)]
 {| class="t"
@@ Line 28: / Line 23: @@
 | CROP (default) or NOCROP
 | Whether to crop the sprites when the -c command line option is set.
 |}
@@ Line 36: / Line 52: @@
  [0, 0, 64, 31, -31, 0, NOCROP]
 </pre>
 == Templates ==

Planetmaker: examples should contain valid code

2011-10-08T08:46:03Z

examples should contain valid code

← Older revision		Revision as of 08:46, 8 October 2011
Line 34:		Line 34:

	<pre style="color:blue">		<pre style="color:blue">
	[0, 0, 64, 31, -31, 0, ~~TILE~~]		[0, 0, 64, 31, -31, 0, NOCROP]
	</pre>		</pre>

Planetmaker: Templates are part of realsprites as they can only be used there

2011-09-09T00:22:52Z

Templates are part of realsprites as they can only be used there

@@ Line 1: / Line 1: @@
 {{NMLNavBlocksyntax}}
 Several features will need to reference actual graphics from files you created. You can provide real sprites in many different formats, all detailed below. There is a lot of information you'll need to provide. Most important are the filename and the location of the sprite in that file. Since most blocks that reference realsprites will allow you to specify a default filename, you don't often need to give a filename for every separate sprite.
@@ Line 34: / Line 36: @@
  [0, 0, 64, 31, -31, 0, TILE]
 </pre>