SetVehicleParamsEx
From SA-MP Wiki
| This function was added in SA-MP 0.3c and will not work in earlier versions! |
Description:
Sets a vehicle's parameters for all players.
(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective)
| vehicleid | The ID of the vehicle to set the parameters of. |
| engine | Engine status. 0 - Off, 1 - On. |
| lights | Light status. 0 - Off, 1 - On. |
| alarm | Vehicle alarm status. If on, the alarm starts. 0 - Off, 1 - On. |
| doors | Door lock status. 0 - Unlocked, 1 - Locked. |
| bonnet | Bonnet (hood) status. 0 - Closed, 1 - Open. |
| boot | Boot/trunk status. 0 - Closed, 1 - Open. |
| objective | Toggle the objective arrow above the vehicle. 0 - Off, 1 - On. |
Return Values:
- 1: The function executed successfully.
- 0: The function failed to execute. This means the vehicle does not exist.
Example Usage:
// If setting a single parameter, you should obtain the current parameters so they aren't ALL changed new engine, lights, alarm, doors, bonnet, boot, objective; GetVehicleParamsEx(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective); SetVehicleParamsEx(vehicleid, VEHICLE_PARAMS_ON, lights, alarm, doors, bonnet, boot, objective); // ONLY the engine param was changed to VEHICLE_PARAMS_ON (1)
 Notes |
|
Example:
new Timer_VehAlarm[MAX_VEHICLES]; SetVehicleParamsEx_Fixed(vehicleid, &engine, &lights, &alarm, &doors, &bonnet, &boot, &objective) { SetVehicleParamsEx(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective); if(alarm) { KillTimer(Timer_VehAlarm[vehicleid]); Timer_VehAlarm[vehicleid] = SetTimerEx("DisableVehicleAlarm", 20000, false, "d", vehicleid); } } forward DisableVehicleAlarm(vehicleid); public DisableVehicleAlarm(vehicleid) { new engine, lights, alarm, doors, bonnet, boot, objective; GetVehicleParamsEx(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective); if(alarm == VEHICLE_PARAMS_ON) { SetVehicleParamsEx(vehicleid, engine, lights, VEHICLE_PARAMS_OFF, doors, bonnet, boot, objective); } }
Related Functions
The following functions may be useful, as they are related to this function in one way or another.
- GetVehicleParamsEx: Get a vehicle's parameters.
- SetVehicleParamsForPlayer: Set the parameters of a vehicle for a player.
- UpdateVehicleDamageStatus: Update the vehicle damage.
