Colors (API)

2012-09-17T19:22:45Z

MrBarry: /* Methods */

The Colors API allows you to mess with colored cable from the RedPower Mod. For the non-American English Version just replace 'color' with 'colour' and it will use the other API, colours, which is exactly the same, except in non-American English (e.g. gray is spelt grey and lightGray is spelt lightGrey).

==Methods==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[colors.combine]](color1, color2, …)
|Combines a set of colors (or sets of colors) into a larger set
|-
|[[colors.subtract]](colors, color1, color2, …)
|Removes one or more colors (or sets of colors) from an initial set
|-
|[[colors.test]](colors, color)
|Tests whether a given color (or set of colors) is contained within a set
|}
Note: Since the colors are just integers, the standard addition (+) and subtraction (-) operators may be used on colors instead of colors.combine and colors.subtract.

Furthermore, the [[Bit (API)]] may be used on sets of colors. For example,
<pre>
bCableLeft = rs.getBundledInput("left")
bCableRight = rs.getBundledInput("right")

-- Get a number representing colors on in both right and left bundled cables
commonColors = bit.band(bCableLeft, bCableRight)

-- Get all the colors active on either right or left
totalColors = bit.bor(bCableLeft, bCableRight)

-- Get the colors which are active on right, or left, but not both at the same time
exclusiveColors = bit.bxor(bCableLeft, bCableRight)

-- Get the colors that are not active on the left
offColorsA = bit.bnot(bCableLeft)
</pre>

==Colors==
Color constants include, in ascending bit order:

{| class="wikitable" width="200px"
! Color
! Decimal
! Hexadecimal
! Binary
|-
| colors.white
| align="right" | 1
| align="right" | 0x1
| align="right" | 0000000000000001
|-
| colors.orange
| align="right" | 2
| align="right" | 0x2
| align="right" | 0000000000000010
|-
| colors.magenta
| align="right" | 4
| align="right" | 0x4
| align="right" | 0000000000000100
|-
| colors.lightBlue
| align="right" | 8
| align="right" | 0x8
| align="right" | 0000000000001000
|-
| colors.yellow
| align="right" | 16
| align="right" | 0x10
| align="right" | 0000000000010000
|-
| colors.lime
| align="right" | 32
| align="right" | 0x20
| align="right" | 0000000000100000
|-
| colors.pink
| align="right" | 64
| align="right" | 0x40
| align="right" | 0000000001000000
|-
| colors.gray
| align="right" | 128
| align="right" | 0x80
| align="right" | 0000000010000000
|-
| colors.lightGray
| align="right" | 256
| align="right" | 0x100
| align="right" | 0000000100000000
|-
| colors.cyan
| align="right" | 512
| align="right" | 0x200
| align="right" | 0000001000000000
|-
| colors.purple
| align="right" | 1024
| align="right" | 0x400
| align="right" | 0000010000000000
|-
| colors.blue
| align="right" | 2048
| align="right" | 0x800
| align="right" | 0000100000000000
|-
| colors.brown
| align="right" | 4096
| align="right" | 0x1000
| align="right" | 0001000000000000
|-
| colors.green
| align="right" | 8192
| align="right" | 0x2000
| align="right" | 0010000000000000
|-
| colors.red
| align="right" | 16384
| align="right" | 0x4000
| align="right" | 0100000000000000
|-
| colors.black
| align="right" | 32768
| align="right" | 0x8000
| align="right" | 1000000000000000
|}
[[Category:APIs]]

Colors (API)

2012-09-17T18:45:39Z

MrBarry: /* Colors */

The Colors API allows you to mess with colored cable from the RedPower Mod. For the non-American English Version just replace 'color' with 'colour' and it will use the other API, colours, which is exactly the same, except in non-American English (e.g. gray is spelt grey and lightGray is spelt lightGrey).

==Methods==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[colors.combine]](color1, color2, …)
|Combines a set of colors (or sets of colors) into a larger set
|-
|[[colors.subtract]](colors, color1, color2, …)
|Removes one or more colors (or sets of colors) from an initial set
|-
|[[colors.test]](colors, color)
|Tests whether a given color (or set of colors) is contained within a set
|}

==Colors==
Color constants include, in ascending bit order:

{| class="wikitable" width="200px"
! Color
! Decimal
! Hexadecimal
! Binary
|-
| colors.white
| align="right" | 1
| align="right" | 0x1
| align="right" | 0000000000000001
|-
| colors.orange
| align="right" | 2
| align="right" | 0x2
| align="right" | 0000000000000010
|-
| colors.magenta
| align="right" | 4
| align="right" | 0x4
| align="right" | 0000000000000100
|-
| colors.lightBlue
| align="right" | 8
| align="right" | 0x8
| align="right" | 0000000000001000
|-
| colors.yellow
| align="right" | 16
| align="right" | 0x10
| align="right" | 0000000000010000
|-
| colors.lime
| align="right" | 32
| align="right" | 0x20
| align="right" | 0000000000100000
|-
| colors.pink
| align="right" | 64
| align="right" | 0x40
| align="right" | 0000000001000000
|-
| colors.gray
| align="right" | 128
| align="right" | 0x80
| align="right" | 0000000010000000
|-
| colors.lightGray
| align="right" | 256
| align="right" | 0x100
| align="right" | 0000000100000000
|-
| colors.cyan
| align="right" | 512
| align="right" | 0x200
| align="right" | 0000001000000000
|-
| colors.purple
| align="right" | 1024
| align="right" | 0x400
| align="right" | 0000010000000000
|-
| colors.blue
| align="right" | 2048
| align="right" | 0x800
| align="right" | 0000100000000000
|-
| colors.brown
| align="right" | 4096
| align="right" | 0x1000
| align="right" | 0001000000000000
|-
| colors.green
| align="right" | 8192
| align="right" | 0x2000
| align="right" | 0010000000000000
|-
| colors.red
| align="right" | 16384
| align="right" | 0x4000
| align="right" | 0100000000000000
|-
| colors.black
| align="right" | 32768
| align="right" | 0x8000
| align="right" | 1000000000000000
|}
[[Category:APIs]]

ComputerCraft Wiki - User contributions [en]

Colors (API)

Colors (API)