SetVehicleParamsEx

From SA-MP Wiki

Jump to: navigation, search


SetVehicleParamsEx was added in SA-MP 0.3c 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.


Parameters:
(vehicleid, engine, lights, alarm, doors, bonnet, boot, objective)
vehicleidThe ID of the vehicle to set the parameters of.
engineEngine status. 0 - Off, 1 - On.
lightsLight status. 0 - Off, 1 - On.
alarmVehicle alarm status. If on, the alarm starts. 0 - Off, 1 - On.
doorsDoor lock status. 0 - Unlocked, 1 - Locked.
bonnetBonnet (hood) status. 0 - Closed, 1 - Open.
bootBoot/trunk status. 0 - Closed, 1 - Open.
objectiveToggle 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)
Image:32px-Ambox_warning_orange.png

Notes

  • The alarm will not reset when finished, you'll need to reset it by yourself with this function.
  • Lights also operate during the day (Only when ManualVehicleEngineAndLights is enabled).


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.

Personal tools
In other languages