ComputerCraft Wiki - User contributions [en]

Printer

2012-09-22T00:23:53Z

Samrg472:

The printer got added in the [[ComputerCraft]] 1.42 update. The printer is placed next to a computer, and allows for printing text onto paper with any color of ink.

== Recipe ==
{{Crafting grid
|A1=stone |B1=stone |C1=stone
|A2=stone |B2=redstone_dust |C2=stone
|A3=stone |B3=Ink_Sac |C3=stone
|Output=printer
}}
== Usage ==
To use a printer, place it adjacently but not diagonally next to a computer (left, right, top, bottom, front, or back side). Place any color ink in the single left slot, and paper in any of the top slots.

If you are using blocks to pull/insert items from the printer the diffrent slots are avaible from these sides:
Paper tray is accessible from: Top
Output paper tray is accessible from: Front or Bottom
Ink slot is accessible from: Back or Sides

[[File:PrinterGUI.png|thumb|256px|GUI of the Printer]]

==Methods==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|printer.[[printer.getPaperLevel|getPaperLevel]]()
|Returns the amount of paper avaible in the paper tray.
|-
|printer.[[printer.getCursorPos|getCursorPos]]()
|Returns the coordinates of the cursor on the paper, works the same way as [[term.getCursorPos()]]
|-
|printer.[[printer.getPageSize|getPageSize]]()
|Returns the size of the paper, works the same way as [[term.getSize()]]
|-
|printer.[[printer.getInkLevel|getInkLevel]]()
|Returns the amount of ink in the ink slot.
|-
|printer.[[printer.setCursorPos|setCursorPos]]( x, y )
|Sets the cursor pos.
|-
|printer.[[printer.newPage|newPage]]()
|Starts a new page. Returns true if page got started, false if not.
|-
|printer.[[printer.write|write]]( text )
|Writes text to the paper, works the same way as [[term.write()]]
|-
|printer.[[printer.setPageTitle|setPageTitle]]( text )
|Sets the title of the page.
|-
|printer.[[printer.endPage|endPage]]()
|Ends the page and prints the page to the output tray. Returns true if page was ended, false if not.
|}

[[Category:Blocks]]
[[Category:APIs]]

Printer

2012-09-22T00:23:16Z

Samrg472:

Main Page

2012-08-12T00:16:03Z

Samrg472: Undo revision 2595 by 92.76.162.42 (talk)

#redirect [[ComputerCraft Wiki - Home]]

Peripheral (API)

2012-07-28T13:26:21Z

Samrg472:

The peripheral API is for interacting with external [http://en.wikipedia.org/wiki/Peripheral peripherals], such as the disk drive and monitor. 
[[Console|Consoles]] and [[Turtle|Turtles]] are also considered peripherals and you can interface two adjacent computers, although in a more limited fashion compared to [[Rednet (API)|rednet]]. Both Computers and Turtles provide the same methods: ''turnOn'', ''shutdown'', ''reboot'', ''getID''.

==Methods==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="210px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[peripheral.isPresent]]( side )
|Returns '''true''' if a peripheral is present on ''side''.
|-
|[[peripheral.getType]]( side )
|Returns the type or peripheral present on ''side'', nothing returned if ''side'' is empty.
|-
|[[peripheral.getMethods]]( side )
|Returns a table containing all methods for peripheral on ''side''.
|-
|[[peripheral.call]]( side, methodName, param1, param2, ... )
|Sends a function call to peripheral located on ''side''. Return values match those of called method. 
'''Note:''' ''methodName'' is a string.
|-
|[[peripheral.wrap]]( side )
|Returns a handle to the peripheral located on ''side''. If assigned to a variable, it can be used to call all methods available from that peripheral, as if calling '''peripheral.call()''', e.g.: 
fdd = peripheral.wrap("left") 
fdd.someMethod() 
''- is the same as -'' 
peripheral.call("left","someMethod")
|}

==Events==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="210px"|Event name
!style="background:#EEE" width="*"|Description
!style="background:#EEE" width="*"|Parameters
|-
|peripheral
|Fired when peripheral is attached
|side
|-
|peripheral_detach
|Fired when peripheral is removed
|side
|}
==Monitor==
List of methods:

'''''mon'' stands for the variable you wrapped the monitor to.'''
''Example:'' mon = peripheral.wrap( "top" )

