mirror of
https://github.com/brues-code/ClassicAPI.git
synced 2026-11-16 16:10:36 +00:00
A WMO backdrop now shows its doodads the way the world builds them, and every sound a scene plays is heard from the scene's camera at its distance. Doodads (model/SceneWorld.cpp). Each parsed group makes its doodads as CreateGroupDoodads (0x00695AA0) does: the group's MODR indices, kept when FindDoodadSet (0x006A4FB0) gives set 0 or the instance's set; a doodad two groups list is one def, sun-lit when any of them is exterior. Each def mirrors CreateGroupDoodadDef (0x00694E90) and CreateDoodadModel (0x00695100): the MODD record's translate / quaternion / scale matrix times the placement, SplitLightColor (0x006A77E0) into the ambient and directional bytes, the model from the MODN name, SetBaseTransform, the engine's own done callback (0x006951B0) and PlayAnimation(-1, 0, -1, ...). Lighting mirrors AddLights (0x006A8050): an exterior doodad takes the frame's sun (the frame light callback 0x0076D680); an interior one its ambient bytes and its directional bytes along the fixed direction at 0x00CA816C, then the group's MOLT point lights built as CreateGroupLights (0x00695C00) and AddMapLight (0x006A7AC0) build them. An interior doodad in a WMO with more than one MFOG takes MFOG[0], else the scene's fog. Each frame mirrors DrawDoodadModels (0x00683F80): the world shows every doodad it draws again (SetAnimated + SetVisible), faded by its sphere (SetDoodadDefBounds 0x006952A0, CM2Model::GetBoundingSphere 0x00713680) and the camera's ground distance, with the radius classes, fade ends and ranges read live from 0x00810188..0x008101A8 and the large end capped by the far clip. Doodad sounds are opt-in, scene:SetPlayWorldModelSounds(enabled) / GetPlayWorldModelSounds (a ClassicAPI extension, off by default): the $DSO / $DSL / $DSE events of DoodadModelEvent (0x006951E0) through PlaySoundAt (0x00458870) and the world's loop emitters (0x00461D80 add, 0x00462000 move, 0x00461F80 remove). The emitter pump runs only in the world, so they play only there. A hidden scene (CSimpleFrame::Hide, 0x0076AD50) drops its loops. Positional scene sounds (model/SceneSound.cpp). The engine has one listener, placed by the world camera. A scene point is played where it lies from the scene camera, its offsets along the camera's forward, up and side laid along the listener's, read back through FSOUND_3D_Listener_GetAttributes (0x007FDB50) in the engine's axes. The engine then applies the row's cutoff, minimum distance and panning as for a unit that far away. Sound::Play gains the world's 3D players: PlayKitIDAt (0x0045CF00, RET 0x18, NULL past the cutoff), PlayKitLoopedAt (0x004589A0) and Move (Sound::SetPosition 0x007A5B10), all owned so StopSound stops them. The actors use it: spell kit sounds at the actor, the missile's loop following the missile (re-mapped each paint) and stopped when the scene hides, and the animation sounds of SetPlayAnimationSounds at the actor. actor:PlaySound(soundKitID) is a ClassicAPI extension: a SoundKitID once at the actor, returning willPlay, soundHandle as PlaySound does.