ComputerCraft Wiki - User contributions [en]

Monitor

2013-08-01T18:53:23Z

Sora the Hedgehog: Changed CCSensors reference to OpenCCSensors, seeing as OCCS is up to date.

{{Block
|name=Monitor
|image=Iso_Monitor.png
|id=4094
|damage-value=0
|is-peripheral=Yes
|peripheral-api=Term (API)
}}
The '''Monitor''' is a block that can display text on its front side. When several screen blocks are placed on the same plane, it will form a single monitor. The maximum size of a single monitor is 8 blocks wide and 6 blocks tall, and must be placed to be shaped as a rectangle, else it will separate into multiple parts. It is useful for displaying information at a server spawn, showing a program on the monitor, and even showing the status of an IC2 reactor! (provided you have [[OpenCCSensors]] installed)

==Recipe==
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=glass_pane |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Monitor
}}

==Redirecting Programs to a Monitor==
[[File:Computer_w_DiskDrive_w_Monitor.png|frame|428x241px|right|A 2x2 [[Monitor]], connected to a [[Computer]], with a [[Disk Drive]] connected.]]
From the CraftOS shell, type <tt>monitor [top|bottom|left|right|front|back] [a-program-name]</tt>. For example, typing <tt>monitor top hello</tt> would show "Hello world." on the top Monitor.

==Monitor as a Peripheral==
To use a Monitor, you need to either call a method directly using [[peripheral.call]](), or, wrap the monitor using the [[Peripheral_(API)|Peripheral API]]. Wrapped monitors provide all functions listed in the [[Term_(API)|Term API]], with the exception of [[Monitor.setTextScale|monitor.setTextScale(size)]], which is native to monitors only.

For this example, we have a Monitor connected to the top of our [[Computer]]:

-- Immediately invoke a method without wrapping
peripheral.call("top", "write", "Hello World!")

-- You can also "wrap" the peripheral side to a variable:
local monitor = peripheral.wrap("top")
monitor.write("Hello World!")

{{BlocksItemsList}}
[[Category:Blocks]][[Category:Peripherals]]

Monitor.setTextScale

2013-08-01T18:51:33Z

Sora the Hedgehog: Changed the pointed-to API to Term, removed TLC notice

{{lowercase}}
{{Function
|name=monitor.setTextScale
|args={{type|number}} scale
|api=Term
|addon=ComputerCraft
|desc=Sets the size of all text on the monitor. scale can be any multiple of 0.5, starting at 0.5 and ending at 5.
|examples=
{{Example
|desc=Sets the monitor's text scale to 2.
|code=monitor.setTextScale(2)
|output=none
}}
}}

[[Category:API_Functions]]

Term (API)

2013-08-01T18:50:17Z

Sora the Hedgehog: Added monitor.setTextScale() to the list, seeing as it's techincally a term API function.

The Terminal API provides functions for writing text to the terminal and monitors, and drawing ASCII graphics.

Methods in ''italics'' are available only to [[Advanced Computer|Advanced Computers]] and [[Advanced Monitor|Advanced Monitors]].
Methods in '''bold''' are available only to [[Monitor|Monitors]].

