punkfuncgames/camera-module

CameraModule Reference

Package: com.punkfuncgames.camera | Define: PUNKFUNC_CAMERA Location: Packages/com.punkfuncgames.camera/Runtime/PunkFuncGames.Camera/ Namespace: PunkFuncGames.Camera

ICameraService

Properties:

• Camera MainCamera
• ReadOnlyReactiveProperty<string> ActiveCameraName

Camera Switching:

• SwitchCamera(string cameraName, float blendTime = 1f) — priority-based (target=10, previous=0)

Targets:

• SetFollowTarget(Transform target) — sets on current + all cameras without follow
• SetLookAtTarget(Transform target) — sets on current camera

Effects:

• Shake(float intensity = 1f, float duration = 0.3f) — Cinemachine noise or DOTween position fallback
• SetZoom(float zoom, float duration = 0.5f) — tweens OrthographicSize (ortho) or FOV (perspective)
• ResetCamera() — kills all tweens, resets noise gains

Coordinate Conversion:

• Vector3 ScreenToWorldPoint(Vector2 screenPosition)
• Vector2 WorldToScreenPoint(Vector3 worldPosition)

Implementation: CameraService

No constructor dependencies. Finds Camera.main and adds CinemachineBrain if missing.

Camera Registration (call from MonoBehaviour or service):

• RegisterCamera(string name, CinemachineCamera camera) — caches noise component
• UnregisterCamera(string name)

Shake Strategy:

1. If Cinemachine noise component exists → tween AmplitudeGain/FrequencyGain
2. Fallback → DOTween position shake on camera transform

Events (MessagePipe requests)

| Event | Key Fields | |-------|------------| | CameraShakeRequest | Intensity (1f), Duration (0.3f) | | CameraFollowRequest | Target (Transform), BlendTime (0.5f) |

CameraEventHandler bridges events to CameraService automatically.

Installer

CameraInstaller.Install(builder, options);
// Registers: CameraService (Singleton), CameraEventHandler (Singleton)
// Events: CameraShakeRequest, CameraFollowRequest

Usage Pattern

// Direct service call
_cameraService.SwitchCamera("BossCamera", blendTime: 2f);
_cameraService.SetFollowTarget(player.transform);
_cameraService.Shake(intensity: 2f, duration: 0.5f);
_cameraService.SetZoom(5f, duration: 1f);

// Via MessagePipe (decoupled)
_shakePublisher.Publish(new CameraShakeRequest(intensity: 1.5f, duration: 0.4f));
_followPublisher.Publish(new CameraFollowRequest(player.transform, blendTime: 1f));

// Coordinate conversion
Vector3 worldPos = _cameraService.ScreenToWorldPoint(Input.mousePosition);