nCache XML 描述文件

 
 
 

创建 nCache 时,缓存将作为 .mc(Maya 缓存)文件保存到磁盘中,并且系统会为缓存生成 .xml 描述文件。XML(可扩展标记语言)描述文件包含 Maya 用于为 Nucleus 对象查找缓存文件的重要缓存属性列表和标识哪个对象设置与哪个缓存文件对应的属性值列表(请参见附加)。

可以使用 XML 描述文件跟踪 nCache 文件及其关联对象、被动对象、约束和场景。

注意

XML 描述文件是只读文件。

XML 描述文件中包含的 nCache 信息由 XML 元素和属性构成或组织。每个常规元素(如 cacheType 和 Channel)或嵌套元素(如 channel#)包含一个或多个列出了特定 nCache 或对象特性的属性(如“Type”“ChannelName”“SamplingRate”)。

Autodesk_Cache_File

cacheType

在磁盘上指定 nCache 的格式。

Type

选择下列类型选项之一:

OneFile

指定 nCache 包含在单个 Maya 缓存文件中。

OneFilePerFrame

指定 nCache 分为多个 Maya 缓存文件,每个缓存帧一个文件。

time

Range

指定 nCache 的帧范围或时间范围。例如,如果 nCache 包含 nCloth 对象的模拟(从帧 1 到帧 25),则“Range”属性将为 250-6250。

时间范围以“时间步”衡量。时间步是子帧单位。每个 nCache 帧包含多个时间步。一个帧中包含的时间步数包含在由当前“工作单位(时间)”(Working Units (Time))用户首选项设置确定。

每帧时间步数 = 6000/帧速率。例如,如果“工作单位(时间)”(Working Units (Time))首选项设定为“电影(24 fps)”(Film (24 fps)),则 nCache 的每个帧包含 250 个时间步。

cacheTimePerFrame

TimePerFrame

指定 nCache 的每一帧中的时间步数。

cacheVersion

Version

指定创建当前 XML 描述文件及其 nCache 文件的 Maya nCaching 功能的版本号。

extra

为 nCache 指定下列内容:

  • nCache 的 Maya 场景文件的名称和创建缓存时其在磁盘上的位置。
  • 在其中创建 nCache 的 Maya 版本。
  • 创建 nCache 的用户帐户名称。
  • 共享相同 Maya® Nucleus 解算器作为缓存的 Nucleus 对象的被动对象名称。该描述 extra 不会应用于流体 nCache。
  • 当前应用于缓存 Nucleus 对象的约束的名称。该描述 extra 不会应用于流体 nCache。
  • 缓存对象的形状节点“属性编辑器”(Attribute Editor)选项卡上来自“注释”字段的文本。
  • 创建缓存时,所有 Nucleus 对象的 nClothNucleusdynamicConstraint 节点属性值。这些属性和值也显示在每个节点的“通道盒”(Channel Box)中。
    注意

    如果将多个对象的模拟缓存到单个缓存中,XML 文件将列出每个缓存对象的属性值及其所有被动对象和约束(如果有)。

通道

包含所有对象或特定于通道的缓存信息

channel#

每个缓存对象已指定其各自的 channel# 嵌套元素。例如,如果选择 5 个 nCloth 对象,将“文件分布”(File Distribution)设定为“一个文件”(One File)“每帧一个文件”(One File Per Frame)并缓存这些对象的模拟,则会生成一个 XML 描述文件,其包括以下嵌套元素:channel0、channel1、channel2、channel3 和 channel4。但是,如果将“文件分布”(File Distribution)设定为“每个几何体一个文件”(One File Per Geometry),则会为每个选定对象生成一个 XML 描述文件,且每个 .xml 文件中仅会出现一个 channel# 嵌套元素。

ChannelName

指定缓存所属的对象的名称。该值是每个缓存对象特有的。

ChannelType

指定存储通道缓存数据的数组的数据类型。由于多边形网格数据存储为“浮点”(Float),因此对于 nCloth 缓存,仅支持“FloatVectorArray”

ChannelInterpretation

指定由通道缓存驱动的对象数据的类型。数据类型取决于经过 nCache 的对象的类型。对于 nCloth 缓存,仅支持“位置”(Positions)属性值。流体 nCache 支持下列属性值:“Density”“Velocity”“Temperature”“Fuel”“Color”“Texture coordinates”“Falloff”

有关可缓存 nParticle 属性的信息,请参见缓存

SamplingType

指定通道模拟采样是否以等间隔保存到磁盘。“常规”(Regular)指示采样以等间隔保存,“非常规”(Irregular)指示采样以非等间隔保存。

这些值可帮助 Maya 更有效地搜索磁盘上的通道缓存文件。

通常,nCache 的采样类型在创建后始终为“常规”(Regular)。但是,如果以会更改缓存的采样间隔的方式编辑缓存,则缓存的采样类型将更改为“非常规”(Irregular)。例如,如果 nCache 为每 1 帧求值一次,且向其附加每 2 帧求值一次的缓存,则缓存的采样类型将更改为“Irregular”。

SamplingRate

指定通道的 nCache 文件在首次创建时在磁盘上的空间。

“SamplingRate”=“每 # 个帧求值一次”(Evaluate every # frame(s)) x“每 # 次求值保存一次”(Save every # evaluation (s))。例如,如果将“每 # 个帧求值一次”(Evaluate every # frame(s))设定为 0.5,并将“每 # 次求值保存一次”(Save every # evaluation(s))设定为 1,并且用户工作单位设定为 24 fps,则将以每 125 时间步或半帧进行采样并保存到 nCache。

StartTime

在时间步中为磁盘上通道的第一个 nCache 文件指定时间。

EndTime

在时间步中为磁盘上通道的最后一个 nCache 文件指定时间。