Project settings

此页面显示Substance 3D Designer中的 项目设置 以及其中包含的设置。

Substance 3D Designer允许您为每个项目​创建首选项,并在工作站间共享它们。 可在首选项窗口的 项目 选项卡中找到这些首选项。

如果您想通过使用​ 所有 ​系统上的​ same ​项目文件为处理同一项目的团队设置通用工作环境,此功能非常有用。

NOTE
有关在​ 生产管道 ​中设置和集成Substance 3D Designer的详细信息,我们​强烈推荐,请参阅文档的管道和项目配置部分。

项目设置 {modal="regular"}

配置

配置文件

这允许您设置Substance 3D Designer 配置文件的路径。 配置文件使用 *.sbscfg 扩展名,并包含项目文件列表以及设置的兼容性显示设置。

默认: default_configuration.sbscfg

NOTE
您可以使用​**—config-file**​命令行选项通过特定的配置文件启动Designer。
有关配置文件的详细信息,请参阅文档的配置列表 — SBSCFG页。

项目文件

项目文件包含许多设置,这些设置在Designer中定义工作环境的主要方面,并整理到选项卡中。 这些设置列在本页的“项目”一章中。 项目文件使用 *.sbsprj 扩展名。

您可以在Designer中导入多个项目文件以用于您的工作环境。 存在多个项目文件时,列出的设置(例如库监视路径、别名等) 是​组合的,并且唯一集值的设置由列表的​ 最后一个项目文件 ​定义。

默认: default_project.sbsprj(只读), user_project.sbsprj

NOTE
有关在生产管道中使用项目文件的详细信息,请参阅文档的项目配置文件 — SBSPRJ页面。

兼容性显示

使用最新版本Designer创建的某些节点与旧版本Substance 引擎不兼容。

兼容模式将突出显示​ 不 ​与所选Substance 引擎兼容的节点,并带有黄色轮廓。

默认:Substance 引擎v7

3D 视图

默认渲染器
此设置允许您选择在启动​新的🔗3D 视图时默认使用的3D渲染器。

默认:默认(预定义的渲染器)
默认着色器
此设置允许您选择在启动​新 3D 视图​

时默认使用的着色器: open_pbr.glslfx
默认环境图
此设置允许您选择在启动​新建3D 视图​

默认环境时默认应用于环境的纹理: panorama_map.hdr
默认状态文件
3D 视图 场景状态文件​包含一些3D 视图设置,如相机位置、环境曝光和网格。 它用于存储3D 视图的状态,以便您可以快速加载根据您的需求定制的场景。 场景状态文件使用​ *.sbsscn ​扩展名。此设置允许您选择在启动新3D 视图时应使用的3D 视图场景状态文件。 警报:​某些软件更新可能会更改场景状态的保存/加载方式。 如果场景​未正确还原,建议手动设置场景的所需状态,并​ 重新导出 ​默认使用的场景状态文件。

默认:空(在本例中使用预设场景状态)
默认光照状态
此设置允许您选择在启动新的3D视图时,如果未设置文件,在​ 默认状态文件 ​字段中​

默认:仅环境光​应启用哪些预定义的可用光源

别名

别名用于​ 缩短 ​系统路径,并允许团队更高效地​ 共享 ​资源。 在整个软件​以及 SBS文件​ 中 ​使用了别名。

这些设置允许您​ 添加 ​和​ 编辑 ​别名。 应用别名后,将使用以下语法替换​映射路径: ://。

示例:如果将文件夹​ myFolder ​中的资源​ myResource ​放置在位置​C:/Users/user/Documents,则将此位置映射到​ myalias ​将导致在应用程序​ 和 ​中使用资源所属的SBS包中的​ myalias://myFolder/myResource ​路径。

默认:sbs;sd-3dview-shapes;sd-3dview-maps;sd-3dview-shaders(默认项目)

WARNING
别名是应用程序​的全局。 这意味着这些路径将应用于应用程序中使用的​所有路径,以及​ 加载的SBSPRJ项目设置文件 ​中的所有路径。 在设置项目环境时请记住这一点!
此外,我们建议​ 不要嵌套 ​别名 — 即,为也包含在另一个别名中的路径设置别名。

烘焙

默认资源名称
此设置允许您设置将用于输出图像文件的默认​命名模板。 烘焙窗口中可用的别名也可以在此使用(即,$(网格),$(烘焙名称),$(udim),$(自定义))

默认值: $(网格)_$(烘焙名称)
默认预设
打开烘焙窗口时,您可以使用此选项指向预设​ JSON ​文件,使其​ 已配置 ​特定的烘焙程序和设置。 根据您的需要设置此文件后,可以从烘焙窗口中导出此文件​

默认值:无
名称筛选模式

匹配低多边形和高多边形场景对象时应使用的场景对象:

  • 几何名称:使用网格几何对象的名称
  • 父级名称(旧版):使用网格几何对象的父级名称(与Designer 14.1及更低版本中的名称相同)

