Skip to content
A framework to unify openFrameworks pointer events into a single W3C-PointerEvent like interface.
C++ Objective-C++ Objective-C Shell Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs
examples
libs/ofxPointer Updates for latest ios. Jul 22, 2019
scripts Remove unused files. Jan 7, 2018
src White space. Jul 22, 2019
.appveyor.yml
.gitignore
.travis.yml Update Travis. Jan 8, 2018
LICENSE.md Update. Jan 25, 2017
README.md Update README. Feb 14, 2019
TODO.md Add TODO. Feb 14, 2019
addon_config.mk Remove built-in serialization and ofxJSON requirement.. Feb 26, 2016

README.md

ofxPointer

Description

This frameworks adapts the W3C Pointer Event specification to work with openFrameworks. A compatibility layer for iOS / UITouch includes support for high-frequency coalesced events, predicted events, event property updates, tilt, pressure and other advanced properties.

Features

Currently the openFrameworks pointer model separates touch and mouse events, making cross platform development a little tricky.

Simply put, ofxPointer merges pointer, touch and pen input into a single extensible interface.

A typical program will now look like this:

All Platforms

#pragma once


#include "ofMain.h"
#include "ofxPointer.h"


class ofApp: public ofBaseApp
{
public:
    void setup() override
    {
        // Register the pointer events.
        ofx::RegisterPointerEvents(this);
    }

    void update() override
    {
        // Update
    }


    void draw() override
    {
        // Draw
    }


    void onPointerUp(ofx::PointerEventArgs& evt)
    {
        ofLogNotice("ofApp::onPointerUp") << evt;
    }


    void onPointerDown(ofx::PointerEventArgs& evt)
    {
        ofLogNotice("ofApp::onPointerDown") << evt;
    }


    void pointerMove(ofx::PointerEventArgs& evt)
    {
        ofLogNotice("ofApp::onPointerMove") << evt;
    }


    void onPointerCancel(ofx::PointerEventArgs& evt)
    {
        ofLogNotice("ofApp::onPointerCancel") << evt;
    }

};

Or even more simply, like this:

#pragma once


#include "ofMain.h"
#include "ofxPointer.h"


class ofApp: public ofBaseApp
{
public:
    void setup() override
    {
        // Register the pointer events.
        ofx::RegisterPointerEvent(this);
    }

    void update() override
    {
        // Update
    }


    void draw() override
    {
        // Draw
    }

    // All pointer events are returned to a single callback.
    void onPointerEvent(ofx::PointerEventArgs& evt)
    {
        ofLogNotice("ofApp::onPointerEvent") << evt;
    }
};

iOS

iOS Currently supports all advanced UITouch features including tiltX/Y, elevation, azimuth, precise location, pressure, predicted and coalesced events, estimated properties and estimated property updates. See the iOS examples for more.

Screenshot

Getting Started

To get started, generate the example project files using the openFrameworks Project Generator.

Documentation

API documentation can be found here.

Build Status

Linux, macOS Build Status

Visual Studio, MSYS Build status

Compatibility

The stable branch of this repository is meant to be compatible with the openFrameworks stable branch, which corresponds to the latest official openFrameworks release.

The master branch of this repository is meant to be compatible with the openFrameworks master branch.

Some past openFrameworks releases are supported via tagged versions, but only stable and master branches are actively supported.

Versioning

This project uses Semantic Versioning, although strict adherence will only come into effect at version 1.0.0.

Licensing

See LICENSE.md.

Contributing

Pull Requests are always welcome, so if you make any improvements please feel free to float them back upstream :)

  1. Fork this repository.
  2. Create your feature branch (git checkout -b my-new-feature).
  3. Commit your changes (git commit -am 'Add some feature').
  4. Push to the branch (git push origin my-new-feature).
  5. Create new Pull Request.
You can’t perform that action at this time.