Extension API for MadMapper
  • User avatar
    cansik
    member
    Posts: 20
    Joined: Mon Apr 27, 2015 9:40 pm
    Location: Zurich
    Contact:

    Extension API for MadMapper

    by cansik » Fri Oct 02, 2015 8:07 pm

    Dear Garagecube Developers

    I think you heard it a lot but it is still a feature which is missing in MadMapper. It would be great if we would have an API to interact with MadMapper and get informations about the current setup.

    I would like to build an app which let you move the handles of the surfaces in MadMapper to map directly in front of the object and let the laptop behind the desk.
    OSC would work to just move the handles but I can't get a list of the current surfaces.

    At the moment we don't need a full python environment like in Modul8 but if this is the simplest way for you, got for it. It would just be great to interact with MadMapper.

    What do you think?
    Is this planned for the (near) future?

    Thank you & cheers
    Florian
  • Xaver2k
    super8 member
    Posts: 103
    Joined: Thu Feb 20, 2014 11:23 pm
    Location: Germany

    Re: Extension API for MadMapper

    by Xaver2k » Mon Oct 12, 2015 9:49 pm

    +1
  • mad-matt
    garageCube team
    Posts: 1475
    Joined: Mon Sep 09, 2013 5:50 pm

    Re: Extension API for MadMapper

    by mad-matt » Wed Oct 14, 2015 9:40 pm

    Hi,
    We were thinking to add the possibility to request the list of nodes and their value from OSC. if you'd like to test, send me your email in PM.
    Cheers,
    Matt
  • franz
    madMapper master
    Posts: 1033
    Joined: Fri Feb 18, 2005 7:05 pm
    Location: Paris, France
    Contact:

    Re: Extension API for MadMapper

    by franz » Fri Oct 30, 2015 7:36 pm

    @cansik: we usually listen to our users ... ;) cannot say more
  • User avatar
    cansik
    member
    Posts: 20
    Joined: Mon Apr 27, 2015 9:40 pm
    Location: Zurich
    Contact:

    Re: Extension API for MadMapper

    by cansik » Wed Nov 18, 2015 3:28 pm

    @franz It seems like you do :D Thank you!
    I'm testing it at the moment:

    https://vimeo.com/143710495
  • User avatar
    broken
    super8 member
    Posts: 125
    Joined: Sun Dec 23, 2012 11:44 pm
    Location: canada

    Re: Extension API for MadMapper

    by broken » Wed Dec 16, 2015 6:00 am

    cansik wrote:@franz It seems like you do :D Thank you!
    I'm testing it at the moment:

    https://vimeo.com/143710495


    That is very cool.

    I was just thinking about the possibility of something like this in order to perform chases or "bumps" (http://chaser.hybridvisuals.nl/) like the Resolume community is mad about, where each surface is activated/deactivated in a pattern or via timeline.
    I just didn't know of a way to grab the data for the surfaces.. but if all this is possible via OSC I'm wondering if it would be possible to setup in Lemur/TouchOSC to manipulate or toggle surfaces on or off.

    Is it just the list of nodes/values for the handles that are able to be requested, or are there other values that can be grabbed and manipulated as well? Very curious :)
  • User avatar
    cansik
    member
    Posts: 20
    Joined: Mon Apr 27, 2015 9:40 pm
    Location: Zurich
    Contact:

    Re: Extension API for MadMapper

    by cansik » Wed Dec 16, 2015 5:19 pm

    broken wrote:Is it just the list of nodes/values for the handles that are able to be requested, or are there other values that can be grabbed and manipulated as well? Very curious :)


    Thank you! Yes it is possible to get a list of controls like surfaces and it is also possible to get the actual values. But these two functions are not in the public release at the moment. I'm currently just testing the alpha builds.

    Setting the value should be already implemented in the current version. You don't have to map the OSC address, you can just call the address you would like to change and MM will set the value to it. But without getting the controls and values it makes not much sense.

    Building a chaser would of course be possible with this API :)
  • User avatar
    broken
    super8 member
    Posts: 125
    Joined: Sun Dec 23, 2012 11:44 pm
    Location: canada

    Re: Extension API for MadMapper

    by broken » Wed Dec 16, 2015 7:24 pm

    cansik wrote:
    broken wrote:Is it just the list of nodes/values for the handles that are able to be requested, or are there other values that can be grabbed and manipulated as well? Very curious :)


    Thank you! Yes it is possible to get a list of controls like surfaces and it is also possible to get the actual values. But these two functions are not in the public release at the moment. I'm currently just testing the alpha builds.

    Setting the value should be already implemented in the current version. You don't have to map the OSC address, you can just call the address you would like to change and MM will set the value to it. But without getting the controls and values it makes not much sense.

    Building a chaser would of course be possible with this API :)


    Thank you for the reply! This is great news.. I imagine a chaser could even be implemented in something like Vezér since it already does the timeline thing very well and works great with OSC. At least once the API is out of alpha/beta. (edit: it's kind of possible with the surface opacity being available via OSC, - can't quite get the visibility flag to work, which would be ideal)

    This is all very exciting! This API thing was a fantastic suggestion :)
  • fastfourier
    junior Member
    Posts: 4
    Joined: Wed Nov 04, 2015 8:40 pm

    Re: Extension API for MadMapper

    by fastfourier » Mon Jan 25, 2016 12:20 am

    Thank you very much for implementing this API. This certainly beats wading through the XML/SVG output.

    Can you make it do polygons next? Please?
  • User avatar
    cansik
    member
    Posts: 20
    Joined: Mon Apr 27, 2015 9:40 pm
    Location: Zurich
    Contact:

    Re: Extension API for MadMapper

    by cansik » Fri Feb 19, 2016 3:15 pm

    For all who want to use this API (which still is under development) I have created a github repository which contains a documentation and some examples. The examples have been written for MadMapper version 2.2.2.

    Since then the API already changed so it really is not very stable. I didn't update the documentation yet (maybe this weekend), but it should work with version 2.2.2.

    https://github.com/cansik/madmapperapi

    If you have something to contribute or have some questions just open an issue.
  • btownshend
    junior Member
    Posts: 2
    Joined: Sun Nov 22, 2015 10:18 pm

    Re: Extension API for MadMapper

    by btownshend » Thu Feb 25, 2016 9:17 am

    Thanks for the API -- that's great!

    One request: it would be great if the mesh coordinates could also be sent/received via OSC. I have an application that does an autoalignment using a camera and test images, but setting the mesh coordinates is then a manual affair once they are determined.

    Thanks!
  • User avatar
    cansik
    member
    Posts: 20
    Joined: Mon Apr 27, 2015 9:40 pm
    Location: Zurich
    Contact:

    Re: Extension API for MadMapper

    by cansik » Fri Feb 26, 2016 10:15 am

    What do you mean with mesh coordinates?
  • btownshend
    junior Member
    Posts: 2
    Joined: Sun Nov 22, 2015 10:18 pm

    Re: Extension API for MadMapper

    by btownshend » Tue Apr 19, 2016 1:46 am

    I thought I had replied to this previously, but apparently not...

    What I mean is that when a mapping is setup that uses "Mesh Warping", the anchors for that mesh can be moved via the GUI, but there is no way to set or query them via the OSC interface.

    Similarly, when a mask is added, the coordinates of the vertices of the mask cannot be set or retrieved via the existing OSC API using getControls or getControlValues.
  • fastfourier
    junior Member
    Posts: 4
    Joined: Wed Nov 04, 2015 8:40 pm

    Re: Extension API for MadMapper

    by fastfourier » Sat Apr 23, 2016 4:46 pm

    I would love to be able to get the mask handles especially!

Who is online

Users browsing this forum: No registered users and 16 guests