phaneron/Kelsidavis-WoWee
1
0
Fork 0
mirror of https://github.com/Kelsidavis/WoWee.git synced 2026-05-11 19:43:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

feat(pipeline): WCAM camera presets catalog (144th open format)

Browse source 
Novel format covering what vanilla WoW handled with hard-coded
camera profiles in the client's CameraMgr (the standard third-
person camera, the flight-path camera, vehicle cameras and
cinematic cameras were all bespoke C++ classes with no data-
driven extension point). Each WCAM entry binds one camera
preset to its FOV, distance, pitch/yaw offsets, shoulder offset,
focus-bone tracking target (M2 bone index, 0xFFFF = follow root),
motion damping curve (0=instant follow / 255=maximum lag), and
intended purpose (Cinematic / Combat / Mounted / Vehicle /
Cutscene / PhotoMode).

Three presets covering common camera scenarios:
  --gen-cam-combat     3 Combat variants (default 75deg / wide
                       ranged 90deg / tight melee 60deg
                       shoulder-cam tracking chest bone) with
                       low motion damping (8-15) for responsive
                       tracking
  --gen-cam-mounted    2 Mounted variants (ground 80deg pulled-
                       back / flying 85deg high-pitch wing-frame)
                       with medium-high damping (60-90) for
                       smooth turning
  --gen-cam-cinematic  3 Cinematic angles (over-shoulder
                       dialogue 50deg telephoto / wide
                       establishing 100deg / portrait 35deg
                       3/4-face composition with yaw offset and
                       head-bone tracking) with high damping
                       (180-220) for film-quality motion

Validator catches: id+name required, purposeKind 0..5, no
duplicate presetIds, FOV in (0,180) (zero/negative makes no
sense, >=180 inverts the view frustum), distanceFromTarget >= 0
(negative places camera in front of target). CRITICAL: pitch
within (-89, +89) — beyond gimbal-locks the camera. Warns on
FOV outside 30..120 player-comfort range (motion-sickness risk
or extreme telephoto compression), distanceFromTarget < 0.5m
(clips into model), and yawOffsetDegrees beyond ±180° (wraps to
smaller equivalent angle — simplify).

Format count 143 -> 144. CLI flag count 1490 -> 1497.
This commit is contained in:
Kelsi 2026-05-10 05:54:48 -07:00
parent 7fbf35e98c
commit ab69171ad9
10 changed files with 722 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

2
tools/editor/cli_dispatch.cpp
View file

@ -188,6 +188,7 @@
#include "cli_sound_swap_catalog.hpp"
#include "cli_tutorial_steps_catalog.hpp"
#include "cli_chat_commands_catalog.hpp"
#include "cli_camera_presets_catalog.hpp"
#include "cli_catalog_pluck.hpp"
#include "cli_catalog_find.hpp"
#include "cli_catalog_by_name.hpp"
@ -421,6 +422,7 @@ constexpr DispatchFn kDispatchTable[] = {
handleSoundSwapCatalog,
handleTutorialStepsCatalog,
handleChatCommandsCatalog,
handleCameraPresetsCatalog,
handleCatalogPluck,
handleCatalogFind,
handleCatalogByName,