Need help with TouchVisualizer?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

morizotter
795 Stars 105 Forks MIT License 332 Commits 14 Opened issues

Description

Lightweight touch visualization library in Swift. A single line of code and visualize your touches!

Services available

!
?

Need anything else?

Contributors list

# 19,060
Swift
Objecti...
ios-thi...
carthag...
211 commits
# 471,489
Swift
Objecti...
7 commits
# 45,130
Objecti...
objecti...
swift-3
perspec...
7 commits
# 468,953
Swift
Shell
Objecti...
6 commits
# 131,174
Swift
avfound...
C
keychai...
2 commits
# 422,989
Swift
Objecti...
1 commit
# 73,118
Objecti...
alfred
wechat
esoteri...
1 commit
# 3,156
sass-fr...
splash
Socket....
pipelin...
1 commit
# 650,248
Swift
Objecti...
1 commit
# 171,163
uicontr...
swift-4...
iterm2
watchos
1 commit
# 8,388
Swift
xcode8
xcode-e...
swift-f...
1 commit
# 340,707
Swift
cocoapo...
viewpag...
Objecti...
1 commit
# 42,919
Swift
swift-f...
swift4
swift5
1 commit
# 284,001
Shell
Go
Objecti...
1 commit

TouchVisualizer

Version License Platform Carthage compatible Circle CI Join the chat at https://gitter.im/morizotter/TouchVisualizer

TouchVisualizer is a lightweight pure Swift implementation for visualising touches on the screen.

Features

  • Works with just a single line of code!
  • Supports multiple fingers.
  • Supports multiple
    UIWindow
    's.
  • Displays touch radius (finger size).
  • Displays touch duration.
  • Customise the finger-points image and colour.
  • Supports iPhone and iPad in both portrait and landscape mode.

How it looks

Portrait:

one

Landscape:

two

Robots:

three

In-app implementation:

four

It's fun!

Runtime Requirements

  • Swift 4.0
  • Xcode 9.2
  • iOS9.0 or later

TouchVisualizer works with Swift 5.2 from version 4.0.0.

Installation and Setup

Note: Embedded frameworks require a minimum deployment target of iOS 9.0.

Information: To use TouchVisualizer with a project targeting iOS 8.0 or lower, you must include the

TouchVisualizer.swift
source file directly in your project.

Installing with CocoaPods

CocoaPods is a centralised dependency manager that automates the process of adding libraries to your Cocoa application. You can install it with the following command:

$ gem update
$ gem install cocoapods
$ pods --version

To integrate TouchVisualizer into your Xcode project using CocoaPods, specify it in your

Podfile
and run
pod install
.
platform :ios, '9.0'
use_frameworks!
pod "TouchVisualizer", '~> 4.0'

Installing with Carthage

Carthage is a decentralised dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate TouchVisualizer into your Xcode project using Carthage, specify it in your

Cartfile
:
github "morizotter/TouchVisualizer" "4.0.0"

Manual Installation

To install TouchVisualizer without a dependency manager, please add all of the files in

/Pod
to your Xcode Project.

Usage

To start using TouchVisualizer, write the following line wherever you want to start visualising:

import TouchVisualizer

Then invoke visualisation, by calling:

Visualizer.start()

and stop the presentation like this:

Visualizer.stop()

Get touch locations by this:

Visualizer.getTouches()

It is really simple, isn't it?

Customisation

TouchVisualizer also has the ability to customize your touch events. Here is an example of what can be customized:

var config = Configuration()
config.color = UIColor.redColor()
config.image = UIImage(named: "YOUR-IMAGE")
config.showsTimer = true
config.showsTouchRadius = true
config.showsLog = true
Visualizer.start(config)

Configuration properties

| name | type | description | default | | :--------------- | :-------- | :------------------------------------------------------------------------------------------------------------------------- | :------------ | | color |

UIColor
| Color of touch point and text. | default color | | image |
UIImage
| Touch point image. If rendering mode is set to
UIImageRenderingModeAlwaysTemplate
, the image is filled with color above. | circle image | | defaultSize |
CGSize
| Default size of touch point. | 60 x 60px | | showsTimer |
Bool
| Shows touch duration. | false | | showsTouchRadius |
Bool
| Shows touch radius by scaling touch point. It doesn't work on simulator. | false | | showsLog |
Bool
| Shows log. | false |

Documentation

Peripheral

Presentation

Contributing

Please file issues or submit pull requests for anything you’d like to see! We're waiting! :)

Licensing

TouchVisualizer is released under the MIT license. Go read the LICENSE file for more information.

Miscellaneous

There is a similar touch visualization library called COSTouchVisualizer, which is written in Objective-C. COSTouchVisualizer supports earlier versions of iOS and is more mature. If TouchVisualizer isn't enough for you, try that!

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.