Modernisation

CHANGELOG.md

@@ -8,6 +8,17 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 <details><summary><b>Added</b></summary>
 
+- Scene lighting and post-processing (see `Documentation/LightingAndEffects.md`).
+	Sky light that spreads through the terrain (caves get darker the deeper they go, digging lets light in), ambient light, and dynamic lights with soft terrain shadows. Every glow effect now casts light in its own color, so muzzle flashes, explosions, thrusters and fire light up their surroundings with no content changes.
+	Automatic edge normals for all sprites and terrain so edges catch the light, emissive palette colors (gold sparkle, tracers), HDR bloom, highlight compression, vignette and color grading (temperature, tint, contrast, split toning, film grain, chromatic aberration).
+	Time of day and day/night cycle (`TimeOfDay`, `DayLengthMinutes`), atmospheric haze on distant background layers, god rays into caves, and procedural rain and snow (`WeatherType`, `WeatherIntensity`, `Wind`) that stays out from under overhangs.
+	Heat haze above hot things, refraction shockwaves from explosions, and scorch marks with cooling, glowing crater rims.
+	Soft edged fog of war.
+	Visual-only render interpolation between simulation updates for smooth motion at any frame rate.
+	New `MovableObject` INI and Lua properties `LightColor` (Lua `SetLightColor(r, g, b)`, `LightRed/Green/Blue`), `LightRadius`, `LightIntensity`, `LightFlicker` and `LightOffset`.
+	New `PostProcessMan` Lua functions and properties: `AddLight(pos, radius, r, g, b, intensity)`, `TimeOfDay`, `DayLengthMinutes`, `WeatherType`, `WeatherIntensity`, `Wind`, `LightingEnabled`, `SetSkyColor(r, g, b)`, `SetAmbientColor(r, g, b)`, `SetColorGrade(temperature, tint, contrast)`, `SetSplitToning(...)`.
+	Lighting, Bloom and Heat/Shockwaves toggles in the Video settings, many new `Settings.ini` keys, and a Graphics Lab debug window (`ShowGraphicsLab`, `DebugMan:ShowGraphicsLab()`) for live tuning.
+
 - Pathfinding and navigation overhaul, including jetpack/jump-aware pathfinding.  
 	Actors will now choose their path depending on how high they can jump, instead of always taking the shortest flying path. This will reduce instances of the AI getting stuck while trying to take paths that are impossible for them.  
 	Improvements to both `ACrab` and `AHuman` navigation. `ACrab`s are now aware of how to pathfind and navigate using their jetpack, and will use it where applicable. Actors are better at using their jetpack, and will use automovers if their jetpack is not sufficient to reach a destination.  

Data/Base.rte/AI/HumanBehaviors.lua

@@ -1107,7 +1107,8 @@ function HumanBehaviors.ShootTarget(AI, Owner, Abort)
 						local TargetPoint = AI.Target.Pos + AI.TargetOffset;
 
 						if (range < Owner.AimDistance + Weapon.SharpLength + FrameMan.PlayerScreenWidth*0.5) and
-							(not AI.isPlayerOwned or not SceneMan:IsUnseen(TargetPoint.X, TargetPoint.Y, Owner.Team))
+							(not AI.isPlayerOwned or not SceneMan:IsUnseen(TargetPoint.X, TargetPoint.Y, Owner.Team)) and
+							not SceneMan:SmokeBlocksSight(Owner.EyePos, TargetPoint) -- lose track of targets hidden by smoke
 						then
 							if PrjDat.pen > 0 then
 								if SceneMan:CastStrengthSumRay(Weapon.Pos, TargetPoint, 6, rte.grassID) * 5 < PrjDat.pen then

Data/Base.rte/Activities.ini

@@ -288,6 +288,34 @@ AddActivity = GAScripted
 	AddRequiredArea = LZ All
 
 
+///////////////////////////////////////////////////////////////////////
+// Sandbox
+
+
+AddActivity = GAScripted
+	PresetName = Sandbox
+	Description = Play god. Spawn armies, brains, bunkers and weapons for up to four sides, paint fire, water and lava, call down lightning and change the weather, then watch the AI fight it out. Take control of any unit whenever you like. Nobody wins and nothing ends. Press F7 for the sandbox tools.
+	SceneName = Ketanot Hills
+	TeamOfPlayer1 = 0
+	MinTeamsRequired = 1
+	Team1Name = Red
+	Team2Name = Green
+	Team3Name = Blue
+	Team4Name = Yellow
+	Team1Funds = 0
+	Team2Funds = 0
+	Team3Funds = 0
+	Team4Funds = 0
+	ScriptPath = Base.rte/Activities/Sandbox.lua
+	LuaClassName = SandboxActivity
+	DefaultRequireClearPathToOrbit = 0
+	DefaultFogOfWar = 0
+	DefaultDeployUnits = 0
+	RequireClearPathToOrbitSwitchEnabled = 0
+	FogOfWarSwitchEnabled = 0
+	DeployUnitsSwitchEnabled = 0
+
+
 ///////////////////////////////////////////////////////////////////////
 // Test Activities
 

