Software/net.loadbang.shado/Tutorials/First Light This is hopefully where things start to get interesting. This is a script which, when loaded, turns on all the LEDs. (More correctly, it illuminates an eight-by-eight block of LEDs, regardless of monome size.) The main body of the script looks like this: {code:python} lightBlock = Block(8, 8) lightBlock.fill(LampState.ON) renderer.render(lightBlock) {code} When this runs, the LEDs will come on. In fact, they'll stay on even when other scripts are loaded, so this script is slightly antisocial; we'll deal with cleaning up script actions later. We'll look at the statements in order: {code:python} lightBlock = Block(8, 8) {code} This creates an object called ~~lightBlock~~ which is a ~~shado~~ ~~Block~~: a rectangular matrix of lamp settings. To light up the monome's LEDs, we need to set these lamps to an "on" state: {code:python} lightBlock.fill(LampState.ON) {code} This isn't quite enough to actually light the LEDs. To do that, we need to ~~render~~ the Block out to the monome itself. {code:python} renderer.render(lightBlock) {code} Before these statements will work we need to do some book-keeping. Names like ~~Block~~, ~~LampState~~ and ~~renderer~~ need to be imported into the script so that the Python system knows where to find them. The import statements look like this: {code:python} from net.loadbang.shado import Block from net.loadbang.shado.types import LampState from config import renderer {code} The first two statements (those mentioning ~~net.loadbang.shado~~) refer to components inside the ~~shado~~ package. The third statement is actually referring to another file of Python statements (called ~~config.py~~), which does some local configuration such as establishing communication settings for the monome. Before the script runs: {image:img=off.png} After the script runs: {image:img=on.png} 1 Full Script {code:python} ''' When launched, this script turns on all LEDs. ''' from net.loadbang.shado import Block from net.loadbang.shado.types import LampState from config import renderer lightBlock = Block(8, 8) lightBlock.fill(LampState.ON) renderer.render(lightBlock) {code} 2009-03-01 21:09:13.639 2009-03-01 20:52:26.298 Sun Mar 01 21:09:05 UTC 2009 Sun Mar 01 21:09:13 UTC 2009