全部产品

渲染(RenderImageForPackageDesign)

更新时间:2020-04-21 13:18:37

介绍

用于设计师上传平面设计图,选定模型类型后,实时生成模型效果预览。

应用场景:上传设计好的平面设计图,调用此API实时生成模型效果预览页面。

点击这里进行在线API调试

参数定义

注意:该接口是异步接口,需通过GetRenderResult获取结果。

输入:

字段 类型 是否必须 描述
category string 用户行业信息,取值范围[Health, 3C, FastFood]
dataId string 用户数据id,对于同一批数据应该唯一,重复提交渲染任务会被拒绝。格式:数字、字母、_、-,长度1-64
modelType string 盒型名称,从模型查询结果列表中选取
materialType string 盒型材质类型,从材质查询结果列表中选取
materialName string 盒型材质名称,从材质查询结果列表中选取
targetWidth int 输出渲染效果图分辨率的宽度,取值范围 []
targetHeight int 输出渲染效果图分辨率的高度,取值范围 []
displayType string 陈列/阵列类型
elementList List<ModelElement> 用户设计图元素列表

ModelElement:

字段 类型 是否必须 描述
sideName string 描述盒型面名称,可编辑,从模型查询结果列表中找到相应的面列表,选取其中的值。
imageUrl string 描述盒型的面上对应的设计图,可编辑,为用户设计图http地址。

输出:

字段 类型 描述
JobId string 渲染任务Id, 使用GetRenderResult获取进展和结果

示例

输入:

  1. RenderImageForPackageDesignRequest request = new RenderImageForPackageDesignRequest();
  2. request.setRegionId("cn-shanghai");
  3. request.setJobId("006");
  4. request.setModelType("ECutoutHandleBagModelType");
  5. request.setMaterialType("paper");
  6. request.setMaterialName("white_paperboard");
  7. request.setCategory("FastFood");
  8. request.setTargetWidth(1024);
  9. request.setTargetHeight(1024);
  10. request.setDisplayType("singletilefan");
  11. List<RenderImageForPackageDesignRequest.ElementList> elementListList = new ArrayList<RenderImageForPackageDesignRequest.ElementList>();
  12. RenderImageForPackageDesignRequest.ElementList elementList1 = new RenderImageForPackageDesignRequest.ElementList();
  13. elementList1.setSideName("mat_front");
  14. elementList1.setImageUrl("http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/package-design/testCaseV2/haobashi/Image/front.png");
  15. elementListList.add(elementList1);
  16. RenderImageForPackageDesignRequest.ElementList elementList2 = new RenderImageForPackageDesignRequest.ElementList();
  17. elementList2.setSideName("mat_back");
  18. elementList2.setImageUrl("http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/package-design/testCaseV2/haobashi/Image/back.jpg");
  19. elementListList.add(elementList2);
  20. RenderImageForPackageDesignRequest.ElementList elementList3 = new RenderImageForPackageDesignRequest.ElementList();
  21. elementList3.setSideName("mat_bottom");
  22. elementList3.setImageUrl("http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/package-design/testCaseV2/haobashi/Image/bottom.png");
  23. elementListList.add(elementList3);
  24. RenderImageForPackageDesignRequest.ElementList elementList4 = new RenderImageForPackageDesignRequest.ElementList();
  25. elementList4.setSideName("mat_left");
  26. elementList4.setImageUrl("http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/package-design/testCaseV2/haobashi/Image/left.png");
  27. elementListList.add(elementList4);
  28. RenderImageForPackageDesignRequest.ElementList elementList5 = new RenderImageForPackageDesignRequest.ElementList();
  29. elementList5.setSideName("mat_right");
  30. elementList5.setImageUrl("http://ivpd-cn-shanghai.oss-cn-shanghai.aliyuncs.com/test/package-design/testCaseV2/haobashi/Image/right.png");
  31. elementListList.add(elementList5);
  32. request.setElementLists(elementListList);

输出:

  1. {
  2. "RequestId": "E2F573C4-40CD-4060-8E76-95FB9FF25F71",
  3. "Message": "success",
  4. "Data": {
  5. "JobId": "001"
  6. },
  7. "Code": "0"
  8. }