{"name":"elevatePeriscope","title":"elevatePeriscope","type":"command","url":"https://community.bistudio.com/wiki/elevatePeriscope","revid":377904,"updated":"2026-01-05T18:01:10Z","groups":["Object Manipulation","Animations"],"status":"ok","games":{"arma3":"2.00"},"since":"arma3 2.00","arma3_since":"2.00","description":"Elevates periscope of a vehicle. Vehicles in Arma 3 which are compatible with this tech are Strider, remote laser designators, the robot arm on Eddie, etc.\nPlease note that SDV submarine has a different periscope, which is just an animated selection and could be raised and lowered with animate command.\n\n> [!NOTE]\n> - a user can immediately override any elevation in progress by using assigned keyboard keys. To block user input see the *blockUserInput* parameter.\n> - a PeriscopeElevationChanged entity event handler is also provided.","syntaxes":[{"syntax":"vehicle elevatePeriscope [turret, elevation, speed, blockUserInput]","params":[{"name":"vehicle","type":"Object","description":"vehicle with periscope tech","type_expr":"Object"},{"name":"turret","type":"Turret Path","description":"turret on which periscope is located","type_expr":"Turret Path"},{"name":"elevation","type":"Number","description":"elevation range 0..1","type_expr":"Number"},{"name":"speed","type":"Number or Boolean","optional":true,"default":"-1","description":"config anim speed multiplier, 2 - twice as fast, 0.5 - twice as slow, etc. -1 - default config speed. If true is used as param, the change in elevation is almost instant","type_expr":"Number | Boolean","text":"speed: Number or Boolean - (Optional, default -1) config anim speed multiplier, 2 - twice as fast, 0.5 - twice as slow, etc. -1 - default config speed. If true is used as param, the change in elevation is almost instant"},{"name":"blockUserInput","type":"Boolean","optional":true,"default":"false","description":"true to disable user ability to control periscope with keyboard. The change is persistent unless set to false again","type_expr":"Boolean","text":"blockUserInput: Boolean - (Optional, default false) true to disable user ability to control periscope with keyboard. The change is persistent unless set to false again"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"vehicle"},"right":{"text":"[turret, elevation, speed, blockUserInput]"}}],"examples":[{"code":["_eddie elevatePeriscope [[0], 0.75, 0.1];"]}],"see_also":["periscopeElevation","animate","Arma 3: Event Handlers"]}