Difference between revisions of "Time cycle"

From GTAMods Wiki
Jump to navigation Jump to search
m (Vice City TimeCyc.dat Structure)
Line 1: Line 1:
The timecyc.dat file contains the information for how to display the sky, weather effects and time of day. It is broken into the many sections. There is one line of data per hour in the game, per weather type. In the Vice City timecyc.dat, there is an extra section at the bottom of the file named "EXTRACOLOURS". These extra colours are used for building interiors, but should function the same.
+
The '''timecyc.dat''' file contains the information for how to display the sky, weather effects and time of day. It is broken into the many sections. There is one line of data per hour in the game, per weather type. In the Vice City timecyc.dat, there is an extra section at the bottom of the file named "EXTRACOLOURS". These extra colours are used for building interiors, but should function the same.
  
Note: A comment in the <code>timecyc.dat</code> file is preceded by a series of slashes ("//") and they will precede each type of weather, and time of day in the file.
+
A comment in the <code>timecyc.dat</code> file is preceded by a series of slashes ("//") and they will precede each type of weather, and time of day in the file.
  
The following lists gives the name of each column group in the format '''Column Name (Data Type)'''. A describes is supplied for each.
+
== File Format ==
 +
The following lists describes format of the timecyc.dat in each game.
  
===Vice City TimeCyc.dat Structure===
+
=== GTA 3 ===
 +
{{Incomplete}}
  
; Amb (Color)
+
=== Vice City ===
: Controls amount of ambient color on static map objects, like most buildings, structures and landmasses.
 
; Amb_Obj (Color)
 
: Controls the amount of ambient light on dynamic objects, like pedestrians and vehicles.
 
; Amb_Bl (Color)
 
: Effect unknown, changing produces no visible results.
 
; Amb_Obj_bl (Color)
 
: Effect unknown, changing produces no visible results.
 
; Dir (Color)
 
: Controls amount of direct light on pedestrians and vehicles.
 
; Sky top (Color)
 
: Color of the top of the sky.
 
; Sky bot (Color)
 
: Color of the bottom of the sky.
 
; SunCore (Color)
 
: Color of the sun's core image.
 
; SunCorona (Color)
 
: Color of the sun's corona image.
 
; SunSz (float)
 
: Size of the sun's corona sprite.
 
; SprSz (float)
 
: Size of the sun's core sprite.
 
; SprBght (float)
 
: How bright sprites will be.
 
; Shdw (integer)
 
: Intensity of pedestrian, vehicle, and lamp shadows. 0 is transparent, 100 seems to be about "normal", and values past that make the shadow darker and darker. 500 will produce almost pure black shadows.
 
; LightShd (integer)
 
: The cast light alpha on traffic signals and lampposts. changing produces no visible results.
 
; PoleShd (integer)
 
: Lamppost shadow alpha. changing produces no visible results.
 
; FarClp (float)
 
: The clipping plane that limits maximum visibility. Setting the value to a smaller number produces a short visibility range, wheras larger numbers mean you can see further. If the number is set too low (i tried 20.0), the game will get glitchy, and may not load textures! The average value for this entry is 2000.0 and most of the map is visible with this value.
 
; FogSt (float)
 
: Fog start position relative to camera? Negatives allowed. Untested.
 
; LightOnGround (float)
 
: Effect unknown, changing produces no visible results.
 
; LowCloudsRGB (Color)
 
: Sets colour for low thin clouds.  Untested.
 
; TopCloudRGB (Color)
 
: Sets colour for topside of large clouds. Untested.
 
; BottomCloudRGB (Color)
 
: Sets colour for underside of large clouds. Untested.
 
; BlurRGB (Color)
 
: RGB values for Trails. If you have not somehow enabled trails on your game, then the values will not be noticable. 0 for no trails, 255 for a pure white screen. If your going to change them, follow the pattern R* set with their setup, as a little bit goes a very long way.
 
; WaterRGBA (Color)
 
