aardio 文档

autos.skills.blender 库模块帮助文档

autos.skills.blender 成员列表 #

autos.skills.blender.captureViewport(client,options) #

当前视口截图。method=offscreen(默认)、screen(区域含UI)、opengl(视口渲染)。
size=800,clean=true,outputDir 可省略。windowIndex/areaIndex/regionIndex 从1开始。
默认临时使用120秒RPC期限,调用后恢复;超时不取消、不重放。返回 path、method、warnings、imageCheck;不自动回退、不抢焦点。

autos.skills.blender.checkImage(path) #

GDI+解码与16x16像素采样。仅作空图提醒,不代表视觉验收;返回width/height/sampleMin/sampleMax/warnings。

autos.skills.blender.connect(session="autos",timeoutMs=30000) #

只连接现有会话。

返回对象:processBlenderClientObject

autos.skills.blender.diagnostics(client,options) #

返回Blender版本、displayGpu、Cycles配置、视口摘要。refreshDevices=true 才探测计算设备(可能初始化驱动)。
Cycles设备列表不是视口兼容性证明;不写偏好、不自动切换后端。

autos.skills.blender.diff(before,after,options) #

本地比较两份 snapshot,无需连接或启动 Blender。match=identity 默认要求同一运行期;跨进程/磁盘回读必须显式 match=name。
tolerance=0.000001 为数值绝对容差,可设0;哈希始终精确。maxChanges=200 仅限制字段详情,仍保留对象级结论。
返回 added/removed/changed/unchanged、unmatchedBefore/After、unverified、coverageComplete、equalWithinCoverage;status=equal/different/inconclusive。
added/removed 指观察范围的成员变化,不证明数据块新建/删除;范围不一致或截断时不推断缺失对象已删除。不是锁/事务/回滚。

autos.skills.blender.findPath() #

只读查找 blender.exe。

autos.skills.blender.finishRender(job) #

等待并排空管道,检查退出码、结果文件和图像;重复调用返回缓存,不再渲染。
长任务可在线程中调用;超时/取消不能通过丢弃job实现,可显式 job.process.terminate()。不跨工具调用传job对象。

autos.skills.blender.inspect(client,options) #

有界场景摘要。names/collection 二选一;includeChildren=true;limit=50,上限200。成功直接返回数据。
经RPC返回的业务数据保留logs元数据(旧桥接可能无此字段),包含stdout/stderr各自的totalBytes、keptBytes、truncated;勿把输出前缀当作完整日志。snapshot/diagnostics/captureViewport/preview同样保留。

autos.skills.blender.minAutos #

最小 Autos 版本。

autos.skills.blender.open(options) #

启动或重连原生 Blender 会话。默认 session=autos,其他参数同 process.blender.jsonRpc;已有会话不自动重启。

返回对象:processBlenderClientObject

autos.skills.blender.preview(client,options) #

隔离目标的多视图几何预览并拼图。names/collection 二选一;views=[iso,front,right];size=640;margin=0.12;maxObjects=200;sheet=false 可禁拼图。
不传 framing 则自动取景并返回 framing;再次传入原 framing 可锁定世界参考归一化、相机矩阵/正交尺度/裁剪、分辨率。用 JSON.save/load 保存,不要手改或四舍五入。
固定模式省略 views/size/margin 则继承;显式冲突报错。越界仍出图,framingCheck.outOfFrame 与每图 overflow 报告保守求值包围盒越界,不自动重新取景。
engine 默认 BLENDER_WORKBENCH,也支持 EEVEE(兼容新旧枚举名)、CYCLES;device=CPU/GPU 可选(仅Cycles)。固定构图不锁定模型/材质/引擎,不等于状态未变。
在当前Blender执行,可能占用主线程并替换Render Result;不改变原模型/相机/选择。返回 images、sheet、boundsWorld、skippedCount、framing、framingMode、framingCheck。

autos.skills.blender.renderBackground(client,options) #

当前相机/场景快照后在独立进程渲染单图。返回 job,立即调用 finishRender(job) 读取日志和结果。
options: outputDir、engine(省略继承)、size(最长边)、samples、device=CPU/GPU、computeDeviceType(如OPTIX/HIP/ONEAPI)。
不强制CPU、不保存偏好。有源相机才可用。保留snapshot.blend供排错;不自动打包外部资源或烘焙模拟。

autos.skills.blender.snapshot(client,options) #

有限只读状态快照,不是 .blend 备份。必须指定 names 或 collection;includeChildren=true,limit=200(最高1000)。
默认轻量;meshHash/nodeHash=true 按需计算基础网格/节点子集的精确指纹。Object模式,不切换模式、不注入模型UUID。
maxMeshElements=1000000、maxNodes=1000、maxBytes=2097152;返回 coverage.complete/truncated/missing/issues/excluded。只声明覆盖内的观察,不保证整模型未变。
用 JSON.save/load 保存回读;不可把跨线程丢失元信息的表代替原始JSON。当前RPC期限可用timeoutMs临时覆盖。

autos.skills.blender.version #

技能版本。

Markdown 格式 Autos 技能包提示词(skill.md)