I don't have a tablet here right now, but here a bit of insight into the format:
The array returned by path.tabletData contains values of the type TabletValue (so far not documented in the Reference). This is a simple object with two fields: offset and value.
Offset is a value between 0 and 1, with 0 being the beginning of the path, and 1 the end. The range for value also goes from 0 to 1.
When retrieving tabletData, you get an array containing these objects. When setting, you can also directly set a two dimensional array, which is then internally converted to TabletValues:
path.tabletData = [[0, 0], [0.5, 1], [1, 0]];
This creates a ramp from 0 to 1 in the middle and back to 0 at the end.
And there are two requirements that you should meet:
- The values should allways have a first object with offset 0 and a last one with offset 1.
- There should not be more than a certain amount of pairs. I am not sure if I remember correctly, but thought it was 128, or 256. Maybe it is more.
Also, it is good to know that when you cut a path, the tabletData array gets split at the right place automatically for you, and the offset values are ajusted accordingly.