Data/Base.rte/Activities/Sandbox.lua

@@ -0,0 +1,34 @@
+package.loaded.Constants = nil; require("Constants");
+
+-- The Sandbox game mode. Almost everything happens in the sandbox tools (F7, Source/Managers/Sandbox.cpp):
+-- the player is a god watching from a free camera, every unit is run by the AI, and nothing ever ends the game.
+
+function SandboxActivity:StartActivity(isNewGame)
+	for player = Activity.PLAYER_1, Activity.MAXPLAYERCOUNT - 1 do
+		if self:PlayerActive(player) and self:PlayerHuman(player) then
+			self:SetViewState(Activity.OBSERVE, player);
+			-- Start looking at the ground in the middle of the map.
+			local look = Vector(SceneMan.SceneWidth * 0.5, 0);
+			while look.Y < SceneMan.SceneHeight - 1 and SceneMan:GetTerrMatter(look.X, look.Y) == rte.airID do
+				look.Y = look.Y + 4;
+			end
+			look.Y = look.Y - FrameMan.PlayerScreenHeight * 0.15;
+			self:SetObservationTarget(look, player);
+			CameraMan:SetScrollTarget(look, 1, self:ScreenOfPlayer(player));
+		end
+	end
+	-- Doors already in the scene open for everyone.
+	for actor in MovableMan.AddedActors do
+		if IsADoor(actor) then
+			actor.Team = Activity.NOTEAM;
+		end
+	end
+end
+
+function SandboxActivity:UpdateActivity()
+	-- Nobody wins: the game only ends when you leave it.
+end
+
+function SandboxActivity:OnSave()
+	-- Nothing extra to save, but saving needs this.
+end

Data/Base.rte/Devices.ini

@@ -22,6 +22,9 @@ IncludeFile = Base.rte/Devices/Weapons/RocketLauncher/RocketLauncher.ini
 // Explosives
 
 IncludeFile = Base.rte/Devices/Explosives/FragGrenade/FragGrenade.ini
+IncludeFile = Base.rte/Devices/Explosives/Flare/Flare.ini
+IncludeFile = Base.rte/Devices/Explosives/SmokeGrenade/SmokeGrenade.ini
+IncludeFile = Base.rte/Devices/Explosives/ToxicGasGrenade/ToxicGasGrenade.ini
 IncludeFile = Base.rte/Devices/Explosives/AntiPersonnelMine/AntiPersonnelMine.ini
 IncludeFile = Base.rte/Devices/Explosives/RemoteExplosive/RemoteExplosive.ini
 IncludeFile = Base.rte/Devices/Explosives/StandardBomb/StandardBomb.ini
@@ -35,6 +38,8 @@ IncludeFile = Base.rte/Devices/Tools/Digger/Digger.ini
 IncludeFile = Base.rte/Devices/Tools/Scanner/Scanner.ini
 IncludeFile = Base.rte/Devices/Tools/Disarmer/Disarmer.ini
 IncludeFile = Base.rte/Devices/Tools/ConcreteSprayer/ConcreteSprayer.ini
+IncludeFile = Base.rte/Devices/Weapons/LiquidSprayers/LiquidSprayers.ini
+IncludeFile = Base.rte/Devices/Explosives/FuelBarrel/FuelBarrel.ini
 IncludeFile = Base.rte/Devices/Tools/Repeller/Repeller.ini
 IncludeFile = Base.rte/Devices/Tools/GrappleGun/GrappleGun.ini
 IncludeFile = Base.rte/Devices/Tools/Constructor/Constructor.ini

Data/Base.rte/Devices/Explosives/Flare/Flare.ini

