Term.blit - Revision history

Bomb Bloke: Can use spaces as colours

2015-12-16T23:42:48Z

Can use spaces as colours

Bomb Bloke at 11:11, 28 June 2015

2015-06-28T11:11:39Z

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=term.blit |args= {{Type|string}} text, {{Type|string}} text colours, {{Type|string}} background colours |api=term |addon=ComputerCraft |desc=Add..."

2015-06-28T10:53:36Z

Created page with "{{lowercase}} {{Function |name=term.blit |args= {{Type|string}} text, {{Type|string}} text colours, {{Type|string}} background colours |api=term |addon=ComputerCraft |desc=Add..."

New page

{{lowercase}}
{{Function
|name=term.blit
|args= {{Type|string}} text, {{Type|string}} text colours, {{Type|string}} background colours
|api=term
|addon=ComputerCraft
|desc=Added by ComputerCraft 1.74, term.blit functions in nearly the same manner as [[term.write]](), but instead of using the current text and background colours, it accepts additional strings specifying colour codes for each individual character. In some circumstances this removes the need to make multiple [[term.setTextColor]]() / [[term.setBackgroundColor]]() calls, allowing complex displays to be rendered in a far more efficient manner. 

Each character in the text/background colour strings must be a valid "paint" symbol from ComputerCraft's [[Colors_%28API%29#Colors|list of colours]] (eg, "a", "3", "e", etc), and the three strings must each be of the same length. Note that only advanced systems can render in colour - if unsupported shades are requested on a normal system, no error will occur, but black will be used instead.
|examples=
{{Example
|desc=Writes the letter "a", using a blue text colour ("b"), and a brown background colour ("c").
|code=term.blit("a","b","c")
|output=a
}}
{{Example
|desc=Writes RAINBOW!, making use of all colours.
|code=term.blit("RAINBOW!","01234567","89abcdef")
|output=RAINBOW!
}}
}}

[[Category:API_Functions]]

@@ Line 7: / Line 7: @@
 |desc=Added by ComputerCraft 1.74, term.blit() functions in nearly the same manner as [[term.write]](), but instead of using the current text and background colours, it accepts additional strings specifying colour codes for each individual character. Although it is no faster than term.write() in its own right, in some circumstances it can reduce code length and speed execution by removing the need to make multiple [[term.setTextColor]]() / [[term.setBackgroundColor]]() calls.<br><br>
-Each character in the text/background colour strings must be a valid "paint" symbol from ComputerCraft's [[Colors_%28API%29#Colors|list of colours]] (eg, "a" for purple, "3" for light blue, "e" for red, etc), in the same order as the text characters they are to be applied to. The three strings must each be of the same length. Note that only advanced systems can render in colour - if unsupported shades are requested on a normal system, no error will occur but black will be used instead.
+Each character in the text/background colour strings must be a valid "paint" symbol from ComputerCraft's [[Colors_%28API%29#Colors|list of colours]] (eg, "a" for purple, "3" for light blue, "e" for red, etc), in the same order as the text characters they are to be applied to. Spaces may also be used: in the text colour string, they'll be taken for white, whereas in the background colour string they'll be taken for black. The three strings must each be of the same length. Note that only advanced systems can render in colour - if unsupported shades are requested on a normal system, no error will occur but black will be used instead.
 |examples=
 {{Example

@@ Line 5: / Line 5: @@
 |api=term
 |addon=ComputerCraft
-|desc=Added by ComputerCraft 1.74, term.blit functions in nearly the same manner as [[term.write]](), but instead of using the current text and background colours, it accepts additional strings specifying colour codes for each individual character. In some circumstances this removes the need to make multiple [[term.setTextColor]]() / [[term.setBackgroundColor]]() calls, allowing complex displays to be rendered in a far more efficient manner.<br><br>
+|desc=Added by ComputerCraft 1.74, term.blit() functions in nearly the same manner as [[term.write]](), but instead of using the current text and background colours, it accepts additional strings specifying colour codes for each individual character. Although it is no faster than term.write() in its own right, in some circumstances it can reduce code length and speed execution by removing the need to make multiple [[term.setTextColor]]() / [[term.setBackgroundColor]]() calls.<br><br>
-Each character in the text/background colour strings must be a valid "paint" symbol from ComputerCraft's [[Colors_%28API%29#Colors|list of colours]] (eg, "a", "3", "e", etc), and the three strings must each be of the same length. Note that only advanced systems can render in colour - if unsupported shades are requested on a normal system, no error will occur, but black will be used instead.
+Each character in the text/background colour strings must be a valid "paint" symbol from ComputerCraft's [[Colors_%28API%29#Colors|list of colours]] (eg, "a" for purple, "3" for light blue, "e" for red, etc), in the same order as the text characters they are to be applied to. The three strings must each be of the same length. Note that only advanced systems can render in colour - if unsupported shades are requested on a normal system, no error will occur but black will be used instead.
 |examples=
 {{Example
@@ Line 18: / Line 18: @@
 |code=term.blit("RAINBOW!","01234567","89abcdef")
 |output=<span style="color:#F0F0F0; background-color:#999999;">R</span><span style="color:#F2B233; background-color:#4C99B2;">A</span><span style="color:#E57FD8; background-color:#B266E5;">I</span><span style="color:#99B2F2; background-color:#3366CC;">N</span><span style="color:#DEDE6C; background-color:#7F664C;">B</span><span style="color:#7FCC19; background-color:#57A64E;">O</span><span style="color:#F2B2CC; background-color:#CC4C4C;">W</span><span style="color:#4C4C4C; background-color:#000000;">!</span>
 }}
 }}
 [[Category:API_Functions]]