{"name":"camPreload","operator":null,"title":"camPreload","type":"command","url":"https://community.bistudio.com/wiki/camPreload","revid":369112,"updated":"2024-09-03T10:28:47Z","groups":["Camera Control"],"status":"ok","replaced_by":[],"games":[{"game":"arma1","name":"Armed Assault","version":"1.00"},{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma1","name":"Armed Assault","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Preloads the scene for the prepared camera with given timeout after which preloading is aborted. Max timeout is 30 seconds. Timeout of 0 means max timeout of 30 seconds as well. \n\n> [!NOTE]\n> This command will read prepared params set with camPrepareFOV, camPreparePos and camPrepareTarget, so no camCommitPrepared is necessary. If camPrepareFOV is not set, the default value is 1. If camPrepareTarget (for direction) and camPreparePos (for position) are not set, current direction and position of the camera are used. The prepared camera preload will preload main camera as well. cameraEffect is not necessary","syntaxes":[{"syntax":"camera camPreload timeout","since":null,"effect":null,"exec":null,"params":[{"name":"camera","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"camera: Object"},{"name":"timeout","type":"Number","optional":false,"default":null,"description":null,"types":["Number"],"since":null,"text":"timeout: Number"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"camera","types":["Object"]},"right":{"text":"timeout","types":["Number"]}}],"examples":[{"text":"```sqf\n_camera camPreload 5;\n```","code":["_camera camPreload 5;"]},{"text":"Preload camera around player to avoid stuttering on optics zooming:\n\n```sqf\n0 spawn \n{\n    _cam = \"camera\" camCreate (player selectionPosition \"camera\");\n    for \"_i\" from 0 to 359 do\n    {\n        _cam setDir _i;\n        _cam camPrepareFov 0.25;\n        _cam camPreload 0;\n        waitUntil { camPreloaded _cam };\n    };\n    camDestroy _cam;\n};\n```","code":["0 spawn \n{\n\t_cam = \"camera\" camCreate (player selectionPosition \"camera\");\n\tfor \"_i\" from 0 to 359 do\n\t{\n\t\t_cam setDir _i;\n\t\t_cam camPrepareFov 0.25;\n\t\t_cam camPreload 0;\n\t\twaitUntil { camPreloaded _cam };\n\t};\n\tcamDestroy _cam;\n};"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["camPreloaded","preloadCamera"],"notes":[],"categories":["ArmA: Armed Assault: New Scripting Commands","ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Camera Control","Introduced with Armed Assault version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}