Help Topics Version 2.0

Troubleshooting

This page describes a number of issues that may be encountered during the work with Touch Creator or Touch Player, and the solutions suggested to remedy the corresponding issue.

Possible Cause Suggested Solution
The Player Mac was either replaced by a Mac that was given the same name, or OS X was reinstalled on the original Player Mac. As a result, the hardware fingerprint of the Player as registered in the known_host file on the Creator Mac doesn't match. To have this issue fixed, delete the known_host file on the Creator Mac. To do so, open Terminal and run the following command:

  rm /Users/YOUR_USER_NAME/.ssh/known_hosts

OS X will automatically recreate the file so that the issue should be fixed.
Bonjour protocol not working as designed. Go to the Project Settings in Touch Creator and select the Targets tab. Open the corresponding Player entries and change the Host names to their current IP addresses instead of their Bonjour names.
Possible Cause Suggested Solution
No tracker selected. Please select a tracker in the Player configuration.
Current user didn't install Touch Player. Please reinstall Touch Player while being logged in as the current user.
Possible Cause Suggested Solution
File path to HTML files not found on Player You can use three kinds of HTML assets to present web content: URLs, webarchive files and HTML files. URLs and webarchive files have no reference issues. URLs point to Internet or local web pages that are available when Creator and Player have a working network connection. Also, when drag & dropped on the Creator UI, webarchive files are incorporated into the current project file. This way it is ensured they will work on Creator and Player alike.

The files that may cause issues are web pages stored in local HTML files. These may be displayed incorrectly or not at all when you use different users on the Creator Mac and the Player Mac. Therefore, we recommend storing HTML file structures in the /Users/Shared directory. Anyway, you may use any location you like as long it has the same file path on both the Creator Mac and the Player Mac.
Possible Cause Suggested Solution
Corrupted OS X standard fonts. To fix this, open the OS X Font Book, go to the File menu and click on Restore Standard Fonts...
Possible Cause Suggested Solution
Interfering files remaining from ~sedna touch version 1.x. Please uninstall ~sedna touch and re-install the latest release of ~sedna touch. To completely remove the current installation, follow the instructions given in the subsequent question below.
Disclaimer: Some actions described here need the attention of an experienced Mac administrator. To delete system files or to edit system configuration files, you might require sudo or even root privileges. By manipulating Mac system configuration files you may risk damaging the operating system to the point that re-installing OS X may be required. Note that you do this at your own risk. ~sedna gmbh can't be made responsible for any damage you inflict.

How to uninstall ~sedna touch version 2.0
To completely uninstall ~sedna touch version 2.0, you need to carry out some steps that include deleting files and deleting or commenting out text lines in system configuration files. Please carry out the following steps to uninstall ~sedna touch 2.0:

1. Delete the following files:

  /private/var/db/receipts/de.sedna.touchPlayer.de.sedna.touchplayer-services.pkg.plist
  /private/var/db/receipts/de.sedna.touchPlayer.de.sedna.touchplayer-services.bom
  /private/var/db/receipts/de.sedna.touchPlayer.TouchPlayer.pkg.bom
  /private/var/db/receipts/de.sedna.touchPlayer.TouchPlayer.pkg.plist
  /Applications/Touch Creator.app
  /Applications/Touch Player.app

2. Delete the following files:

  ~/Library/LaunchAgents/de.sedna.touchplayer-services.plist
  ~/Library/LaunchAgents/de.sedna.TouchPlayer.plist
  ~/Library/LaunchAgents/de.sedna.touchtracker.plist

Note: After deleting these files, you have to restart the Mac. If you want to avoid restarting the Mac, you have to stop the corresponding launch agents before deleting the files. To do so, start Terminal and enter the following commands:

  launchctl unload -w ~/Library/LaunchAgents/de.sedna.touchplayer-services.plist
  launchctl unload -w ~/Library/LaunchAgents/de.sedna.TouchPlayer.plist
  launchctl unload -w ~/Library/LaunchAgents/de.sedna.touchtracker.plist

3. Remove the following folder including all files therein:

  ~/Library/Application Support/sedna/

4. Open the following file:

  /etc/sudoers

Note: This step requires root privileges and can only be carried out with the vi editor.
Delete or comment out the following lines in the file mentioned:

  sedna ALL = NOPASSWD: /usr/sbin/sysctl -w kern.timer.coalescing_enabled=0
  sedna ALL = NOPASSWD: /sbin/route add 239.0.0.123 -interface lo0
  devadmin ALL = NOPASSWD: /sbin/route add 239.0.0.123 -interface lo0
  devadmin ALL = NOPASSWD: /usr/sbin/sysctl -w kern.timer.coalescing_enabled=0

The standard 239.0.0.123 multicast IP address quoted in the lines above may differ, if an admin had changed it manually. Usually, the above address should be in use.

5. Open the following file:

  /etc/sysctl.conf

Note: This step also requires root privileges. It can be carried out with any plain text editor, but it can't be done with rich text editors such as Microsoft Word or TextEdit in rich text mode.
Delete or comment out the following lines in the file mentioned:

  kern.timer.coalescing_enabled=0

How to uninstall ~sedna touch version 1.x
To uninstall ~sedna touch 1.x, do all the steps given above for uninstalling ~sedna touch 2.0, and, in addition, delete the following file:

  /Applications/License Reader.app

To use touch displays in portrait orientation, you need to consider three points:

  1. Obviously, you need to create the touch portion of your multi-touch scenario in portrait orientation.
  2. On the Mac your Touch Player is running on, you need to set the corresponding display to vertical orientation. Go to OS X System PreferencesDisplays, select the corresponding display and set the Rotation option to either 90° or to 270° depending on how you turned the physical display.
  3. The final touch is the correct configuration of Player. Open the Touch Tracker tab in Player Preferences. The following image shows the corresponding dialog.

    Display_Rotation

    To enable rotation, you need to check the Custom Settings option first. Then adjust the Resolution, Offset and Rotation parameters. The following list shows the settings you need to make for some common display resolutions, and general formulae in case your touch display has another resolution.
  4. Full HD:
    Resolution: W 1920 px, H 1080 px
    Offset: X -420 px, Y 420 px
    Rotation: 90° or 270° (according to OS X settings)

    4K:
    Resolution: W 3840 px, H 2160 px
    Offset: X -840 px, Y 840 px
    Rotation: 90° or 270° (according to OS X settings)

    General formulae for X and Y offset values:
    X = - (W-H) / 2
    Y = + (W-H) / 2
Possible Cause Suggested Solution
The corresponding Player Mac has an issue with USB detection Try the steps described in the following list. If a step is not working, try the next one.

  1. Unplug the touch display's USB cable from the Mac, wait a second and plug it back again.
  2. Unplug all USB devices from the Player Mac. Plug the touch display's USB cable back again.
  3. Restart the Player Mac. If that doesn't help, you might want to unplug all USB devices while the Mac is off.
  4. Try a PRAM reset. Shut down the Player Mac. Start the Mac while holding the ⌘ + Alt + P + R keys on the attached keyboard. When the PRAM reset is done, the Mac will restart once again. Let go of the keys.
  5. Try an SMC reset. Shut down the Mac. Then unplug the power cord, press and hold the Mac's power button for at least 5 seconds. Plug the power cord back in and start the Mac.
If all of the above steps won't fix the issue, it is likely that the corresponding Mac has a technical defect. You should consider requesting the assistance of a technician.

As there is a large variety of possible setups and individual systems, you may encounter issues that are not described on this page while using Touch Creator or Touch Player. In such a case you can always contact us or your local reseller directly for support.

© ~sedna gmbh 2016