Difference between revisions of "Monitor"

From ComputerCraft Wiki
Jump to: navigation, search
(I think this is what "damage value: un-used" actually means.)
m (→‎Recipe)
 
(13 intermediate revisions by 10 users not shown)
Line 2: Line 2:
 
|name=Monitor
 
|name=Monitor
 
|image=Iso_Monitor.png
 
|image=Iso_Monitor.png
−
|id=4094
+
|id=ComputerCraft:CC-Peripheral
−
|damage-value=0
+
|damage-value=2
 
|is-peripheral=Yes
 
|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. 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 [[CcSensors]] installed)
+
{{Selfref|This article is about the monitor block. For the monitor's API, see [[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. By default, a monitor has a [[resolution]] of 7 pixels horizontally by 5 pixels horizontally, but this can be increased by using the monitor API and combining monitors (see explanation on the [[resolution]] page). 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 ==
−
{{Crafting grid
+
{{Crafting
 
  |A1=stone |B1=stone      |C1=stone
 
  |A1=stone |B1=stone      |C1=stone
−
  |A2=stone |B2=glass_pane |C2=stone
+
  |A2=stone |B2=glass pane |C2=stone
 
  |A3=stone |B3=stone      |C3=stone
 
  |A3=stone |B3=stone      |C3=stone
 
  |Output=Monitor
 
  |Output=Monitor
−
}}
+
}}
−
[[Category:Blocks]]
+
  
−
==Using the 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.]]
+
[[File:Computer_w_DiskDrive_w_Monitor.png|thumb|right|A 2x2 [[Monitor]], connected to a [[Computer]], with a [[Disk Drive]] connected.]]
−
The command used to control a monitor: monitor [top, bottom, left, right, front or back] [the name of the command to display]
+
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.
  
−
So, in this case, if you typed "hello" in the name of the program part, the monitor would display "Hello World!".
+
== 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.
  
−
==Using the Monitor within the Lua interface==
+
For this example, we have a Monitor connected to the top of our [[Computer]]:
−
The monitor can be summoned through a command or through coding with the Lua command.
+
  
−
The command used to control a monitor within the Lua interface: shell.run("monitor" "[top, bottom, left, right, front or back]" "[the name of the command to display]")
+
''-- Immediately invoke a method without wrapping''
 +
[[peripheral.call]]( "top", "write", "Hello World!" )
  
−
For example, here is a way of summoning the monitor through a command:
+
''-- You can also "wrap" the peripheral side to a variable:''
 +
local monitor = [[peripheral.wrap]]( "top" )
 +
[[term.write|monitor.write]]( "Hello World!" )
  
−
<tt>[[print]]("Hello Monitor!")
+
== History ==
 +
{{History|head}}
 +
{{History|1.31|Added Monitors.}}
 +
{{History|1.51|Event <code>monitor_resize</code> is send when rezising the monitor.}}
 +
{{History|1.53|Can now be placed on floors and ceilings.}}
 +
{{History|1.55|Tweaked screen colours.}}
 +
{{History|1.75|Fixed rendering.}}
 +
{{History|foot}}
  
−
[[Shell (API)|shell]].[[Shell.run|run]]("monitor", "right", "hello")</tt>
+
{{BlocksItemsList}}
  
−
== Peripheral Functions ==
+
[[Category:Blocks]]
−
'''''monitor'' stands for the variable you wrapped the monitor to.'''
+
[[Category:Peripherals]]
−
''Example:'' monitor = peripheral.wrap( "top" )
+
−
 
+
−
Methods in ''italic'' are available on [[Advanced Monitor|Advanced Monitors]] only.
+
−
 
