Puck mapping

Questions and answers about 3Dconnexion devices on Windows.

Moderator: Moderators

Post Reply
Thalamus
Posts: 3
Joined: Sat Oct 19, 2019 8:10 pm

Puck mapping

Post by Thalamus »

Hi,
I'd like to map the Puck axes to various functions in some audio software I'm using.
It seems the Mac drivers allow key bindings but this has been removed from the newer Windows drivers.

Is there a way to do this right now? Are older drivers available?
It seems a shame to prohibit this kind of thing.
jwick
Moderator
Moderator
Posts: 3328
Joined: Wed Dec 20, 2006 2:25 pm
Location: USA
Contact:

Re: Puck mapping

Post by jwick »

There is no GUI for it, so while it basically works, it is limited, untested and a lot of manual XML editing is required.

There is a long thread here.

Fundamentally you have to tell the driver which keys to send and when.

It's best to start with some copy & paste from samples we ship. The KeyboardWASDTemplate.xml file contains some Axis assignments that send WASD keys (for games).
E.g., this sends an HID 8 keycode ("E") when the cap is pushed in the positive X and the value is > 200.

Code: Select all

        <Axis>
          <Enabled>true</Enabled>
          <Input>
            <ActionID>HIDMultiAxis_X</ActionID>
            <Min>0</Min>
            <Max>511</Max>
            <Deadband>200</Deadband>
          </Input>
          <Output>
            <ActionID>KB_Keystroke</ActionID>
            <RepeatStyle>PressAndHold</RepeatStyle>
            <KeyStroke>
              <Key>8</Key>
            </KeyStroke>
          </Output>
        </Axis>
aporia
Posts: 1
Joined: Wed Dec 15, 2021 9:33 am

Re: Puck mapping

Post by aporia »

Hello Jwick

I have a 3D Spacemouse (Enterprise) and am interested in this forum thread and modifying the XML.
However, the forum area you linked (https://www.3dconnexion.com/forum/viewt ... 37&t=20812) says that I cannot access that area. Could I please have access so I can read what is there?
Thank you
jwick
Moderator
Moderator
Posts: 3328
Joined: Wed Dec 20, 2006 2:25 pm
Location: USA
Contact:

Re: Puck mapping

Post by jwick »

Yes, that thread is locked for some reason. I don't know why. I can't unlock it.
It is a bit out-of-date (5 years old).

I can though answer your questions here.

As shown in the above sample, you can map keys to the cap movement.
First you need a cfg file for your application. Let our software create this for you. Change something while your app is in focus, in our GUI, or just press the Rotation Lock button on your SME.

That gives you a valid file to work with (in %appdata%\3Dconnexion\3DxWare\Cfg).
You can then start copying in and modifying Axis definitions.
scubanarc
Posts: 4
Joined: Sun Jun 20, 2021 4:08 pm

Re: Puck mapping

Post by scubanarc »

Is there a list of keystrokes anywhere?

I've figured a few out through trial and error, but a list would be great.
pdschell
Posts: 3
Joined: Thu Mar 11, 2021 9:56 am

Re: Puck mapping

Post by pdschell »

keystrokes are based off of HID usage tables.

Start on page 89 of the PDF https://usb.org/document-library/hid-usage-tables-14

hope this helps
Post Reply