Ruby on Rails中如何为FBX/OBJ格式3D模型生成缩略图？

Carrierwave本身不支持直接生成3D模型（FBX/OBJ）的PNG缩略图，它的内置处理器（如MiniMagick、RMagick）仅针对2D图像格式设计。要实现这个需求，必须借助外部3D处理工具，在Ruby/Rails中通过调用命令行或绑定库的方式完成渲染，再将结果集成到Carrierwave的上传流程中。

下面是最适合新手的实现方案：

推荐方案：用Blender生成缩略图 #

Blender是免费开源的3D创作工具，支持命令行模式批量渲染3D模型为PNG，无需图形界面，非常适合服务器环境。

步骤1：服务器安装Blender #

根据你的服务器系统安装Blender（例如Ubuntu用apt install blender，CentOS用yum或源码编译），确保blender命令能在终端正常执行。

步骤2：编写Blender渲染脚本 #

在项目根目录的lib文件夹下创建render_thumbnail.py，用于加载模型、设置渲染参数并输出PNG：

import bpy
import sys

# 清除Blender默认场景物体
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete()

# 获取命令行传入的模型路径和输出路径
model_path = sys.argv[-2]
output_path = sys.argv[-1]

# 导入3D模型
if model_path.endswith('.fbx'):
    bpy.ops.import_scene.fbx(filepath=model_path)
elif model_path.endswith('.obj'):
    bpy.ops.import_scene.obj(filepath=model_path)

# 设置自动视角（让相机对准模型）
target_obj = bpy.context.selected_objects[0]
bpy.ops.object.camera_add(location=(5, -5, 5))
camera = bpy.context.active_object
bpy.context.scene.camera = camera

# 添加相机跟踪约束
constraint = camera.constraints.new(type='TRACK_TO')
constraint.target = target_obj
constraint.track_axis = 'TRACK_NEGATIVE_Z'
constraint.up_axis = 'UP_Y'

# 添加基础灯光
bpy.ops.object.light_add(type='SUN', location=(3, 3, 5))

# 配置渲染参数
scene = bpy.context.scene
scene.render.image_settings.file_format = 'PNG'
scene.render.filepath = output_path

# 执行渲染并保存
bpy.ops.render.render(write_still=True)

步骤3：修改Carrierwave上传器 #

在ItemUploader中添加处理逻辑，调用Blender生成缩略图，并关联到Item模型的thumbnail字段（需先给Item模型添加thumbnail:string字段，且对应一个ThumbnailUploader）：

class ItemUploader < CarrierWave::Uploader::Base
  # 其他配置...

  # 处理3D模型时生成缩略图
  process :generate_thumbnail, if: :is_3d_model?

  private

  def is_3d_model?(file)
    %w[fbx obj].include?(file.extension.downcase)
  end

  def generate_thumbnail
    # 生成临时缩略图路径
    temp_thumb_path = Rails.root.join('tmp', "#{SecureRandom.uuid}.png")

    # 调用Blender命令行执行渲染脚本
    blender_cmd = "blender --background --python #{Rails.root.join('lib', 'render_thumbnail.py')} -- #{file.path} #{temp_thumb_path}"
    system(blender_cmd)

    # 将生成的缩略图赋值给Item的thumbnail字段
    if File.exist?(temp_thumb_path)
      @model.thumbnail = File.open(temp_thumb_path)
      File.delete(temp_thumb_path) # 清理临时文件
    end
  end
end

步骤4：调整控制器代码 #

无需在createItem方法中额外添加逻辑，Carrierwave的process会在store!执行时自动触发缩略图生成，只需确保Item模型的thumbnail字段正确关联上传器即可。

其他可选方案（适合有图形编程基础的开发者） #

• Ruby-Assimp绑定：Assimp是开源3D模型导入库，通过ruby-assimp gem可以在Ruby中读取FBX/OBJ模型数据，再结合OpenGL/SDL等图形库手动渲染生成PNG，但实现复杂度较高。

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