一、功能介绍
功能简介：如何在硬装使用模型阵列功能？本教程为您解决
操作路径：点击进入背景墙，选择素材库放置模型，点击模型调整阵列放置
二、面向用户
所有用户
三、图文操作步骤
第一步
一、面向用户
全体用户
二、功能简介
硬装顶/墙/地工具中，支持对模型进行线性阵列，提供两种阵列模式：
距离模式：中心点间距值固定，按照鼠标确定的总距灵活计算模型数量
数量模式：模型数量固定，按照鼠标确定的总距灵活计算中心点间距
三、功能演示
功能步骤：
选中模型，选择【线性阵列】
选择阵列模式，默认与上次使用的阵列模式保持一致
选择阵列起点和终点，完成阵列
动图演示：
1、距离模式：在底部工具栏输入中心点间距
2、数量模式：在底部工具栏输入模型数量
面向用户：
全部用户
背景：
为了实现在吊顶设计中精准布置灯具，用户期望可以“按中心点间距”阵列灯具。
灯具布置一般均以中心点为基准。
用户的设计链路为吊顶造型设计：设计造型——灯具布置，在吊顶设计中完成全部的天花布置。
功能简介：
在硬装工具中使用阵列功能时，增加“按照中心点间距”选项。
默认“按中心点间距”阵列
按“空格键”可以进行距离基准切换，“按中心点间距”与“按模型边距”可相互切换
功能演示：
一、功能介绍
功能简介：顶墙地设计页面中如何成组解组模型？本教程为您解决
操作路径：点击顶面进入吊顶设计，可以对多个模型成组解组；支持对成组的模型进行移动、旋转、复制、镜像等操作
二、面向用户
全部用户
三、图文操作步骤
第一步：点击顶面进入吊顶设计。
第二步：点击顶面可以进行翻转、旋转、镜像等操作。
第三步：按住shift框选多个模型，可以进行成组。
第四步：点击多个组合模型可以进行解组。
一、功能介绍
功能简介：在吊顶设计中如何使用环形阵列工具？本教程为您解决
操作路径：点击进入吊顶设计，选择顶面模型，可以使用环形阵列工具
二、面向用户
所有用户
三、图文操作步骤
第一步：点击顶面进入吊顶设计。
第二步：可以使用圆形工具，绘制一个圆，作为使用环形阵列数据参考。
第三步:在圆上面放置一个灯具模型，点击模型，点击环形阵列工具。
第四步：点击筒灯使用环形阵列工具。
第五步：选择圆心，放置筒灯。
如果上传的是3DsMax模型，请查看<3D模型上传要求>
写在前面
犀牛模型上传可支持保存的.3dm格式，如想将模型从犀牛导出在3ds Max中修改，可另存为.obj。
下文将列出3dm与obj的模型设置：
3dm模型
一、支持格式
1. Rhino7及更早版本的模型
2. 支持后缀名.3dm格式模型
二、模型要求
1.模型制作单位为毫米
2.选择“文件”--“另存为”，保存为.3dm模型。
3.材质名称不要有特殊符号
4.文件名称不要有空格
三、材质支持情况
1.PBR材质：
基础颜色有色差
勾选金属后，预览图颜色偏差较大
金属粗糙度不生效
不支持置换
不支持发光
2.双面：
不支持双面材质
3.发光：
不支持发光材质，上传为黑色
4.图像：
支持添加贴图
支持自发光
不支持灰度级
不支持Alpha通道
不支持颜色遮罩
不支持临界值
不支持物件透明度
5.塑胶：
支持颜色
预览图是透明效果，与犀牛渲染区别较大
6.宝石：
支持宝石材质
7.油漆：
支持颜色
不支持光泽度
8.玻璃：
支持玻璃材质
支持颜色
支持清晰度
支持折射率
9.金属：
支持金属材质
支持颜色
支持抛光度
不支持凹凸贴图
三：上传
新版上传模型教程https://www.kujiale.com/hc/article/3FO4K4VWQWYB?kjl_source=hc_nav
备注：上传方法和3D模型的上传方法一致；
四、预览效果
Rhino软件内部渲染效果
酷家乐前端展示效果
酷家乐渲染效果图
导出obj模型
一、导出流程
1.选择“文件”--“另存为”，保存为.obj模型。
2.obj导出选项
选择导出多边形网格物件
NURBS曲面模型在转换为多边形网格时，可以设置转换精细度。
如果模型面数不多，可直接用默认设置；如面数较多，可以酌情删减细分和网格面。
二、导入3dsMax
直接选择默认设置，如不想将模型合并为一个，可取消勾选“作为单个模型导入”。
点击导入，模型导入完成。
一、功能介绍
在定制工具使用过程中，模型搭建完成或修改后可以一键出图预览，快速看到调整效果
支持同时选中多个模型一键出图，查看整体效果
支持聚焦显示对象后出图，可快速定位所需模型，避免其他模型遮挡导致看不全模型的情况，更便于观察，提高设计修改效率
渲染清晰度有1K标清和4K超高清两种选择，可根据需求自行选择
二、面向用户
所有用户，其中4K超高清渲染功能仅具有该权限的用户可以使用
三、操作步骤
1、入口
进入定制工具线，选择需要模型出图的模型，点击浮窗工具栏中的“模型出图”
2、单个模型出图
选中需要渲染的模型，点击模型出图，选择需要的清晰度后点击渲染，等待出图即可
注意：清晰度有1K标清和4K超高清两种选择，清晰度越高，渲染时间也会相应增加
操作演示视频教程可见如下：
3、多个模型出图
选中需要渲染的多个模型，点击模型出图，选择需要的清晰度后点击渲染，等待出图即可
注意：切换不同模型的渲染视窗，不需要关闭视窗后再重新打开，直接选择另一个模型即可完成视窗切换
操作演示视频教程可见如下：
4、显示对象视角出图
选中模型，点击显示对象视角，选择需要的视角后选择模型出图，点击渲染等待出图
操作演示视频教程可见如下：
5、聚焦显示对象出图
聚焦显示对象可快速定位所需模型，避免其它模型遮挡导致看不全模型的情况
选中模型，点击聚焦显示对象，调整合适角度后，点击渲染等待出图
操作演示视频教程可见如下：
四、注意事项
具有夜间4K渲染权限的用户需关注一下渲染进程，渲染时如果上一张图片没有渲染完成，就不能进行下一张图片的渲染，在夜间需要渲染多张4K高清图片时，由于渲染4K高清图时间会比较长，可能会出现当天夜晚无法全部渲染完成的情况，会影响到白天的渲染进程
一、功能介绍
功能简介：照明设计中如何阵列模型？本教程为您解决
操作路径：选择行业库点击进入照明设计，点击模型可以进行阵列，阵列后模型自动成组
二、面向用户
所有用户
三、图文操作步骤
第一步：选择行业库点击进入照明设计
第二步：点击灯具模型可以进行阵列。
第三步：阵列模式下，可以直接勾选阵列成组，勾选后阵列出来的造型自动成为一个组合。
一、功能介绍
功能简介：蹲便模型嵌入地下如何操作？本教程为您解决
操作路径：放置蹲便模型，设置离地高度负值，设置后进入地台设计，清空下铺贴重新吸附即可
二、面向用户
所有用户
三、图文操作步骤
第一步：放置蹲便模型，设置模型离地高度负值。
第二步：点击地面，进入地台设计。
第三步：清空地面材质重新吸附退出。
第四步：退出后就可以看到放置好的蹲便模型。
一、功能介绍
使用3D插件工具可以将酷家乐方案内的【户型】、【定制家具】导入3ds Max二次创作
二、注意事项
成品模型、单个模型是不支持导出的，导出的只有户型和全屋定制做的家具
插件支持3ds Max2018版-2023版使用，其他版本不支持
三、操作步骤
1.安装/更新酷家乐3D插件
重要说明：当前最新版插件为1.1.9版（版本号可在插件页上方查看）
①从未安装过插件及安装过1.0.0版插件的用户，请点击下载！
插件下载链接：https://qhstaticssl.kujiale.com/application/xmsdownload/1747908822813/KujialeFor3dsMax-1.2.0-test-x64.exe
②安装过1.1.0版及以上版本插件的用户，请选择自动更新！
2.登录酷家乐账号
打开3ds Max软件，在顶部栏右上角，找到【酷家乐】插件（小屏电脑在箭头里），选择【导入】，或者使用快捷键Shift+K唤起，登录你的酷家乐账号。勾选【记住我】，使用更方便！
3.导入素材
默认读取当前账号下的所有方案，选中任意方案，将方案内的户型/定制家具导入或预下载。
选择预下载会显示导入进度，不用开着窗口一直等待~
4.编辑模型
如果您日常更偏好以四边化展示和修改素材，我们提供了自动四边化的能力，点击顶部栏【酷家乐】-【四边化已选择模型】或使用快捷键【Shift+Q】即可满足。
四、视频教程
五、常见插件问题
1.插件无法安装？
有以下几种可能
①插件未下载完整：建议重新安装
②未下载对应Max版本的插件：确认后重新下载
③关掉杀毒软件试试
④尝试以管理员身份启动插件安装包
如果都不行，可在下方留言、提供截图。
2.插件导入崩溃？
先尝试再次导入试试，如无法成功，可下放留言告知max版本以及对应打开的方案链接。
3.如何怎么体验最新版插件？
①从未安装过插件及安装过1.0.0版插件的用户，请直接下载！
插件下载链接：https://qhstaticssl.kujiale.com/application/xmsdownload/1747908822813/KujialeFor3dsMax-1.2.0-test-x64.exe
②安装过1.1.0版及以上版本插件的用户，请在插件界面-顶部右上角-点击更新，可自动升级至最新版！
一、功能介绍
功能简介：户型工具中的飘窗模型如何使用？本教程为您解决
操作路径：在户型页面左侧工具栏中点击使用一字飘窗，点击飘窗右侧可以修改飘窗参数
二、面向用户
所有用户
三、图文操作步骤
第一步：在户型页面，左侧工具栏中点击使用一字飘窗。
第二步：点击一字型飘窗，右侧可以修改飘窗尺寸参数。
一、功能介绍
模型检测功能旨在帮助在建模阶段早期发现潜在问题，以应对参数化模型日益增长的复杂性。通过自动化的检测机制，本功能可以有效识别模型中可能存在的错误配置、不合理参数或结构缺陷，从而：
降低风险：显著减少因模型错误导致的生产环境返工，避免可能造成的资损
提升效率：替代繁琐的人工检查和工具内测试，将原先复杂的检测流程缩短至更简便的步骤
保障质量：通过预设的通用特征和灵活的自定义特征，对模型进行多维度检查，提升模型库的整体质量
二、面向用户
全体参数化编辑器建模的用户，逐步开放中
三、操作步骤
1、模型检测入口
模型检测功能入口位于后台的变量与数据页面，点击模型检测即可进入
2、模型检测主界面
进入后，您会看到主要的功能区域，包括选择检测范围、选择检测特征、管理特征、开始检测、检测历史等功能
3、执行模型检测
模型检测执行以任务的形式发起
第一步：选择检测范围
1）选择模型范围
首先，在“请选择检测范围”下，从下拉框中选择您需要检测模型所在的行业线（如：全屋家具定制）
接着，在“请选择类目”中进一步选择库节点/文件夹来圈定模型范围
支持选择所有编辑器可打开的模型、虚拟模型
支持跨行业线选择模型，但不支持跨库选择
2）选择模型版本
优先正式版本（默认选中）
优先草稿版本
第二步：选择检测特征
1）通用特征
系统预置了一系列常用的检测脚本，封装为“通用特征”选，这些特征覆盖了常见的模型错误类型
您可以根据需要，勾选一个或多个通用特征进行检测，各特征之间独立检查
例如：“传递隐藏变量配置错误”、“包含某个材质”、“子部件上使用了@A.constants.xx的语法”等
2）自定义特征
如果您有特定的检测需求，可以通过“自定义特征”来实现
已创建的自定义特征会在此列出，您可以勾选使用。
点击“+管理自定义特征”超链接，可以跳转到自定义特征管理界面，进行NCQL脚本的编写和封装。（详见“4、 管理自定义特征”）
第三步：开始检测
1）完成模型和特征选择后，点击右下角的开始检测按钮
2）系统会弹窗提示“确认是否检测”，点击确认后，将发起一次检测任务
3）任务发起后，您可以在检测历史中查看任务的执行状态和结果
4、管理自定义特征
第一步：点击“检测”页面的“+管理自定义特征”链接
第二步：此区域提供一个独立的开发环境，您可以通过编写NCQL脚本来定义新的检测逻辑
第三步：编写完成的脚本可以封装为一个自定义特征选项，供后续在“检测”页面选择使用
注意：通用特征不允许删除，但您创建的自定义特征可以被删除
第四步：此页面主要包含以下四个区域：
1）左侧：脚本导航区
作用：展示和管理所有的特征脚本
内容：
通用特征：列出系统预设的通用特征脚本，供用户查看和参考其实现方式
自定义特征：列出用户已创建的自定义特征脚本。用户可以点击选择已有脚本，或点击此区域的“+”号（或类似按钮）来新建脚本
2）中间：脚本编辑区
作用：用户在此区域编写、查看或修改NCQL脚本的具体代码
联动：当在左侧选择一个脚本或新建脚本后，其代码内容会显示在此处以供编辑
3）右侧：脚本校验结果区
作用：实时显示当前编辑区内NCQL脚本的语法校验结果
指示：告知用户脚本是否存在语法错误或警告
4）下方：开发文档区
作用：提供编写NCQL脚本时必要的参考信息
内容：
类型文档：说明脚本中可以访问和操作的模型数据结构及其属性
函数文档：列出脚本中可以调用的内置函数及其功能描述
5. 检测历史
在检测历史中，您可以查看所有已发起检测任务的记录
检测时间： 任务发起的时间
任务ID： 系统为每个检测任务生成的唯一标识
任务状态：
执行中： 任务正在进行
成功： 任务成功
失败： 检测过程出错（例如网络波动、脚本能力不完善等）
已取消： 用户手动取消的检测任务
已过期： 超过30天存储期限的任务
详情：当前检测任务相应的检测特征
操作人： 发起检测任务的用户
检测结果：
若检测成功，显示“下载”超链接，点击可下载该任务的检测结果统计表
若检测失败，显示“-”
四、常见问题
Q1: 我可以同时运行多个检测任务吗？
A1: 不可以。系统限制同时只能有1个检测任务在执行。如果您在已有任务执行时尝试发起新任务，系统会提示：“检测任务正在进行，请稍后再试”
Q2: 如果检测任务失败了怎么办？
A2: 如果任务状态显示为“失败”，请查看“备注”列获取失败原因。可能的原因有脚本故障、网络波动等。您可以根据提示尝试重试，或联系工作人员协助排查
Q3: 检测结果会保存多久？
A3: 检测历史和结果会保存30天。超过30天的任务状态会变为“已过期”，结果可能无法再下载
Q4: “通用特征”和“自定义特征”有什么区别？我可以修改或删除“通用特征”吗？
A4: “通用特征”是系统预设的、经过验证的常用检测规则，不允许用户删除或修改。“自定义特征”是用户根据自身需求，通过编写NCQL脚本创建的检测规则，用户可以对其进行管理和删除
Q5: “自定义特征”中的NCQL脚本需要我自己从零开始写吗？
A5: 是的，“自定义特征”功能提供了一个独立的开发环境，您可以在其中编写NCQL脚本来实现特定的检测逻辑，并将其封装成一个可供选择的特征项
Q6: “检测所有测试用例”模式是什么时候会用到？
A6: “检测所有测试用例”是二期规划的功能。它允许您为模型定义多组参数组合（测试用例），并在这些组合下运行特征检测，以覆盖更多场景。一期功能主要围绕“检测当前值”进行