Shared camera feed component: owns one camera component's render target and re-enables it only while a TV or weapon calls RequestFrame. Also handles temporary held/tracking view overrides and restoring the authored lens transform on save.
/// <summary>
/// Shared video output for physical cameras and camera weapons. Owns the render target
/// and render demand; producers only supply the lens view and TVs consume this component.
/// </summary>
[Title( "#entity.name.camera_feed" ), Icon( "videocam" ), SignalOutput( Default = true )]
public sealed class CameraFeed : Component, Global.ISaveEvents
{
[Property] public CameraComponent Lens { get; set; }
Texture _renderTexture;
RealTimeSince _lastRequested = 999f;
Transform _localView;
bool _overridingView;
public CameraComponent Camera
{
get
{
if ( !Lens.IsValid() ) Lens = GetComponentInChildren<CameraComponent>( true );
return Lens;
}
}
public Transform ViewTransform => Camera.IsValid() ? Camera.WorldTransform : WorldTransform;
/// <summary>The authored lens mount, unaffected by temporary held/tracking view overrides.</summary>
public Transform PhysicalViewTransform => _overridingView && Camera.IsValid()
? (Camera.GameObject.Parent?.WorldTransform ?? global::Transform.Zero).ToWorld( _localView )
: ViewTransform;
public Texture RenderTexture => Active ? _renderTexture : null;
/// <summary>A visible TV requests frames. Multiple TVs can share a feed without disabling each other.</summary>
public Texture RequestFrame()
{
if ( !Active || !Camera.IsValid() ) return null;
if ( !_renderTexture.IsValid() )
_renderTexture = Texture.CreateRenderTarget().WithSize( 512, 512 ).Create();
_lastRequested = 0;
Camera.RenderTarget = _renderTexture;
Camera.Enabled = true;
return _renderTexture;
}
protected override void OnEnabled()
{
if ( !Camera.IsValid() ) return;
Camera.IsMainCamera = false;
Camera.BackgroundColor = Color.Black;
Camera.ClearFlags = ClearFlags.Color | ClearFlags.Depth | ClearFlags.Stencil;
Camera.RenderExcludeTags.Add( "viewmodel" );
Camera.Enabled = false;
}
protected override void OnUpdate()
{
if ( Camera.IsValid() ) Camera.Enabled = _renderTexture.IsValid() && _lastRequested < 0.25f;
}
protected override void OnPreRender()
{
if ( Camera.IsValid() && _renderTexture.IsValid() ) Camera.RenderTarget = _renderTexture;
}
/// <summary>Use the lens's physical transform, restoring it after a held-camera override.</summary>
public void UseLensView( float fov )
{
if ( !Camera.IsValid() ) return;
RestoreLens();
Camera.FieldOfView = fov;
Camera.FovAxis = CameraComponent.Axis.Horizontal;
Camera.RenderExcludeTags.Remove( "viewer" );
}
public void SetWorldView( Transform view, float fov, CameraComponent.Axis axis, bool hideViewer )
{
if ( !Camera.IsValid() ) return;
if ( !_overridingView ) _localView = Camera.LocalTransform;
_overridingView = true;
Camera.WorldPosition = view.Position;
Camera.WorldRotation = view.Rotation;
Camera.FieldOfView = fov;
Camera.FovAxis = axis;
Camera.RenderExcludeTags.Set( "viewer", hideViewer );
}
void RestoreLens()
{
if ( _overridingView && Camera.IsValid() ) Camera.LocalTransform = _localView;
_overridingView = false;
}
void Cleanup()
{
RestoreLens();
if ( Camera.IsValid() ) { Camera.Enabled = false; Camera.RenderTarget = null; }
_renderTexture?.Dispose();
_renderTexture = null;
_lastRequested = 999f;
}
protected override void OnDisabled() => Cleanup();
protected override void OnDestroy() => Cleanup();
void Global.ISaveEvents.BeforeSave( string filename )
{
// Save the authored lens offset, not its temporary held-player position.
if ( _overridingView && Camera.IsValid() ) Camera.LocalTransform = _localView;
}
}