AE-Element 开源项目安装与使用指南
1. 项目目录结构及介绍
当你通过git克隆或下载并解压缩了AE-Element
项目后, 你会看到以下主要的目录与文件:
-
bin: 存放执行文件和动态库。
ElementInstaller.exe
: Windows下用于安装Element 3D插件的执行程序。ElementInstaller.app
: macOS下用于安装Element 3D插件的应用程序。
-
lib: 包含插件运行所需的库文件。
ElementLib.dll
: 插件的功能库文件,在Windows环境下被加载。
-
src: 源代码目录,包含了所有源码文件。
ElementPlugin.cpp
: 插件的核心逻辑实现。ElementLicense.cpp
: 许可验证模块的实现。
-
res: 资源文件存储区。
ElementLicense.license
: 插件授权许可文件。material_packs/**
: 预置的材料包, 包括3D模型和纹理等资源。
-
config: 配置文件存放位置。
ElementConfig.ini
: 主要配置文件,包括插件参数设置。
-
README.md: 项目说明和使用指南文档。
-
LICENSE: 描述使用的许可证类型和条件的法律声明文档。
2. 启动文件介绍
Windows平台下启动安装流程
-
执行
bin/ElementInstaller.exe
进行初始安装;- 安装过程将自动检测AE的版本并安装相应兼容版本的Element 3D插件。
-
根据需要,运行
bin/ElementInstaller-update_build.exe
来更新插件至最新版本。- 更新补丁将覆盖旧版本并保留原有设置和授权状态。
macOS平台下启动安装流程
-
双击
bin/ElementInstaller.app
, 进入macOS安装界面; -
选择已安装的After Effect版本或者手动指向AE的插件目录(
/Applications/<Your AE Version>/Plug-ins/
)以便正确安装; -
插件将根据系统环境自动调整兼容性配置。
注意: 不论在哪个平台上, 完成安装后, 都应当重启AE以激活Element 3D插件环境。
3. 配置文件介绍
ElementConfig.ini
这是Element 3D的主要配置文件, 其中的关键配置项如下:
-
[General]
language=zh-CN
: 设置插件用户界面语言为简体中文。autoUpdateCheck=true
: 启用自动检查更新功能。
-
[Performance]
hardwareAccelerationEnabled=true
: 开启硬件加速支持以提升渲染速度。
-
[License]
licenseFile=res/ElementLicense.license
: 指定许可文件的位置路径。
在编辑配置文件前确保备份原始副本, 并保存更改后重新启动AE确保配置生效。
此文档详细介绍了AE-Element
项目的各个组成部分及其用途。从文件结构解析到具体的配置设定,都遵循了清晰而直观的原则。对于初次接触该插件的用户来说,这份指南无疑将提供全面且实用的帮助。