+
−
{| class="wikitable"
+
−
!style="background:#EEE" width="210px"|Method name
+
−
!style="background:#EEE" width="*"|Description
+
−
|-
+
−
|[[term.write|monitor.write]]()
+
−
|Write to the Monitor's screen.
+
−
|-
+
−
|[[term.scroll|monitor.scroll]](n)
+
−
|Scrolls the monitor screen.
+
−
|-
+
−
|[[term.setCursorPos|monitor.setCursorPos]](x, y)
+
−
|Sets the cursor position on the Monitor.
+
−
|-
+
−
|[[term.setCursorBlink|monitor.setCursorBlink]](b)
+
−
|Enables or disables cursor blinking.
+
−
|-
+
−
|[[term.getCursorPos|monitor.getCursorPos]]()
+
−
|Returns two arguments containing the x and the y position of the cursor on the Monitor.
+
−
|-
+
−
|[[term.getSize|monitor.getSize]]()
+
−
|Returns two arguments containing the x and the y values stating the size of the Monitor.
+
−
|-
+
−
|[[term.clear|monitor.clear]]()
+
−
|Clears the Monitor.
+
−
|-
+
−
|[[term.clearLine|monitor.clearLine]]()
+
−
|Clears the line the cursor is on.
+
−
|-
+
−
|[[monitor.setTextScale|monitor.setTextScale]](scale)
+
−
|Sets the size of the text on the Monitor. Textscale can be between 0.5 and 5.0, with increments of 0.5
+
−
|-
+
−
|''[[term.setTextColor|monitor.setTextColor]]([[colors (API)#colors|color]])''
+
−
|Sets the text-color of the [[Advanced Monitor]]. Available only to [[Advanced Monitor|Advanced Monitors]]
+
−
|-
+
−
|''[[term.setBackgroundColor|monitor.setBackgroundColor]]([[colors (API)#colors|color]])''
+
−
|Sets the background-color of the [[Advanced Monitor]]. Available only to [[Advanced Monitor|Advanced Monitors]]
+
−
|}
+
−
 
+
−
[[Category:Blocks]][[Category:Peripherals]]
+

Latest revision as of 05:59, 4 August 2020

Grid workbench.png   Monitor
Iso Monitor.png
Item ID ComputerCraft:CC-Peripheral
Damage Value 2
Peripheral? Yes- Term (API)
Is this the page you were looking for?
This article is about the monitor block. For the monitor's API, see 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. By default, a monitor has a resolution of 7 pixels horizontally by 5 pixels horizontally, but this can be increased by using the monitor API and combining monitors (see explanation on the resolution page). 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)

Crafting

Empty-crafting-table.png
Grid stone.png
Grid stone.png
Grid stone.png
Grid stone.png
Grid glass pane.png
Grid stone.png
Grid Monitor.png
Grid stone.png
Grid stone.png
Grid stone.png

Redirecting Programs to a Monitor

A 2x2 Monitor, connected to a Computer, with a Disk Drive connected.

From the CraftOS shell, type monitor [top|bottom|left|right|front|back] [a-program-name]. For example, typing monitor top hello 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. Wrapped monitors provide all functions listed in the Term API, with the exception of 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!" )

History

1.31Added Monitors.
1.51Event monitor_resize is send when rezising the monitor.
1.53Can now be placed on floors and ceilings.
1.55Tweaked screen colours.
1.75Fixed rendering.
Grid Redstone.pngComputerCraft Blocks and Items
Grid paper.png  Blocks
 Iso Computer.png  Computer Iso Advanced Computer.png  Advanced Computer Iso Command Computer.png  Command Computer Iso DiskDrive.png  Disk Drive
 Iso Monitor.png  Monitor Iso Advanced Monitor.png  Advanced Monitor Iso Printer.png  Printer Grid turtle.png  Turtle
 Grid Modem.png  Wireless Modem Grid Ender Modem.png  Ender Modem Grid Wired Modem.png  Wired Modem Grid Networking Cable.png  Networking Cable
Grid paper.png  Items
 Grid Pocket Computer.png  Pocket Computer Grid Advanced Pocket Computer.png  Advanced Pocket Computer Grid disk.png  Floppy Disk Grid printed page.png  Printed Page
 Grid printed pages.png  Printed Pages Grid printed book .png  Printed Book
Retrieved from "https://www.computercraft.info/wiki/index.php?title=Monitor&oldid=7632"