{"name":"BIS_fnc_animatePicture","operator":null,"title":"BIS fnc animatePicture","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_animatePicture","revid":336173,"updated":"2022-12-13T16:43:33Z","groups":["Systems"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.78"}],"since":{"game":"arma3","name":"Arma 3","version":"1.78"},"arma3_since":"1.78","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"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","since":null,"effect":null,"exec":null,"params":[{"name":"control","type":"Control","optional":false,"default":null,"description":"the control to be moved","types":["Control"],"since":null,"text":"control: Control - the control to be moved"},{"name":"durationOrSpeed","type":"Number","optional":true,"default":"2","description":"transition duration *or* movement speed, depending on *useDuration*","types":["Number"],"since":null,"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]","description":null,"types":["Array","Position2D"],"since":null,"text":"translationPosition: Array format Position2D - (Optional, default [0,0])"},{"name":"isRelativeTranslation","type":null,"optional":true,"default":"true","description":"Boolean -  is *translationPosition* relative to the original *control*'s position","types":[],"since":null,"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)","types":["Boolean"],"since":null,"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","types":["Number","Array"],"since":null,"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","types":["Boolean"],"since":null,"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\"","types":["String"],"since":null,"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","types":["Number"],"since":null,"text":"alpha: Number - (Optional, default 0) *control*'s final opacity"}],"returns":{"type":"Number","types":["Number"],"description":"animation's duration","text":"Number - 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;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":[],"notes":[],"categories":["Arma 3: Functions","Arma 3: New Functions","Function Group: Systems","Functions","Introduced with Arma 3 version 1.78"],"docblock":null,"filled_from_docblock":[]}