关于数据路径

数据路径是用于查找资源(例如文件、配置文件和链接)的排序路径列表。 如果找不到资源的相对路径,应用程序将使用数据路径来解析外部参考。

将讨论以下主题:

相关主题
数据路径

常规信息

本主题提供有关数据路径的常规信息。

数据路径:

  • 当资源路径为绝对路径时不可用。
  • 为了便于修改,将统一并从数据文件中提取绝对路径的位置。
  • 支持本地、UNC、HTTP 和 FTP 路径。
  • 存储在可供处理同一方案的用户共享的文件中(默认为 DataPath.xml)。
  • 为指定常见路径提供一种机制以避免路径重复:
    • 全局 (DataPath.CommonGlobalList)) 路径将附加至所有其他路径列表
    • 配置文件 (DataPath.CommonProfileList)) 路径将附加至配置文件路径列表

注:

  • 路径顺序很重要;在找到资源后,搜索就会停止。
  • 数据路径支持带有变量的路径(例如 %USERPROFILE%\folder)。
  • 当用户首次运行 Composer 时,将在 User 文件夹中创建 DataPath.xml 文件。 请参见应用程序路径
  • 搜索多个路径以查找资源会增加文档的加载时间。 为获得最佳性能,应最大限度地减少路径的数量并先列出大量使用的路径。
  • 使用文本编辑器编辑数据路径文件。 不能从“数据路径”页面编辑文件。

指定 DataPath 文件

数据路径页面上指定数据路径文件。

默认值是您的 User 文件夹中的 DataPath.xml。 此位置存储在以下注册表设置中:

HKEY_CURRENT_USER\Software\Dassault Systemes\Composer\Preferences\DataPath.PathFolderDataPath

要使同一台计算机的多个用户参考相同的数据路径文件,请定义 HKEY_LOCAL_MACHINE 注册表项:

HKEY_LOCAL_MACHINE\Software\Dassault Systemes\Composer\Preferences\DataPath.PathFolderDataPathInstall

默认情况下,尚未定义此 HKEY_LOCAL_MACHINE 注册表项。 HKEY_CURRENT_USER 值将覆盖 HKEY_LOCAL_MACHINE

注: 这些注册表项的完整路径取决于操作系统。

保存时行为

保存 .smgXml 文件时,可能会改变其参考以保持子文件(未保存)和根(可存储在另一文件夹中)之间的链接。

在这种情况下:

  • 不会修改绝对参考。
  • 在使用尚未修改的数据路径进行加载时解析相对参考。 但是,如果通过父文件路径解析相对参考,则解析的绝对文件路径将用于计算其父文件的新相对路径。
  • 由于无法解析缺失的文件,因此使用其父文件路径来尝试计算新的相对路径。

此行为适用于方案 (.smgProj)、产品 (.smgXml) 和场景 (.smgSce) 文件。 您可以使用保存时解析相对参考选项更改行为。 您可以全面禁用相对路径解析(始终)或仅禁用无法解析的路径(仅解析路径)。 保存时行为默认为始终解析相对路径(如上所述,对这些路径应用修改)。

标签

下列标签会显示在数据路径 XML 文件中。

标签 描述
通用  
DataPath.CommonGlobalList 附加至所有其他路径列表的路径
DataPath.CommonProfileList 附加至所有配置文件路径列表的路径
Composer 文件  
DataPath.GeometryList 几何图形文件 ( .smgGeom)
DataPath.MetaPropertyList 元属性定义文件 ( .smgMeta)
DataPath.ProductList 产品文件 ( .smgXml)
DataPath.ScenarioList 场景文件 ( .smgSce)
DataPath.ViewList 视图文件 ( .smgView)
资源  
DataPath.LinkList 按事件链接和链接角色参考的资源
DataPath.TextureList 纹理图像文件(所有支持的图像文件格式)
轮廓  
DataPath.BOMList BOM 工作间配置文件 ( .smgBOMSet)
DataPath.ClashList 间隙检查工作间配置文件 ( .smgClashStaticSet)
DataPath.ClashRTList 交互式间隙检查配置文件 ( .smgClashRTSet)

注: 配置文件不可用于交互式间隙检查工作间。

DataPath.FilterList 过滤器工作间过滤器定义 ( .smgFilterSet)
DataPath.HiResList 高分辨率图像工作间配置文件 ( .smgHighResSet)
DataPath.Profiles.PublishHTML HTML 配置文件 ( .smgPublishHtmlSet). 这些配置文件在 HTML 输出中定义特征。
DataPath.Profiles.VideoList 视频工作间配置文件 ( .smgVideoCameraSet)
DataPath.Profiles.ViewList 视图工作间配置文件 ( .smgViewSet)
DataPath.SimplificationList 简化工作间配置文件 ( .smgLODSet)
DataPath.StyleList 样式工作间样式定义(.smgStyleSet.sset
DataPath.VectoList 技术图解工作间配置文件(.smgVectoSet.vset

示例

下面的示例显示了数据路径文件的语法。

注:

  • 通过 XML 文件中的路径顺序确定搜索顺序,而非Path 标签尾部的数字(<Path1><Path2> 等)。 找到资源后,搜索就会停止。
  • 可选 Description 参数提供了有关路径的附加信息。

  • 通过 XML 文件中的路径顺序确定搜索顺序,而非Path 标签尾部的数字(<Path1><Path2> 等)。 找到资源后,搜索就会停止。
  • 可选 Description 参数提供了有关路径的附加信息。

<CLitDataPathSet><DataPath.CommonGlobalList> <Path2 Value="chemin1"Description="Global resource location"/> </DataPath.CommonGlobalList> <DataPath.CommonProfileList > <Path0 Value="C:\My Documents\Composer\User"/> </DataPath.CommonProfileList> <DataPath.FilterList> <Path0 Value="http://datapath/Composer"/><Path2 Value="path1"/><Path1 Value="path2"/></DataPath.FilterList><DataPath.GeometryList> <Path2 Value="\\server1\Geometry\ProductID\" Description="ACME project files"/><Path1 Value="\\server2\Geometry\ProductID\"/></DataPath.GeometryList><DataPath.LinkList> <Path2 Value="http://globalweb/Composer"/><Path1 Value="C:\Documents and Settings\dgoss\My Documents"/><Path3 Value="ftp.3ds.com/fra/files"/></DataPath.LinkList><DataPath.ScenarioList> <Path2 Value="\\server1\Scenario\animation1\"/><Path1 Value="c:\Scenario\animation1"/></DataPath.ScenarioList>. . . </CLitDataPathSet>