{"name":"BIS_fnc_animatePicture","title":"BIS fnc animatePicture","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_animatePicture","revid":379489,"updated":"2026-10-31T00:25:34Z","groups":["Systems"],"status":"ok","games":{"arma3":"1.78"},"since":"arma3 1.78","arma3_since":"1.78","description":"Translates (relative or absolute), scales (relative or absolute), and sets the alpha over time on the provided control.","syntaxes":[{"syntax":"[control, durationOrSpeed, [translationPosition, isRelativeTranslation, useDuration], [scalePosition, isRelativeScale, scalePivot], alpha] call BIS_fnc_animatePicture","params":[{"name":"control","type":"Control","description":"the control to be moved","type_expr":"Control"},{"name":"durationOrSpeed","type":"Number","optional":true,"default":"2","description":"transition duration *or* movement speed, depending on *useDuration*","type_expr":"Number","text":"durationOrSpeed: Number - (Optional, default 2) transition duration *or* movement speed, depending on *useDuration*"},{"name":"translationPosition","type":"Array format Position2D","optional":true,"default":"[0,0]","type_expr":"Position2D","types":["Array","Position2D"],"text":"translationPosition: Array format Position2D - (Optional, default [0,0])"},{"name":"isRelativeTranslation","type":"Boolean","optional":true,"default":"true","description":"is *translationPosition* relative to the original *control*'s position","type_expr":"Boolean","text":"isRelativeTranslation: Boolean - (Optional, default true) is *translationPosition* relative to the original *control*'s position"},{"name":"useDuration","type":"Boolean","optional":true,"default":"true","description":"if set to false, *durationOrSpeed* will be used as *control* speed (and effect duration will be recalculated from it)","type_expr":"Boolean","text":"useDuration: Boolean - (Optional, default true) if set to false, *durationOrSpeed* will be used as *control* speed (and effect duration will be recalculated from it)"},{"name":"scalePosition","type":"Number or Array of Numbers","optional":true,"default":"1","description":"define X and Y scale value","type_expr":"Number | Array<Number>","text":"scalePosition: Number or Array of Numbers - (Optional, default 1) define X and Y scale value"},{"name":"isRelativeScale","type":"Boolean","optional":true,"default":"true","description":"is *scalePosition* relative to the original *control*'s scale","type_expr":"Boolean","text":"isRelativeScale: Boolean - (Optional, default true) is *scalePosition* relative to the original *control*'s scale"},{"name":"scalePivot","type":"String","optional":true,"default":"\"center\"","description":"case-**in**sensitive. Possible values:\n\n- \"topLeft\"\n- \"topCenter\"\n- \"topRight\"\n- \"centerLeft\"\n- \"center\" - fallback value\n- \"centerRight\"\n- \"bottomLeft\"\n- \"bottomCenter\"\n- \"bottomRight\"","type_expr":"String","text":"scalePivot: String - (Optional, default \"center\") case-**in**sensitive. Possible values:\n\n- \"topLeft\"\n- \"topCenter\"\n- \"topRight\"\n- \"centerLeft\"\n- \"center\" - fallback value\n- \"centerRight\"\n- \"bottomLeft\"\n- \"bottomCenter\"\n- \"bottomRight\""},{"name":"alpha","type":"Number","optional":true,"default":"0","description":"*control*'s final opacity","type_expr":"Number","text":"alpha: Number - (Optional, default 0) *control*'s final opacity"}],"returns":{"type":"Number","type_expr":"Number","description":"animation's duration"}}],"examples":[{"text":"```sqf\nprivate _t =\n[\n    _controlFront,\n    1,\n    [[0.5, 0.5], true, false],\n    [],\n    0.5\n]\ncall BIS_fnc_animatePicture;\n```","code":["private _t =\n[\n\t_controlFront,\n\t1,\n\t[[0.5, 0.5], true, false],\n\t[],\n\t0.5\n] \ncall BIS_fnc_animatePicture;"]}]}