: Controls the color of the water. On the pc version of the game, the water texture is greenish-blue. It needs to be converted to grayscale to fully see the effect of changing the water color in the timecyc.dat, as the colors defined in this file, are multiplied by the water texture color ingame. The last part of RGBA, the A, is the alpha channel and it controls the level of transparency for the water. 0, will make the water totally transparent, while 255 will make the water as opaque as the game will allow.
 
  
===San Andreas TimeCyc.dat Structure===
+
{|{{Prettytable}} class="collapsible"
 +
!Column Name
 +
!Data Type
 +
!Description
 +
|-
 +
|'''Amb''' ||Color|| Controls amount of ambient color on static map objects, like most buildings, structures and landmasses.
 +
|-
 +
|'''Amb_Obj''' ||Color|| Controls the amount of ambient light on dynamic objects, like pedestrians and vehicles.
 +
|-
 +
|'''Amb_Bl''' ||Color|| Effect unknown, changing produces no visible results.
 +
|-
 +
|'''Amb_Obj_bl''' ||Color|| Effect unknown, changing produces no visible results.
 +
|-
 +
|'''Dir''' ||Color|| Controls amount of direct light on pedestrians and vehicles.
 +
|-
 +
|'''Sky top'''||Color|| Color of the top of the sky.
 +
|-
 +
|'''Sky bot'''||Color|| Color of the bottom of the sky.
 +
|-
 +
|'''SunCore''' ||Color|| Color of the sun's core image.
 +
|-
 +
|'''SunCorona''' ||Color|| Color of the sun's corona image.
 +
|-
 +
|'''SunSz''' ||float|| Size of the sun's corona sprite.
 +
|-
 +
|'''SprSz''' ||float|| Size of the sun's core sprite.
 +
|-
 +
|'''SprBght''' ||float|| How bright sprites will be.
 +
|-
 +
|'''Shdw''' ||integer|| Intensity of pedestrian, vehicle, and lamp shadows. 0 is transparent, 100 seems to be about "normal", and values past that make the shadow darker and darker. 500 will produce almost pure black shadows.
 +
|-
 +
|'''LightShd''' ||integer|| The cast light alpha on traffic signals and lampposts. changing produces no visible results.
 +
|-
 +
|'''PoleShd''' ||integer|| Lamppost shadow alpha. changing produces no visible results.
 +
|-
 +
|'''FarClp''' ||float|| The clipping plane that limits maximum visibility. Setting the value to a smaller number produces a short visibility range, wheras larger numbers mean you can see further. If the number is set too low (i tried 20.0), the game will get glitchy, and may not load textures! The average value for this entry is 2000.0 and most of the map is visible with this value.
 +
|-
 +
|'''FogSt''' ||float|| Fog start position relative to camera? Negatives allowed. Untested.
 +
|-
 +
|'''LightOnGround''' ||float|| Effect unknown, changing produces no visible results.
 +
|-
 +
|'''LowCloudsRGB''' ||Color|| Sets colour for low thin clouds.  Untested.
 +
|-
 +
|'''TopCloudRGB''' ||Color|| Sets colour for topside of large clouds. Untested.
 +
|-
 +
|'''BottomCloudRGB''' ||Color|| Sets colour for underside of large clouds. Untested.
 +
|-
 +
|'''BlurRGB''' ||Color|| RGB values for Trails. If you have not somehow enabled trails on your game, then the values will not be noticable. 0 for no trails, 255 for a pure white screen. If your going to change them, follow the pattern R* set with their setup, as a little bit goes a very long way.
 +
|-
 +
|'''WaterRGBA''' ||Color|| Controls the color of the water. On the pc version of the game, the water texture is greenish-blue. It needs to be converted to grayscale to fully see the effect of changing the water color in the timecyc.dat, as the colors defined in this file, are multiplied by the water texture color ingame. The last part of RGBA, the A, is the alpha channel and it controls the level of transparency for the water. 0, will make the water totally transparent, while 255 will make the water as opaque as the game will allow.
 +
|}
  
 +
=== San Andreas ===
 
In San Andreas the format is nearly the same, but some of the sections are left out.
 
In San Andreas the format is nearly the same, but some of the sections are left out.
  
Line 79: Line 87:
 
* BottomCloudRGB (Color)
 
* BottomCloudRGB (Color)
 
* WaterRGBA (Color)
 
* WaterRGBA (Color)
 +
{{Incomplete}}
  
 +
=== GTA 4 ===
 +
{{Incomplete}}
  
[[Category:Map Formats]] [[Category:GTA 3]] [[Category:GTA VC]]
+
== Tools ==
 +
