# vena.module.camera

**Repository Path**: nave-modules/vena.module.camera

## Basic Information

- **Project Name**: vena.module.camera
- **Description**: No description available
- **Primary Language**: C#
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-02-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vena Camera Module

基于栈的虚拟相机管理与轨道混合模块，提供统一的相机切换、参数计算与多轨道加权混合能力。

> [English Version](README.en.md)

## 用途
- 栈式虚拟相机切换（Push/Pop），支持自动回退
- 相机轨道混合（CameraMixerTrack），按优先级加权插值位置、旋转与 FOV
- 内置第一人称/第三人称相机实现
- 相机参数快照（CameraArgs）用于 Track 间传递

## 安装
- Unity Package Manager: Add from disk... 选择 `Packages/vena.module.camera`
- 或在 `Packages/manifest.json` 中添加本地路径引用

## 快速使用
```csharp
using UnityEngine;
using Vena.Camera;

public class CameraBootstrap : MonoBehaviour
{
    public Camera mainCamera;
    private ThirdPersonCamera _virtualCamera;

    private void Awake()
    {
        VenaCamera.camera = mainCamera;

        _virtualCamera = new ThirdPersonCamera
        {
            origin = transform,
            offset = new Vector3(0f, 1.6f, 0f),
            distanceRange = new Vector2(2f, 8f),
            distance = 4f
        };

        VenaCamera.Push(_virtualCamera);
    }

    private void OnDestroy()
    {
        VenaCamera.Pop(_virtualCamera);
    }
}
```

## 文档索引
- [架构设计](docs/architecture.md)：系统架构、边界与核心模型说明。
- [内部维护 SOP](docs/internal-sop.md)：内部维护与改动流程规范（仅维护者使用）。
- [外部集成与 API](docs/usage-sop.md)：使用指南、API 概览与集成说明。
- [Changelog](docs/changelog.md)：版本变更记录。
- [依赖说明](docs/dependencies.md)：模块依赖与引用说明。

## MCP Index
- Vena Camera：`Packages/vena.module.camera` / 相机管理模块 / Unity Package / v0.1.0 / 无外部模块依赖