Skip to content

Looking for a highly customizable animated banner-like dot matrix view? Got it!

License

Notifications You must be signed in to change notification settings

JaNd3r/CKDotMatrixView

Repository files navigation

CKDotMatrixView

Version Platform

Looking for a highly customizable animated banner-like dot matrix view? Got it!

It's almost as easy to handle as a UILabel.

To see the demo app in action, clone this repo, navigate to the DotMatrixDemo folder and run pod install. Open the created workspace in Xcode and you are ready to go.

Here's a screenshot of a real app that uses two CKDotMatrixView instances to simulate a retro till display.

Features

  • Can be adjusted to fit almost any size using storyboard settings only (including live rendering!).
  • Uses color information provided in the storyboard.
  • Provides some basic animation (to be optimized and extended...)
  • Displays a cool glowing around the illuminated dots.
  • Comes with a 10 dot font providing numbers and upper case fonts (to be extended...)

Usage

As you can see in the provided demo app, the CKDotMatrixView can be added to your app's UI without a single line of code (there's no view controller implementation in that demo app).

Add a UIView to your storyboard and set its origin and size appropriately.

Head to the identity inspector and set the class to CKDotMatrixView. You don't have to add the user defined runtime attributes by yourself (since 0.1.1).

Go to the attributes inspector and set the following properties in the first section titled Dot Matrix View:

  • horizontalDotCount - number of dots displayed horizontally (mandatory)
  • verticalDotCount - number of dots displayed vertically (mandatory)
  • text - the string to be displayed by the dot matrix (optional, can be used for static content)
  • animated - a flag indicating, wether the content should be initially animated (optional, default is NO). Please note, that the interface builder's live rendering will be always without animation.

Finally set the background color and the tint color as you like. The illuminated dots will be drawn using the tint color and the dots that are off will be drawn using a slightly lighter color than the background color.

If you want to set the text programmatically simply set the text property of the CKDotMatrixView instance.

You can create your own dot font by providing your own CKDotMatrixFontMapping and setting it to the fontMapping property of the CKDotMatrixView instance.

Author

Christian Klaproth, @JaNd3r

Thanks to...

... @ivowessel for pointing me at the interface builder's live rendering feature.

License

CKDotMatrixView is available under the MIT license. See the LICENSE file for more info.

About

Looking for a highly customizable animated banner-like dot matrix view? Got it!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published