C4D 配置文件文档

分析:我们将场景中需要的信息分析出来并保存到task.json, asset.json, upload.json, tips.json中,以便进一步解析和处理

1.task.json解析

说明: 存放场景分析结果、渲染设置等信息

task.json示例

{
  "scene_info_render": {
    "renderer": {
      "octane_renderer_info": {},
      "name": "Physical",
      "Octane_renderer_resave_info": {},
      "physical_sampler_mode": "",
      "physical_sampler": ""
    },
    "common": {
      "all_take_info": [],
      "frames": "0-333[1]",
      "multipass_saveonefile": "0",
      "fps": "25",
      "multipass_save_enabled": "0",
      "frame_rate": "25",
      "multi_pass": {
        "投影": [],
        "高光": []
      },
      "all_take_name": [],
      "saved_version": "MAXON CINEMA 4D Studio (RC - R18) 18.011",
      "regular_image_format": "TIFF",
      "multi_pass_format": "TIFF",
      "regular_image_saveimage_path": "ybt",
      "all_format": [
        "RLA",
        "HDR",
        "PSB",
        "TIFF",
        "TGA",
        "BMP",
        "IFF",
        "JPEG",
        "PICT",
        "PSD",
        "DDS",
        "RPF",
        "B3D",
        "PNG",
        "DPX",
        "EXR"
      ],
      "regular_image_save_enabled": "1",
      "created_version": "MAXON CINEMA 4D Studio 15.057",
      "all_camera": [
        "1"
      ],
      "width": "1920",
      "multipass_save_saveimage": "1",
      "multipass_saveimage_path": "E:/王顺利练习制作/气象局建模/序列/ae3D文件/3D摄像机",
      "height": "1080",
      "c4d_software_version": 22123
    }
  },
  "additional_info": {},
  "task_info": {
    "enable_layered": "0",
    "task_stop_time": "0",
    "concurrent_tasks": "1",
    "channel": "4",
    "frames_per_task": "1",
    "task_id": "54508419",
    "project_name": "Project1",
    "platform": "2",
    "tiles": "1",
    "is_picture": "0",
    "project_id": "469457",
    "job_stop_time": "259200",
    "distribute_render_node": "3",
    "stop_after_test": "1",
    "clone_original_id": "",
    "ram": "64",
    "render_layer_type": "0",
    "test_frames": "100",
    "edit_name": "",
    "pre_frames": "100",
    "input_project_path": "",
    "is_layer_rendering": "1",
    "is_distribute_render": "0",
    "tiles_type": "block",
    "time_out": "43200",
    "multi_node": "0",
    "cg_id": "2005",
    "user_id": "100150764",
    "input_cg_file": "D:/houdini/cg_file/ybt.c4d",
    "os_name": "1",
    "hardwareConfigId": ""
  },
  "software_config": {
    "plugins": {},
    "cg_version": "R22",
    "cg_name": "CINEMA 4D"
  },
  "scene_info": {
    "renderer": {
      "octane_renderer_info": {},
      "name": "Physical",
      "Octane_renderer_resave_info": {},
      "physical_sampler_mode": "",
      "physical_sampler": ""
    },
    "common": {
      "all_take_info": [],
      "frames": "0-333[1]",
      "multipass_saveonefile": "0",
      "fps": "25",
      "multipass_save_enabled": "0",
      "frame_rate": "25",
      "multi_pass": {
        "投影": [],
        "高光": []
      },
      "all_take_name": [],
      "saved_version": "MAXON CINEMA 4D Studio (RC - R18) 18.011",
      "regular_image_format": "TIFF",
      "multi_pass_format": "TIFF",
      "regular_image_saveimage_path": "ybt",
      "all_format": [
        "RLA",
        "HDR",
        "PSB",
        "TIFF",
        "TGA",
        "BMP",
        "IFF",
        "JPEG",
        "PICT",
        "PSD",
        "DDS",
        "RPF",
        "B3D",
        "PNG",
        "DPX",
        "EXR"
      ],
      "regular_image_save_enabled": "1",
      "created_version": "MAXON CINEMA 4D Studio 15.057",
      "all_camera": [
        "1"
      ],
      "width": "1920",
      "multipass_save_saveimage": "1",
      "multipass_saveimage_path": "E:/王顺利练习制作/气象局建模/序列/ae3D文件/3D摄像机",
      "height": "1080",
      "c4d_software_version": 22123
    }
  }
}

task.json参数解析

参数 类型 是否必须 说明 示例
software_config object Y 渲染环境(软件类型、版本和用到的插件等) 见software_config对象解析
task_info object Y 渲染设置(优先帧、渲染帧数、超时时间等) 见task_info对象解析
scene_info object Y 场景的分析结果(场景中的渲染节点、输出路径等) 见scene_info对象解析
scene_info_render object N 一般同"scene_info"
参数 类型 是否必须 说明 示例
cg_name string Y 软件名称 "CINEMA 4D"
cg_version string Y 软件版本,例如R13/R14/R15/R16/R17/R18/R19 "R22"
plugins object Y 插件对象。
为插件名称,value为插件版本
{"c4dtoa": "2.2.0", "vray":"1.9"}

task_info对象解析

