C4D过滤器插件 C.O.F.F.E.E. FILTER

使用Cinema 4D R20，COFFEE脚本语言已被删除。

COFFEE筛选器插件应该可以帮助定位场景，无论以哪种方式都可以使用COFFEE，而且还可以轻松访问所涉及的COFFEE代码。COFFEE筛选器插件不会将现有的COFFEE代码转换或移植到Python（或其他任何东西）。它只是提供了定位包含COFFEE的场景的方法，并且提供了一种获取场景内部代码的简便方法。COFFEE筛选器可以并且不会删除文件。
COFFEE筛选器不会覆盖文件。

Cinema 4D中的常规工作流程

常规工作流程
常规工作流程包括两个主要步骤：

1. 导入场景文件
   • （可选）过滤并选择导入结果
2. 单击实体的图标以打开场景，然后在“属性管理器”中查看COFFEE代码

在哪里可以找到插件
COFFEE过滤器可以在“插件”菜单中找到：

主对话框
主对话框如下所示：

选单

文件

打开文件

导入单个.c4d场景文件。

打开文件夹

导入选定目录中的所有.c4d场景文件。

打开一级子文件夹

导入给定目录中和下一级中的所有.c4d场景文件。此选项适用于具有项目文件夹的人员，该文件夹随后包含不同项目的子目录，但又不想扫描实际项目目录中可能包含的任何备份子目录。

打开所有子文件夹

导入给定目录（包括所有子目录）中的所有.c4d场景文件。也可以将文件或文件夹从资源管理器或Finder拖到此对话框中，以便将其导入。

目录树的示例以及所有三个选项之间的差异：

打开当前文档

导入当前活动的场景。该文档需要一个名称，因此它要么已加载，要么至少需要保存一次。

打开所有打开的文档

导入所有打开的场景。这些文档需要有名称，因此必须加载或至少保存一次。

内容浏览器

将所有内容从您的个人内容预设库导入对话框。虽然我们在内部使用此插件来扫描自己的内容库，但已发布的版本中不包括这些内容。这样做不是为了隐藏任何东西，而是为了将结果减少到与用户相关的那些结果。R20随附的内容库将不包含任何COFFEE场景。

搜索COFFEE插件

从位于以下目录中的当前Cinema 4D实例导入COFFEE插件：

• 程序安装文件夹中的Cinema 4D插件文件夹
• 用户家中的Cinema 4D插件文件夹
• 在C4D_PLUGINS_DIR环境变量中定义的路径

编辑

去掉

根据选择的选项从结果列表中删除条目（请参见下文）。它不会删除任何文件。

找到咖啡

删除至少包含一个COFFEE元素的结果。这些通常是场景文件，需要采取措施才能在R20中正常工作。

没有咖啡

删除不包含任何COFFEE元素的结果。

预设值

从内容浏览器库扫描中删除结果。

插入

从插件扫描中删除结果。

筛选结果

为了快速了解导入操作的结果，可以轻松隐藏某些文件组。

找到咖啡

黄色–显示的结果至少包含一个COFFEE元素，最有可能的结果需要采取行动才能在R20中正常工作。

没有咖啡

绿色–显示的结果根本不包含COFFEE元素，可能是要从结果列表中删除的候选对象。

访问COFFEE代码
导入一个或多个场景文件后，它们将显示在结果列表中，如下所示。

单击该图标可以直接访问COFFEE元素。

刷新

刷新文件状态。例如，在删除COFFEE节点之后。如果当前在Cinema 4D中打开了此文件，则插件将使用此文档，而不使用磁盘上的文档。

打开

在Cinema 4D中打开给定的场景文件。

在资源管理器/查找器中查看

在Windows OS或macOS的Finder中打开给定的场景。

去掉

从结果列表中删除文件。该文件不会被删除，只是从列表中删除。

咖啡使用清单

如果需要，单击图标将打开文件，并且将选择COFFEE元素特定的COFFEE元素，以便将其显示在“属性管理器”中。如果COFFEE节点在Xpresso标记内，而此节点在锁定的xgroup内，则仅显示该组。锁定的节点/ xgroup将不会公开代码。

命令行上的常规工作流程

命令行的一般工作流程与上述工作流程几乎相同。

基本上，将文件/文件夹设置为要扫描，它将把带有COFFEE元素的结果列表写入文件。与该插件的UI命令相比，该命令行可用于Cinema 4D到R16的版本。

命令行选项所有命令行选项都必须用双引号引起来。

例子1

检查来自的所有文件 {您的路径} / CS群集/ （包括子文件夹的第一级）和plugins文件夹，将结果列表写入 {您的路径} /result.txt 并允许覆盖此生成的文本文件（以防该操作多次运行）。

1个CINEMA 4D.exe "-COFFEEFilter '{your path}/CS Cluster/' -SubFolder -Output '{your path}/result.txt' -OverwriteOutput -CheckPlugins" 例子2 检查来自的所有文件 {您的路径} / CS群集/ （包括子文件夹的第一级）和plugins文件夹，将结果列表写入 {您的路径} / CS Cluster / result.json 并允许覆盖此生成的文本文件（以防该操作多次运行）。 1个CommandLine.exe "-COFFEEFilter '{your path}/CS Cluster/' -SubFolder -Output '{your path}/CS Cluster/result.json' -Json -OverwriteOutput -CheckPlugins" 示例2输出 将结果列表以JSON文件格式写入： {您的路径} / CS Cluster / result.json 1个2个3456789101112131415161718岁192021岁22[{"path": "{your path}\CS Cluster\CS Cluster.c4d","coffee": ["CS-Cluster-XPresso-XGroup::C.O.F.F.E.E.-C.O.F.F.E.E.","CS-Cluster-XPresso-XGroup::C.O.F.F.E.E.-C.O.F.F.E.E.","CS-Cluster-XPresso-XGroup::Framestart-Framestart","CS-Cluster-XPresso-XGroup::RIGHT Instance Maker-RIGHT Instance Maker","CS-Cluster-XPresso-XGroup::LEFT Instance Maker-LEFT Instance Maker"]},{"path": "{c4d installation path}\plugins\Commentator\commentator.cob","coffee": ["commentator.cob"]},{"path": "{c4d installation path}\plugins\cinema4dsdk\res\scene\stairs.c4d","coffee": []},] 局限性 无法通过命令行进行内容浏览器扫描。 Xpresso预设无法扫描。如果需要检查它们，请创建一个Xpresso标签并将所有预设拖动到其中，保存场景，然后运行插件。 加载某些文件时，例如，如果“物质”模块中缺少资产，则可能会打开一个消息对话框。该插件将一直挂起，直到与用户互动为止。插件无法绕过这些消息。 要求 要在Cinema 4D用户界面中用作命令，必须使用Cinema 4D R19（Windows或Mac）。
要在命令行（批处理模式）上使用，必须使用Cinema 4D R16（Windows或Mac）。