SuperAPI AI 工具集

blender-core-gpu

设计与创作

查看项目

更新于 10-15 22:17

技能介绍

用途:在 Blender Python 中绘制自定义叠加层、视口可视化或离屏渲染时,指导使用 gpu 模块而非已废弃的 bgl 模块。

主要能力:涵盖 gpu、gpu.shader、gpu.types、gpu.state、gpu.texture、gpu.matrix、gpu.select、gpu.platform 及 gpu_extras.batch、gpu_extras.presets 等模块;提供内置着色器(UNIFORM_COLOR、POLYLINE_UNIFORM_COLOR、FLAT_COLOR、SMOOTH_COLOR、IMAGE 等)用法、绘制回调注册与移除、离屏缓冲、状态管理与 bgl 到 gpu 的迁移对照。

必要用法:使用 gpu.shader.from_builtin() 获取着色器,配合 batch_for_shader() 构建批次;POLYLINE_* 着色器必须设置 viewportSize 与 lineWidth uniform;绘制结束须恢复 gpu.state 默认值;离屏缓冲用完调用 offscreen.free();在 addon 的 unregister() 中移除 draw handler。

限制:bgl 自 Blender 3.5 起废弃、5.0 完全移除;4.0+ 移除 3D_/2D_ 前缀;所有 GPU 操作必须在主线程执行,离屏缓冲需有效图形上下文。具体版本兼容与完整 API 签名以官方文档为准。