C#调用Blender的BPY
1.编译BPY
(1) 编译环境
需要安装以下软件,SVN用来下载第三方库,Git用来更新Blender的源码,第三方库下载最好科学上网,因为文件数量比较多,我实际上是用TortoiseSVN下载的。
•Visual Studio 2019 Community Edition
•Subversion for Windows (SlikSVN)
•Git for Windows
(2)源码下载
版本根据需要自己指定即可
git clone -b blender-v2.93-release https://github.com/blender/blender.git
(3)第三方库下载
第三方库比较大,下载时间比较久,建议用TortoiseSVN
svn co https://svn.blender.org/svnroot/bf-blender/trunk/lib/win64_vc15/
最后目录结构为:
--blender
--lib\win64_vc15
(4) 更新并编译
make是Blender的编译命令,2019是指定vs的版本
cd blender
make update 2019
make bpy 2019
(5)拷贝
更新完毕之后会在blender同级目录下生成build_windows_Bpy_x64_vc16_Release文件夹,BPY库在 build_windows_Bpy_x64_vc16_Release\bin\Release中。
此处,将Release目录下文件夹2.93,bpy文件,和所有的dll文件拷贝到任意目录中,比如C:\Python\blender-2.93,之后该目录会在代码中进行设置。
2.安装PythonNet
此处我需要将Python引擎嵌入到自己的库中,所以此处使用Python的嵌入式版本,Python虚拟环境配置更为复杂,此处不做探讨。
Blender 2.93的第三方库使用的Python3.92,此处需要保持一致。
(1)下载 python-3.9.2-embed-amd64.zip并解压到C:\Python\python-3.9.2-embed-amd64
(2)安装pip
解压完毕之后,进入C:\Python\python-3.9.2-embed-amd64文件夹,下载get-pip脚本,并安装pip。
python get-pip.py
(3)配置
修改文件 python39._pth,取消import site的注释
(4)安装PythonNet
python -m pip install pythonnet
3.C#测试代码
新建C#工程,引用C:\Python\python-3.9.2-embed-amd64\Lib\site-packages\Python.Runtime.dll
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Python.Runtime;
namespace ConsoleApp
{
class Program
{
static IntPtr InitializePythonEngine()
{
System.Console.WriteLine("Initializing Python Engine...");
var PythonHome = @"C:\Python\python-3.9.2-embed-amd64";
var BlenderHome = @"C:\Python\blender-2.93";
//SystemPath
var SystemPath = Environment.GetEnvironmentVariable("PATH").TrimEnd(';');
SystemPath = string.IsNullOrEmpty(SystemPath) ? PythonHome : SystemPath + ";" + PythonHome;
Environment.SetEnvironmentVariable("PATH", SystemPath, EnvironmentVariableTarget.Process);
//PythonHome,此处不需要设置PYTHONHOME,PYTHONNET_PYDLL等环境变量
PythonEngine.PythonHome = PythonHome;
//PythonPath
var PythonLib = $@"{PythonHome}\Lib";
var PythonSitePackages = $@"{PythonHome}\Lib\site-packages";
var PythonZip = $@"{PythonHome}\python39.zip";
PythonEngine.PythonPath = $"{PythonZip};{PythonHome};{PythonLib};{PythonSitePackages};{BlenderHome}";
//Blender
Environment.SetEnvironmentVariable("BLENDER_SYSTEM_SCRIPTS", $@"{BlenderHome}\2.93\scripts");
Environment.SetEnvironmentVariable("BLENDER_SYSTEM_DATAFILES", $@"{BlenderHome}\2.93\datafiles");
//Initialize
PythonEngine.Initialize();
IntPtr ThreadsPtr = PythonEngine.BeginAllowThreads();
return ThreadsPtr;
}
static void ShutdownPythonEngine(IntPtr ThreadsPtr)
{
//Shutdown
System.Console.WriteLine("Shutting Down Python Engine...");
PythonEngine.EndAllowThreads(ThreadsPtr);
PythonEngine.Shutdown();
}
static void Main(string[] args)
{
IntPtr ThreadsPtr = InitializePythonEngine();
if(ThreadsPtr != null)
{
//http://pythonnet.github.io/
using (Py.GIL())
{
dynamic bpy = Py.Import("bpy");
bpy.ops.render.render(write_still: true);
}
ShutdownPythonEngine(ThreadsPtr);
}
}
}
}
4 Python测试代码
# -*- coding: utf-8 -*-
blenderhome=R"C:\Python\blender-2.93"
# 指定bpy依赖库路径
import sys
sys.path.append(blenderhome)
# 指定x.y下子文件夹的环境变量
import os
os.environ['BLENDER_SYSTEM_DATAFILES']= blenderhome + R"\2.93\datafiles"
os.environ['BLENDER_SYSTEM_SCRIPTS']=blenderhome + R"\2.93\scripts"
import bpy
bpy.ops.render.render(write_still=True)
5 import的问题
C#测试过程中,出现了import调用失败的问题,此处只需要按照以下修改C:\Python\blender-2.93\2.93下代码即可,一共有三处。
__import__(name=__name__, fromlist=_modules)
改成
__import__(__name__, fromlist=_modules)