# Cpp_Cmake_Project_Template

**Repository Path**: fangcongss/cpp_cmake_project_template

## Basic Information

- **Project Name**: Cpp_Cmake_Project_Template
- **Description**: 一个用Cmake管理C++项目工程的模板，可直接在此基础上构建大型C++工程项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-27
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenGL 3D Renderer

基于OpenGL 3.3的现代3D渲染引擎，使用GLAD、GLFW、GLM和Assimp。

## 特性

- **现代OpenGL**: 使用OpenGL 3.3核心模式
- **GLAD**: OpenGL加载器（替代GLEW）
- **GLFW**: 窗口管理和输入处理
- **GLM**: 图形数学库
- **Assimp**: 3D模型加载
- **跨平台**: Windows、macOS、Linux
- **CMake**: 构建系统
- **现代C++**: C++17特性

## 截图

![截图](https://p3-flow-imagex-sign.byteimg.com/tos-cn-i-a9rns2rl98/rc/pc/super_tool/6b628001afb44902ac5e1a647e9092a2~tplv-a9rns2rl98-image.image?rcl=20251117101053A461E9C187A8A04896E9&rk3s=8e244e95&rrcfp=f06b921b&x-expires=1765938019&x-signature=WIPv%2BgzZ%2BXCtwT4iAw85LUTZAug%3D)

## 国内用户特别说明

由于国内网络环境限制，GitHub访问可能不稳定。我们提供以下解决方案：

### 方法一：使用国内镜像源（推荐）

```bash
# 创建构建目录
mkdir build && cd build

# 使用国内镜像源配置CMake
cmake .. -DUSE_CN_MIRROR=ON

# 或者使用Gitee镜像
cmake .. -DUSE_GITEE_MIRROR=ON

# 或者使用GitHub镜像
cmake .. -DUSE_GITHUB_MIRROR=ON

# 构建
make -j$(nproc)  # Linux/macOS
# 或者
cmake --build . --config Release  # Windows
```

### 方法二：手动下载依赖（完全无法访问GitHub时）

```bash
# Linux/macOS
chmod +x download_deps.sh
./download_deps.sh

# Windows
download_deps.bat

# 然后配置CMake
mkdir build && cd build
cmake .. -DUSE_MANUAL_DEPS=ON

# 构建
make -j$(nproc)  # Linux/macOS
# 或者
cmake --build . --config Release  # Windows
```

### 方法三：使用一站式构建脚本

```bash
# Linux/macOS
chmod +x build.sh
./build.sh
```

脚本会自动检测网络环境，选择最佳的构建方式。

## 构建要求

- CMake 3.15或更高版本
- 支持C++17的编译器
- Git
- 支持OpenGL 3.3或更高版本的GPU

## 快速开始

### Linux/macOS

```bash
# 克隆仓库
git clone https://github.com/yourname/OpenGL3DRenderer.git
cd OpenGL3DRenderer

# 构建
./build.sh

# 运行
cd build
./bin/opengl3d_renderer
```

### Windows

```bash
# 克隆仓库
git clone https://github.com/yourname/OpenGL3DRenderer.git
cd OpenGL3DRenderer

# 下载依赖
download_deps.bat

# 创建构建目录
mkdir build && cd build

# 配置CMake
cmake .. -DUSE_MANUAL_DEPS=ON

# 构建
cmake --build . --config Release

# 运行
bin\Release\opengl3d_renderer.exe
```

## 项目结构

```
OpenGL3DRenderer/
├── cmake/                 # CMake模块
├── include/               # 头文件
│   └── opengl3d/
│       └── core/          # 核心组件
├── src/                   # 源文件
│   └── core/              # 核心实现
├── resources/             # 资源文件
│   ├── shaders/           # 着色器文件
│   ├── textures/          # 纹理文件
│   └── models/            # 3D模型文件
├── tests/                 # 单元测试
├── examples/              # 示例程序
├── docs/                  # 文档
├── CMakeLists.txt         # 主CMake文件
├── CMakeLists.txt_CN      # 国内镜像CMake文件
├── download_deps.sh       # Linux/macOS依赖下载脚本
├── download_deps.bat      # Windows依赖下载脚本
├── build.sh               # 构建脚本
├── README.md              # 英文README
└── README_CN.md           # 中文README
```

## 核心组件

- **Window**: 窗口管理（基于GLFW）
- **Shader**: 着色器程序管理
- **Texture**: 纹理加载和管理
- **Mesh**: 3D网格渲染
- **Model**: 3D模型加载（基于Assimp）
- **Renderer**: 渲染管理
- **Camera**: 相机系统

## 许可证

本项目采用MIT许可证 - 详见[LICENSE](LICENSE)文件。