{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="210px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[mon.write|''mon''.write]]()
|Write to the Monitor's screen.
|-
|[[mon.scroll|''mon''.scroll]]( n )
|Scrolls the monitor screen.
|-
|[[mon.setCursorPos|''mon''.setCursorPos]]( x, y )
|Sets the cursor position on the Monitor.
|-
|[[mon.setCursorBlink|''mon''.setCursorBlink]]( b )
|Enables or disables cursor blinking.
|-
|[[mon.getCursorPos|''mon''.getCursorPos]]()
|Returns two arguments containing the x and the y position of the cursor on the Monitor.
|-
|[[mon.getSize|''mon''.getSize]]()
|Returns two arguments containing the x and the y values stating the size of the Monitor.
|-
|[[mon.clear|''mon''.clear]]()
|Clears the Monitor.
|-
|[[mon.clearLine|''mon''.clearLine]]( line )
|Clears the line the cursor is on.
|-
|[[mon.setTextScale|''mon''.setTextScale]]( scale )
|Sets the size of the text on the Monitor. Textscale can be between 0.5 and 5, with increments of 0.5.
|}
==Computers==
List of methods:

'''''computer'' stands for the variable you wrapped the computer to.'''
''Example:'' computer = peripheral.wrap( "top" )

{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="210px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[computer.turnOn|''computer''.turnOn]]()
|Turns on the Computer or Turtle.
|-
|[[computer.shutdown|''computer''.shutdown]]()
|Shuts off the Computer or Turtle.
|-
|[[computer.reboot|''computer''.reboot]]()
|Reboots the Computer or Turtle.
|-
|[[computer.getID|''computer''.getID]]()
|Gets the ID of the Computer or Turtle.
|}
[[Category:APIs]]

Fs.getSize

2012-07-09T15:41:25Z

Samrg472: Created page with "{{lowercase}} {{Function |name=fs.getSize |args=string path |returns=bytes |api=fs |desc=Gets the size of a file |examples= {{Example |desc=Get the size of t..."

{{lowercase}}
{{Function
|name=fs.getSize
|args=[[string (type)|string]] path
|returns=bytes
|api=fs
|desc=Gets the size of a file
|examples=
{{Example
|desc=Get the size of the shell from the ROM and print it
|code=print( fs.getSize("/rom/programs/shell") )
}}
}}

Fs (API)

2012-07-09T15:31:24Z

Samrg472:

The FS API allows you to mess around with the filesystem.

==Methods==
{| border="1" cellpadding="2" cellspacing="0"
!style="background:#EEE" width="200px"|Method name
!style="background:#EEE" width="*"|Description
|-
|[[fs.list]](path)
|Lists the directories and files in the given directory
|-
|[[fs.exists]](path)
|Checks if a path refers to an existing file or directory
|-
|[[fs.isDir]](path)
|Checks if a path refers to an existing directory
|-
|[[fs.isReadOnly]](path)
|Checks if a path is read-only (i.e. cannot be modified)
|-
|[[fs.getName]](path)
|Gets the final component of a pathname
|-
|[[fs.getDrive]](path)
|Gets the type of storage medium holding a file or directory
|-
|-
|[[fs.getSize]](path)
|Gets the size of a file and returns in bytes
|-
|[[fs.makeDir]](path)
|Makes a directory
|-
|[[fs.move]](fromPath, toPath)
|Moves a file or directory to a new location
|-
|[[fs.copy]](fromPath, toPath)
|Copies a file or directory to a new location
|-
|[[fs.delete]](path)
|Deletes a file or directory
|-
|[[fs.combine]](basePath, localPath)
|Combines two path components, returning a path consisting of the local path nested inside the base path
|-
|[[fs.open]](path, mode)
|Opens a file so it can be read or written
|}
[[Category:APIs]]

==Path Names==
All of these functions except for [[fs.combine]] refer solely to absolute paths. 
This means that the current working directory, as set by the <code>cd</code> command or the [[shell.setDir]] function, is ignored. Each path name consists of a list of nonempty path components separated by forward slashes, and those path components are taken one by one with the first being contained in the root directory of the computer.

If you need to deal with paths provided by the user that may be absolute or may be relative to the current working directory, use [[shell.resolve]].

Unlike most real-world operating systems, ComputerCraft's absolute path name system does not need to be started with a forward slash ( / ). Making the directory "a/b/c" is the same as making "/a/b/c". Leaving the slashes is just a matter of preference to the coder.

Os.version

2012-07-05T22:06:04Z

Samrg472:

{{lowercase}}
{{Function
|name=os.version
|returns=the version of the operating system of the Computer
|api=os
|addon=ComputerCraft
|desc=Returns the version of the OS the computer is running.
|examples=
{{Example
|desc=prints the version of the Computer's OS
|code=print( os.version() )
}}
}}