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

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

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

Cinema 4D中的常规工作流程

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

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

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

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

选单

文件

打开文件

导入单个.c4d场景文件。

打开文件夹

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

打开一级子文件夹

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

打开所有子文件夹

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

目录树的示例以及所有三个选项之间的差异：
C4D过滤器插件 C.O.F.F.E.E. FILTER

打开当前文档

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

打开所有打开的文档

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

内容浏览器

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

搜索COFFEE插件

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

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

编辑

去掉

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

找到咖啡

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

没有咖啡

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

预设值

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

插入

从插件扫描中删除结果。

筛选结果

为了快速了解导入操作的结果，可以轻松隐藏某些文件组。
C4D过滤器插件 C.O.F.F.E.E. FILTER

找到咖啡

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

没有咖啡

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

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

单击该图标可以直接访问COFFEE元素。
C4D过滤器插件 C.O.F.F.E.E. FILTER

刷新

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

打开

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

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

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

去掉

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

咖啡使用清单

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

命令行上的常规工作流程

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

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

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

选项	描述
`-COFFEEFilter`	这个论点必须是第一个。直接在此参数旁边指定的扫描文件/文件夹：`-COFFEEFilter’FILE_OR_FOLDER_PATH’`
导入选项（仅一种可能） `-文件夹` `-一级` `-子文件夹`	如果要处理的路径是文件，则忽略此选项。 `-文件夹` （默认行为）：仅处理文件夹的内容，与文件菜单=>打开文件夹中所述的相同 `-一级`：处理文件夹和一级子文件夹，与文件菜单=>打开一级子文件夹中所述的相同 `-子文件夹`：处理文件夹和所有子文件夹，与文件菜单=>打开所有子文件夹相同
`-CheckPlugins`	处理插件文件夹，与文件菜单=>搜索COFFEE插件相同
`-只有场景与咖啡`	结果列表中仅包含带有COFFEE的场景。
`-输出`	将结果列表写入文件，直接在此参数旁边指定 `-输出’FILEPATH’` 输出格式取决于-Json选项。如果由于某种原因无法写入文件，则将结果打印到控制台。
`-覆盖输出`	允许覆盖结果列表文件。如果未设置此选项并且无法写入结果列表文件，则将结果打印到控制台。
`杰森`	结果列表将为JSON格式。

例子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）。