默认:几何名称

资源名称宏
除了​ $(bakername) ​别名之外,您还可以对每个贝克使用自己的字符串。 在输出图像名称中使用​ $(自定义) ​别名作为任何烘焙商时,该别名将被替换为与列表中该烘焙商匹配的字符串。 如果将与面包机对应的列表单元格留空,则此面包机​ $(自定义) ​别名​ 将 ​不会被替换。示例:分配给“从网格曲率映射”面包机的“c-mesh”值将​t_mymesh_​$(自定义)自动重命名为​t_mymesh_​c-mesh,以获得从网格面包机曲率输出​仅​

默认: None
子网格名称筛选器
在生成器中使用​ 按名称匹配 ​选项时,如果在定义的​ 后缀 ​之前网格的低清晰度版本和高清晰度版本的名称是​相同,则这些部分的名称​匹配。 此设置允许您设置自己的后缀以适应您的特定工作流程。 网格的匹配部分可以使光线忽略烘焙操作中不需要的几何形状。示例:body.fbx​网格中的​*body-torso​**_low***​对象将与​body_high.fbx, 中的 body-torso _high*对象匹配,如果这些对象存在*​这些网格中​ 。默认值: _low (低多边形网格) / _high (高多边形网格)*同样,​背面​**可以是​ 有选择性的对于包含**​忽略背面**选项

​默认:_ignorebf ​注意:忽略背面和低/高多边形网格后缀可以以任何顺序组合​ (例如,body-torso_low_ignorebf),对于名称包含定义的​ 后缀 ​的网格部分,忽略*

色彩管理

请参阅色彩管理页面。

WARNING
对这些设置的更改将在重新启动Designer后生效。

常规

Substance模板
创建新图形时,系统会提示您开始处理​模板,该模板可具有许多设置和内容​预配置,如输出(例如,PBR(金属/粗糙度))。此设置允许您将Designer指向可存储自己的SBS文件以用作模板的目录。 然后,在创建新图形时,您的自定义模板将​ 添加到列表 ​中​

默认:无​

注意:​我们建议使用当前模板作为配置和格式化模板SBS文件的参考。 可在Substance 3D Designer安装目录的​ 资源> templates ​文件夹中找到模板。
3D场景
默认情况下,Designer在3D视图中使用​MikkT切线空间。 MikkT被广泛使用,并且是Unity、Unreal Engine 4、Blender和xNormal等程序的默认值。您可以将​ 自己的切线空间 ​用于3D视图,该视图以​ DLL文件 ​输入此设置的形式提供给Designer。 系统会自动从DLL文件中检测到标签,您可以编辑插件的说明​

默认值: miktspace.dll​始终重新计算正切帧​

默认值:未选中​法线和正切平滑角度​

默认值: 180.0°
杂项
可以使用 DirectX 或 OpenGL 格式生成或处理正常映射。 此设置在多个位置设置此格式的值,例如3D视图中的素材属性和普通滤镜节点参数。

默认值:DirectX

​关于普通滤镜节点,您可以设置 Alpha通道内容 参数的默认值。 在所有情况下,您可以选择强制Alpha为1,或使用其输入的信息填充它。

默认:强制Alpha为1
图像格式
这使您可以指定​ 已导出 ​图像​

的默认格式设置:默认(BMP)/基于Piz的小波、未选中、未选中(EXR)/未选中、未选中、75 (JPG)/最佳速度、未选中(PNG)/默认(TGA)/LZW (TIF)/未选中、75 (WEBP)
依赖关系路径

SBS包通常具有依赖项,即依赖于外部资源,例如其他SBS包、位图或矢量文件。
这些依赖项,列在依赖项管理器中,它们存储在SBS包中并被引用,其路径为路径,指向这些资源。

对于包含与SBS包相同的 路径 的依赖项(即,它们位于同一位置或来自该位置的子文件夹中),将引用路径写入相对于 SBS包位置。

示例:对于SBS包myproject/mypackage.sbs,图像myproject/myfolder/myimage.png 将引用到myfolder/myimage.png mypackage.sbs中的路径).

对于 不 包含与SBS包相同的路径的依赖项(即,它们与SBS包位于完全不同的位置),您可以选择路径写入方式。

如果它被设置为相对路径,则将按上述相同方式引用资源。

示例:对于SBS包myparentfolder/myproject/mypackage.sbs,图像myparentfolder/myotherfolder/myimage.png 将引用到…/myotherfolder/myimage.png mypackage.sbs中的路径.

如果设置为绝对路径,则资源将由其完整系统路径引用。

示例:对于SBS包myparentfolder/myproject/mypackage.sbs,图像myparentfolder/myotherfolder/myimage.png 将引用到mypackage.sbs中的同一完整路径

默认: …相对路径。

