Window.reposition - Revision history

Bomb Bloke at 10:41, 7 April 2014

2014-04-07T10:41:33Z

Bomb Bloke at 10:38, 7 April 2014

2014-04-07T10:38:55Z

Bomb Bloke: Created page with "{{lowercase}} {{Function |name=window.reposition |args={{type|number}} xPosition, {{type|number}} yPosition [, {{type|number}} width, {{type|number}} height] |returns..."

2014-04-07T10:37:39Z

Created page with "{{lowercase}} {{Function |name=window.reposition |args={{type|number}} xPosition, {{type|number}} yPosition [<nowiki/>, {{type|number}} width, {{type|number}} height] |returns..."

New page

{{lowercase}}
{{Function
|name=window.reposition
|args={{type|number}} xPosition, {{type|number}} yPosition [<nowiki/>, {{type|number}} width, {{type|number}} height]
|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 moves and / or resizes the window in concern.

If [[window.setVisible|visible]], the window will be automatically re-rendered, however the parent terminal object won't be (meaning "ghost" images of the window's previous shape / location may be left behind unless you manually clear them).

If shrinking a window will result in some of its contents being cropped from view, then that content will be removed from the window's buffer and will ''not'' be restored if you later re-enlarge it. If a new width / height is not specified then the window will retain its previous dimensions.

See also: [[window.getPosition|window.getPosition()]]
|examples=
{{Example
|desc=Stretches and bounces a small window filled with white around the display.
|code= local xSize, ySize = term.getSize()
local xPos, yPos, xLen, yLen = math.random(xSize-5), math.random(ySize-5), math.random(5), math.random(5)
local xDir, yDir, xLenDir, yLenDir = 1, 1, 1, 1

local smallWindow = window.create(term.current(), xPos, yPos, xLen, yLen)
smallWindow.setBackgroundColor(colours.white)

while true do
sleep(0.2)

xPos = xPos + xDir
yPos = yPos + yDir
xLen = xLen + xLenDir
yLen = yLen + yLenDir

term.setBackgroundColor(colours.black)
term.clear()
smallWindow.reposition(xPos, yPos, xLen, yLen)
smallWindow.clear()

if xPos <= 1 then xDir = 1 end
if xPos + xLen >= xSize + 1 then xDir = -1 end

if yPos <= 1 then yDir = 1 end
if yPos + yLen >= ySize + 1 then yDir = -1 end

if xLen <= 1 then xLenDir = 1 end
if xLen >= 5 then xLenDir = -1 end

if yLen <= 1 then yLenDir = 1 end
if yLen >= 5 then yLenDir = -1 end
end
}}
}}

[[Category:API_Functions]]

@@ Line 15: / Line 15: @@
 |examples=
 {{Example
-|desc=Stretches and bounces a small window filled with white around the display.
+|desc=Stretches and bounces a small window filled with white around the display until terminated (Ctrl + T).
 |code= local xSize, ySize = term.getSize()
   local xPos, yPos, xLen, yLen = math.random(xSize-5), math.random(ySize-5), math.random(5), math.random(5)

@@ Line 12: / Line 12: @@
 If shrinking a window will result in some of its contents being cropped from view, then that content will be removed from the window's buffer and will ''not'' be restored if you later re-enlarge it. If a new width / height is not specified then the window will retain its previous dimensions.
-See also: [[window.getPosition|window.getPosition()]]
+See also: [[window.getPosition|window.getPosition()]], [[term.getSize|term.getSize()]]
 |examples=
 {{Example