# pymi

**Repository Path**: hineven/pymi

## Basic Information

- **Project Name**: pymi
- **Description**: 派米
好吧，这实际上是MiRenderer的python遥控仓库，负责使用ZMQ和MiRenderer通信，进行遥控、截图等
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pymi

MIRenderer 的 Python 远程控制客户端。

## 简介

`pymi` 通过 ZMQ 协议与 MIRenderer 3D 查看器通信，允许你从 Python 脚本远程控制渲染器、加载模型、调整相机参数以及导出渲染数据。

## 安装

```bash
pip install pyzmq numpy
```

## 快速开始

```python
from pymi import ViewerClient
import numpy as np

# 连接到 MIRenderer（默认端口 25957）
client = ViewerClient()

# 检查连接
client.ping()

# 加载模型
client.load_gltf_abs_path("/path/to/model.gltf")

# 设置相机位置
client.set_camera_pos([0, 0, 5])
client.set_camera_dir([0, 0, -1])

# 渲染并导出当前帧
result = client.render_and_export_current_frame(types=["radiance"])
image = result["exports"][0]["data"]  # numpy 数组
```

## 主要功能

- **模型加载**: `load_gltf_abs_path()`, `load_ply_abs_path()`
- **相机控制**: `set_camera_pos()`, `set_camera_dir()`, `set_camera_fovy()`
- **渲染导出**: `render_and_export_current_frame()` - 支持导出 radiance、depth、normal 等
- **场景管理**: `set_transform()`, `remove_renderable_node()`
- **控制台命令**: `console_execute()`, `get_cvar()`, `set_cvar()`

## 协议说明

- 服务器地址: `tcp://127.0.0.1:25957`
- 通信模式: ZMQ REQ/REP（请求-回复）
- 数据格式: JSON + 二进制帧（用于图像数据）

## 依赖

- Python >= 3.10
- pyzmq
- numpy