Difference between revisions of "OCCL"

From GTAMods Wiki
Jump to navigation Jump to search
Line 1: Line 1:
'''Occlusion''' is a feature in Vice City and San Andreas that helps make the game run smoother in certain parts of the game. The occlusions are created using invisible boxes. These boxes disable models that are behind the boxes from rendering. This feature is not really effective and Rockstar did not use this feature efficiently. There are not much improvements on occlusions in San Andreas compared to Vice City. Deleting all entries in the occlu section doesn't have a major effect on your games.
+
'''Occlusion''' is a feature in Vice City and San Andreas that helps make the game run smoother in certain parts of the map. The occlusions are created using invisible boxes. These boxes disable models that are behind the boxes from rendering. This feature is not really effective and Rockstar did not use this feature efficiently. There are not much improvements on occlusions in San Andreas compared to Vice City. Deleting all entries in the occlu section does not have any major effects on the game.
  
 
==Location==
 
==Location==
Line 9: Line 9:
 
  ...
 
  ...
 
  end
 
  end
<br>
+
 
 
''Format of the occlu section of the IPL file:''
 
''Format of the occlu section of the IPL file:''
  direct mid x, direct mid y, bottom height z, width x, width y, height from bottom height to top,
+
  mid x, mid y, bottom height z, width x, width y, height from bottom height to top, rotation
