Difference between revisions of "OCCL"

From GTAMods Wiki
Jump to navigation Jump to search
m
 
(28 intermediate revisions by 6 users not shown)
Line 1: Line 1:
−
==Introduction==
+
{{IplSection
−
'''Occlusion''' is a feature in Vice City and San Andreas that helps make the game run smoother in certain parts of the game. Occlusion boxes disable models that are behind the box from rendering. The occlusions are controlled by the occlu.ipl file in Vice City and other files scattered around in San Andreas. Rockstar didn't use this feature efficiently and didn't improve this much from Vice City. Deleting all entries in the occlu section doesn't have a major affect on your games.
+
| game        = {{Icon|VC}} {{Icon|SA}} {{Icon|4}}
 +
| description = Creates occlusion culling zones
 +
}}
 +
'''OCCL''' is a section in the [[item placement]] file in [[Vice City]], [[San Andreas]], and [[GTA IV]]. It is used to create [[wikipedia:Hidden surface determination|occlusion culling]] zones that helps make the game run smoother in certain parts of the world. Since it is wasteful to render models behind opaque models, these zones can disable the rendering of any models that are directly behind the zones.
  
−
==Details==
+
== Format ==
−
'''Format of the occlu section of the IPL file:'''
+
=== Vice City ===
−
direct mid x, direct mid y, bottom height z, width x, width y, height from bottom height to top,
+
[[File:VC occlu.jpg|thumb|A map of Vice City's <code>occlu.ipl</code> areas]]
−
rotation
+
{{Pre|
−
*'''direct mid x, direct mid y:''' The middle of the occlusion box in X and Y coordinates.<br>
+
occl
−
*'''bottom height z:''' The bottom Z coordinate of the occlusion box.<br>
+
MidX, MidY, BottomZ, WidthX, WidthY, Height, Rotation
−
*'''width x, width y:''' The width of the occlusion box in units of X and Y.<br>
+
end
−
*'''height from bottom height to top:''' The difference in height from the top of the occlusion box to the bottom.<br>
+
}}
−
*'''rotation:''' The rotation of the occlusion box in angles (probably radians, I'm not sure).<br>
 
−
Occlusion boxes can only be viewed through ([[KEd]]).<br>
 
−
The only known person who uses this file in modifications is spaceeinstein.
 
  
−
==References==
+
The section is used in the <code>occlu.ipl</code> file but it can be used in any IPL files.
−
[http://sodagirl.xmgfree.com/occlu.php Occlusion Tool] Temporary site to host Opius's occlusion tool
+
{|class="wikitable center-col-1 center-col-2"
 +
!style="width: 3em;"|{{Icon|VC}}
 +
!style="width: 12em;"|Identifier
 +
!style="width: 6em;" |Type
 +
!Description
 +
|-
 +
|A,B ||MidX, MidY ||float[2] ||The X and Y coordinates of the center of the occlusion zone.
 +
|-
 +
|C ||BottomZ ||float ||The bottom Z coordinate of the occlusion zone.
 +
|-
 +
|D,E ||WidthX, WidthY ||float[2] ||The width of the occlusion zone in units.
 +
|-
 +
|F ||Height ||float ||The height of the zone &mdash; the difference between the top and the bottom of the zone.
 +
|-
 +
|G ||Rotation ||float ||The [[Angle|rotation]] of the occlusion zone in degrees.
 +
|}
  
−
[[Category:Map Formats]][[Category:GTA VC]][[Category:GTA SA]]
+
=== San Andreas ===
 +
The section is used in <code>occluint.ipl</code>, <code>occluLA.ipl</code>, <code>occlusf.ipl</code>, and <code>occluveg.ipl</code> files.
 +
 
 +
{{Pre|
 +
occl
 +
MidX, MidY, BottomZ, WidthX, WidthY, Height, Rotation, , ,
 +
end
 +
}}
 +
{|class="wikitable center-col-1 center-col-2"
 +
!style="width: 3em;"|{{Icon|SA}}
 +
!style="width: 12em;"|Identifier
 +
!style="width: 6em;" |Type
 +
!Description
 +
|-
 +
|A,B ||MidX, MidY ||float[2] ||The X and Y coordinates of the center of the occlusion zone.
 +
|-
 +
|C ||BottomZ ||float ||The bottom Z coordinate of the occlusion zone.
 +
|-
 +
|D,E ||WidthX, WidthY ||float[2] ||The width of the occlusion zone in units.
 +
|-
 +
|F ||Height ||float ||The height of the zone &mdash; the difference between the top and the bottom of the zone.
 +
|-
 +
|G ||Rotation ||float ||The [[Angle|rotation]] of the occlusion zone in degrees.
 +
|-
 +
|H,I || ||float ||
 +
|-
 +
|J || ||int ||
 +
|}
 +
 
 +
== Issues ==
 +
When removing buildings from the world, you may see unexpected pop ups caused by existing occlusion zones. Deleting all the occlusion zones is the easiest solution. An example of this issue is the Liberty City project. Before this section was researched, the team experienced unexpected pop ups with models loading and unloading behind areas where Vice City's buildings used to be. Someone realized that the <code>occlu.ipl</code> was the problem and deleted every line in that file. The pop ups disappeared and the issue was resolved.
 +
 
 +
== Statistics ==
 +
Total number of OCCL entries in:
 +
:Vice City: 344 (max 350)
 +
 
 +
== Tools and scripts ==
 +
* [[KEd]] &ndash; by {{U|JernejL}}
 +
* {{GTAF|277798|Script pack for 3ds Max}} &ndash; by {{U|Deniska}}
 +
* {{GTAF|402942|&#91;IV&#93;&#91;Rel&#93;GTA-IV Scripts Centre}} &ndash; by {{U|Gforce}}
 +
 
 +
{{N|4|SA|VC}}
 +
[[Category:Map Formats]]

Latest revision as of 18:40, 10 November 2016

OCCL (IPL section)
Short description:Creates occlusion culling zones
Supported games:Vice City San Andreas 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

OCCL is a section in the item placement file in Vice City, San Andreas, and GTA IV. It is used to create occlusion culling zones that helps make the game run smoother in certain parts of the world. Since it is wasteful to render models behind opaque models, these zones can disable the rendering of any models that are directly behind the zones.

Format

Vice City

A map of Vice City's occlu.ipl areas
occl
MidX, MidY, BottomZ, WidthX, WidthY, Height, Rotation
end

The section is used in the occlu.ipl file but it can be used in any IPL files.

Vice City Identifier Type Description
A,B MidX, MidY float[2] The X and Y coordinates of the center of the occlusion zone.
C BottomZ float The bottom Z coordinate of the occlusion zone.
D,E WidthX, WidthY float[2] The width of the occlusion zone in units.
F Height float The height of the zone — the difference between the top and the bottom of the zone.
G Rotation float The rotation of the occlusion zone in degrees.

San Andreas

The section is used in occluint.ipl, occluLA.ipl, occlusf.ipl, and occluveg.ipl files. 

occl
MidX, MidY, BottomZ, WidthX, WidthY, Height, Rotation, , ,
end
San Andreas Identifier Type Description
A,B MidX, MidY float[2] The X and Y coordinates of the center of the occlusion zone.
C BottomZ float The bottom Z coordinate of the occlusion zone.
D,E WidthX, WidthY float[2] The width of the occlusion zone in units.
F Height float The height of the zone — the difference between the top and the bottom of the zone.
G Rotation float The rotation of the occlusion zone in degrees.
H,I float
J int

Issues

When removing buildings from the world, you may see unexpected pop ups caused by existing occlusion zones. Deleting all the occlusion zones is the easiest solution. An example of this issue is the Liberty City project. Before this section was researched, the team experienced unexpected pop ups with models loading and unloading behind areas where Vice City's buildings used to be. Someone realized that the occlu.ipl was the problem and deleted every line in that file. The pop ups disappeared and the issue was resolved.

Statistics

Total number of OCCL entries in:

Vice City: 344 (max 350)

Tools and scripts

v · d · e
GTA IV Grand Theft Auto IV
File Formats.dat • .gxt • .ide • .img • .ipl • .nod • .sco • .rpf • .rrr • .wad • .wbd/.wbn • .wdd • .wdr • .wft • .whm • .wpl • .wtd
DocumentationAudio • Bink Video • Cryptography • Cutscenes • GXT Text • Image listing • Keycodes • Map Listing • Native functions • Paths • Radar Blips • Radio Stations • Saves • Scenarios • VTable • Weapons
ToolsASI Loader • ENBSeries • G-Texture • GIMS IV • Ingame WPL Editor • IV Needle • OpenIV • SparkIV • XLiveLess • WPL Manager • X Mod Installer
Alice • C++ Script Hook • .NET Script Hook • Scocl
TutorialsImporting Textures with OpenIV • Importing Textures with SparkIV
ModificationsGTA Connected • Gostown IV • Four Multiplayer • IV Multiplayer • CitizenMP:IV Reloaded
Useful linksCommunity portal • Discussion forums • Modding forums • Mods on GTAGarage.com
v · d · e
San Andreas Grand Theft Auto: San Andreas
File Formats.b • .col • .cfg • .cut • .dff • .dat • .fxp • .gxt • .ide • .ifp • .img • .ipl • nodes*.dat • .ped • .rep • .rrr • .scm • .set • .txd
DocumentationAudio • Cryptography • Cutscenes • Game memory • Handling.cfg • Map Listing • Mission Packs • Instructions • Paths • Replays • Saves • Scripts • Sound Effects • Statistics • Vehicles • Wanted levels
ToolsCLEO • Collision File Editor II • ENBSeries • G-Tools • IMG Tool • Limit Adjuster • Map Editor • Mod Loader • San Andreas Audio Toolkit • Sanny Builder • TXD Workshop • Magic.TXD
TutorialsSan Andreas v2.0 Modding • How to create a mission • How to create a script • How to use Map Editor • Vehicle Mod Installation
ModificationsDesign Your Own Mission • Gostown Paradise • GTA: United • Myriad Islands
MultiplayergtaTournament • Multi Theft Auto • San Andreas Multiplayer • (more...)
Useful linksCommunity Portal • Discussion Forums • Modding Forums • Mods on GTAGarage.com • Mobile Modding • Opcodes Database
v · d · e
Vice City Grand Theft Auto: Vice City
File Formats.adf • .b • .col • .cfg • .dff • .dat • .gxt • .ide • .ifp • .img/.dir • .ipl • .raw/.sdt • .rep • .set • .scm • .txd
DocumentationAudio • Handling • Map Listing • Memory Addresses • Skin List • Opcodes • RenderWare • Script Paths • Saves • Sound Effects • Statistics • Vehicles • Text • Wanted levels • Weapons
ToolsCLEO • Collision File Editor II • G-Tools • GXT Editor • IMG Tool • Limit Adjuster • KEd (map editor) • Sanny Builder • TXD Workshop • Magic.TXD
TutorialsHow to create a mission • How to create a script • Vehicle Mod Installation
MultiplayerGTA:LC Multiplayer • gtaTournament • Multi Theft Auto • State Of Liberty Online • Vice City Multiplayer • Vice City Online
Useful linksCommunity Portal • Discussion Forums • Modding Forums • Mods on GTAGarage.com • Mobile Modding • Opcodes Database
Retrieved from "https://gtamods.com/mediawiki/index.php?title=OCCL&oldid=16258"