Simple Start
Effects for your project are defined in a ProjectConfig file 1 which LCPF uses to make things happen.
In The Beginning…
Any line in your ProjectConfig which starts with a # sign is a comment. LCPF will ignore comments, so they don’t actually do anything other than provide some (hopefully) useful information for whoever is reading it.
Your ProjectConfig should always2 start with the following two lines :
from LumensalisCP.Simple import *
main = ProjectManager()For simple projects, the easist way to start is by copying the following :
from LumensalisCP.Simple import *
main = ProjectManager()
#############################################################################
# SCENES : http://lumensalis.com/ql/h2Scenes
#############################################################################
# CONTROLLER : http://lumensalis.com/ql/h2Controller
#############################################################################
# HARDWARE : http://lumensalis.com/ql/h2Hardware
#############################################################################
# ACTORS : http://lumensalis.com/ql/h2Actors
#############################################################################
# ACTIONS : http://lumensalis.com/ql/h2Actions
#############################################################################
# Wrap up and launch : http://lumensalis.com/ql/h2Launch
main.launchProject( globals() )Stop reading here … ???
You don’t really need to understand what those two lines do, you can just put them at the top of your file and move on. But if you’re curious …
The first line, from LumensalisCP.Simple import *, loads the LCPF ‘vocabulary’ so it is avaible for the rest of the file.
The second line, main = ProjectManager(), gives you access to the MainManager which you’ll use to setup hardware and effects for your project.
You need a MainManager to get started.
Footnotes
-
Technically, it is a Python file which runs in CircuitPython  using the LCPF framework. However, you don’t really need to know that - or learn Python - to use LCPF. ↩
-
There are other options, but this is by far the easist when you’re getting started ↩