# 在Object001上添加Plane并刻文字Logo的完整指南

## 概述
本指南提供了两种在指定GameObject（如Object001）上添加Plane并刻上文字Logo的方法：
1. **LogoPlaneCreator** - 创建2D文字Logo
2. **Logo3DCarver** - 创建3D雕刻文字Logo

## 方法一：使用LogoPlaneCreator（2D文字）

### 功能特点
- 支持TextMeshPro和传统Text组件
- 可自定义字体、颜色、大小
- 支持Canvas世界空间渲染
- 文字自动面向摄像机

### 使用步骤

1. **创建脚本对象**
   ```
   在场景中创建空GameObject → 添加LogoPlaneCreator脚本
   ```

2. **配置目标对象**
   - 直接拖拽Object001到`Target Object`字段
   - 或在`Target Object Name`中输入"Object001"

3. **设置Plane参数**
   - `Plane Position`: Plane相对于目标对象的位置
   - `Plane Rotation`: Plane的旋转角度
   - `Plane Scale`: Plane的缩放
   - `Plane Material`: Plane的材质

4. **配置Logo文字**
   - `Logo Text`: 要显示的文字
   - `Logo Font`: 字体
   - `Font Size`: 字体大小
   - `Text Color`: 文字颜色
   - `Text Alignment`: 文字对齐方式

5. **高级设置**
   - `Use TextMeshPro`: 是否使用TextMeshPro（推荐）
   - `Create As Child`: 是否作为子对象创建
   - `Add Collider`: 是否添加碰撞体
   - `Add Rigidbody`: 是否添加刚体

6. **执行创建**
   ```
   右键点击脚本 → 选择"创建Logo Plane"
   ```

### 右键菜单命令
- **创建Logo Plane**: 创建Plane和文字Logo
- **删除Logo Plane**: 删除已创建的Logo
- **更新Logo文字**: 更新文字内容
- **查找目标对象**: 自动查找目标对象

## 方法二：使用Logo3DCarver（3D雕刻文字）

### 功能特点
- 真正的3D文字雕刻效果
- 支持凹陷和凸起两种效果
- 可自定义雕刻深度
- 支持发光材质效果
- 完整的3D Mesh生成

### 使用步骤

1. **创建脚本对象**
   ```
   在场景中创建空GameObject → 添加Logo3DCarver脚本
   ```

2. **配置目标对象**
   - 直接拖拽Object001到`Target Object`字段
   - 或在`Target Object Name`中输入"Object001"

3. **设置Plane参数**
   - `Plane Position`: Plane相对于目标对象的位置
   - `Plane Rotation`: Plane的旋转角度
   - `Plane Scale`: Plane的缩放
   - `Plane Material`: Plane的材质

4. **配置3D雕刻文字**
   - `Logo Text`: 要雕刻的文字
   - `Logo Font`: 字体
   - `Font Size`: 字体大小
   - `Carve Depth`: 雕刻深度
   - `Text Color`: 文字颜色
   - `Emboss`: 浮雕效果（凸起）
   - `Carve`: 雕刻效果（凹陷）

5. **材质设置**
   - `Text Material`: 文字材质
   - `Use Emission`: 是否使用发光效果
   - `Emission Color`: 发光颜色
   - `Emission Intensity`: 发光强度

6. **执行创建**
   ```
   右键点击脚本 → 选择"创建3D雕刻Logo"
   ```

### 右键菜单命令
- **创建3D雕刻Logo**: 创建Plane和3D雕刻文字
- **删除3D雕刻Logo**: 删除已创建的Logo
- **更新3D文字**: 更新文字内容
- **查找目标对象**: 自动查找目标对象

## 快速开始示例

### 示例1：简单2D Logo
```csharp
// 1. 创建空GameObject
// 2. 添加LogoPlaneCreator脚本
// 3. 设置参数：
//    - Target Object Name: "Object001"
//    - Logo Text: "MY LOGO"
//    - Font Size: 48
//    - Text Color: White
// 4. 右键选择"创建Logo Plane"
```

### 示例2：3D雕刻Logo
```csharp
// 1. 创建空GameObject
// 2. 添加Logo3DCarver脚本
// 3. 设置参数：
//    - Target Object Name: "Object001"
//    - Logo Text: "3D LOGO"
//    - Carve Depth: 0.1
//    - Carve: true
//    - Use Emission: true
//    - Emission Color: Yellow
// 4. 右键选择"创建3D雕刻Logo"
```

## 常见问题解决

### 1. 找不到目标对象
**问题**: 提示"未找到名为Object001的对象"
**解决**: 
- 确认对象名称拼写正确
- 使用"查找目标对象"功能
- 直接拖拽对象到Target Object字段

### 2. 文字不显示
**问题**: Plane创建成功但文字不可见
**解决**:
- 检查文字颜色是否与背景对比
- 调整文字位置偏移
- 确认字体文件存在

### 3. 3D文字效果不明显
**问题**: 3D雕刻效果太浅
**解决**:
- 增加Carve Depth值
- 调整材质和光照
- 启用发光效果

### 4. 文字方向错误
**问题**: 文字朝向不正确
**解决**:
- 调整Plane Rotation
- 修改文字对象的旋转
- 使用LookAt功能自动面向摄像机

## 高级技巧

### 1. 材质优化
```csharp
// 创建发光材质
Material glowMaterial = new Material(Shader.Find("Standard"));
glowMaterial.EnableKeyword("_EMISSION");
glowMaterial.SetColor("_EmissionColor", Color.yellow);
```

### 2. 动态更新文字
```csharp
// 在代码中动态更新文字
LogoPlaneCreator creator = GetComponent<LogoPlaneCreator>();
// 修改logoText参数后调用
creator.UpdateLogoText();
```

### 3. 批量处理
```csharp
// 为多个对象创建Logo
GameObject[] targets = {"Object001", "Object002", "Object003"};
foreach (string targetName in targets)
{
    // 设置目标名称并创建Logo
}
```

### 4. 自定义字体
```csharp
// 加载自定义字体
Font customFont = Resources.Load<Font>("Fonts/MyCustomFont");
// 设置到脚本的Logo Font字段
```

## 性能优化建议

1. **合理使用发光效果**: 发光材质会增加渲染负担
2. **控制文字复杂度**: 避免使用过于复杂的字体
3. **适当设置LOD**: 对于3D文字，考虑距离LOD
4. **材质合并**: 相同材质的对象可以合并渲染

## 扩展功能

### 1. 添加动画效果
```csharp
// 添加旋转动画
void Update()
{
    if (carvedText != null)
    {
        carvedText.transform.Rotate(0, 1, 0);
    }
}
```

### 2. 交互功能
```csharp
// 添加点击事件
void OnMouseDown()
{
    // 处理Logo点击
    Debug.Log("Logo被点击了！");
}
```

### 3. 动态颜色变化
```csharp
// 颜色渐变效果
void Start()
{
    StartCoroutine(ColorAnimation());
}

IEnumerator ColorAnimation()
{
    while (true)
    {
        // 颜色变化逻辑
        yield return new WaitForSeconds(0.1f);
    }
}
```