View source for CULL

{{IplSection
| game        = [[GTA 3]] [[GTA VC]] [[GTA SA]] [[GTA IV]]
| description = Create a [[Wikipedia:Culling|culling zone]]
}}
'''CULL''' is one of the major [[IPL]] sections used in plaintext map placement files. It is used to create zones with different behaviour like mirrors {{ref|1}} or fixed camera positions. It can also influence the environment like disable rain within the zone.

== GTA III / Vice City ==

Cull zones in GTA III and Vice City series are built by a box which is controlled by various flags{{ref|2}}. Most of the default cull zones are located in <code>data\maps\cull.ipl</code> for both games.

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

{|class="wikitable" class="collapsible"
!Identifier
!Description
|-
|<center>CenterX, CenterY, CenterZ</center>||A point which defines the center of the box in real world coordinates
|-
|<center>LowerLeftX, LowerLeftY, LowerLeftZ</center>||A point which corresponds to the ''lower left'' corner of the box.
|-
|<center>UpperRightX, UpperRightY, UpperRightZ</center>||A point which corresponds to the ''upper right'' corner of the box.
|-
|<center>Flags</center>||The behaviour of the cull zone &ndash; ''see [[CULL#Flags|below]]''.
|-
|<center>Unknown</center>||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 ''[[Wikipedia:Power_of_2|power of 2]]''-numbers lower than 2<sup>30</sup>. Some are defining various behaviours of the zone. They can be combined by simply adding one lag value to another.

{|{{Prettytable}} class="collapsible"
!width="120px"|Flag
!width="25%"|Binary
!Description
|-
|<center>-1</center>||||Enables all flags.
|-
|<center>1</center>||<center>0000 0000 0000 0001</center>||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
|-
|<center>2</center>||<center>0000 0000 0000 0010</center>||camera remotely placed outside the zone, no control of camera, camera mode cannot be changed while in the zone
|-
|<center>4</center>||<center>0000 0000 0000 0100</center>||Unknown
|-
|<center>8</center>||<center>0000 0000 0000 1000</center>||Rain-free, police helicopter-free zone
|}

{{Incomplete}}

== San Andreas ==

[[:Category:GTA SA|San Andreas]] has two different major formats in the game:

 CenterX, CenterY, CenterZ, Unknown1, WidthY, BottomZ, WidthX, Unknown2, TopZ, Flag, Unknown3

 CenterX, CenterY, CenterZ, Unknown1, WidthY, BottomZ, WidthX, Unknown2, TopZ, Flag, Vx, Vy, Vz, Cm

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

{{Incomplete}}

==== Flags ====

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

{|{{Prettytable}} class="collapsible"
!width="120px"|Flag
!width="25%"|Binary
!Description
|-
|<center>-1</center>||||Enables all flags.
|-
|<center>1</center>||<center>0000 0000 0000 0001</center>||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
|-
|<center>2</center>||<center>0000 0000 0000 0010</center>||camera remotely placed outside the zone, no control of camera, camera mode cannot be changed while in the zone
|-
|<center>4</center>||<center>0000 0000 0000 0100</center>||Unknown
|-
|<center>8</center>||<center>0000 0000 0000 1000</center>||Rain-free, police helicopter-free zone
|-
|<center>4096</center>||<center>0001 0000 0000 0000</center>||5-star military zone 
|}

{{Incomplete}}

== GTA IV ==

{{Research}}

== References ==
* {{note|1}} {{GTAF|203741|8 Track Screen}}
* {{note|2}} {{GTAF|106678|GTA III cullzones encryption}}

== See also ==
* [[IPL|Item placement file format specification]]

== External links ==
* {{GTAF|209163|Karma contest with cullzones as topic}}
* {{GTAF|202532|IPL documentation topic}}

{{N|4|SA}}

[[Category:Map Formats]][[Category:GTA LCS]][[Category:GTA VCS]]