Bomb Bloke at 12:31, 9 April 2014

2014-04-09T12:31:36Z

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=window.redraw |args= |returns=None |api=term |addon=ComputerCraft |desc=A function available to window-based terminal objects cre..."

2014-04-08T10:53:31Z

Created page with "{{lowercase}} {{Function |name=window.redraw |args= |returns=None |api=term |addon=ComputerCraft |desc=A function available to window-based terminal objects cre..."

New page

{{lowercase}}
{{Function
|name=window.redraw
|args=
|returns=None
|api=term
|addon=ComputerCraft
|desc=A function available to window-based [[term (API)|terminal objects]] created via the [[window (API)|window API]], which re-renders everything that has been rendered via the window in concern (assuming it is [[window.setVisible|visible]]). This includes content rendered via child windows.

Generally this is handy if one window has written content over the top of the top of another (of which it is ''not'' a child), and you wish to bring the content of the covered window back to the fore-front of your display.

You need not call this function when simply making a window [[window.setVisible|visible]] or when [[window.reposition|moving / resizing]] it; these actions perform automatic redraws.
|examples=
{{Example
|desc=Draws a checkerboard pattern in a large window, then bounces a smaller window over the top of it, without needing to manually reconstruct the areas rendered over (Ctrl + T to exit):
|code= local xSize, ySize = term.getSize()

-- Draw a checkerboard pattern in a window that covers the screen:
local checkerWindow = window.create(term.current(), 1, 1, xSize, ySize)
for i=1,ySize do
checkerWindow.setCursorPos(1,i)
for j=1,xSize do
checkerWindow.setBackgroundColor(bit.band(i+j,1) == 1 and colours.white or colours.black)
checkerWindow.write(" ")
end
end

-- Define a small window at the top left of the display:
local smallWindow = window.create(term.current(), 1, 1, 5, 1)
smallWindow.write("BOING")

-- Bounce the small window around the screen:
local xDir, yDir, xPos, yPos = 1, 1, 1, 1

while true do
sleep(0.5)

xPos = xPos + xDir
yPos = yPos + yDir

checkerWindow.redraw()
smallWindow.reposition(xPos, yPos)

if xPos == 1 then xDir = 1 end
if yPos == 1 then yDir = 1 end
if xPos == xSize - 4 then xDir = -1 end
if yPos == ySize then yDir = -1 end
end
}}
}}

[[Category:API_Functions]]

@@ Line 10: / Line 10: @@
 Generally this is handy if one window has written content over the top of the top of another (of which it is ''not'' a child), and you wish to bring the content of the covered window back to the fore-front of your display.
-You need not call this function when simply making a window [[window.setVisible|visible]] or when [[window.reposition|moving / resizing]] it; these actions perform automatic redraws.
+You need not call this function when simply making a window [[window.setVisible|visible]] or when [[window.reposition|moving / resizing]] it; they call it automatically. Redrawing a window also [[window.restoreCursor|restores its cursor]].
 |examples=
 {{Example

Window.redraw - Revision history

Bomb Bloke at 12:31, 9 April 2014

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=window.redraw |args= |returns=None |api=term |addon=ComputerCraft |desc=A function available to window-based terminal objects cre..."