rotation
+
*'''mid x, mid y:''' The middle of the occlusion box in X and Y coordinates.
*'''direct mid x, direct mid y:''' The middle of the occlusion box in X and Y coordinates.<br>
+
*'''bottom height z:''' The bottom Z coordinate of the occlusion box.
*'''bottom height z:''' The bottom Z coordinate of the occlusion box.<br>
+
*'''width x, width y:''' The width of the occlusion box in units.
*'''width x, width y:''' The width of the occlusion box in units.<br>
+
*'''height from bottom height to top:''' The difference in height from the top of the occlusion box to the bottom.
*'''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.
*'''rotation:''' The rotation of the occlusion box in angles.<br>
 
  
 
==Viewing It==
 
==Viewing It==
Vice City's occlusions can only be viewed through [[KEd]]. So far, no program can view San Andreas's occlusions with its models. You can copy San Andreas's occlusions and paste it into Vice City's and view it through KEd. KEd sees occlusion boxes as green, transparent boxes with a small triangular hole in the 3D View. KEd does not support editing the occlusions through the program so you have to create the boxes yourself.
+
Vice City's occlusions can only be viewed through [[KEd]]. So far, no program can view San Andreas' occlusions with its models. You can copy San Andreas' occlusions and paste it into Vice City's and view it through KEd. KEd sees occlusion boxes as green, transparent boxes with a small triangular hole in the 3D View. KEd does not support editing the occlusions through the program so you have to create the boxes yourself.
<br>
 
http://img.photobucket.com/albums/v41/spaceeinstein/Occlusion.png<br>
 
''Occlusion boxes in [[KEd]]''
 
  
==How 2.0==
+
[[Image:Occlusion.png|center|frame|Occlusion boxes in KEd]]
The following way to make occlusion boxes is practiced by [[User:spaceeinstein|spaceeinstein]]. No other people are modifying the occlusions. First find a building that you want to make occlusion boxes and align it to the X- and Y-axis. Get the coordinates of the lower left corner of the building and the upper right corner of the building. The coordinates for the lower left and upper right corner of the building can be inputted as X1, Y1, and Z1, and X2, Y1, and Z2, respectively, into the occlusion tool. If you are not bothered to get the lower Z coordinate of the box, you can input any number that is lower than the foundation of your building. Making the boxes with angles is pretty tough to do and probably needs some trial and error to fit it into the building.
+
 
 +
==Creating It==
 +
The following way to make occlusion boxes is practiced by [[User:spaceeinstein|spaceeinstein]]. First find a building that you want to make occlusion boxes and align it to the X- and Y-axis. Get the coordinates of the lower left corner of the building and the upper right corner of the building. The coordinates for the lower left and upper right corner of the building can be inputted as X1, Y1, and Z1, and X2, Y1, and Z2, respectively, into the occlusion tool. If you are not bothered to get the lower Z coordinate of the box, you can input any number that is lower than the foundation of your building. Making the boxes with angles is pretty tough to do and probably needs some trial and error to fit it into the building.
  
 
==Problems==
 
==Problems==
 
If you delete the buildings in Vice City or San Andreas without deleting the occlusions, you would see pop ups behind the occlusions. These occlusions had created problems for a few modifications, most notably in the Liberty City modification. In the Liberty City mod, the team experienced unexpected pop ups caused by the occlusion boxes. These boxes are loading and unloading the models behind boxes where Vice City's buildings used to be at. Someone realized that the <code>occlu.ipl</code> was the problem and deleted every line in that file. The pop ups disappeared.
 
If you delete the buildings in Vice City or San Andreas without deleting the occlusions, you would see pop ups behind the occlusions. These occlusions had created problems for a few modifications, most notably in the Liberty City modification. In the Liberty City mod, the team experienced unexpected pop ups caused by the occlusion boxes. These boxes are loading and unloading the models behind boxes where Vice City's buildings used to be at. Someone realized that the <code>occlu.ipl</code> was the problem and deleted every line in that file. The pop ups disappeared.
 
==Current Usage==
 
The only person who is known to modify the occlusions for modifications is spaceeinstein. The modifications that currently use modified occlusions are the Liberty City mod and the Myriad Islands mod for Vice City.
 
 
==Backups==
 
If you did not backup the files and need the original files, get it here.<br>
 
[http://sodagirl.xmgfree.com/occlu.ipl Vice City's occlu.ipl]<br>
 
[http://sodagirl.xmgfree.com/SA/occlu.ipl San Andreas's occlu.ipl]<br>
 
[http://sodagirl.xmgfree.com/occluint.ipl San Andreas's occluint.ipl]<br>
 
[http://sodagirl.xmgfree.com/occluLA.ipl San Andreas's occluLA.ipl]<br>
 
[http://sodagirl.xmgfree.com/occlusf.ipl San Andreas's occlusf.ipl]<br>
 
[http://sodagirl.xmgfree.com/occluveg.ipl San Andreas's occluveg.ipl]<br>
 
 
==References==
 
[http://sodagirl.xmgfree.com/occlu.php Occlusion Tool] - Temporary site to host Opius's occlusion tool
 
  
 
[[Category:Map Formats]][[Category:GTA VC]][[Category:GTA SA]]
 
[[Category:Map Formats]][[Category:GTA VC]][[Category:GTA SA]]

Revision as of 20:10, 13 December 2008

Occlusion is a feature in Vice City and San Andreas that helps make the game run smoother in certain parts of the map. The occlusions are created using invisible boxes. These boxes disable models that are behind the boxes from rendering. This feature is not really effective and Rockstar did not use this feature efficiently. There are not much improvements on occlusions in San Andreas compared to Vice City. Deleting all entries in the occlu section does not have any major effects on the game.

Location

Occlusions are controlled by the occl section of the IPL files. Rockstar created the occlusions through the occlu.ipl in Vice City and the occlu.ipl, occluint.ipl, occluLA.ipl, occlusf.ipl, and the occluveg.ipl in San Andreas. You can open these files using Microsoft Notepad. You do not need to use these files to create your own occlusions as long as the entry is in a defined IPL file.

Format

Section identifier:

occl
...
end

Format of the occlu section of the IPL file:

mid x, mid y, bottom height z, width x, width y, height from bottom height to top, rotation
  • mid x, mid y: The middle of the occlusion box in X and Y coordinates.
  • bottom height z: The bottom Z coordinate of the occlusion box.
  • width x, width y: The width of the occlusion box in units.
  • height from bottom height to top: The difference in height from the top of the occlusion box to the bottom.
  • rotation: The rotation of the occlusion box in angles.

Viewing It

Vice City's occlusions can only be viewed through KEd. So far, no program can view San Andreas' occlusions with its models. You can copy San Andreas' occlusions and paste it into Vice City's and view it through KEd. KEd sees occlusion boxes as green, transparent boxes with a small triangular hole in the 3D View. KEd does not support editing the occlusions through the program so you have to create the boxes yourself.

File:Occlusion.png
Occlusion boxes in KEd

Creating It

The following way to make occlusion boxes is practiced by spaceeinstein. First find a building that you want to make occlusion boxes and align it to the X- and Y-axis. Get the coordinates of the lower left corner of the building and the upper right corner of the building. The coordinates for the lower left and upper right corner of the building can be inputted as X1, Y1, and Z1, and X2, Y1, and Z2, respectively, into the occlusion tool. If you are not bothered to get the lower Z coordinate of the box, you can input any number that is lower than the foundation of your building. Making the boxes with angles is pretty tough to do and probably needs some trial and error to fit it into the building.

Problems

If you delete the buildings in Vice City or San Andreas without deleting the occlusions, you would see pop ups behind the occlusions. These occlusions had created problems for a few modifications, most notably in the Liberty City modification. In the Liberty City mod, the team experienced unexpected pop ups caused by the occlusion boxes. These boxes are loading and unloading the models behind boxes where Vice City's buildings used to be at. Someone realized that the occlu.ipl was the problem and deleted every line in that file. The pop ups disappeared.