Difference between revisions of "Redstone Input Port"

From WebDisplays
Jump to: navigation, search
(Recipe)
 
(5 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
The Redstone Input Port is an [[Screen#Upgrades|upgrade]] which allows web pages to read the redstone levels around the screen.
 
The Redstone Input Port is an [[Screen#Upgrades|upgrade]] which allows web pages to read the redstone levels around the screen.
 +
 +
{{#widget:AdSense}}
  
 
==Recipe==
 
==Recipe==
[[File:Redinput.png]]
+
[[File:Upgrade redin.png]]
  
 
The item on the left is a [[Blank Upgrade]].
 
The item on the left is a [[Blank Upgrade]].
 +
 +
==How to use==
 +
Like any other upgrades, install it by right-clicking on a screen with the upgrade in your main hand. You will need the "Link & upgrade" permission to do that.
  
 
==JavaScript==
 
==JavaScript==
The upgrade name returned by <code>GetUpgrades</code> is <code>webdisplays:redinput</code>.
+
* The upgrade name returned by <code>GetUpgrades</code> is <code>webdisplays:redinput</code>
 
+
* If this upgrade is used in combination with the [[Redstone Output Port]] upgrade, the redstone level obtained by any of these queries/callbacks on an emitting block is undefined
If this upgrade is used in combination with the [[Redstone Output Port]] upgrade, the redstone level obtained by any of these functions/callbacks on an emitting block is undefined.
+
* For more information on how to use these queries, check out [[Screen#JavaScript]]
  
===Functions===
+
===Queries===
This upgrade adds the following functions:
+
This upgrade adds the following queries:
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 23: Line 28:
 
|GetRedstoneAt||int, int||<code>{"level":int}</code>||0, 0 is the bottom left block. Rotation is not handled.
 
|GetRedstoneAt||int, int||<code>{"level":int}</code>||0, 0 is the bottom left block. Rotation is not handled.
 
|-
 
|-
|GetRedstoneArray||None||<code>{"levels":[int]}</code>||The block x, y is at <code>levels[y * width + x]</code>
+
|GetRedstoneArray||None||<code>{"levels":[int]}</code>||The level of the block at (x, y) is at index <code>y * width + x</code>
 
|}
 
|}
  

Latest revision as of 08:09, 14 February 2018

The Redstone Input Port is an upgrade which allows web pages to read the redstone levels around the screen.

Recipe

Upgrade redin.png

The item on the left is a Blank Upgrade.

How to use

Like any other upgrades, install it by right-clicking on a screen with the upgrade in your main hand. You will need the "Link & upgrade" permission to do that.

JavaScript

  • The upgrade name returned by GetUpgrades is webdisplays:redinput
  • If this upgrade is used in combination with the Redstone Output Port upgrade, the redstone level obtained by any of these queries/callbacks on an emitting block is undefined
  • For more information on how to use these queries, check out Screen#JavaScript

Queries

This upgrade adds the following queries:

Query name Arguments Return value Comment
GetRedstoneAt int, int {"level":int} 0, 0 is the bottom left block. Rotation is not handled.
GetRedstoneArray None {"levels":[int]} The level of the block at (x, y) is at index y * width + x

Callbacks

This upgrade adds the following callbacks:

  • webdisplaysRedstoneCallback(x, y, level) will be called if the redstone level of the block at x, y has changed.