Door States
DoorStates can be used with the functions GetVehicleDamageStatus and UpdateVehicleDamageStatus.
Which bit stores what?
The damage of each door (note that the hood and the trunk are also doors) will be saved in 1 byte (which is 8 bits). You can only change the state of one bit for every door at each time - so you have to call the function twice if you want to damage and open the door.
- The first bit stores whether the door is opened(1) or not(0) (the door will still lock (and change the first bit to 0) if closed - its just open)
- The second bit stores whether the door is damaged(1) or not(0) (If you want a damaged door to turn normal you have to remove and re-attach it undamaged)
- The third bit stores whether the door is removed(1) or attached(0)
- The rest of the bits are empty
It seems like there is no bit which stores if the door will lock or not.
Notice that you count the bits from behind - so the first is the rightmost bit
Which byte stores what?
- The first byte stores the state of the hood
- The second byte stores the state of the trunk
- The third byte stores the state of the drivers door
- The fourth byte stores the state of the co-drivers door
- The states of the 2 rear doors cannot be handled by GetVehicleDamageStatus and UpdateVehicleDamageStatus.
Notice that I count the bytes from behind - so the first is the rightmost byte
Example
The following code tells that the hood is removed, the front left door damaged, the front right door opened and the trunk is damaged and opened:
00000001 00000010 00000011 00000100
However SA-MP returns a decimal number so you have to convert it to a binary number first to get a result like above. What SA-MP would return you in this case is this:
16909060
Info table
First byte (hood):
0 (000) 1 (001) 2 (010) 3 (011) 4 (100) 5 (101) 6 (110) 7 (111) °--° °[]° °~~° °{}° ° ° ° ° ° ° ° ° | | | | | | | | | | | | | | | | °--° °--° °--° °--° °--° °--° °--° °--°
Second byte (trunk):
0 (000) 1 (001) 2 (010) 3 (011) 4 (100) 5 (101) 6 (110) 7 (111) °--° °--° °--° °--° °--° °--° °--° °--° | | | | | | | | | | | | | | | | °--° °[]° °--° °{}° ° ° ° ° ° ° ° °
Third byte (drivers door):
0 (000) 1 (001) 2 (010) 3 (011) 4 (100) 5 (101) 6 (110) 7 (111) °--° °--° °--° °--° °--° °--° °--° °--° | | -- | § | ww | | | | | °--° °--° °--° °--° °--° °--° °--° °--°
Fourth byte (co-drivers door):
0 (000) 1 (001) 2 (010) 3 (011) 4 (100) 5 (101) 6 (110) 7 (111) °--° °--° °--° °--° °--° °--° °--° °--° | | | -- | § | ww | | | | °--° °--° °--° °--° °--° °--° °--° °--°
Legend:
Static Doors Hood / Trunk ° - Light | - healthy, closed -- - healthy, closed -- - healthy, opened [] - healthy, opened § - damaged, closed ~~ - damaged, closed ww - damaged, opened {} - damaged, opened - missing - missing
Wrapper
Usefull little snippet to avoid working with the bits and bytes too much;
enum Door { DOOR_HOOD, DOOR_TRUNK, DOOR_DRIVER DOOR_PASSENGER } enum DoorState(<<= 1) { IS_OPENED = 1, IS_DAMAGED, IS_REMOVED } stock GetDoorState(doorStates, Door:door, DoorState:doorState) return (doorStates >>> (8 * door)) & doorState;
Examples:
new panels, doors, lights, tires; GetVehicleDamageStatus(vehicleid,panels,doors,lights,tires); // simple if(GetDoorState(doors, DOOR_DRIVER, IS_DAMAGED)) { SendClientMessage(playerid, -1, "The driver door of your vehicle is damaged!"); } // or even combined if(GetDoorState(doors, DOOR_HOOD, IS_OPENED | IS_DAMAGED)) { SendClientMessage(playerid, -1, "The hood of your vehicle is both opened and damaged!"); }