object:getPosition()

类型 函数
返回值 数字
修订 版本 2024.3703
关键词 动画, 补间动画, 插值, getPosition
另请参阅 object:setPosition()
animation.setPosition()
补间动画
animation.*

概述

object:getPosition() 方法返回补间动画的位置，单位为毫秒。

注意

此值可能大于补间动画的持续时间，实质上表示它已完成。如有必要，可以通过向方法调用传递 true 将返回值约束在 0 到补间动画持续时间之间的范围内 — 详见下文。

语法

object:getPosition( [getClipped] )
getClipped （可选）

布尔值。 如果为 true，则返回值将介于 0 和补间动画的持续时间之间。默认为 false。

示例

local object1 = display.newRect( 50, 50, 100, 100 )

-- Move the object
local newTween = animation.to( object1, { x=150, y=400 }, { time=5000 } )

-- Sometime later, pause the tween
newTween:pause()

-- Check the tween position
local currentPosition = newTween:getPosition()
print( currentPosition )