{{API table|Term|image=Grid disk.png|2=

{{API table/row|[[term.write]]({{type|string}} text)
|Writes ''text'' to the screen.|odd}}

{{API table/row|[[term.clear]]()
|Clears the entire screen}}

{{API table/row|[[term.clearLine]]()
|Clears the line the cursor is on|odd}}

{{API table/row|[[term.getCursorPos]]()
|Returns two arguments containing the x and the y position of the cursor.}}

{{API table/row|[[term.setCursorPos]]({{type|number}} x, {{type|number}} y)
|Sets the cursor's position.|odd}}

{{API table/row|[[term.setCursorBlink]]({{type|boolean}} bool)
|Disables the blinking or turns it on.}}

{{API table/row|[[term.isColor]]()
|Returns if the computer supports color. (Used to determine whether or not an [[Advanced Computer]] is being used)|odd}}

{{API table/row|[[term.getSize]]()
|Returns two arguments containing the x and the y values stating the size of the screen. (Good for if you're making something to be compatible with both [[Turtle]]s and [[Computer]]s.)}}

{{API table/row|[[term.scroll]]({{type|number}} n)
|Scrolls the terminal ''n'' lines.|odd}}

{{API table/row|[[term.redirect]](target)
|Redirects terminal output to a monitor or other redirect target. (Use [[peripheral.wrap]] to acquire a monitor "object".)}}

{{API table/row|[[term.restore]]()
|Restores terminal output to the previous target.|odd}}

{{API table/row|''[[term.setTextColor]]({{type|number}} [[Colors (API)|color]])''
|Sets the text color of the terminal. Available only to [[Advanced Computer|Advanced Computers]] and [[Advanced Monitor]]s.}}

{{API table/row|''[[term.setBackgroundColor]]({{type|number}} [[Colors (API)#Colors|color]])''
|Sets the background color of the terminal. Available only to [[Advanced Computer|Advanced Computers]] and [[Advanced Monitor]]s.|odd}}

{{API table/row|'''[[monitor.setTextScale]]({{type|number}} scale)'''
|Sets the text scale on a [[Monitor]].}}

}}

[[Category:APIs]]

Tutorials

2013-04-05T20:28:54Z

Sora the Hedgehog: /* External Tutorials/Guides */ Added PIL as a guide

As some tutorials might not be listed here, you can also browse the [[:Category:Tutorials|tutorials category]].

== Basic Tutorials ==
These tutorials are designed to be used in the order shown, each tutorial will build on the previous ones.
=== Introduction to Coding ===
*[[Hello_World_Tutorial|Hello World!]]
*[[Variables]]
*[[Conditional_statements|If, Then, Else]]
*[[Function (type)|Function]]
*[[Loops]]
*[[Tables]]

== Example Programs ==
These pages guide you through programs created by other users. They are not necessarily well-coded, but can be useful as a loose guide.

=== Programming & Wiring ===
*[[Guess_The_Number_(tutorial)|Guess the Number]]
*[[Making_a_Password_Protected_Door|Password Protected Door]]
*[[Making_an_API_(tutorial)|Programming an API]]
*[[Startup|Running script automatically at boot with Startup]]
*[[Raw key events| Detecting specific keys (such as the arrow keys)]]
*[[Receiving a rednet message through os.pullEvent()|Receiving a rednet message through os.pullEvent()]]
*[[Calculator Tutorial]]
*[[Rednet Tutorial]].

=== Turtles ===
The nice little robots that do the hard work for you.
*[[Turtle_Tutorial|Turtles!]]
*[[Turtle_Lumberjack_(tutorial)|Turtle Lumberjack]]
*[[Advanced_Turtle_Lumberjack_(tutorial)|Advanced Turtle Lumberjack]]
*[[Cobble_Generator|Cobblestone Generator]]
*[[Turtle_Stairbuilder_(tutorial)|Turtle Stairbuilder]]

== External Tutorials/Guides ==
*[http://www.minecraftforum.net/topic/907632-mod-tutorial-computercraft-v12-very-basic-lua-tutorial-updated-1112/page__p__11556908#entry11556908 Onionnion's Basic Lua Tutorial]
*[http://www.computercraft.info/forums2/index.php?/topic/1516-ospullevent-what-is-it-and-how-is-it-useful/page__view__findpost__p__11156 Onionnion's os.pullEvent() Guide]
*[http://wiki.roblox.com/ Roblox Wiki (Has tutorials on Lua)]
*[http://www.lua.org/pil/contents.html Programming in Lua, a general purpose guidebook written by a programmer that writes the Lua interpreter]

[[Category:Tutorials]]

Talk:Login with Roaming Profiles

2013-04-05T20:20:29Z

Sora the Hedgehog:

Does not work. Not authorised

== Not the best tutorial ==

And by that, I mean that this program isn't conceptually simple enough.
We should make room for other tutorials that are simpler to understand.
Hopefully that will stop the flood of lock programs, as that is the
only tutorial on the wiki that is simple enough for new programmers to
follow.

[[User:Sora the Hedgehog|Sora the Hedgehog]] 00:20, 6 April 2013 (MSK)

== Should be posted in "Programs" instead? ==

My argument is that this does not belong on the wiki. My reason is: we have forums for this. That simple.

Just wanted to make a quick note here -

if validSender then
for i,v in ipairs(users) do
if message == v then
password = passwords[i]
valid = true
else
valid = false
end
end

That section of code is why it doesn't work - after the 'valid = true', there needs to be a 'break' or it will continue to iterate.

if validSender then
for i,v in ipairs(users) do
if message == v then
password = passwords[i]
valid = true
break
else
valid = false
end
end

Wireless Modem

2013-04-05T20:11:18Z

Sora the Hedgehog: Changed the first example to use the Modem API rather than the Rednet API

{{NeedsWork|The behaviour of Rednet has changed as of 1.5 - please consider updating this page with information. (Please don't add prerelease info!)}}
:''This page is for the Modem blocks. For the modem API, see [[Modem_(API)|Modem (API)]]''
{{Block
|name=Modem
|image=WirelessModem.png
|id=4094
|damage-value=1
|is-peripheral=Yes
|peripheral-api=Modem (API)
}}
Modems are blocks which can be used to wirelessly transfer data between [[Computer|computers]] and [[Turtle|turtles]], using the [[Rednet_(API)|Rednet API]] or the [[Modem_(API)|Modem API]].
To place a modem on a side of a computer, right-click to place the modem while sneaking.

It is also possible to turn the modem on and off by typing "rednet.open ( side )" to open and "rednet.close ( side )" to close.

Modems can send messages to other modems located up to 64 meters away, or 16 meters during a thunderstorm.
As of 1.4 Modem range is increased with higher altitudes. If there is no thunderstorm, the range will always be higher than 64, and at max altitude you would have a range of 384 meters.

In 1.4 and 1.41 there is a miscalculation that causes the range to only be 381 meters at max altitude.

== Recipe ==
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=ender_pearl |C2=stone
|A3=stone |B3=stone |C3=stone
|Output=Modem
}}

== Example (Modem API)==
* Place 2 computers and add modems to them by clicking the right mouse button while sneaking.
* Access them, and start Lua.
* Once Lua has started, wrap your modem using peripheral.wrap() (something like "modem = peripheral.wrap("<side of modem>")
* Type "[[modem_(API)|modem.open]] (<A modem port number, anything from 1 to 65535>)" on one computer.
* Check if there exists a connection: a dim, red light should be found on the modem.
* Now, type "[[modem_(API)|modem.transmit]] (<Same number as above>, <Also the same number>, 'Your message')" on the other computer. This should send your message to all computers connected.
* Opening the first computer should show the message written on the second computer.

==Modem as a Peripheral==
To use a Modem as a peripheral, you need to either call a method directly using [[peripheral.call]](), or, wrap the modem using the [[Peripheral_(API)|Peripheral API]]. Wrapped modems provide all functions listed in the [[Modem_(API)|Modem API]].

For this example, we have a Modem connected to the top of our [[Computer]], we are going to open channel 5:

-- Immediately invoke a method without wrapping
peripheral.call("top", "open",5)

-- You can also "wrap" the peripheral side to a variable:
local modem = peripheral.wrap("top")
modem.open(5)

[[Category:Peripherals]]