@@ -0,0 +1,81 @@
+// A thrown flare: lights the area around it in flickering red for about 45 seconds (see Flare.lua).
+
+AddDevice = TDExplosive
+	PresetName = Flare
+	Description = Throw it to light up the battlefield with a bright red glow for about 45 seconds. Handy at night.
+	AddToGroup = Bombs - Grenades
+	AddToGroup = Bombs
+	Mass = 0.5
+	RestThreshold = -500
+	HitsMOs = 1
+	GetsHitByMOs = 1
+	ScriptPath = Base.rte/Devices/Explosives/Flare/Flare.lua
+	ScreenEffect = ContentFile
+		FilePath = Base.rte/Effects/Glows/RedSmall.png
+	EffectStartStrength = 1
+	EffectStopStrength = 1
+	PostEffectEnabled = 0
+	EffectAlwaysShows = 1
+	SpriteFile = ContentFile
+		FilePath = Base.rte/Devices/Explosives/FragGrenade/FragGrenade.png
+	FrameCount = 2
+	SpriteAnimMode = 0
+	SpriteOffset = Vector
+		X = -3
+		Y = -4
+	EntryWound = AEmitter
+		CopyOf = Dent Metal
+	ExitWound = AEmitter
+		CopyOf = Dent Metal
+	GoldValue = 8
+	Buyable = 1
+	AtomGroup = AtomGroup
+		AutoGenerate = 1
+		Material = Material
+			CopyOf = Military Stuff
+		Resolution = 2
+		Depth = 0
+	DeepGroup = AtomGroup
+		AutoGenerate = 1
+		Material = Material
+			CopyOf = Military Stuff
+		Resolution = 4
+		Depth = 10
+	DeepCheck = 0
+	JointStrength = 75
+	JointStiffness = 0.5
+	JointOffset = Vector
+		X = -1
+		Y = 1
+	DrawAfterParent = 0
+	StanceOffset = Vector
+		X = 8
+		Y = 6
+	SharpStanceOffset = Vector
+		X = -7
+		Y = 7
+	SupportOffset = Vector
+		X = 1
+		Y = -2
+	SharpLength = 75
+	ActivationSound = SoundContainer
+		AddSound = ContentFile
+			FilePath = Base.rte/Sounds/Devices/EmptyClick1.flac
+	StartThrowOffset = Vector
+		X = -11
+		Y = -3
+	EndThrowOffset = Vector
+		X = 12
+		Y = -1
+	TriggerDelay = 45000
+	ActivatesWhenReleased = 1
+	StrikerLever = MOSParticle
+		CopyOf = Grenade Pin
+	AddGib = Gib
+		GibParticle = MOSParticle
+			CopyOf = Spark Yellow Particle
+		Count = 6
+		Spread = 3.14
+		MaxVelocity = 6
+		MinVelocity = 2
+		InheritsVel = 0

Data/Base.rte/Devices/Explosives/Flare/Flare.lua

@@ -0,0 +1,24 @@
+function Create(self)
+	self.lit = false;
+end
+
+function Update(self)
+	-- Once thrown, the flare burns with a flickering red light until it fizzles out.
+	-- Lit once thrown: activated, or flying free of whoever held it.
+	if not self.lit and (self:IsActivated() or (self.ID == self.RootID and self.Age > 150 and self.Vel.Magnitude > 0.5)) then
+		self.lit = true;
+		self.LightRadius = 320;
+		self.LightIntensity = 3.0;
+		self.LightFlicker = 0.25;
+		self:SetLightColor(255, 70, 50);
+		self.PostEffectEnabled = true;
+		self.burnTimer = Timer();
+	end
+	if self.lit and self.burnTimer then
+		-- Dim over the last few seconds of its life.
+		local remaining = 1 - self.burnTimer.ElapsedSimTimeMS / 45000;
+		if remaining < 0.15 then
+			self.LightIntensity = 3.0 * math.max(remaining / 0.15, 0);
+		end
+	end
+end

Data/Base.rte/Devices/Explosives/FuelBarrel/FuelBarrel.ini