参数 类型 是否必须 说明 默认值 示例
graphics_cards_num string Y 1: 开启单卡渲染 2: 开启双卡渲染 "2" “2”
enable_layered string Y 是否开启分层提交, "0":关闭 "1":开启 "0" "0"
cg_id string Y 渲染软件id."2005": C4d "2005"
ram string Y 内存要求: 64 / 128 “64” "64"
os_name string Y 渲染操作系统: "0":Linux; "1": Windows “1” "1"
render_layer_type string Y 渲染层方式选择: "0":renderlayer方式 "1":rendersetup方式 “0” "0"
is_distribute_render string N 是否开启分布式渲染: "0":关闭 "1":开启 “0” "0"
input_cg_file string Y 渲染场景本地绝对路径 "D:/houdini/cg_file/ybt.c4d"
input_project_path string Y 项目路径,如用户未设置传空字符串 " "
job_stop_time string Y 设置帧的超时时间,只会影响当前帧, 单位秒 “259200” "28800"
user_id string N 用户ID
pre_frames string Y 优先渲染(优先帧不建议自定义多个单独帧) “000” "000:1,3-4[1]" 表示: 优先渲染首帧:否 优先渲染中间帧:否 优先渲染末帧:否 优先渲染自定义帧:1,3-4[1]
platform string Y 提交平台: "2": "www2", "3": "www3", "6": "www4", "21": "gpu", "2"
is_picture string Y “0: 效果图 "1": 动画图 “0” "0"
channel string Y 1:web本地分析(动画扣费); 2:web云端分析; 3:效果图插件提交; 4:API/SDK提交; 8:动画插件提交 “4” "4"
tiles_type string Y "block(分块),strip(分条)" “block” "block"
tiles string Y 分块数量,大于1就分块或者分条,等于1 就是单机 "1" "1"
project_id string N 项目id "200953"
project_name string Y 项目名称 " " "Project1"
distribute_render_node string N 分布式渲染机器数 "3" "3"
frames_per_task string Y 一机渲多帧的帧数量 "1" "1"
stop_after_test string Y 优先渲染完成后是否暂停任务 "1":优先渲染完成后暂停任务 "2".优先渲染完成后不暂停任务 "2" “2”
task_id string N 任务号 “54508419”
task_stop_time string Y 大任务超时停止 单位秒,"0"表示不限制 "0" "86400"
time_out string Y 超时时间 单位秒 “43200” "43200"

scene_info对象解析

参数 类型 是否必须 说明 示例
common dict Y 装载平台普通参数 见scene_info.common对象解析
renderer dict Y 渲染器详细参数

scene_info.common对象解析

参数 类型 是否必须(Y/N) 说明 示例
all_take_info list Y 场次 []
frames string Y 起始针,隔针 "0-333[1]"
multipass_saveonefile string Y c4d软件场景中的通道是否开启 "1"
fps string Y 帧速率 "25"
multipass_save_enabled string Y 通道输出开关(开为1,关为0) "1"
frame_rate string Y 隔帧 "25"
multi_pass dict Y 场景中的通道
all_take_name list Y 场次名称 []
saved_version string Y 保存版本 "MAXON CINEMA 4D Studio (RC - R18) 18.011"
regular_image_format string Y 主图输出格式 "TIFF"
multi_pass_format string Y 通道输出格式 "TIFF"
regular_image_saveimage_path string Y 主图输出名((默认显示的输出文件名) "ybt"
all_format list Y 所有输出格式 [
"RLA",
"HDR",
"PSB",
"TIFF",
"TGA",
"BMP",
"IFF",
"JPEG",
"PICT",
"PSD",
"DDS",
"RPF",
"B3D",
"PNG",
"DPX",
"EXR"
]
regular_image_save_enabled string Y 主图输出开关(开为1,关为0) "1"
created_version string Y 创建版本 "MAXON CINEMA 4D Studio 15.057"
all_camera list Y 场景中的所有相机 ["1"]
width string Y "1920"
height string Y "1080"
multipass_save_saveimage string Y c4d软件场景中的通道保存路径 "1"
multipass_saveimage_path string Y 通道输出名 "E:/王顺利练习制作/气象局建模/序列/ae3D文件/3D摄像机"
c4d_software_version int Y 软件版本 22123

2.upload.json解析

说明: 存放需要上传的资产路径信息

upload.json示例

{
    "asset": [
        {
            "local": "D:/houdini/cg_file/ybt.c4d", 
            "server": "/D/houdini/cg_file/ybt.c4d"
        }
    ], 
    "scene": {
        "local": "D:\\houdini\\cg_file\\ybt.c4d", 
        "server": "/D/houdini/cg_file/ybt.c4d"
    }
}

upload.json参数解析

参数 类型 说明 示例
asset list 需要上传的资产路径信息 见asset对象解析
scene dict 上传的场景文件信息

asset对象解析

参数 类型 说明 示例
local string 资产本地路径 "D:/houdini/cg_file/ybt.c4d"
server string 服务器端相对路径,一般与local保持一致 "/D/houdini/cg_file/ybt.c4d"

3.tips.json解析

说明: 存放分析出的错误、警告信息

{"35001":"d:\\abc\\jdf.jpg"}