Sablon:SchematicSprite/doc forrásának megtekintése

{{Documentation header}}
{{Lua|Schematic}}
{{merge|Template:Schematic|Wikitext is exactly the same in both templates}}
This template displays a block sprite built from [[:File:SchematicSprite.png]].

== Usage ==

SchematicSprite can take one named parameter and any number of unnamed parameters:

 <nowiki>{{SchematicSprite|size=<size>|sprite1|sprite2|…}}</nowiki>

The ''size'' parameter may be added to specify the width and height of the sprite in pixels. Its value should be a simple number with no units added (e.g., <code>size=16</code>). If omitted, size defaults to 32.

[[File:SchematicSprite.png|thumb|Sprite sheet for SchematicSprite]]
A ''sprite'' parameter identifies the sprite to be displayed from the sprite sheet on the right.

If the ''sprite'' parameter is not recognized as a valid sprite identifier, it is simply displayed as center-aligned text within the sprite's bounding box. Overflow text is not displayed, so this is primarily intended to be used to display one or two characters in a schematic (such as input and output locations, feature markers to be referenced in text, or numbers representing light levels or distance). [[Wikipedia:List_of_XML_and_HTML_character_entity_references|HTML character entity references]] may be needed for some characters, such as <code>&amp;#124;</code> for the pipe character: <code>&#124;</code>, or <code>&amp;#61;</code> for an equals sign.

When multiple ''sprite'' parameters are defined, the resulting sprites or text are stacked on top of each other, from bottom to top in the order they were defined.

=== Examples ===

{| class="wikitable"
|-
! colspan=3 | Empty parameters
|-
| {{SchematicSprite}}
| <code><nowiki>{{SchematicSprite}}</nowiki></code>
| omitting the ''sprite'' parameter produces a blank sprite (i.e., [[air]])
|-
| {{SchematicSprite|}}
| <code><nowiki>{{SchematicSprite|}}</nowiki></code>
| a defined but empty ''sprite'' parameter also produces a blank sprite
|-
! colspan=3 | Characters
|-
| {{SchematicSprite|A}}
| <code><nowiki>{{SchematicSprite|A}}</nowiki></code>
| displaying a single character
|-
| style="text-align: center;" | {{SchematicSprite|size=16|A}}
| <code><nowiki>{{SchematicSprite|size=16|A}}</nowiki></code>
| text scales to sprite size (size=16)
|-
| {{SchematicSprite|&rarr;}}
| <code><nowiki>{{SchematicSprite|&amp;rarr;}}</nowiki></code>
| displaying an HTML character entity reference
|-
| {{SchematicSprite|Q&#x305;}}
| <code><nowiki>{{SchematicSprite|Q&amp;#x305;}}</nowiki></code>
| using an HTML character entity reference to combine a character with a [[Wikipedia:Combining_Diacritical_Marks|diacritical mark]]
|-
| {{SchematicSprite|15}}
| <code><nowiki>{{SchematicSprite|15}}</nowiki></code>
| two characters usually fit…
|-
| {{SchematicSprite|MM}}
| <code><nowiki>{{SchematicSprite|MM}}</nowiki></code>
| …but some do not &mdash; text that doesn't fit aligns to the left edge and overflows to the right
|-
! colspan=3 | Sprite identifiers
|-
| {{SchematicSprite|grass block}}
| <code><nowiki>{{SchematicSprite|grass block}}</nowiki></code>
| displaying a sprite predefined by a sprite identifier
|-
! colspan=3 | Stacked sprites
|-
| {{SchematicSprite|SB+rd-!}}
| <code><nowiki>{{SchematicSprite|SB+rd-!}}</nowiki></code>
| redstone dust on block of gold
|-
| style="text-align: center;" | {{SchematicSprite|size=24|SB+A}}
| <code><nowiki>{{SchematicSprite|size=24|SB+A}}</nowiki></code>
| text on block of gold
|-
| {{SchematicSprite|obsidian+A}}
| <code><nowiki>{{SchematicSprite|obsidian+A}}</nowiki></code>
| text has a blurred white shadow behind it, to help it show up against dark backgrounds<noinclude>
|-
! colspan=3 | Error testing (section not transcluded)
|-
| {{SchematicSprite|"}}
| <code><nowiki>{{SchematicSprite|"}}</nowiki></code>
| okay
|-
| {{SchematicSprite|&amp;}}
| <code><nowiki>{{SchematicSprite|&}}</nowiki></code>
| okay
|-
| {{SchematicSprite|'}}
| <code><nowiki>{{SchematicSprite|'}}</nowiki></code>
| okay
|-
| {{SchematicSprite|<}}
| <code><nowiki>{{SchematicSprite|<}}</nowiki></code>
| okay
|-
| {{SchematicSprite|>}}
| <code><nowiki>{{SchematicSprite|>}}</nowiki></code>
| okay
|-
| {{SchematicSprite|&#61;}}
| <code><nowiki>{{SchematicSprite|&amp;#61;}}</nowiki></code>
| substitution required for equals sign (used to create a named parameter)
|-
| {{SchematicSprite|&#124;}}
| <code><nowiki>{{SchematicSprite|&amp;#124;}}</nowiki></code>
| substitution required for vertical line (used to delimit parameters)</noinclude>
|}

SchematicSprites can also appear in the flow of text, like this: {{SchematicSprite|size=16|SB+rd-ew!}}.

== List of identifiers ==

An '''identifier''' is a string of characters that specify which sprite to display.

{{LoadPage|Template:SchematicSprite/ids-basic|Basic identifiers|h3}}
{{LoadPage|Template:SchematicSprite/ids-redstone|Redstone identifiers|h3}}

== See also ==
{{Sprite see also}}

<includeonly>
[[en:Template:SchematicSprite]]
[[Category:Sprite templates]]
</includeonly>
<noinclude>
[[en:Template:SchematicSprite/doc]]
</noinclude>