@@ -0,0 +1,164 @@
+///////////////////////////////////////////////////////////////////////
+// Fuel Barrel: leaks oil where it's shot (the oil runs and pools), and explodes in a shower of burning fuel when fire reaches it or it's shot to pieces.
+
+
+AddEffect = MOPixel
+	PresetName = Leaking Fuel Drop
+	Mass = 0.03
+	AirResistance = 0.01
+	RestThreshold = 500
+	HitsMOs = 0
+	GetsHitByMOs = 0
+	Color = Color
+		R = 64
+		G = 19
+		B = 12
+	Atom = Atom
+		Material = Material
+			CopyOf = Oil
+		TrailColor = Color
+			R = 64
+			G = 19
+			B = 12
+		TrailLength = 2
+
+
+AddEffect = AEmitter
+	PresetName = Fuel Leak
+	Mass = 0.0001
+	HitsMOs = 0
+	GetsHitByMOs = 0
+	SpriteFile = ContentFile
+		FilePath = Base.rte/Effects/Wounds/MetalWoundA.png
+	FrameCount = 1
+	SpriteOffset = Vector
+		X = -2
+		Y = -2
+	AtomGroup = AtomGroup
+		AutoGenerate = 1
+		Material = Material
+			CopyOf = Military Stuff
+		Resolution = 2
+		Depth = 5
+	DeepCheck = 0
+	JointStrength = 10000
+	JointStiffness = 1
+	DrawAfterParent = 1
+	AddEmission = Emission
+		EmittedParticle = MOPixel
+			CopyOf = Leaking Fuel Drop
+		Spread = 0.3
+		MaxVelocity = 3
+		MinVelocity = 1
+	EmissionEnabled = 1
+	EmissionCountLimit = 150
+	EmissionsIgnoreThis = 1
+	ParticlesPerMinute = 400
+	BurstSize = 6
+	BurstScale = 1
+	BurstTriggered = 1
+	EmissionDamage = 0
+
+
+AddDevice = TDExplosive
+	PresetName = Fuel Barrel
+	AddToGroup = Bombs
+	AddToGroup = Bunker Systems
+	Description = A drum of fuel. Shoot it and it leaks oil that runs downhill and pools; set it alight, or shoot it to pieces, and it explodes in a shower of burning fuel.
+	Mass = 40
+	RestThreshold = -500
+	HitsMOs = 1
+	GetsHitByMOs = 1
+	ScriptPath = Base.rte/Devices/Explosives/FuelBarrel/FuelBarrel.lua
+	AddCustomValue = NumberValue
+		Flammable = 1
+	SpriteFile = ContentFile
+		FilePath = Base.rte/Devices/Explosives/FuelBarrel/FuelBarrel.png
+	FrameCount = 1
+	SpriteOffset = Vector
+		X = -5
+		Y = -7
+	EntryWound = AEmitter
+		CopyOf = Fuel Leak
+	ExitWound = AEmitter
+		CopyOf = Fuel Leak
+	GoldValue = 10
+	Buyable = 1
+	AtomGroup = AtomGroup
+		AutoGenerate = 1
+		Material = Material
+			CopyOf = Military Stuff
+		Resolution = 2
+		Depth = 0
+	DeepGroup = AtomGroup
+		AutoGenerate = 1
+		Material = Material
+			CopyOf = Military Stuff
+		Resolution = 4
+		Depth = 10
+	DeepCheck = 0
+	JointStrength = 40
+	JointStiffness = 0.5
+	DrawAfterParent = 0
+	StanceOffset = Vector
+		X = 7
+		Y = 5
+	SharpStanceOffset = Vector
+		X = 4
+		Y = -4
+	SupportOffset = Vector
+		X = 2
+		Y = 2
+	GibImpulseLimit = 3000
+	GibWoundLimit = 14
+	GibBlastStrength = 15
+	GibSound = SoundContainer
+		AttenuationStartDistance = 250
+		AddSound = Base.rte/Sounds/Explosions/Ballistic/ExplodeLarge1.flac
+		AddSound = Base.rte/Sounds/Explosions/Ballistic/ExplodeLarge2.flac
+		AddSound = Base.rte/Sounds/Explosions/Ballistic/ExplodeLarge3.flac
+	TriggerDelay = 600000
+	ActivatesWhenReleased = 0
+	AddGib = Gib
+		GibParticle = MOPixel
+			CopyOf = Glow Explosion Huge
+		MaxVelocity = 1
+	AddGib = Gib
+		GibParticle = MOSParticle
+			CopyOf = Fire Puff Large
+		Count = 8
+		MinVelocity = 10
+		MaxVelocity = 25
+		LifeVariation = 0.20
+		InheritsVel = 0
+	AddGib = Gib
+		GibParticle = MOPixel
+			CopyOf = Napalm Fuel
+		Count = 70
+		Spread = 3.14
+		MinVelocity = 4
+		MaxVelocity = 14
+		InheritsVel = 0
+	AddGib = Gib
+		GibParticle = MOSParticle
+			CopyOf = Flame Hurt Short
+		Count = 10
+		Spread = 3.14
+		MinVelocity = 3
+		MaxVelocity = 9
+		InheritsVel = 0
+	AddGib = Gib
+		GibParticle = MOSParticle
+			CopyOf = Explosion Smoke 1
+		Count = 6
+		Spread = 3.14
+		MinVelocity = 2
+		MaxVelocity = 6
+		InheritsVel = 0
+	AddGib = Gib
+		GibParticle = MOSParticle
+			CopyOf = Gib Military Tiny A
+		Count = 4
+		Spread = 3.14
+		MinVelocity = 6
+		MaxVelocity = 16