ofxGVF 开源项目使用教程

ofxGVF 开源项目使用教程

ofxGVF Gesture Variation Follower: oF add-on, MaxMSP, PureData 项目地址: https://gitcode.com/gh_mirrors/of/ofxGVF

1. 项目介绍

ofxGVF 是一个用于实时手势识别和变化跟踪的 C++ 库，支持多种创意编程环境，如 openFrameworks、MaxMSP 和 PureData。该项目起源于学术研究，旨在通过物理手势实现与数字媒体的互动。ofxGVF 的核心功能包括手势模板的学习、手势的识别和跟踪，以及手势变化的实时处理。

2. 项目快速启动

2.1 安装 ofxGVF

首先，将 ofxGVF 添加到你的 openFrameworks 项目中。你可以通过以下步骤完成安装：

1. 克隆 ofxGVF 仓库到你的本地机器：

   git clone https://github.com/bcaramiaux/ofxGVF.git
   

2. 将 ofxGVF 文件夹复制到你的 openFrameworks 项目的 addons 文件夹中。

2.2 创建 GVF 对象

在你的 openFrameworks 项目中，创建一个 GVF 对象：

#include "ofxGVF.h"

ofxGVF gvf;

2.3 录制手势模板

切换到学习模式并录制手势模板：

gvf.setState(GVF::STATE_LEARNING);

// 开始录制新手势
gvf.startGesture();

// 添加手势点
ofVec2f point(x, y);
gvf.addObservation(point);

2.4 手势识别与跟踪

切换到跟踪模式并开始手势识别与跟踪：

gvf.setState(GVF::STATE_FOLLOWING);

// 开始新手势
gvf.startGesture();

// 更新手势识别与跟踪
ofVec2f observation(x, y);
gvf.update(observation);

2.5 获取结果

获取 GVF 的输出结果：

GVFOutcomes outcomes;
outcomes = gvf.update(observation);

3. 应用案例和最佳实践

3.1 实时手势控制

ofxGVF 可以用于实时手势控制，例如通过手势控制音乐播放器的播放、暂停和音量调节。通过录制不同的手势模板，用户可以自定义手势来控制不同的功能。

3.2 互动艺术装置

在互动艺术装置中，ofxGVF 可以用于识别观众的手势，并根据手势的变化实时调整艺术作品的视觉效果。例如，手势的移动速度和方向可以影响灯光的颜色和亮度。

3.3 游戏开发

在游戏开发中，ofxGVF 可以用于实现手势控制的技能释放。例如，玩家可以通过特定的手势来释放不同的技能，增加游戏的互动性和趣味性。

4. 典型生态项目

4.1 openFrameworks

ofxGVF 是 openFrameworks 的一个插件，广泛应用于 openFrameworks 项目中。openFrameworks 是一个跨平台的 C++ 工具包，用于创意编程和互动艺术。

4.2 MaxMSP

MaxMSP 是一个用于音乐和多媒体创作的编程环境。ofxGVF 提供了 MaxMSP 的编译版本，可以直接在 MaxMSP 中使用。

4.3 PureData

PureData 是一个开源的图形化编程语言，用于实时音频和视频处理。ofxGVF 也提供了 PureData 的编译版本，方便用户在 PureData 中进行手势识别和跟踪。

通过这些生态项目，ofxGVF 可以与多种创意编程环境无缝集成，为用户提供丰富的手势识别和跟踪功能。

ofxGVF Gesture Variation Follower: oF add-on, MaxMSP, PureData 项目地址: https://gitcode.com/gh_mirrors/of/ofxGVF