Blender后台脚本添加DAE模型纹理显示异常问题排查

The core problem with your script is that it relies heavily on Blender's UI context elements (like windows, screens, and viewport areas) which don't exist when running Blender in --background mode. When you run the script interactively in the Blender UI, these elements are present, so the operations work—but in headless mode, they're missing, leading to failed UV unwrapping and incorrect view transformations.

Let's break down the key issues and fix them:

1. Hardcoded Area Index & Viewport Operations Fail in Background Mode #

Your code uses bpy.context.screen.areas[2] to target the 3D Viewport, but in background mode, the screen/area structure is completely different (there are no UI areas at all). This means your viewport rotation/orthographic setup does nothing, and worse, could throw silent errors that break subsequent steps.

Fix: Avoid UI-dependent view operations entirely—they're irrelevant when exporting a model. Instead, modify the object's transform directly (which is reliable in any mode):

# Get the imported object (assuming single object is imported; adjust if multiple)
imported_obj = bpy.context.selected_objects[0]

# Rotate and scale the object directly (no UI context needed)
imported_obj.rotation_euler = (-pi/2, 0, 0)
imported_obj.scale = (myscale, myscale, myscale)

# Apply transformations to make them permanent (optional but recommended)
bpy.context.view_layer.objects.active = imported_obj
bpy.ops.object.transform_apply(location=False, rotation=True, scale=True)

2. UV Unwrapping with project_from_view Depends on UI Viewport #

The bpy.ops.uv.project_from_view operation requires an active 3D Viewport to project from—and in background mode, there's no viewport to use. Your override context code can't find any valid VIEW_3D area, so the UV unwrap step never runs, leading to broken texture mapping.

Fix: Use a UI-independent UV unwrapping method like smart_project, which works purely on the mesh geometry:

# Unwrap the mesh without UI dependencies
bpy.context.view_layer.objects.active = imported_obj
bpy.ops.object.mode_set(mode='EDIT')
bpy.ops.mesh.select_all(action='SELECT')
# Smart project creates clean UV islands without needing a viewport
bpy.ops.uv.smart_project(angle_limit=66, island_margin=0.02)
bpy.ops.object.mode_set(mode='OBJECT')

3. Hardcoded Material Name & Legacy Shader Setup #

Your code references bpy.data.materials['m0DefaultMaterial'] directly, which breaks if the imported DAE uses a different material name. Additionally, you're using Blender's legacy material system (pre-node-based), which is less reliable and may not export correctly.

Fix: Fetch the material from the imported object directly, and use Blender's modern node-based shader system:

# Load texture image
imgpath = "input.jpg"
img = bpy.data.images.load(filepath=imgpath)

# Get or create material for the imported object
if imported_obj.data.materials:
    mat = imported_obj.data.materials[0]
else:
    mat = bpy.data.materials.new(name="TexturedMaterial")
    imported_obj.data.materials.append(mat)

# Switch to node-based shader system
mat.use_nodes = True
nodes = mat.node_tree.nodes
links = mat.node_tree.links

# Clear default nodes
for node in nodes:
    nodes.remove(node)

# Create required shader nodes
principled_bsdf = nodes.new(type='ShaderNodeBsdfPrincipled')
principled_bsdf.inputs['Specular'].default_value = 0.0  # Match your original specular intensity
tex_image = nodes.new(type='ShaderNodeTexImage')
tex_image.image = img
output_node = nodes.new(type='ShaderNodeOutputMaterial')

# Link nodes together
links.new(tex_image.outputs['Color'], principled_bsdf.inputs['Base Color'])
links.new(principled_bsdf.outputs['BSDF'], output_node.inputs['Surface'])

Full Fixed Script #

Here's the complete script with all fixes applied:

import bpy
from math import pi
from mathutils import Quaternion

myscale = 0.1
daepath = "input.dae"

# Reset to empty scene
bpy.ops.wm.read_factory_settings(use_empty=True)

# Import DAE model
bpy.ops.wm.collada_import(filepath=daepath)

# Get imported object
imported_obj = bpy.context.selected_objects[0]

# Rotate and scale object directly
imported_obj.rotation_euler = (-pi/2, 0, 0)
imported_obj.scale = (myscale, myscale, myscale)
bpy.context.view_layer.objects.active = imported_obj
bpy.ops.object.transform_apply(location=False, rotation=True, scale=True)

# UV Unwrap with smart project (UI-independent)
bpy.ops.object.mode_set(mode='EDIT')
bpy.ops.mesh.select_all(action='SELECT')
bpy.ops.uv.smart_project(angle_limit=66, island_margin=0.02)
bpy.ops.object.mode_set(mode='OBJECT')

# Add texture using node-based materials
imgpath = "input.jpg"
img = bpy.data.images.load(filepath=imgpath)

if imported_obj.data.materials:
    mat = imported_obj.data.materials[0]
else:
    mat = bpy.data.materials.new(name="TexturedMaterial")
    imported_obj.data.materials.append(mat)

mat.use_nodes = True
nodes = mat.node_tree.nodes
links = mat.node_tree.links

for node in nodes:
    nodes.remove(node)

principled_bsdf = nodes.new(type='ShaderNodeBsdfPrincipled')
principled_bsdf.inputs['Specular'].default_value = 0.0
tex_image = nodes.new(type='ShaderNodeTexImage')
tex_image.image = img
output_node = nodes.new(type='ShaderNodeOutputMaterial')

links.new(tex_image.outputs['Color'], principled_bsdf.inputs['Base Color'])
links.new(principled_bsdf.outputs['BSDF'], output_node.inputs['Surface'])

# Export textured DAE
bpy.ops.wm.collada_export(filepath="output.dae")

Why This Works #

• No UI Context Dependencies: All operations either modify the object directly or use bpy.ops functions that don't require a viewport/window.
• Reliable Material Handling: Fetches materials from the object instead of hardcoding names, ensuring compatibility with any imported DAE.
• Modern Shader System: Uses Blender's node-based materials, which export more reliably to DAE and other formats.

内容的提问来源于stack exchange，提问作者Kmp86