# CdiuStage

**Repository Path**: ezofc/CdiuStage

## Basic Information

- **Project Name**: CdiuStage
- **Description**: 自动裁剪用于屏蔽 Cdiu 自定义舞台的左上角和左下角的文本区域，这样可以结合 OBS Studio 加载裁剪后的图片达到录制自编激舞视频时完美屏蔽文本显示的效果。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-04-12
- **Last Updated**: 2025-05-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: OBS, Cdiu, BeatUp, 激舞

## README

# CdiuStage

## 背景
在使用 Cdiu BeatUp Editor 加载自定义舞台时, 会出现以下几个问题：
1. 左边与上边会出现各一个像素的黑边
2. 左上角与左下角会有文本显示
3. 右挡屏会被拉升变形

## 功能
本程序可对 bg.dds 舞台文件进行区域裁剪, 裁剪后的 PNG 文件可加载到 OBS Studio 的场景中, 以达到完美屏蔽黑边及文本区域的效果, 还你一个纯净的录制画面。

## 软件架构
Python

## 安装教程
1. 安装 Python
2. 安装 Pillow
```cmd
pip install Pillow
```

## 使用说明
1. 修改 Cdiu 自定义舞台文件的路径 (CdiuStage/DdsHacker.py)
```python
# 舞台文件所在的用户文件夹.
strUserDir = path.join("D:", path.sep, "Program", "CdiuMod", "User")
```
2. 运行 CropDds.bat 即可在 Cdiu 主程序的 User\OBSImg 文件夹下看到生成的三张 PNG 图：
    * tl.png (左上)
    * bt.png (下边)
    * rt.png (右边)

3. 在 OBS Studio 中:
  1. 设置分辨率为 1024x768
  2. 在场景中:
    1. 添加游戏采集
    2. 设置采集窗口为 Cdiu BeatUp Editor, 为方便起见, 这里将采集窗口命名为 Player
    3. 单击 Player, 用方向键向左、上分别移动一个像素 (屏蔽舞台左边与上边的黑边)
    4. 添加生成的 PNG 图像到对应位置
    5. 添加 r3.png 到右挡屏的位置 (解决右挡屏被拉升的问题), 对应 OBS 场景配置文件 (.json) 中的位置参数如下:
      ```json
      {
        "name": "img-r3",
        "pos": {
            "x": 909.0,
            "y": 420.0
        }
      }
      ```

## 如何自定义舞台
1. 准备一张 1024x768 分辨率的图片；
2. 使用 dds 编辑软件将图片另存为 bg.dds（覆盖 User 文件夹下的 bg.dds 文件）；
3. 打开 CdiuBeatupEditor.exe, 选择【Map】菜单下的【User Setting】项即可看到替换后的舞台。

   ![自定义舞台](https://images.gitee.com/uploads/images/2020/0412/223021_cd2a8041_2194019.png "自定义舞台.png")