注意:在所有情况下,移动资源将中断依赖关系,这将在图形中生成 Ghost实例 节点。 若要将所有依赖项与SBS包合并到一个项目文件夹中,可以在资源管理器面板中使用带依赖项导出……功能。 这实际上创建了一个可自由移动的 自包含的 项目文件夹。

库

此部分允许您管理库的自定义内容。

添加的路径列表中列出的所有文件夹的内容都将包含在库中。 对内容所做的任何更改都会反映在库中,刷新期之后即可在首选项窗口的库 选项卡中设置。

在列表的列中,您可以找到一些选项,这些选项使您可以更精细地控制将这些文件夹的内容添加到库的方式:

  • 已启用:​文件夹的内容显示在库中(默认:已选中)
  • 递归:​所有子文件夹的内容也显示在库中(默认:已选中)
  • 排除模式: 名称​与输入Regex (正则表达式)匹配的文件​ 不 ​显示在库中(例如wip-*) 。 在此处了解有关正则表达式语法的详细信息
  • 排除扩展名: 扩展名​包含输入文本字符串的文件​ 不 ​显示在库中。 多个字符串应该用;分号分隔。 (E.g. jpg;png;tif;fbx)

如果将SBS包添加到库中,并且其​ 在库中可见 ​参数设置为“是”,则它包含的​ 图形 ​和​ 资源 ​可以​作为单独的条目显示在库中。
在包中创建/添加新图形或资源时,可使用此选项来定义此参数是否应在默认情况下​**​设置为“是”。

默认值:已选中

如果PSD中包含的Photoshop文档(*.library文件)具有多个图层,则可以通过某个选项将*​每个图层的内容作为单独的图像条目*显示在库中。

默认值:已选中

NOTE
将您的自定义资源添加到库时,由于为现有库类别设置了筛选规则,因此​可能不可见。 我们建议创建​您自己的筛选器(以文件夹组织),以确保在处理您的项目时可靠地找到您的内容。
有关详细信息,请参阅文档的管理自定义内容和筛选器部分。

Python

Substance 3D Designer将自动加载您添加到 Url 列表的文件夹中的所有插件。

默认值:无

WARNING
对这些设置的更改将在重新启动Designer后生效。
仍需要​ 使用插件管理器手动 ​安装插件包。

脚本

WARNING
在将来的版本中,此功能将​停用,以使用更强大的​Python API。 因此,我们建议尽快在您的脚本中进行切换。
您可以转到文档的脚本部分中的应用程序回调页面以开始操作。

通过此部分,您可以设置并控制在Designer中发生特定​ 事件 ​时要执行的​脚本。 当与可在“项目设置”的“版本控制”选项卡中配置的性能集成一起使用时,此功能特别有用。

操作

Designer已预先配置了​回调触发器,它将会​执行您在下述​ 解释器 ​列表中设置的解释器所提供的脚本。包含的回调如下:

  • onBeforeFileLoaded — 在加载SBS包之前执行脚本
  • onAfterFileLoaded — 在加载SBS包之后执行脚本
  • onBeforeFileSaved — 在保存SBS包之前执行脚本
  • onAfterFileSaved — 在保存SBS包后执行脚本
  • getGraphExportOptions — 在调用导出输出选项时执行脚本

安装文件中包含Python脚本,每个回调​ 触发的函数已设置 ​且可以使用。 您可以将其用作起点,并根据需要添加功能。 此脚本为​functions.py,位于安装文件的​ tools > scripting ​文件夹中​

*默认: None *

注意:​最初,为任何回调选择一个脚本都将在​ 全部 ​回调中输入该脚本以方便使用。 之后,您可以为特定回调自由设置不同的脚本。

解释器
在此列表中,您可以提供特定的​解释器,Designer应使用这些解释器执行在上述​ 操作 ​列表中设置的脚本。 解释器使用​ 自定义别名 ​进行标识,您可以在列表每个条目的文本字段中进行编辑。Designer安装文件随附了一个Python 3.6解释器。 您可以在安装文件的​ plugins > pythonsdk ​文件夹中​

找到它。默认:无

版本控制

WARNING
性能是版本控制当前支持的​ 仅 ​工具。

请参阅版本控制页面。

应该如何使用它?

您应在Designer的项目文件(*.sbsprj)中设置所有特定于项目的首选项**。 这些首选项包括:

所有路径都存储在​ 相对于项目文件(.spsprj)的 ​中。 因此,可将​ 库 ​文件夹与Perforce中的项目文件放在同一位置,并具有以下子文件夹树:

  • 地图/
  • 网格/
  • sbs/
  • sbsar/
  • psd/
  • 3Dview/
  • …

在项目文件所在的层级上,您还可以存储切线空间插件或默认着色器。

配置文件(*.sbscfg)应与“项目文件”一起放在“性能”工作区中。

NOTE
有关在​ 生产管道 ​中设置和集成Substance 3D Designer的详细信息,我们​强烈推荐,请参阅文档的管道和项目配置部分。
recommendation-more-help
substance-3d-designer-help-guide