Fighting Game · Guides & deep dives

V2 Split-Screen Camera

direction, per-player settings, safe-zone padding, and blend duration.

5sections1 minread
Markdown source
On this page

The split-screen camera layer resolves two-, three-, and four-player camera views into normalized viewport rectangles. It applies optional per-player camera offset and FOV settings before exporting camera manager mode specs for each player view.

Runtime Surface#

  • FV2SplitScreenCameraConfig configures requested player count, split direction, per-player settings, safe-zone padding, and blend duration.
  • FV2SplitScreenCameraPlayerSettings carries player id, base camera mode, per-player camera offset, optional custom FOV, FOV multiplier, and active state.
  • FV2SplitScreenCameraViewportRect stores normalized min and max viewport coordinates.
  • FV2SplitScreenCameraPlayerView returns the resolved viewport and camera mode for a player.
  • FV2SplitScreenCameraEvaluation returns resolved player count, requested and resolved split direction, layout flags, player views, and validation issues.

Split Rules#

  1. Split-screen requires at least two active players and supports up to four.
  2. Requested player count is clamped to the supported two-to-four range.
  3. Auto resolves to vertical for two players and grid for three or four.
  4. Horizontal stacks player viewports from top to bottom.
  5. Vertical splits player viewports from left to right.
  6. Grid uses two columns and one or two rows depending on player count.
  7. Safe-zone padding shrinks each viewport and reports ViewportPadded.
  8. Duplicate player ids, invalid camera modes, invalid FOV settings, or too few active players are blocking.

Per-Player Camera Settings#

When bUsePerPlayerCameraSettings is enabled, each player can add a camera offset, use a custom FOV, or multiply the base camera FOV. FOV values are clamped to camera manager bounds and report CameraSettingsClamped.

Camera Manager Export#

EvaluateSplitScreenCamera fills each player view with a camera manager mode spec that preserves the player camera mode type, rotation, blend function, input flags, and cinematic flags. BuildSplitScreenPlayerMode can export a custom id, priority, and active flag for any resolved player view.

Validation Commands#

Run these targeted checks when touching split-screen camera:

bash
python3 V2/ue/Tools/check-v2-split-screen-camera.py
python3 V2/ue/Tools/check-v2-camera-manager.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/Camera/SplitScreenCamera_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-split-screen-camera.py