mirror of
https://github.com/Creators-of-Create/Create.git
synced 2024-11-10 20:45:10 +01:00
fac1ebcd3f
- Lua documentation has been added for all peripherals except the train station (not looking forward to writing that one) - This documentation will be added to the GitHub wiki pages
89 lines
3.1 KiB
Markdown
89 lines
3.1 KiB
Markdown
| Method | Description |
|
|
|---------------------------------------|------------------------------------------------------|
|
|
| [`setCursorPos(x, y)`](#setCursorPos) | Sets the cursor position |
|
|
| [`getCursorPos()`](#getCursorPos) | Gets the current cursor position |
|
|
| [`getSize()`](#getSize) | Gets the display size of the connected target |
|
|
| [`isColor()`](#isColor) | Whether the connected display target colors |
|
|
| [`isColour()`](#isColour) | Whether the connected display target supports colours |
|
|
| [`write(text)`](#writetext) | Writes text at the current cursor position |
|
|
| [`clearLine()`](#clearLine) | Clears the line at the current cursor position |
|
|
| [`clear()`](#clear) | Clears the whole display |
|
|
| [`update()`](#update) | Pushes an update to the display target |
|
|
|
|
---
|
|
### `setCursorPos(x, y)`
|
|
Sets the cursor position. Can be outside the bounds of the connected display.
|
|
|
|
**Parameters**
|
|
- _x:_ `number` The cursor x position
|
|
- _y:_ `number` The cursor y position
|
|
|
|
---
|
|
### `getCursorPos()`
|
|
Gets the current cursor position.
|
|
|
|
**Returns**
|
|
- `number` The cursor x position
|
|
- `number` The cursor y position
|
|
|
|
---
|
|
### `getSize()`
|
|
Gets the size of the connected display target
|
|
|
|
**Returns**
|
|
- `number` The width of the display
|
|
- `number` The height of the display
|
|
|
|
---
|
|
### `isColor()`
|
|
Checks whether the connected display target supports color
|
|
|
|
**Returns**
|
|
- `boolean` Whether the display support color
|
|
|
|
---
|
|
### `isColour()`
|
|
Checks whether the connected display target supports colour
|
|
|
|
**Returns**
|
|
- `boolean` Whether the display support colour
|
|
|
|
---
|
|
### `write(text)`
|
|
Writes text at the current cursor position, moving the cursor to the end of the text.
|
|
This only writes to an internal buffer. For the changes to show up on the display [`update()`](#update) must be used.
|
|
If the cursor is outside the bounds of the connected display the text will not show up on the display.
|
|
|
|
This will overwrite any text currently at cursor position.
|
|
|
|
**Parameters**
|
|
- _text:_ `string` Text to write.
|
|
|
|
**See also**
|
|
- [`update()`](#update) To push the changes to the display target.
|
|
|
|
---
|
|
### `clearLine()`
|
|
Clears the line at the current cursor position.
|
|
|
|
**See also**
|
|
- [`update()`](#update) To push the changes to the display target.
|
|
|
|
---
|
|
### `clear()`
|
|
Clears the whole display.
|
|
|
|
**See also**
|
|
- [`update()`](#update) To push the changes to the display target.
|
|
|
|
---
|
|
### `update()`
|
|
Pushes any changes to the connected display target.
|
|
Any changes made are only made to an internal buffer.
|
|
For them to show up on the display they must be pushed to the display using this function.
|
|
This allows for this peripheral to be better multithreaded and for users to be able to change multiple lines at once by
|
|
using multiple [`write(text)`](#writetext) calls and then one [`update()`](#update) call.
|
|
|
|
**See also**
|
|
- [`write(text)`](#writetext) To write text to the display target.
|