Home

a copy here.

1. T1 2 0 T1 2 0 T1 2 0 T1 2 0 Max TO T1 2 0 TO Ti 2 0 TO T 2 0 T 2 0 T 2 0 Ti 2 0 Met TO IER T 2 0 Units Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians By Sensitivity NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO Sind SA po 70 TC Data User Guide Version 1 0 Controller Pitch During Group Pitch During Group Running Pitch During Group Running Roll Roll Roll Touch 4 Roll Touch 4 Roll Touch T Roll Touch f Roll During Touch Roll During Touch m J l 1 T Roll During Group Roll Group Roll Group Roll Group Sen Oe e Roll Group Roll During Group Roll During Group Running Description Min Rotation around the x axis changing only during group Rotation around the x axis cumulative changing only 0 during group T1 2 Rotation around the x axis cumulative changing only 1 2 during group Rotation around the y axis 0 Rotation around the y axis TI Rotation around the y axis 0 Rotation around the y axis TI Rotation around the y axis 0 Rotation around the y axis TI Rotation around the y axis changing only during touch 0 Rotation around the y axis
2. TC Data Version 1 0 User Guide March 20 2015 Bit Shape Software LLC Bit Shape Software LLC http www bitshapesoftware com i Eka SA ne TC Data User Guide Version 1 0 Contents Getting Started a MOGUCU l kas t li kk 225 ces kk aa fe kk ki e n ab ti oka kibik aka 4 TC Data E 4 MID QUICK YE EE 5 EE ee 5 Interface 7 Ke AUG EE 7 1 0 Navigati n Bar ek ka td a pk e E e e A a 7 EE 8 2 0 e ler 8 3 0 Load 7 IS NAN Ske kk kk ok kask ok l ke n ak n a ko iv kk bk ba 12 ee ba e it a e R e te pet dicta e a e ae e ra epa tak 16 EE 20 Performance 24 Performance e 24 Viele Tee MON Vs tn a ok e na n es ok e e aa e ek e 24 6 0 OSC and MIDI Voice Allocation WE 24 Device a le E 25 PAC YO LAN EE 26 By Sind SA po TC Data User Guide Version 1 0 Performance TIN tate isi ati aston hee a ik ek ie et ek aie 26 Patch Editing 28 Controllers Explained en a in a aa n eege 28 7 0 Voiced vs Global Controllers E 28 9 0 Controller Ee 29 KEENT 34 Gebei 34 10 0 Special Output F AatUN S vie se denssaksldi passe vanse vi aske east a ake ka ae ide 38 Module Programming ME 41 Ke EI 41 120 LFO a as ii pl oni ii fi ik tj tk en a st ERE E at e ka bn ka a ki ek by an peye 43 19O TA EE 45 SEENEN 49 Appendices 53 MOU IS wa le Le ai kn a a bk lat et ek tn e a ja m a ae e screener ei st 53 RR A SOU NON E 53 Appendix A Sy CIS kob k asi e st ek ab ba ak
3. 73 Units Degrees Points Points Points Points By Cl po Sind Sensitivity NO NO NO NO NO 69 TC Data User Guide Version 1 0 18 2 Device Motion Controllers Controller Accelerometer X Accelerometer X Accelerometer Y Accelerometer Y Accelerometer Z Accelerometer Z Pitch Pitch Pitch Touch L Pitch Touch Pitch Touch T Pitch Touch f Pitch During Touch Pitch During Touch Pitch Group Pitch Group Pitch Group Pitch Group l l 1 T Pitch During Group SS Ss Sea Description Acceleration minus gravity on the short x axis Acceleration minus gravity on the short x axis Acceleration minus gravity on the long y axis Acceleration minus gravity on the long y axis Acceleration minus gravity on the through z axis Acceleration minus gravity on the through z axis Rotation around the x axis Rotation around the x axis Rotation around the x axis Rotation around the x axis Rotation around the x axis Rotation around the x axis Rotation around the x axis changing only during touch Rotation around the x axis changing only during touch Rotation around the x axis Rotation around the x axis Rotation around the x axis Rotation around the x axis Rotation around the x axis changing only during group Min San NI TI 11 2 0 T1 2 0
4. Creation Time Since Previous Time Alive Time Alive T Time Stationary Time Stationary T Time Moving Description Time difference between a touch and the first touch Time difference between a touch and the prevoius touch A running value that reports the time a touch has been active A running value that reports the time a touch has been active A running value that reports the time a touch has not moved A running value that reports the time a touch has not moved A running value that reports the time a touch has been Moving Units Seconds Seconds Seconds Seconds Seconds Seconds Seconds oA Ss ge Sensitivity YES YES YES YES YES YES YES TC Data User Guide Version 1 0 Controller Time Moving T X Position Y Position X Position 4 Y Position X Position T Y Position T Speed X Velocity X Velocity Y Velocity Y Velocity Velocity to Center Velocity to Center Rotation Speed Around First Rotation Speed Around Center Description A running value that reports the time a touch has been Moving The x axis position of the touch The y axis position of the touch The x axis position of the touch The y axis position of the touch The x axis position of the touch The y axis position of the touch The speed of the touch The x velocity of the touch The x velocity of the touch The
5. ai SA po Multitouch controllers are split into two categories Touch controllers are voiced controllers that have values for every active touch Note that in many cases more than one touch is needed to generate the data For example the Angle To Previous Touch checks the position of two touches to find the angle between them and assigns that value to the latter touch Group controllers are global controllers that examine the entire collection of active touches the group to generate their data One example is Total Distance To Center which sums all of the touches distances to the center of the screen Like the Controllers popover list there is a corresponding Triggers popover list that shows triggers generated by touch data device motion and modules The same voiced and group categorization applies 7 3 Device Motion Controllers Device Motion controllers are global controllers that pull data from the physical movement of the iPad There are three device motion sensors the accelerometer the gyroscope and the compass The accelerometer measures the rate of change in the device s motion through three axes The gyroscope measures the device s position in space by describing its rotation around three axes Finally the compass compares the direction of the device to a fixed heading magnetic north Accel Z Accel Y Fan Accel X Accelerometer x y Z and gyroscope pitch roll yaw
6. changing only during touch ou Rotation around the y axis 0 Rotation around the y axis TI Rotation around the y axis 0 Rotation around the y axis TI Rotation around the y axis changing only during group 0 Rotation around the y axis s changing only during group Rotation around the y axis cumulative changing only 0 during group Max O m 2 0 T 2 0 O m 2 0 2 FEN fe a Units Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians By Sensitivity NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO Sind SA po 71 TC Data User Guide Version 1 0 Controller Roll During Group Running Yaw Yaw Yaw Touch 4 Yaw Touch 4 Yaw Touch T Yaw Touch T Yaw During Touch Yaw During Touch Yaw Group 4 L s a A Yaw Group T Yaw Group Yaw Group Yaw During Group Description Rotation around the y axis cumulative changing only during group Rotation around the z axis Rotation around the z axis Rotation around the z axis Rotation around the z axis Rotation around the z axis Rotation around the z axis Rotation around the z axis changing only during touch Rotation around the z axis changing only durin
7. po Note that grids have a maximum custom division of 32 for the X and Y axes and 16 for the R axis 13 3 2 Table Order When controlling one Table with another it is important to get the order correct The rule is Tables send their values in order from topmost Table downward a Ee e Tables send their values in order from top down Because of this Tables which have parameters controlled by other Tables should have their controlling Tables above them This ensures the proper order of execution for parameter updates 48 TC Data User Guide Version 1 0 Sind 14 0 Sequencer A Sequencer is playable sequence of values Like the Table module Sequencers have a 128 index array where the user can design a series of specific values Sequencers have the ability to step through the sequence at a user controlled rate and have more options for live data transforming Sequencer 1 4 1 Seq Graph Range Buttons 49 64 96 Sei Seq Graph Seq Position Gates Seq Function Buttons Seq Playback Parameters on S amp S Se n Seq Parameters mmm mme e Group Center Y Group Center X Group Count Random When Group Begins 49 TC Data User Guide Version 1 0 ai SA po 13 1 Sequencer Graph Range Buttons Sequencers have up to 128 values which can be viewed by tapping the range buttons The Sequencer will automatically switch to
8. 1 67 AH 1 cc 7 709 cu 1 ce 44 67 Gyroscope Reorientation Button CH 1 cco 7 109 Patch Name CH 1 CC 1 67 CH 1 CC 7 109 w N OO aa Se N cu 1 ce 1 67 Navigation Bar Button CH 1 CC 7 CH 1 CC 1 a CH 1 cC 7 109 The Performance view is the edge to edge multitouch interface for generating touch control data It will display the active controllers as you play as well as an optional message list which shows all outgoing control messages TC Data User Guide Version 1 0 ai SA po 2 1 Quick Load Button Double tap the Quick Load Button to pop open a list of patches to load Swipe left and right to change between folders of patches There is an A All Notes Off button for quickly silencing stuck notes when in the Performance view All Patches AHDSR Attack Rate AHDSR Pitch Bend AHDSR Pitch Drop AHDSR Start Stop Chords AHDSR Timing Angle Chords in 5ths Angle Notes CC Only 1 CC Only 2 CC Only 3 CCOny4 2 2 Message List The Message List displays a scroll of MIDI and OSC messages generated during performance It is useful for seeing live values when in the Performance view Turning off the list can improve graphics performance and touch responsiveness TC Data User Guide Version 1 0 ai SA po 2 3 Axis Labels The Performance view is unique in that is does not rotate when the iPad is reoriented This is because moving the device c
9. 4 ANN ZAN 0 3 y x 3 A d Ui KE Mapped LLY f HH Value A ANN 0 5 y x 0 6 y 1 1 x 2 0 7 y 1 1 x 3 0 8 y 1 1 x 4 0 9 y 1 1 x 5 1 0 y 1 1 x 6 Incoming Controller Normalized Let us look at one example to see how slope can affect a patch If a MIDI Note On Velocity parameter is controlled by Touch X Position with a range from 1 100 changing the slope will change how much of the screen will be playing stronger notes and how much of the screen with be playing softer notes For mostly softer notes choose 0 4 or lower For an even spread choose 0 5 For mostly louder notes choose 0 6 or higher 37 TC Data User Guide Version 1 0 ai SA po Slope 0 4 Slope 0 5 Slope 0 6 Q Q O d d d Differences in slope with the Touch X Position mapped to a parameter with a range of 1 100 9 6 Sensitivity Some controllers have a user definable Sensitivity setting For example you can decide whether Touch Speed reacts to slow movements in a drastic way high sensitivity or if it should require a violent gesture just to set it going low sensitivity Not only does this allow flexibility in performance but it can dramatically change how an output parameter reacts to a controller In particular Sensitivity should be addressed by the user when using controllers in the Time category For example Creation Time Since Pre
10. 4 3 Touch Chord 4 4 Touch Chord 4 5 Touch Chord 4 6 Touch Chord 4 7 Touch Chord 4 8 Touch Chord 4 9 Touch Chord 4 10 Touch Chord 4 11 Touch Chord 4 gt 1 Touch Chord 4 gt 2 Touch Chord 4 gt 3 Touch Chord 4 gt 4 Touch Chord 4 gt 5 Touch Chord ai SA po Description Touch 8 ended contact with the screen Touch 9 began contact with the screen Touch 9 ended contact with the screen Touch 10 began contact with the screen Touch 10 ended contact with the screen Touch 11 began contact with the screen Touch 11 ended contact with the screen Any time 1 touch contacts the screen 2 touches contact the screen simultaneously 3 touches contact the screen simultaneously 4 touches contact the screen simultaneously 5 touches contact the screen simultaneously 6 touches contact the screen simultaneously 7 touches contact the screen simultaneously 8 touches contact the screen simultaneously 9 touches contact the screen simultaneously 10 touches contact the screen simultaneously 11 touches contact the screen simultaneously Any time 1 touch or more simultaneously contacts the screen 2 touches or more contact the screen simultaneously 3 touches or more contact the screen simultaneously 4 touches or more contact the screen simultaneously 5 touches or more contact the screen simultaneously 76 TC Data User Guide Version 1 0 Trigger gt 6 Touch Chord 4 gt
11. 9 4 Start and End Values All controllers generate their own particular range of values A parameter will take that range and map it to its own Start and End values The most basic example of this is the Touch X Position parameter The far left of the screen is the controller s minimum limit O pixels and the opposite side of the screen is the maximum limit 768 pixels The position of the touch within that range would set the parameter s value mapped to whatever minimum maximum value range the user has set for example 0 127 for many MIDI messages To invert the range of a parameter simply flip the start and end values for example 127 0 Note When controlling a MIDI Note output with a Table or Sequencer keep in mind that the sequence values will only reoresent actual MIDI notes when the start and end values of the Note parameter are 0 127 36 TC Data User Guide Version 1 0 ai SA po 9 5 Slope The Slope value weighs incoming controller data along a curve This makes controllers cover more distance over a particular range and less of another Setting the slope well can be the key to making a controller feel right The following table shows exactly how the sloping calculations work along with a graph to visualize the change Output controller graphs will also change to reflect how the slope is set Slope Calculations 1 0 0 0 y x6 A AN 0 1 y x5 AA d A 0 2 y x
12. See 6 0 OSC and MIDI Voice Allocation for more information lt Utilities arget IP Address 123 tcdata OSC Setup port 45 routeOSC tcdata tag routeOSC Q data message voice Q value An example OSC setup between TC Data and Pd Pure Data Note the matching port number and message routing TC Data User Guide Version 1 0 ai SA po Interface Navigation 1 0 Navigation Bar E Performance Load Share Patch Settings Show the Navigation Bar by double tapping the Show Navigation Bar Button in the Performance view Here you can switch between views The Navigation Bar will hide automatically when a touch is played in the Performance view While the Navigation Bar is showing TC Data can rotate its orientation See 2 3 Axis Labels and iPad Rotation for more information 1 1 TC Data Views The Performance view is where you can play the currently loaded patch The Load Share view is where you can load save duplicate rename and share patches In the Patch view you can create outputs and modules to design your patch The Settings view allows you to change the display style and colors and has a quick help reference area TC Data User Guide Version 1 0 Sind Views 2 0 Performance Quick Load Button SE j EI Message List Axis Labels Performance Area Device Motion Position CRL cc
13. T gt 7 Touch Chord T gt 8 Touch Chord T gt 9 Touch Chord T gt 10 Touch Chord T ay SA po Description 2 touches or more end contact with the screen simultaneously 3 touches or more end contact with the screen simultaneously 4 touches or more end contact with the screen simultaneously 5 touches or more end contact with the screen simultaneously 6 touches or more end contact with the screen simultaneously 7 touches or more end contact with the screen simultaneously 8 touches or more end contact with the screen simultaneously 9 touches or more end contact with the screen simultaneously 10 touches or more end contact with the screen simultaneously 19 2 Device Motion Triggers Trigger Pitch Crossed Center Roll Crossed Center Yaw Crossed Center Pitch Drag Long Description Sent when the device tilts across the center point of its pitch Sent when the device tilts across the center point of its roll Sent when the device rotates across the center point of its yaw Sent whenever pitch has moved a large amount 78 TC Data User Guide Version 1 0 ai SA po Trigger Description Pitch Drag Medium Sent whenever pitch has moved a medium amount Pitch Drag Short Sent whenever pitch has moved a small amount Roll Drag Long Sent whenever roll has moved a large amount Roll Drag Medium Sent whenever ro
14. because there is only one control value created no matter how many touches are on screen For example the Average Angle To Center averages every touch on screen to create one control value A voice value of 1 indicates it is not tied to any particular touch 6 2 MIDI Voice Allocation For MIDI users note that assigning a voiced controller one which has voiced values for each touch to an output like the MIDI CC output is a special case To avoid the zippering and wasted messages that would occur if every touch s value were sent to the CC target only the most recently created touch will send its value Device Motion The physical motion of the iPad or Device Motion can be used as a controller You can turn and twist the device to change filters and effects or even create vibrato through movement The screen will display an orientation graphic that will move based on the motion of the device Follow the graphic carefully to learn how to maneuver the iPad For more information about Device Motion see 7 3 Device Motion Controllers 25 TC Data User Guide Version 1 0 ai SA po iPad Rotation Since physically moving the iPad can be part of the synthesis generation device rotation is disabled while in the Performance view To temporarily enable rotation double tap the Show Navigation Bar Button You can then rotate the device to your current orientation The axes of the device are treated stat
15. of all Around Group touches rotation around the 0 720 Degrees NO Center Running center of the group Random Group 4 Random number generated when the group begins 0 99999 N A NO Random Group T Random number generated when the group ends 0 99999 N A NO Random when Random number generated Group Starts whenever the group starts 0 99999 N A NO Moving moving Random when Random number generated Group Stops whenever the group stops 0 99999 N A NO Moving moving Random when Random number generated Group Starts or whenever the group starts or 0 99999 N A NO Stops Moving stops moving Random when Random number generated Group Dragged when the group center drags o 99999 N A NO Long a long distance Random when Random number generated Group Dragged when the group center drags 0 99999 N A NO Medium a medium distance Random when Random number generated Group Dragged when the group center drags 0 99999 N A NO Short a short distance Fastest Speed The fastest active touch Points per speed 0 10000 gon VES 66 TC Data User Guide Version 1 0 Controller Slowest Speed Min X Max X Min Y Max Y Group Center X 4 Group Center X T Group Center Y Group Center Y T Total X Velocity Total X Velocity Total Y Velocity Total Y Velocity Description The slowest active touch speed The lowest active touch x position The highest active touch x position The lowest active touch y position The highes
16. to broadcast on All available ports 9 2 Controller Graph The Controller Graph shows a real time readout of the controller data translated into the output s value range This is useful to view how the slope and sensitivity of your controller are performing as you play as well as viewing the exact values sent by outputs Y Velocity 7 Ty Z BA CH 1 Modulation CC 1 A minimized output showing the controller graph in full view 35 TC Data User Guide Version 1 0 ai SA po 9 3 Controller Selection The Controller Select Button allows you to choose which controller will be watched by that parameter When you press the button you will be shown a list of controller categories that are appropriate for that parameter You can navigate the menu to choose a controller When you tap the controller name it will be selected as the source for that parameter This is where most of the fun happens in programming TC Data Choosing a novel way of controlling a parameter may open up a new sound or style of performance Some controllers are driven very directly by the player like touch based controllers Others like an LFO module will run by themselves with as much or as little user interaction as you decide When constructing a patch deciding which areas of your patch you want to control directly is often a good first step For more information about controllers see Controllers Explained
17. with TC Data This function will copy missing presets into the User Documents folder of TC Data It will not overwrite any existing patches 5 1 2 Display The Screen Axes options Invert X Axis and Invert Y Axis will fip the minimum and maximum edges for the Performance area and Live Preview view See 2 3 Axis Labels for more information about the screen orientation The Performance View options provide a choice for user interface buttons and labels to be visible on screen Show or hide the Quick Load Button Patch Title and Axis Labels TC Data can show a representation of MIDI note on velocity for each touch Also a scrolling Message List can display all outgoing messages being generated Note Turning off Show Message List can improve interface responsiveness in the Performance view on some devices Reduced Drawing Mode is an option to turn off anti aliasing in the Performance view Some devices will see a marked improvement in interface responsiveness with this option enabled Custom Controller Drawing is a way to enjoy the many controller graphics displays in the Performance view Normally only the controllers used in a patch will display their graphics cues With Override Patch Controller Display enabled you can choose to display whichever cues you want for a custom display Note that Override Patch Controller Display is a purely aesthetic option The controllers displayed are not doing anything except looking good
18. y velocity of the touch The y velocity of the touch The velocity towards away from the center of the screen The velocity towards away from the center of the screen The rate of rotation around the first touch The rate of rotation around the center of the screen Min 10000 10000 10000 Max 5 767 1023 767 1023 767 1023 10000 10000 10000 10000 10000 10000 10000 Units Seconds Points Points Points Points Points Points Points per second Points per second Points per second Points per second Points per second Points per second Points per second Degrees per second Degrees per second Ej Sensitivity YES NO NO NO NO NO NO YES YES YES YES YES YES YES YES YES Sind SA po 57 TC Data User Guide Version 1 0 Controller Rotation Speed Around Group Center Distance to First Distance to First L Distance to First T Distance to Previous Distance to Previous L Distance to Previous f Distance to Center Distance to Center d Distance to Center t Distance to Group Center Distance Traveled Distance Traveled 1 Description The rate of rotation around the center of the group The distance between a touch and the first touch The distance between a touch and the first touch The distance between a touch and the first touch The d
19. 000 10000 G YES Group Center Y The group center y velocity Points per Velocity O 10000 Ee YES Group Center Y The group center y velocity Points per Velocity 10000 10000 Ser YES Group Center The group center velocity Velocity to Center towards away from the 0 10000 Points per VES center of the screen second Group Center The group center velocity Velocity to Center towards away from the 40000 10000 Points per VES fa center of the screen second Total Rotation The sum of all touches Around Center rotation around the center of 1440 1440 Degrees YES the screen Total Rotation The cumulative sum of all Around Center touches rotation around the _4449 1440 Degrees NO Running center of the screen Total Rotation The sum of all touches Around Group rotation around the center of _720 720 Degrees YES Center the group 68 TC Data User Guide Version 1 0 Controller Rotation Around Group Center Running Total Touch Size Average Touch Size Max Touch Size Min Touch Size Description The cumulative sum of all touches rotation around the center of the group The sum of the amount of contact the fingers have with the screen The average amount of contact the fingers have with the screen The largest amount of contact the fingers have with the screen The smallest amount of contact the fingers have with the screen Min 720 21 21 21 21 Max 720 803 73 73
20. 22 TC Data User Guide Version 1 0 ai SA po 5 1 3 Colors Choose the color set that best suites you The entire interface will change to reflect the color set chosen 5 1 4 Help Here there are a number of in app videos to watch to learn about connecting OSC and MIDI from TC Data as well as some interface lessons 5 1 5 About Contact information and links to the App Store to rate TC Data There is no in app reminder to rate TC Data so consider this my one moment of asking and thanks 23 TC Data User Guide Version 1 0 ai SA po Performance Performance Basics TC Data was designed from the ground up as a multitouch driven controller That is to say the multitouch data itself is what generates control data Some apps have buttons sliders and other on screen objects that are controlled with a multitouch interface In these systems the multitouch capability is meant to enhance the interface accessibility but it is not the means of control TC Data takes a different approach The multiple touches on the screen are examined and relationships between them are used as controller data streams Take this example in most controllers there may be a knob that targets a synthesizer s volume The user touches the screen to move the knob which changes the volume With TC Data that job will be given to a touch controller Perhaps the volume level will be control
21. 3 Miscellaneous Controllers Controller Constant Description Single unchanging value Min Min N A Max m 2 5 MAN W s 12 5 men W 360 Max N A Units Radians Radians Radians Radians Radians Radians Degrees Units N A By Sensitivity NO NO NO NO NO NO NO Sensitivity NO Sind SA po 73 TC Data User Guide Version 1 0 Appendix C Triggers ai SA po The term trigger is used to describe a command to start a synth process The AHDSR and Sequencer modules use triggers to control playback Sequencers and Tables can also generate triggers 19 0 Touch eee Triggers Trigger Touch Began Touch Ended Touch Began or Ended Started Moving Stopped Moving Started or Stopped Moving Drag Long Drag Medium Drag Short Description Sent when a touch begins contact with the screen Sent when a touch ends contact with the screen Sent both when the touch begins and ends contact with the screen Sent whenever a touch begins moving from a stationary position Sent whenever a touch stops moving Sent both when the touch begins or stops moving Sent whenever a touch has moved 200 points Sent whenever a touch has moved 100 points Sent whenever a touch has moved 50 points 74 TC Data User Guide Version 1 0 19 1 Group e Triggers Trigger De
22. 7 4 4 Sequencer TC Data has a powerful step Sequencer The Sequencer stores up to 128 values which it can play through to generate a customized stream of values All Sequencer parameters are controllable playback rate value adjustment sequence length and position and playback controls For more information about using Sequencers see 14 0 Sequencers 32 TC Data User Guide Version 1 0 ai SA po 7 5 Special Controllers 7 5 1 Constant Most parameters can be set to a Constant controller the exception is the OSC Output which must have a variable controller Parameters set to constant controllers have their values set once by the user Outputs driven by constant controllers send their values when the following events occur 1 The user changes the constant value 2 A patch finishes loading 7 5 2 Patch Loaded The Patch Loaded trigger is useful for firing a trigger once when the patch first loads For example starting playback of a Sequencer immediately after loading a patch 7 5 3 None As the name suggests the None trigger allows a parameter to have no trigger control 33 TC Data User Guide Version 1 0 ai SA po Output Programming 9 0 Outputs An Output has one main function translating TC Data controllers into standard MIDI or OSC messages Outputs are organized by their outgoing message type for example MIDI Note or OSC Trigger To c
23. 7 Touch Chord 4 gt 8 Touch Chord 4 gt 9 Touch Chord 4 gt 10 Touch Chord 4 1 Touch Chord f 2 Touch Chord T 3 Touch Chord T 4 Touch Chord T 5 Touch Chord f 6 Touch Chord T 7 Touch Chord f 8 Touch Chord T 9 Touch Chord T 10 Touch Chord T 11 Touch Chord T gt 1 Touch Chord f ai SA po Description 6 touches or more contact the screen simultaneously 7 touches or more contact the screen simultaneously 8 touches or more contact the screen simultaneously 9 touches or more contact the screen simultaneously 10 touches or more contact the screen simultaneously Any time 1 touch ends contact with the screen 2 touches end contact with the screen simultaneously 3 touches end contact with the screen simultaneously 4 touches end contact with the screen simultaneously 5 touches end contact with the screen simultaneously 6 touches end contact with the screen simultaneously 7 touches end contact with the screen simultaneously 8 touches end contact with the screen simultaneously 9 touches end contact with the screen simultaneously 10 touches end contact with the screen simultaneously 11 touches end contact with the screen simultaneously Any time 1 touch or more simultaneously ends contact with the screen U7 TC Data User Guide Version 1 0 Trigger gt 2 Touch Chord T gt 3 Touch Chord T gt 4 Touch Chord T gt 5 Touch Chord T gt 6 Touch Chord
24. FO Parameters The Rate parameter controls the LFO rate and has a range of 0 30Hz The Center parameter changes the vertical center of the wave The Scale parameter changes the amplitude scale of the wave Use the Center and Scale parameters to make the LFO stretch over the range you need Scale 1 0 Scale 0 5 Center 0 5 Center 0 5 Scale 0 2 Center 0 8 Scale 0 5 Center 0 0 LFO Scale and Center Parameters change the y position and amplitude of the LFO 44 TC Data User Guide Version 1 0 Sind 13 0 Table A Table is an indexed array of values Its main function is to take an incoming controller to scrub through the table indexes and output the indexed value This can make an otherwise continuous controller discrete Table 1 1 16 KO On Kou kou mou kon ao Reset Touch Ended Index Start End Slope pon Start End Slope m ER lt Y Position Add 4 Table Graph Range Buttons Table Graph Table Function Buttons gt A O N Table Parameters 45 TC Data User Guide Version 1 0 ai SA po 13 1 Table Graph Range Buttons The Table has up to 128 values which can be viewed by tapping the range buttons The Table will automatically switch to the range of values that contains the current index position when a controller changes it 13 2 Table Graph Set and view the Table values with the Table Gra
25. an be part of the performance for motion control and having the screen rotate beneath your fingers is an undesired effect You can reorient TC Data whenever the Navigation Bar is visible to switch between portrait and landscape modes Many controllers depend on X or Y axis positions To keep X Y controllers consistent those axes are always fixed as follows Y axis X axis The X axis is always the short axis and the Y axis is always the long axis regardless of the interface orientation You can invert the minimum and maximum of these axes in Settings gt gt General gt gt Invert Axes The Axis Labels will remind you which way is up labeled and which way is down labeled for each axis 2 4 Performance Area The entire screen is used as the performance area Many controllers require multiple touches to activate As you touch the screen the graphic display will update to show you which types of controllers are active and what their positions or values are If you wish to customize which interface objects appear in the view choose Settings gt gt Display gt gt Performance View 10 TC Data User Guide Version 1 0 ai SA po 2 5 Gyroscope Reorientation Button When the gyroscope is in use you can reset the natural position of the device by double tapping this button The pitch roll and yaw positions will all be zeroed You can reset the orienta
26. ch and device motion controllers TC Data makes no sound it is a controller interface for any instrument or software that can receive MIDI or OSC TC Data does not have on screen objects to control during performance Instead the performer s touches generate the control information Some controllers are driven by a single touch For example the speed of the touch as it moves around the screen is its Touch Speed Other controllers are generated with multiple touches such as Distance to Previous Touch where the positions of two touches are compared Finally the iPad s device motion capabilities can be used as controllers The accelerometer gyroscope and compass can be assigned as controllers to turn your iPad into a expressive motion controller TC Data User Guide Version 1 0 ai SA po MIDI Quick Start To connect TC Data to another synth app on your iPad open the target synth app and check for the following two settings 1 Background Audio Mode 2 MIDI Input Mode Be sure both of these options are on and available If a synth app does not support external MIDI input or background audio mode it will not receive any MIDI data from TC Data Open TC Data and select a patch from the Quick Load Button popover within the MIDI group swipe the list once to the right By default TC Data broadcasts MIDI messages to any available target synth on iOS More setup options are available including
27. creating a virtual MIDI port within TC Data or passing incoming MIDI through to TC Data s targets See 5 1 1 General for more information about these Settings OSC Quick Start To connect TC Data to another device via OSC Open Sound Control run through the following steps 1 Make sure both the iPad running TC Data and the target device computer are on the same Wi Fi network 2 Be sure to double check IP address numbers after entering more below 3 Be sure to double check that the port number is the same for both the target and TC Data more below Find the IP address of the target device Be sure it is the IP address of the Wi Fi connection and not another network connection e g Ethernet Open TC Data and open an OSC patch from the Quick Load Button popover and the OSC group Swipe twice to the right TC Data User Guide Version 1 0 ai SA po Switch to the Patch view Open the Utilities popover in the upper left corner and choose OSC Setup Enter the IP address and choose a port that will match your target software s expected port Open your target software and configure the incoming port and message tags to receive data from TC Data The messages sent from TC Data are always a list of two float values voice value The voice value corresponds to a touch s voice allocation and should be used to route the data to the proper polyphonic destination
28. eate H Save currently loaded patch If a patch is not saved before loading another patch it will lose its changes N ki Duplicate currently loaded patch Pressing this button creates a copy of the current patch and loads the copy LW Delete the currently loaded patch This operation is not undoable 3 8 Patch Organizer Create and edit patch organizing folders in this area Make a Tag Search folder to filter all patches by tag and a Group folder to collect any patches together into a folder Drag patches from the Folders and Patches sidebar to add the patch to a Group or add the tags in a Tag Search to that patch 14 TC Data User Guide Version 1 0 ai SA po Some tags are managed by TC Data For example the MIDI tag is added automatically if a patch contains any output that sends MIDI The user cannot add or remove the MIDI tag manually For this reason dragging a patch into a Tag Search that only contains managed tags is not allowed Note You can tell the difference between managed tags and normal tags by the color of the tag text White tags are editable by the user tinted tags are managed by TC Data 3 9 AirDrop Sharing If another device is on the same Wi Fi or Bluetooth network TC Data will recognize the device and the two will appear on each other s screen in the AirDrop Sharing area Drag a patch or folder onto the floating screen to transfer the patche
29. eel free to include the crash log located at Library Logs CrashReporter MobileDevice iPadName TC Data_iPad crash This will helo keep TC Data as solid of an app as possible 14 0 Issues Solutions Target synthesizer makes no sound eCheck that the target synth is Background Audio enabled eCheck that the target synth accepts incoming MIDI ports el ocad a new patch or send CC 7 and CC 11 MIDI messages to reset any volume controls Graphical slowdown eTurn off the Message List in Settings gt gt Display gt gt Show Message List e Turn on Reduced Draw Mode in Settings gt gt Display gt gt Reduced Draw Mode The notes created are not what are expected eCheck the MIDI Note output Key Filter eCheck the Note parameter value range especially when using a Table or Sequencer 0 127 expected 53 TC Data User Guide Version 1 0 ai SA po OSC messages are intermittent eConnect to a different WiFi network eCreate a peer to peer WiFi network directly with your target computer OSC message ao not appear ed you really check the IP address eMake sure the iPad WiFi is connected eDouble check the IP address e Double check the port number e Test to see if any messages arrive If so check that the message tag routing matches the incoming message tags 54 TC Data User Guide Version 1 0 Appendix A Symbols A few symbols are used a
30. f how the AHDSR is shaped with the current parameter controls Use it to watch how your envelope shape changes based on your performance Note that the AHDSR Graph is not to scale but rather does its best to represent the changes in values in a clear visual way 42 TC Data User Guide Version 1 0 Bin 12 0 LFO The LFO is a low frequency oscillator It has a selectable waveform and control over the rate of oscillation and amplitude LFOs are generally used for periodic control of parameters but can also facilitate quasi random parameter control LFO 1 i A Rate Start Hz End Hz Slope 2 Y Position Center Start End Scale Start End RE CH Lo wm 5 Es ZE SEN eo e E gt Sa oi oi 1 LEO Waveform Graph and Selection 2 LFO Waveform Select Buttons 3 LFO Parameters 12 1 LFO Waveform Graph and Selection The LFO Graph shows a live image of how the rate center and scale parameters are working together to make the current LFO wave Tap the LFO Graph to bring up the LFO Waveform Select popover Scroll through the dozens of waveforms to find the shape you need TC Data User Guide Version 1 0 ai SA po 12 2 LFO Waveform Select Buttons There are two LFO Waveform Select Buttons to allow for quick cycling through the available waveforms Tap them to move forward and backward through the list 12 3 L
31. for complex data streams TC Data differs from TC 11 in how Hold is implemented In TC Data hold is the duration after the attack time finishes where the maximum point of the envelope is held 31 TC Data User Guide Version 1 0 ai SA po 7 4 2 LFO LFOs are low frequency oscillators They can be used to add a slow periodic change to a Parameter or a wild vibrating effect Each LFO has an assignable waveform that cycles at controllable rate In addition the cycling waveform can be scaled amplitude adjusted and shifted center position change When a Parameter is controlled by an LFO it will be modulated by the incoming slow cycling waveform 7 4 3 Table A Table is an indexed array of values Its Index parameter takes incoming controller data and maps it to read through the Table from start to finish Think of the Table as a way to discretize a controller s values For example if a Table s Index parameter is set to Touch X Position the incoming X position is used to look up the value at the corresponding position in the Table Instead of a smooth stream of values that comes from Touch X Position a set of discrete values would be output to create a stair step data stream Note When a new index position is read from a Table the value will only be sent once and the Table will wait for a new index to be accessed This prevents duplicate messages from clogging the output stream
32. g touch Rotation around the z axis Rotation around the z axis Rotation around the z axis Rotation around the z axis Rotation around the z axis changing only during group Yaw During Group Rotation around the z axis Yaw During Group Running Yaw During Group Running Total Motion changing only during group Rotation around the z axis cumulative changing only during group Rotation around the z axis cumulative changing only during group Sum of pitch roll and yaw Min Ni Max i 1 FEN IW 7 SW fal 4 MAS Units Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians Radians By Sensitivity NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO Sind SA po 72 TC Data User Guide Version 1 0 Controller Total Motion Touch I Total Motion Touch t Total Motion During Touch Total Motion Group d Total Motion Group 1 Total Motion During Group Compass Heading Description Sum of pitch roll and yaw Sum of pitch roll and yaw Sum of pitch roll and yaw changing only during touch Sum of pitch roll and yaw Sum of pitch roll and yaw Sum of pitch roll and yaw changing only during group Magnetic heading 18
33. hes to generate their value These controllers are Global controllers A basic global controller is Group Count This controller sends a value based on the number of currently held touches between O 8 This number is not unique to a single touch voice and so the controller will report the same value to every voice that follows it When assigning controllers to outputs it is important to know whether the output parameters should follow a voiced or global controller More information about controllers can be found in the following section 28 TC Data User Guide Version 1 0 8 0 Controller Types ai SA po TC Data has a variety of controllers to use when building patches most of which pull data directly from multitouch relationships There are four types of controllers 1 Touch based controllers 2 Device Motion controllers 3 Module controllers AHDSR LFO Table Sequencer 4 Special controllers Constant Patch Loaded None In this section the different controller types will be explained Touch Group Motion AHDSR LFO Table Sequencer Constant Controllers 7 2 Multitouch Controllers Triggers Touch Group Motion Table Sequencer Patch Loaded None Multitouch controllers are created by touching the screen in the Performance view Multitouch data streams are built by comparing these touches to one another 29 TC Data User Guide Version 1 0
34. hold the Sequencer and choose Scale 51 TC Data User Guide Version 1 0 meli When using both the Add and Scale parameters keep in mind that the Add parameter acts first and then the value is scaled Original Values Original Values Add 2 Original Values Scale 0 5 Original Values Add 2 then Scale 0 5 Sequencer Add and Scale Parameters The Start Position parameter allows for the beginning index of playback to move freely through the sequence Use this to construct long sequences of values which can then be shifted through during playback To use the Start Position parameter tap and hold the Sequencer and choose Start Pos The Length parameter determines the sequence length Sometimes it can be useful to set the sequence length to 1 and simply use the Add and Scale parameters to shift the one playing value around Start Position is 1 Length is 4 Start Position is 3 Length is 5 Start Position and Length Parameters 52 TC Data User Guide Version 1 0 Appendices Troubleshooting ai SA po If you are experiencing odd behavior from TC Data check the following common solutions for assistance If your issue is not addressed here please email feedback bitshapesoftware com with a description of the problem If the issue is an app crash f
35. ically throughout TC Data The rule is the X axis is always the left right axis when holding the device with the Home button along the bottom and the Y axis is always up down There is a strong reason for this When programming it is significant which axis is assigned to a parameter If the axes changed arbitrarily it would be impossible to retain consistency in performance Performance Tips When first performing any patch try a variety of touch interactions Some patches are designed to be held down for long durations others are meant to be plucked with short touches Here are a few common gestures that can trigger complex responses from patches e Hold multiple touches down and move them around the screen e Change the number of touches on the screen e Move touches around the screen quickly or slowly e Throw the touches by moving them quickly then releasing e Pluck the screen by tapping and releasing quickly e Stretch a group of touches by moving them farther apart then closer together e Twist a group of touches like you are turning a knob 26 TC Data User Guide Version 1 0 ai SA po Be aware that while some patches may feel as though they are sensitive to touch pressure the iPad does not respond to touch pressure Use a light touch when performing TC Data The capacitive touch screen is sensitive to the charge of your finger not the pressure it exerts on
36. ion is for changing the key filters of all MIDI Note outputs You can shift by interval or set to a particular key or mode The Randomize section is a quick way to globally randomize controllers triggers and values The CC Generator is a utility that mutes all MIDI output except for a ramping CC value of your choice Use this when a synthesizer supports MIDI mapping but only by listening to incoming MIDI data The CC Generator outputs on MIDI Channel 1 Press All Notes Off Nto stop stuck MIDI notes 17 TC Data User Guide Version 1 0 4 2 Add Output Bi A po Sind Add outputs and modules from this popover For more information on outputs and modules see 9 0 Outputs 4 3 Output Sections The Patch view is organized into sections by output type The sections are e OSC e OSC Trigger e MIDI Note e MIDI CC e MIDI Pitch Bend e MIDI Aftertouch e MIDI Patch Change e AHDSR e LFO e Table e Sequencer 4 4 Minimize and Maximize Buttons To conserve screen space view multiple controller graphs and speed up editing outputs can be minimized Each output has its own minimize button and can be tapped when minimized to maximize Entire sections can be minimized with the Minimize and Maximize Buttons 18 TC Data User Guide Version 1 0 ai SA po 4 5 Outputs An Output is an OSC or MIDI generator driven by one or more of TC Data
37. istance between a touch and the previous touch The distance between a touch and the previous touch The distance between a touch and the previous touch The distance between a touch and the center of the screen The distance between a touch and the center of the screen The distance between a touch and the center of the screen The distance between a touch and the center of the group The distance between a touch and the center of the group The distance between a touch and the center of the group Max 1280 1280 1280 1280 1280 1280 640 640 640 1024 10000 10000 Units Degrees per second Points Points Points Points Points Points Points Points Points Points Points Points By SA po Sensitivity YES NO NO NO NO NO NO NO NO NO NO YES YES Sind 58 TC Data User Guide Version 1 0 Tes Controller Description Min Max Units Sensitivity Distance to Start The distance between a touch s position and its 1280 Points NO starting position Distance to Start T The distance between a touch s position and its 1280 Points NO starting position Distance to Start X The distance between a touch s x position and its 768 Points NO starting x position Distance to Start X The distance between a touch s x position and its 768 Points NO star
38. led by the Average Distance to Group Center The farther apart the touches are spread the louder the volume The power of this system is the ability to create complex synth responses using sets of simple touch controllers When a patch uses multiple touch controllers the performative capabilities change dramatically depending on the style of performance Voice Allocation 6 0 OSC and MIDI Voice Allocation Each touch in the Performance view is given its own polyphonic voice allocation Users who have created polyphonic synthesis graphs in programs like Pd or Max MSP may be familiar with this technique 24 TC Data User Guide Version 1 0 ai SA po 6 1 OSC Voice Allocation When the very first touch occurs it is assigned the voice value O The next touch to occur will be voice 1 followed by voice 2 and so on until the maximum polyphony value is reached When that occurs TC Data will cycle back to the beginning to search for a new free voice slot In short any given touch will have a voice value between O 10 Touches keep their voice values for the duration of the touch lifecycle If voice 2 is released before 1 and 3 nothing changes about the other voice assignments If the maximum polyphony is exceeded the earliest created touch will be destroyed to make space for the newly created touch Finally group controllers and device motion controllers have a special voice assignment of 1 This is
39. les per second Otherwise the rate format is displayed in BPM beats per minute where each step is equal to the note value selected For example if the rate format is set to a 16th note and the Rate parameter is a constant 120 BPM each step will occur 0 125 seconds after the previous This is equivalent to a rate of 8Hz The Sync button allows one Sequencer to have all of its playback start position and length parameters synchronized to another TC Data Sequencer Use this to lock performance of two or more Sequencers together 13 5 Sequencer Playback Parameters The four playback parameters are Play Step Stop and Reset Play will begin the regular stepping through the sequence Step will instantly step one index forward Stop immediately halts the sequence Reset sets the next sequence index back to the beginning There are buttons in the view added for editing convenience Use these buttons while designing your Sequencer but consider which triggers you wish to use to control playback during performance 13 6 Sequencer Parameters The Rate parameter controls the Sequencer playback rate Its range is from 0 1Hz to 30HZz The Add parameter will add a value to the entire sequence allowing for live shifting of the sequence values To use the Add parameter tap and hold the Sequencer and choose Add The Scale parameter scales the sequence values It can scale between 0 100 of the sequence value To use the Scale parameter tap and
40. ll has moved a medium amount Roll Drag Short Sent whenever roll has moved a small amount Yaw Drag Long Sent whenever yaw has moved a large amount Yaw Drag Medium Sent whenever yaw has moved a medium amount Yaw Drag Short Sent whenever yaw has moved a small amount 19 3 Sequencer Triggers Trigger Description Sequencer e Trigger sent when a Sequencer steps to its next value Every touch receives the same trigger simultaneously Sequencer eee Trigger sent when a Sequencer steps to its next value Each touch gets its own trigger based on the touch s current Sequence parameters 79 TC Data User Guide Version 1 0 ai SA po Trigger Description Sequencer ee Trigger sent when a Sequencer steps to its next value Cycles through to the next available touch voice Sequencer Reset e Trigger sent when a Sequencer steps back to its first value Every touch receives the same trigger simultaneously Sequencer Reset eee Trigger sent when a Sequencer steps back to its first value Each touch gets its own trigger based on the touch s current sequence parameters 19 4 Miscellaneous Triggers Trigger Description None No trigger Patch Loaded Trigger sent once when the user switches to the Performance view 80
41. motions Accel X Accel Y Accel Z 30 TC Data User Guide Version 1 0 ai SA po TC Data uses these data sources as continuous controllers When the iPad s orientation is reset gyroscope controllers will output their minimum value As the device is rotated controller values will change based on the deviation from that position Accelerometer controllers do not require an orientation reset The gyroscope can reset its natural position orientation Double tap the Gyroscope Reorientation Button to zero the rotation values when you are in a comfortable resting position or when you wish to offset the position to hold a value Since the compass reports the same motion as gyroscope yaw it will not reset to a new fixed heading with the Gyroscope Reorientation Button is pressed Use the compass when you want a permanently fixed spatial reference in your patch 7 4 Module Controllers TC Data has four different Module types AHDSRs LFOs Tables and Sequencers In this section their functionality will be explained For a detailed look at programming Modules see Module Programming p 41 7 4 1 AHDSR An AHDSR is an envelope generator AHDSR stands for attack hold decay sustain and release This module ramps smoothly along its envelope shape Each part of the AHDSR envelope shape can be changed in real time by another controller Plus the output of the AHDSR can be scaled allowing
42. nd the Y screen edge The amount of distance covered from a touch s starting position and the Y screen edge The amount of distance covered from a touch s starting position and a Y screen edge The amount of distance covered from a touch s starting position and a Y screen edge The distance between a touch and the X Y corner The distance between a touch and the X Y corner The distance between a touch and the X Y corner Min oO Max 1279 1279 1279 Units N A N A N A N A N A N A N A Points Points Points By SA po Sind Sensitivity NO NO NO NO NO NO NO NO NO NO 60 TC Data User Guide Version 1 0 Controller Distance to X Y Corner Distance to X Y Corner J Distance to X Y Corner T Distance to X Y Corner Distance to X Y Corner J Distance to X Y Corner T Distance to X Y Corner Distance to X Y Corner L Distance to X Y Corner ft Angle to First Angle to First 4 Angle to First f Angle to Previous Angle to Previous 4 Angle to Previous f Description The distance between a touch and the X Y corner The distance between a touch and the X Y corner The distance between a touch and the X Y corner The distance between a touch and the X Y corner The distance between a touch and the X Y corner The distance be
43. ontrol value along a user defined envelope shape Like traditional AHDSRs the envelope starts at a zero 0 value then ramps to its full value before returning to zero 0 Start AHDSR 1 Group Began End Attack Start ms End ms Slope Group Center X Start ms End ms Slope Group Center Y EST 1 000 Sustain Value Release Start ms End ms Slope Sensitivity Scale Start End Slope Average Distance To Center E 1 AHDSR Parameters 2 AHDSR Graph 41 TC Data User Guide Version 1 0 ai SA po 11 1 AHDSR Parameters The Start and End parameters are the two triggers that start and stop value ramping A start trigger that occurs before the envelope has finished its cycle will re trigger the envelope from the beginning Attack is the time ms from zero to the maximum envelope value Hold is the time ms where it will stay at maximum before the initial decay Decay is the time ms to ramp down to the Sustain value which is the percentage of the maximum where it will stay until the end trigger is received Release is the time ms to ramp back down to zero Scale is a parameter which live scales the entire envelope as it is running Use this parameter to add an extra mode of control to the envelope output To use the Hold and Scale parameters tap and hold the AHDSR output and choose Hold or Scale 11 2 AHDSR Graph The AHDSR Graph is a live update o
44. osition of all touches The average y position of all touches The sum of all touch speeas The speed of the group center position The rate of all rotation around the center of the screen The rate of all rotation around the center of the group The sum of all distances to the first touch The sum of all distances to previous touches The sum of all distances to the center of the screen The sum of all distances to the center of the group Min al 100 100 767 1023 80000 10000 40 40 4000 4000 5000 2880 Units N A N A N A N A Points Points Points per second Points per second Degrees per second Degrees per second Points Points Points Points By Sensitivity NO NO YES YES NO NO YES YES YES YES NO NO NO NO Sind SA po G4 TC Data User Guide Version 1 0 Controller Average Distance to First Average Distance to Previous Average Distance to Center Average Distance to Group Center Group Center Distance Traveled Closest to Center Farthest From Center Total Angle to First Total Angle to Previous Total Angle to Center Average Angle to First Average Angle to Previous Average Angle to Center Total Rotation Around Center Total Rotation Around Center Running Description The average distance to the first
45. ouch taps a location then wishes to tap the same location again a reset command must be sent to the Table to allow the re triggering of the same index In this case a good candidate is Jouch Ended Example Create a new Scale patch This default patch divides the Y axis of the screen into 10 divisions Note how the Touch Ended trigger allows for the same index to be sent multiple times in a row The Add parameter will add a value to the outgoing Table allowing for live shifting of the Table values To use the Add parameter tap and hold the Table and choose Add The Add parameter can be used in some clever ways to extend a Table s scale For example use another Table to add specifics amounts like O or 12 for an octave step For more information about using two or more Tables together see 13 3 2 Table Order Example Load the patch Three Octave Scale to see how two Tables work together to create a scale on the Y axis and octave leaps on the X axis 13 3 Table Special Functionality 13 3 1 Setting Custom Grids Because Tables are often used to divide the screen special shortcuts are available to customize the axes into checkered boxes After setting the Index parameter End value tap and hold the Table and choose an appropriate axis with Set X Grid Set Y Grid or Set R Grid You can undo your change in Utilities gt gt Patch Options 47 TC Data User Guide Version 1 0 ai SA
46. ph Tap a value slider or drag over the graph to change a range of values Each value is between O 127 floating point If the Table has an active Add parameter lines will appear above and below the graph s sliders These indicate the actual reported value of the Table when read The graph will update to show the currently active index by highlighting the appropriate index slider including switching the view to the necessary range if the Table length is greater than 16 13 3 Table Function Buttons The Rand function sets each value in the active Table length to a random value The Ramp function will evenly step from O to 127 over the Table length 13 4 Table Parameters The Index parameter uses an incoming controller to set the current Table index For example if Touch Y Velocity is used when the velocity is zero the Table index would be at the very beginning As the velocity reaches its maximum the Table index would be near the end The Table will send its value only when a new index is set This prevents the Index parameter from rapidly reading the same index as it receives its controller values To force a re trigger of the same index choose a trigger for the Reset parameter 46 TC Data User Guide Version 1 0 Tes For example if Touch Y Position controls the Index parameter a simple kind of keyboard screen division can be created Drag a touch from Y to Y to scrub through the Table If a t
47. rameter to tilt the device through three different scales or chords 39 TC Data User Guide Version 1 0 ai SA po 10 0 2 MIDI CC Output When MIDI programs and hardware receive messages they hold the new value until a new value occurs This can be a problem when one patch sets a CC value that another patch ignores For example if CC 7 Volume is set to O and the user loads a new patch which does not send CC 7 the target synthesizer will stay at zero volume To compensate for this TC Data sends the following common CC values at the beginning of every patch load CC 1 O CC 7 127 CC 10 64 CC 11 127 CC 64 0 CC messages sent at patch load 10 0 3 MIDI Patch Change Output You can add the Bank Change parameter by tapping and holding the output and choosing Bank If the Patch Change parameter is set to a constant controller the constant value is sent at launch It receives a special dispatch order over other constant parameters Patch Change constants are sent first followed by a 100ms delay followed by the rest of the initial values 40 TC Data User Guide Version 1 0 Sind Module Programming The three Module controllers in TC Data are the AHDSR LFO and Sequencer In this section we will look at their functionality and some tips for using them in your patches 11 0 AHDSR The AHDSR is an envelope generator When triggered it ramps a c
48. reate an output use the Se Add Output button To delete an output tap and hold the output and choose the Delete menu option To duplicate the output choose Duplicate MIDI Target CH 1 Modulation CC 1 Start Sensitivity n pop Output Target Controller Graph Controller Selection Start and End Values Slope D ak on Sensitivity 9 1 Output Target The Target for any output is the destination where the converted output message is sent For OSC outputs the target is a textfield where a custom message tag is entered tcdata 0 data Note that the first part of the message is always the Tag set in Utilities gt gt OSC Setup 34 TC Data User Guide Version 1 0 ai SA po For MIDI outputs the target is a MIDI Port and Channel as detected by the CoreMIDI system By default TC Data sets MIDI outputs to broadcast on all available MIDI ports except for the Network Port Note The Network Port is ignored when choosing All for your MIDI output target This is because the WiFi connection used by Network MIDI can introduce a significant amount of lag in messaging You can choose a specific MIDI port and channel for each individual MIDI output This allows a single patch to discretely control multiple synthesizers separately Note that if the specific target is not available for example if another iOS app is not running TC Data will temporarily set the output
49. s always available and shows every patch installed The other folders are Tag Searches and Groups and can be created or deleted to suit your needs see 3 8 Patch Organizer When scrolled to either the Organizer or Sharing areas tap and drag or swipe right a patch or folder to drag that patch into the view for organization or sharing 3 2 Patch Information This area shows the currently loaded patch information The title tags and comments for a patch are set here 3 3 Patch Tags Add descriptive tags to patches for easy searching and organization later Choose from a list of common tags by pressing the mu button or type in your own Some tags are managed by TC Data and cannot be added or removed by the user 3 4 Comments Add comments to patches to explain particular setups or useful performance techniques 3 5 Outputs and Controllers List See a quick overview of all outputs and controllers in the loaded patch plus the value ranges they are sending 13 TC Data User Guide Version 1 0 ai SA po 3 6 Live Preview View The Live Preview view allows the currently loaded patch to be played when not in the Performance view It can be dragged and thrown around the screen and docks itself automatically on the right side of the screen 3 7 File Management Buttons Create a New Patch You can choose from a list of standard configurations depending on the kind of patch you wish to cr
50. s controllers Outputs in the Patch view are organized by section For more information on outputs and modules see 9 0 Outputs 4 6 Data Entry Enter values into output controllers with either a textfield or data slider Each textfield has a nub to its right for quick value changes Drag up or down to increase decrease the value There are two sensitivities coarse and fine which correlate to the left right overlays that appear when dragging 4 7 Live Preview View The Live Preview view allows the currently loaded patch to be played when not in the Performance view It can be dragged and thrown around the screen and docks itself automatically on the right side of the screen 19 TC Data User Guide Version 1 0 5 0 Settings Settings Display Colors Help About Minimize Outputs at Patch Load Maximize Outputs at Patch Load Max Touches 11 MID MIDI Pass Through Virtual MIDI Output Note Message Delay 0 ms Restore Patch Presets d Settings Sections Sind The Settings view is where you can set global user options such as interface options display settings and color changes The Settings view also has a quick help reference section 20 TC Data User Guide Version 1 0 ai SA po 5 1 Settings Sections 5 1 1 General The General section allows you to customize editing performance and MIDI options The Minimize Ma
51. s shorthand indicators controllers 17 0 Symbols ee Bi They often represent common properties of A controller or module is a Touch controller A unique value is sent for each touch A controller or module is a Group controller A single value is sent to all touches A Sequencer that is Poly Routed Each successive value is sent to the next available active touch index Touch or group began Signifies controllers that only send when a touch group is created Touch or group ended Signifies controllers that only send when a touch group finishes A controller that rests at its midpoint and both pushes towards its maximum and pulls towards its minimum based on direction of movement Drag handle A cell or drawer can be dragged Sind SA po 55 TC Data User Guide Version 1 0 Appendix B Controllers The term first touch refers to the touch that begins a new group of touches It will be colored differently than all following touches The term previous touch refers to the last touch created before starting a new touch The x axis of the iPad is the narrow axis 768 points wide The y axis of the iPad is the long axis 1024 points The Min and Max generated values by the controller are mostly inconsequential when programming TC 11 They are only listed here for your information 18 0 Touch eee Controllers Controller Creation Time Since First
52. s to the other device You can disable automatic searching by pressing your screen display in the middle of the AirDrop Sharing area If the devices do not appear but are nearby toggle automatic searching off on for both devices 3 10 Email Sharing Drag a patch or folder onto the Email Sharing floating icon to email a patch or folder 15 TC Data User Guide Version 1 0 4 0 Patch 1 MIDI Note 3 Distance To Center ki 61 MIDI CC MIDI Target ch zl ER m e e N Sind Utilities Add Output Output Sections Minimize and Maximize Buttons Outputs Data Entry Live Preview View The Patch view contains the guts of a TC Data patch and always displays the currently loaded patch It is the editing area 16 TC Data User Guide Version 1 0 ai SA po 4 1 Utilities The Utilities popover shows functionality pertaining to the currently loaded patch as well as OSC address entry and a dedicated CC generator for MIDI mapping Utilities OSC Setup Patch Options Randomize CC Generator All Notes Off OSC Setup is where the target IP address port and device message tag are entered Patch Options include setting custom grid divisions and suppressing the first touch Choose Suppress First Touch if the patch uses multitouch controllers where the first touch may not be useful like Distance to First Touch The Transpose sect
53. scription Group Began Sent when a group begins contact with the screen Group Ended Sent when a group enas contact with the screen Group Started Moving Sent whenever a group begins moving from a stationary position Group Stopped Moving Sent whenever a group stops moving Group Center Drag Long Sent whenever the group center has moved oA Ss ge 200 points Group Center Drag Sent whenever the group center has moved Medium 100 points Group Center Drag Short Sent whenever the group center has moved 50 points Touch 1 4 Touch 1 began contact with the screen Touch 1 T Touch 1 ended contact with the screen Touch 2 4 Touch 2 began contact with the screen Touch 2 T Touch 2 ended contact with the screen Touch 3 4 Touch 3 began contact with the screen Touch 3 T Touch 3 ended contact with the screen Touch 4 4 Touch 4 began contact with the screen Touch AT Touch 4 ended contact with the screen Touch 5 4 Touch 5 began contact with the screen Touch 5 T Touch 5 ended contact with the screen Touch 6 4 Touch 6 began contact with the screen Touch 6 T Touch 6 ended contact with the screen Touch 7 4 Touch 7 began contact with the screen Touch 7 T Touch 7 ended contact with the screen Touch 8 4 Touch 8 began contact with the screen 75 TC Data User Guide Version 1 0 Trigger Touch 8 T Touch 9 4 Touch 9 T Touch 10 L Touch 10 T Touch 11 4 Touch 11 T 1 Touch Chord 4 2 Touch Chord
54. syo ot ki a ae net z 55 170 OO a te a kk E 55 Appendix B Controllers tait ei kita eat ti tb eat a a kan e a n kk eta a baye 56 18 0 Touch ee Mee 56 18 1 Group Reimer 63 18 2 Device Motion Controllers v api koi abitan ke eka kk in e ak bk a kin 70 18 3 Miscellaneous GONMO ENS ei kawas aza a kaki pwa aka kwa ai ka ia ak bip tenis s 73 Appendix IMOO SIS E 74 19 0 TOUCH Elle 74 By Sind SA po TC Data User Guide Version 1 0 1951 GROUP leie 75 19 2 Device Motion JEE eege 78 19 3 Sequencer le le 79 19 4 Miscellaneous Triggers sa visa kaa ty ks ka lk ka aa is kn pk ia 80 By SA po Sind TC Data User Guide Version 1 0 ai SA po Getting Started Introduction Thank you for purchasing TC Data Your support is greatly appreciated and it means can continue developing innovative music apps for iOS and Mac OS X TC Data is the product of countless hours of programming and research into controller design Your comments feedback and news are important to me If you use TC Data in a performance or recording please let me know through the website www bitshapesoftware com or email feedbackQbitshapesoftware com Your creative output is one of the reasons making software instruments is rewarding TC Data Overview TC Data is a programmable MIDI and OSC Open Sound Control controller the iPad driven by multitou
55. t active touch y position The x position of the group center when it is first created The x position of the group center when it is ended The y position of the group center when it is first created The y position of the group center when it is ended The sum of all touch x velocities The sum of all touch x velocities The sum of all touch y velocities The sum of all touch y velocities Min Max O 10000 0 767 0 767 0 1023 0 1023 O 767 0 767 0 1023 0 1023 O 80000 80000 80000 0 80000 80000 80000 Units Points per second Points Points Points Points Points Points Points Points Points per second Points per second Points per second Points per second By Sensitivity YES NO NO NO NO NO NO NO NO MES YES YES YES Sind SA po 67 TC Data User Guide Version 1 0 Tes Controller Description Min Max Units Sensitivity Total Velocity to The sum of all touch Center velocities towards away Points pe from the center of the O 10000 na 1 YES screen Total Velocity to The sum of all touch Center velocities towards away j Points pe from the center of the 10000 10000 ia d YES screen Group Center X The group center x velocity Points per Velocity OU OO ad YES Group Center X The group center x velocity Points per Velocity 10
56. th the screen Touch Size 4 The amount of contact a 24 73 PONS NO finger has with the screen Touch Size f The amount of contact a 24 73 Points NO finger has with the screen 18 1 Group e Controllers Controller Description Min Max Units Sensitivity Creation Time The time since the last group Since Previous began when a group begins Q S Seconds YES Group Group Time Alive A running value that reports the time a group is active 0 5 Seconds YES Group Time A running value that reports Stationary the time a group is 0 5 Seconds YES stationary Group Time A running value that reports Moving the time a group is moving 0 6 Seconds YES Group Time Alive T A value that reports the time a group is active 0 5 Seconds YES Group is Alive Max value sent while the group Is alive 0 1 N A NO 63 TC Data User Guide Version 1 0 Controller Group Count Group Count Absolute Touches Created Per Second Touches Ended Per Second Group Center X Group Center Y Group Total Speed Group Center Speed Total Rotation Speed Around Center Total Rotation Speed Around Group Center Total Distance to First Total Distance to Previous Total Distance to Center Total Distance to Group Center Description The number of active touches out of the user set maximum polyphony The number of active touches out of 11 The number of touches created per second The number of touches released per second The average x p
57. the screen that is a resistive touch screen If you are performing TC Data in a live show you may wish to turn off your iPad s automatic sleep function Auto Lock You can turn off this function in the iPad s Settings under General Prevent accidental Home Button taps in the System Preferences under General gt gt Accessibility gt gt Guided Access Also be sure to turn off Multitasking Gestures in the iPad s Settings under General Otherwise moving groups of touches may close the app or switch to another open app 27 TC Data User Guide Version 1 0 ai SA po Patch Editing Controllers Explained At the heart of TC Data is a complex system that pulls as much user interaction as possible from the iPad This system analyzes multitouch relationships and the movement of the device to create controllers Each controller represents a single mode of interaction It is important to understand the different types of controllers to make the most out of TC Data in your projects 7 0 Voiced vs Global Controllers Some controllers generate their values by following a single touch voice 6 0 OSC and MIDI Voice Allocation These controllers are Voiced controllers A simple example of a voiced controller is Touch X Position Each touch has its own position along the x axis so the controller reports a value for every active touch Other controllers may depend on the entire collection of touc
58. the range of values that contains the current index position during playback 13 2 Sequencer Graph Set and view the sequence values with the Sequencer Graph Tap a value slider or drag over the graph to change a range of values Each value is between 0 127 floating point If the Sequencer has an active Add or Scale parameter lines will appear above and below the graph s sliders These indicate the actual reported value of the Sequencer after being shifted and scaled The graph will update to show the currently active index by highlighting the appropriate index slider including switching the view to the necessary range The graph will also dim values that are skipped because their position gate value is off 13 3 Sequencer Position Gates The Position Gate buttons show whether a sequence index will be played or skipped By default all indexes are set to play You can create a rhythm by turning some position gates off 13 4 Sequencer Function Buttons The Rand function sets each value in the active sequence length from its current start position to the end of its length to a random value The Ramp function will evenly step from O to 127 over the sequence length 50 TC Data User Guide Version 1 0 ai SA po The J Rate Format button allows the Rate parameter unit to be changed to a preferred musical format If the rate format is Hz Hertz the rate of sequence playback will read out in cyc
59. ting x position Distance to Start X The distance between a T touch s x position and its 768 Points NO starting x position Distance to Start X The distance between a T touch s x position and its 768 Points NO starting x position Distance to Start Y The distance between a touch s y position and its 1024 Points NO starting y position Distance to Start Y The distance between a touch s y position and its 1024 Points NO starting y position Distance to Start Y The distance between a ll touch s y position and its 1024 Points NO starting y position Distance to Start Y The distance between a touch s y position and its 1024 Points NO starting y position Distance to X The amount of distance Edge covered from a touch s 4 N A NO starting position and the X screen edge TC Data User Guide Version 1 0 Controller Distance to X Edge Distance to X Edges Distance to X Edges Distance to Y Edge Distance to Y Edge Distance to Y Edges Distance to Y Edges Distance to X Y Corner Distance to X Y Corner J Distance to X Y Corner T Description The amount of distance covered from a touch s starting position and the X screen edge The amount of distance covered from a touch s starting position and a X screen edge The amount of distance covered from a touch s starting position and a X screen edge The amount of distance covered from a touch s starting position a
60. tion any time during performance by double tapping the Gyroscope Reorientation Button 2 6 Show Navigation Bar Button Double tap this button to show the TC Data Navigation Bar 11 TC Data User Guide Version 1 0 Sind 3 0 Load Share Patches LFO Arpeggio Organizer Sharing Ges Patch Name LFO Arpeggio All Patches Tags Comments a ote Sequence x Table OSC fa The LFO module sweeps through the Table s index OSC Angles OSC Center Distances OSC Corners and Center Outputs OSC Distances Note CH Load Share 1 Folders and Patches 7 File Management Buttons 2 Patch Information 8 Patch Organizer 3 Patch Tags 9 AirDrop Sharing 4 Comments 10 Email Sharing 5 Outputs and Controllers List 6 Live Preview View The Load Share view is your portal to loading saving duplicating importing and exporting TC Data patches It is also a place to organize and share your patches When working on your own patches TC Data will Keep a working copy saved in a temporary location in case you leave the app However it is a good idea to save your work permanently by visiting this view 12 TC Data User Guide Version 1 0 ai SA po 3 1 Folders and Patches This area shows the patches installed on your device organized by folder The actual patch files can be found in the iTunes App File Sharing section of your iPad The All Patches folder i
61. touch The average distance to previous touches The average distance to the center of the screen The average distance to the center of the group The cumulative distance the center of the group moves The smallest active distance to center The largest active distance to center The sum of all angles to the first touch The sum of all angles to previous touches The sum of all angles to the center of the screen The average angle to the first touch The average angle to previous touches The average angle to the center of the screen The sum of all touches rotation around the center of the screen The cumulative sum of all touches rotation around the center of the screen Min Max 1280 1280 640 384 10000 640 640 2880 2880 2880 360 360 360 1440 720 Units Points Points Points Points Points Points Points Degrees Degrees Degrees Degrees Degrees Degrees Degrees Degrees Ej A po Sensitivity NO NO NO NO YES NO NO NO NO NO NO NO NO YES NO Sind 65 TC Data User Guide Version 1 0 Tes Controller Description Min Max Units Sensitivity Total Rotation The sum of all touches Around Group rotation around the center of 0 720 Degrees YES Center the group Total Rotation The cumulative sum
62. touch and the center of the screen The angle between a touch and the center of the group Angular rotation around the first touch Angular rotation around the center of the screen Angular rotation around the center of the group Random number generated when the touch begins Random number generated when the touch ends Random number generated whenever the touch starts Moving Random number generated whenever the touch stops Moving Random number generated whenever the touch starts or stops moving Random number generated when the touch drags a long distance Min Max 360 360 360 360 720 720 360 99999 99999 99999 99999 99999 99999 Units Degrees Degrees Degrees Degrees Degrees Degrees Degrees N A N A N A N A N A N A Gi L Sensitivity NO NO NO NO YES YES YES NO NO NO NO NO NO Sind SA po 62 TC Data User Guide Version 1 0 Tes Controller Description Min Max Units Sensitivity Random when Random number generated Dragged Medium when the touch drags a O 99999 N A NO medium distance Random when Random number generated Dragged Short when the touch drags a O 99999 N A NO short distance Touch is Alive Max value sent while the Q 4 N A NO touch is alive Touch Size The amount of contact a 24 73 Points NO finger has wi
63. tween a touch and the X Y corner The distance between a touch and the X Y corner The distance between a touch and the X Y corner The distance between a touch and the X Y corner The angle between a touch and the first touch The angle between a touch and the first touch The angle between a touch and the first touch The angle between a touch and the previous touch The angle between a touch and the previous touch The angle between a touch and the previous touch Min Max 1279 1279 1279 1279 1279 1279 1279 1279 1279 360 360 360 360 360 360 Units Points Points Points Points Points Points Points Points Points Degrees Degrees Degrees Degrees Degrees Degrees Ej Sensitivity NO NO NO NO NO NO NO NO NO NO NO NO NO NO NO Sind SA po 61 TC Data User Guide Version 1 0 Controller Angle to Center Angle to Center 4 Angle to Center T Angle to Group Center Rotation Around First Rotation Around Center Rotation Around Group Center Random J Random tT Random when Starts Moving Random when Stops Moving Random when Starts or Stops Moving Random when Dragged Long Description The angle between a touch and the center of the screen The angle between a touch and the center of the screen The angle between a
64. vious Touch can be used to simulate chording if the sensitivity is high enough The sensitivity value will appear automatically for controllers that support it A higher value makes a controller more sensitive a lower value makes it less so 10 0 Special Output Features 10 0 1 MIDI Note Output The default MIDI Note output only shows the Note and On Velocity parameters You can also control Off Velocity and Polyphonic Aftertouch Poly by tapping and holding the output and choosing Off Velocity or Poly If you remove those parameters they will revert to constants 38 TC Data User Guide Version 1 0 ai SA po Each MIDI Note output has an optional Key Filter Tap the Note parameter graph to open the key filter popover Highlighted notes will play and notes generated that do not fit the custom scale will be shifted to the nearest acceptable note A key filter will C E F A and B filtered out Note outputs also have a controllable Key Filter Parameter which allows up to 12 filters to be shifted through during performance Tap and hold the MIDI Note output and select Key Filter to add the parameter control Multiple scales can be constructed and changed on the fiy using any of the available controllers A key filter with active controllable parameter Try using different types of controllers to shift through different keys For example connect Gyroscope Roll to the Key Filter pa
65. ximize Outputs at Patch Load options will shrink or expand all outputs for newly loaded patches If neither is selected the patches own output minimize settings will be preserved Polyphony in TC Data is how many touches are allowed during performance For example if Max Touches is set to five a sixth touch will steal the earliest touch s polyphonic slot Polyphony does not have anything to do with the number of MIDI notes being generated The MID Pass Through setting takes incoming MIDI messages for example from a connected MIDI interface and sends them out to all MIDI output destinations Connect a MIDI keyboard controller to the MIDI IN port to combine the notes with TC Data s continuous controller generation Virtual MIDI Output is a virtual port created by TC Data for applications that do not automatically create their own virtual MIDI destination TC Data will appear as a valid input source with this option enabled The Note Message Delay amount is how many milliseconds a MIDI note message will be delayed before firing This is useful when target a synthesizer ramps CC message values and the note messages occur too quickly MIDI Note MIDI Note EES Delay 10ms Without MIDI Note Message Delay With MIDI Note Message Delay 21 TC Data User Guide Version 1 0 ai SA po Pressing the Restore Patch Presets button will prompt you to restore any deleted preset patches that come

a copy here.

Contents

Download Pdf Manuals

Related Search

Related Contents