PatternPaint 
Making beautiful light shows is as easy as drawing a picture with PatternPaint! Simply plug in your BlinkyTape, run PatternPaint, and draw away!
User Guide
This is the devlopment guide- For instructions on how to use Pattern Paint, please visit the PatternPaint website: http://blinkinlabs.com/patternpaint
For instructions on how to contribute to Pattern Paint development, read on!
Development
PatternPaint is a cross-platform application, targetting macOS, Windows, and Linux.
We use Github Issues for bug tracking and feature implementation.
PatternPaint is written in C++ with QT (5.15.0) libraries. The easiest way to get started is to download QT Creator, and run the project through there.
PatternPaint is licensed under the GPL version 2
macOS Prerequsites
macOS development requires the following software tools:
macOS
We're building on Sierra.
Xcode
Use Xcode 8, available in the app store:
https://itunes.apple.com/us/app/xcode/id497799835?ls=1&mt=12
Note: Be sure to run Xcode at least once to accept the license agreements.
Note: If the current version of Xcode is not compatible, it should be possible to download an ISO from the Apple developer website.
Get the command line tools:
xcode-select --install
Qt dev environment
Get Qt 5.8:
https://download.qt.io/archive/qt/5.8/5.8.0/qt-opensource-mac-x64-clang-5.8.0.dmg
Install it using the default options.
Windows Prerequisites:
Windows development requires the following software tools:
Windows:
Windows 10 is used internally.
msysgit:
https://git-for-windows.github.io/
Note: be sure to check 'Run Git from the Windows Command Prompt', 'Checkout Windows-style, commit Unix-stlye line endings', and 'Use MinTTY'.
QT dev environment
https://download.qt.io/archive/qt/5.8/5.8.0/qt-opensource-windows-x86-mingw530-5.8.0.exe
Note: When installing, make sure to select the 'Tools' 'MinGW 5.3.0' option.
Windows SDK (version 10) (for signtool):
https://go.microsoft.com/fwlink/p/?LinkId=619296
When installing, only the 'Windoes Software Development Kit' feature is required.
Windows Driver Kit (version 10) (for dpinst):
http://go.microsoft.com/fwlink/p/?LinkId=526733
NSIS (3.0), for generating the installer:
http://nsis.sourceforge.net/Download
(Optional) Dependency Walker, for tracking down which DLLs need to be included with the release:
http://www.dependencywalker.com/
Ubuntu Prerequsites (tested with 14.4):
Qt, libusb
First, get the essential build tools:
sudo apt-get install build-essential mesa-common-dev libglu-mesa1-dev libusb-1.0-0-dev
There's a PPA with the latest version of Qt, Hooray!
sudo add-apt-repository --yes ppa:beineri/opt-qt58-trusty
sudo apt-get update -qq
sudo apt-get install qt58[QTPACKAGE] qt58serialport
linuxdeployqt, for generating a portable AppImage executable
wget -c https://github.com/probonopd/linuxdeployqt/releases/download/2/linuxdeployqt-2-x86_64.AppImage -O linuxdeployqt
chmod a+x linuxdeployqt
Serial permissions
You'll need to add yourself to the dialout group in order to access the serial ports:
sudo adduser `whoami` dialout
All platforms: Build process
First, clone the PatternPaint repository:
git clone https://github.com/Blinkinlabs/PatternPaint.git
Next, open QT creator, then open the project file PatternPaint.pro, which should be located in the PatternPaint subdirectory of the repository.
That's all you should need to do to build and make changes to PatternPaint. If you come up with a cool new feature or add support for a new device, please send a pull request!
Deployment instructions
These are the steps required to build a release version (installer) for PatternPaint. This is for distribution only- for hacking or modifying PatternPaint, only the steps in the above section 'Development' are necessicary.
macOS
Developer certificate (for signing the application)
- First, sign up for an Apple developer account and pay up to get the account. Then, in Xcode:
- xcode->preference->accounts
- add ID for dev account
- click ‘view details'
- click '+' to add ‘developer ID application’ and ‘developer ID Installer’
Building a Pattern Paint Release
Once the prerequsites have been installed, the deployment script can be run:
git clone https://github.com/Blinkinlabs/PatternPaint.git
cd PatternPaint
export QTDIR=~/Qt5.8.0/5.8/clang_64
sh dist_macos.sh
If everything works, it will generate a redistributable disk image 'PatternPaint_X.Y.Z.dmg', where X.Y.Z is the current version of PatternPaint.
Test this file manually on a clean macOS host.
Windows
Certificate setup
The release version of PatternPaint needs to be crypograpically signed. We use a certificate from GlobalSign.
- Install the .pfx file for code signing (right click and choose 'Install PFX'). You'll need to purchase your own if you intend to distribute PatternPaint for Windows with a signature.
- Install the GlobalSign cross certificate if you are using a GlobalSign certificate (as suggested in David Grayson's guide)
Building a Pattern Paint Release
NOTE: Obtain the GlobalSign file and install the Blinkinlabs Cert before continuing. The GlobalSign file needs to be in the directory the build script is run from.
Start Git bash (start->run->git bash)
git clone https://github.com/Blinkinlabs/PatternPaint.git
cd PatternPaint
export QTDIR=/c/Qt/Qt5.8.0
sh dist_windows.sh
If everything works, it will generate an installer executable 'PatternPaint_Installer_X.Y.Z.exe', where X.Y.Y is the current version of PatternPaint.
Test this file manually on clean Windows 7 and 8 hosts.
Linux
Building a Pattern Paint Release
Once the prerequsites have been installed, the deployment script can be run:
git clone https://github.com/Blinkinlabs/PatternPaint.git
cd PatternPaint
export QTDIR=~/Qt5.8.0/5.8/gcc_64
sh dist_linux.sh
If everything works, it will generate a distributable AppImage 'PatternPaint_X.Y.Z.Appimage', where X.Y.Z is the current version of PatternPaint.
Test this file manually on a clean Linux host.
Create a release page on Github
-
Go to the releases page:
-
Click 'Draft a new release' to start a new release
-
Take a cool screenshot demonstrating the new features
-
Write a description of the changes
-
Upload the macOS and Windows distribution files from above
-
Pause and reflect on these changes
-
Click publish to make the release official
-
Tweet about it and maybe a blog post?
Update the website
The PatternPaint page at blinkinlabs.com contains links to the latest releases. Update those! The page is:
https://blinkinlabs.com/patternpaint
Update the appcast files
PatternPaint uses Sparkle and WinSparkle to notify PatternPaint users of new releases, and allow them to upgrade automatically. PattternPaint installs regularly check for updates by querying an XML file on the Blinkinlabs server. There are two files, one for macOS releases and one for Windows releases.
TODO: Script to autmate this procedure
-
Create a new <item> entry to describe the release. Most of the details can be scraped from the Github releases page. A sample one looks like this:
<item> <title>PatternPaint 1.8.0</title> <pubDate>Mon, 27 Jul 2015 8:32:00 +0000</pubDate> <description> <![CDATA[ <b>Introducing PatternPaint 1.8! This is a big one- now you can store multiple animations on your BlinkyTape at once!<b> <br>Changelog:<br> <ul> <li>New slideshow editor to load and manage multiple patterns</li> <li>Upload multiple patterns to your BlinkyTape (BlinkyTile and BlinkyPendant coming soon)</li> <li>Drag and drop support for loading animations directly from your file manager or favorite program</li> <li>Automatically checks for new versions (using Sparkle and WinSparkle)</li> <li>Mac: Appnap automatically disabled</li> </ul> ]]> </description> <enclosure url="https://github.com/Blinkinlabs/PatternPaint/releases/download/1.8.0/PatternPaint_1.8.0.dmg" sparkle:version="1.8.0" length="13321443" type="application/octet-stream" /> </item><item> <title>PatternPaint 1.8.0</title> <pubDate>Mon, 27 Jul 2015 8:32:00 +0000</pubDate> <description> <![CDATA[ <b>Introducing PatternPaint 1.8! This is a big one- now you can store multiple animations on your BlinkyTape at once!<b> <br>Changelog:<br> <ul> <li>New slideshow editor to load and manage multiple patterns</li> <li>Upload multiple patterns to your BlinkyTape (BlinkyTile and BlinkyPendant coming soon)</li> <li>Drag and drop support for loading animations directly from your file manager or favorite program</li> <li>Automatically checks for new versions (using Sparkle and WinSparkle)</li> <li>Mac: Appnap automatically disabled</li> </ul> ]]> </description> <enclosure url="https://github.com/Blinkinlabs/PatternPaint/releases/download/1.8.0/PatternPaint_Installer_1.8.0.exe" sparkle:version="1.8.0" length="25551480" type="application/octet-stream" /> </item> -
The description and features should (probably) be the same for both macOS and Windows, so they can be created once and then copied into both files. The file links and lengths will need to be modified independently.
-
TODO: Test locally?
-
Check the appcast files into Github. Then the server can pull them from Github.
-
Upload the updated files to the Blinkinlabs server.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent