adjustPosition

API -

return function()
    local app = getApp();
    local myObject = app.createObject();
    wait(3);
    
    local pos = app.convertPercentToPosition(0, 0.5);
    myObject.setPosition(pos.x, pos.y); 
    --places the object in the center-left of the screen
    local speed = 5;
    while true do
        local deltaTime = yield(); --deltaTime is seconds between frames.
        pos = myObject.getPosition();
        
        if pos.x > 500 then
            yieldBreak();
        end
        
        myObject.adjustPosition(deltaTime * speed, 0); 
        --moves the object to the right by 5units per second.
    end
    
    --as soon as the script ends the object will be destroyed automatically.
    keepAlive();
end