CULL

CULL (IPL section)

Short description:	Create a culling zone
Supported games:	GTA 3 GTA VC GTA SA GTA IV
IPL Sections: 2DFX • AUZO • BLOK • CARS • CULL • ENEX • GRGE INST • JUMP • LINK • LODM • MLO+ • MULT • OCCL PATH • PICK • RTFX • SLOW • TCYC • VNOD • ZONE

CULL is a section in the IPL file. It is used to create zones with different behaviour like mirrors ^[1] or fixed camera positions. It can also influence the environment like disable rain within the zone and certain police behaviors.

GTA III / Vice City

Cull zones in GTA III and Vice City are built by a box which is controlled by various flags^[2]. By default, most of the cull zones are located in data\maps\cull.ipl for both games.

CenterX, CenterY, CenterZ, LowerLeftX, LowerLeftY, LowerLeftZ, UpperRightX, UpperRightY, UpperRightZ, Flags, Unknown

Identifier	Description
CenterX, CenterY, CenterZ	A point which defines the center of the box in real world coordinates Useless? Doesn't seem to affect the zone.
LowerLeftX, LowerLeftY, LowerLeftZ	A point which corresponds to the lower left corner of the box.
UpperRightX, UpperRightY, UpperRightZ	A point which corresponds to the upper right corner of the box.
Flags	The behaviour of the cull zone – see below.
Unknown	Always 0

The first three parameters are odd since placing any values do not have an effect on the zone. They seem to act like identifiers rather than functions.

Flags

Flags are numbers which are build out of a collection of numbers formed by the power of 2-numbers lower than 2³⁰. Some are defining various behaviours of the zone. They can be combined by simply adding one flag value to another (see binary to decimal conversion).

Flag	Binary	Description
-1	1111 1111 1111 1111 [3]	Enables all flags.
1	0000 0000 0000 0001	Camera close in into player using closest third-person view camera mode, does not close in if in first person or cinematic mode, camera mode cannot be changed while in the zone
2	0000 0000 0000 0010	camera remotely placed outside the zone, no control of camera, camera mode cannot be changed while in the zone
4	0000 0000 0000 0100	Lowers the camera angle on boats
8	0000 0000 0000 1000	Rain-free, police helicopter-free zone
16	0000 0000 0001 0000	Police will not exit their vehicles voluntarily. They will only exit if you do something to them (like shoot it). Cops both on foot and in vehicles will not chase you but can shoot at you.
32	0000 0000 0010 0000
64	0000 0000 0100 0000
128	0000 0000 1000 0000
256	0000 0001 0000 0000	Police will always exit their vehicles once they are spawned ONLY IF you have a wanted level. If you don't, they'll drive normally.
512	0000 0001 0000 0000
1024	0000 0010 0000 0000	Some visual water effects are removed like the transparent waves and sparkles on the water (like the water in GTA III).

This section is incomplete. You can help by fixing and expanding it.

San Andreas

San Andreas has two different major formats in the game:

CenterX, CenterY, CenterZ, Unknown1, Width, Bottom, Length, Unknown2, Top, Flag, Unknown3

CenterX, CenterY, CenterZ, Unknown1, Width, Bottom, Length, Unknown2, Top, Flag, Vx, Vy, Vz, Cm

Coordinates are always rounded to the nearest world unit so that they are no longer floating point values, they are non-decimal integers.

Value	Description
CenterX, CenterY, CenterZ	Vector to the center of the cull zone.
Unknown1, Unknown2, Unknown3	Allways 0. (The third value appears to be an placeholder. If it is zero the parser stops here. If it is not zero the parser tries to parse mirror information)
Width	Dimensions of the zone along x-axis.
Length	Dimensions of the zone along y-axis.
Top, Bottom	Distance from the center to the top/bottom of the zone. The sum of both values represents the zone's height.
Flag	Flags - see below!
Vx, Vy, Vz, Cm	Mirror parameters [4].

This section is incomplete. You can help by fixing and expanding it.

Flags

Not all flags from the previous game are compatible with San Andreas.

Flag	Binary	Description
-1	1111 1111 1111 1111 [3]	Enables all flags.
1	0000 0000 0000 0001	Camera close in into player using closest third-person view camera mode, does not close in if in first person or cinematic mode, camera mode cannot be changed while in the zone
2	0000 0000 0000 0010	camera remotely placed outside the zone, no control of camera, camera mode cannot be changed while in the zone
4	0000 0000 0000 0100	Unknown
8	0000 0000 0000 1000	Rain-free, police helicopter-free zone
4096	0001 0000 0000 0000	5-star military zone

This section is incomplete. You can help by fixing and expanding it.

References

• ^  GTAForums: 8 Track Screen
• ^  GTAForums: GTA VC cullzones deciphered
• ^ Two's complement

See also

• Item placement file format specification

External links

•  GTAForums: Karma contest with cullzones as topic
•  GTAForums: IPL documentation topic