* [[VC.Config#VC:Weather|VC:Weather]]
 +
* [[G-Tools#G-CYC|G-CYC]]
 +
 
 +
== External Link ==
 +
{{GTAF|255093|Modding timecyc.net for Vice City}}
 +
 
 +
{{GTA4-navi|state=autocollapse}}
 +
{{SA-navi|state=autocollapse}}
 +
 
 +
[[Category:Map Formats]][[Category:GTA 3]][[Category:GTA VC]]

Revision as of 15:58, 6 February 2009

The timecyc.dat file contains the information for how to display the sky, weather effects and time of day. It is broken into the many sections. There is one line of data per hour in the game, per weather type. In the Vice City timecyc.dat, there is an extra section at the bottom of the file named "EXTRACOLOURS". These extra colours are used for building interiors, but should function the same.

A comment in the timecyc.dat file is preceded by a series of slashes ("//") and they will precede each type of weather, and time of day in the file.

File Format

The following lists describes format of the timecyc.dat in each game.

GTA 3

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

Vice City

Column Name Data Type Description
Amb Color Controls amount of ambient color on static map objects, like most buildings, structures and landmasses.
Amb_Obj Color Controls the amount of ambient light on dynamic objects, like pedestrians and vehicles.
Amb_Bl Color Effect unknown, changing produces no visible results.
Amb_Obj_bl Color Effect unknown, changing produces no visible results.
Dir Color Controls amount of direct light on pedestrians and vehicles.
Sky top Color Color of the top of the sky.
Sky bot Color Color of the bottom of the sky.
SunCore Color Color of the sun's core image.
SunCorona Color Color of the sun's corona image.
SunSz float Size of the sun's corona sprite.
SprSz float Size of the sun's core sprite.
SprBght float How bright sprites will be.
Shdw integer Intensity of pedestrian, vehicle, and lamp shadows. 0 is transparent, 100 seems to be about "normal", and values past that make the shadow darker and darker. 500 will produce almost pure black shadows.
LightShd integer The cast light alpha on traffic signals and lampposts. changing produces no visible results.
PoleShd integer Lamppost shadow alpha. changing produces no visible results.
FarClp float The clipping plane that limits maximum visibility. Setting the value to a smaller number produces a short visibility range, wheras larger numbers mean you can see further. If the number is set too low (i tried 20.0), the game will get glitchy, and may not load textures! The average value for this entry is 2000.0 and most of the map is visible with this value.
FogSt float Fog start position relative to camera? Negatives allowed. Untested.
LightOnGround float Effect unknown, changing produces no visible results.
LowCloudsRGB Color Sets colour for low thin clouds. Untested.
TopCloudRGB Color Sets colour for topside of large clouds. Untested.
BottomCloudRGB Color Sets colour for underside of large clouds. Untested.
BlurRGB Color RGB values for Trails. If you have not somehow enabled trails on your game, then the values will not be noticable. 0 for no trails, 255 for a pure white screen. If your going to change them, follow the pattern R* set with their setup, as a little bit goes a very long way.
WaterRGBA Color Controls the color of the water. On the pc version of the game, the water texture is greenish-blue. It needs to be converted to grayscale to fully see the effect of changing the water color in the timecyc.dat, as the colors defined in this file, are multiplied by the water texture color ingame. The last part of RGBA, the A, is the alpha channel and it controls the level of transparency for the water. 0, will make the water totally transparent, while 255 will make the water as opaque as the game will allow.

San Andreas

In San Andreas the format is nearly the same, but some of the sections are left out.

Here is a list of the columns San Andreas uses:

  • Amb (Color)
  • Amb_Obj (Color)
  • Dir (Color)
  • Sky top (Color)
  • Sky bot (Color)
  • SunCore (Color)
  • SunCorona (Color)
  • SunSz (float)
  • SprSz (float)
  • SprBght (float)
  • Shdw (integer)
  • LightShd (integer)
  • PoleShd (integer)
  • FarClp (float)
  • FogSt (float)
  • LightOnGround (float)
  • LowCloudsRGB (Color)
  • BottomCloudRGB (Color)
  • WaterRGBA (Color)

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

GTA 4

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

Tools

External Link

GTA Net GTAForums: Modding timecyc.net for Vice City