added midi events example and filter for ListAll()

Author: FMMT666

MANIFEST.in

@@ -1,9 +1,11 @@
 include examples/hello.py
 include examples/information.py
+include examples/launchpad_pressure.py
 include examples/launchpad_pro.py
+include examples/launchpad_rgb.py
 include examples/launchpad_rgb-fire.py
 include examples/launchpad_rgb-pulse.py
-include examples/launchpad_rgb.py
+include examples/midi_events.py
 include README.md
 include LICENSE.txt
 include images/lppro_colorcodes.png

README.md

@@ -78,6 +78,8 @@ Successfully tested with Ubuntu 18.04-LTS+. Requires compiling your own PyGame t
     - added demo file "launchpad_pressure.py" for pressure sensitivity
     - added multiple search names for the X
     - updated all rgb-demos to work with the X
+    - changed ListAll() method to optionally accept a string to query specific devices only
+    - added a general midi_events.py demo file for better debugging
 
 ### CHANGES 2020/05/XX:
 
@@ -944,7 +946,7 @@ Btw, the fireworks demo will play whenever the Launchpad cannot be enumerated (c
 
 ### Utility functions
 
-    ListAll()
+    ListAll( [searchString] )
     EventRaw()
 
 
@@ -1245,13 +1247,15 @@ Functions requiring a color code have a "...ByCode" naming style.
       RETURN:
 
 
-### ListAll()
+### ListAll( searchString = '' )
 
     Debug function.
-    Can be called any time and does not even require Open().
     Prints a list of all detected MIDI devices and addresses.
+    Can be called any time and does not even require an opened device.
+    The optional <searchString> parameter can be used to return a filtered set of
+    device names only. By default, it is set to an empty string, which simply prints everything.
 
-      PARAMS:
+      PARAMS: <searchString>     [OPTIONAL] only devices containing this string will be considered
       RETURN:
 
 

examples/.gitignore

@@ -8,4 +8,4 @@
 !launchpad_rgb.py
 !launchpad_rgb-pulse.py
 !launchpad_pressure.py
-
+!midi_events.py

examples/midi_events.py

@@ -0,0 +1,83 @@
+#!/usr/bin/env python
+#
+# Show MIDI events for a device.
+#
+# Some restrictions apply:
+#  - This will only work if a device has an in- AND output, because the Launchpad
+#    classes always open both directions.
+#  - If multiple devices are attached or the search string returns more than one device,
+#    only the first one will be openend. Remove devices as necessary.
+#  - Picking the wrong device might result in no output.
+#  - Quit with CTRL-C :)
+#
+#
+# FMMT666(ASkr) 7/2013..8/2020
+# www.askrprojects.net
+
+import sys
+
+try:
+	import launchpad_py as launchpad
+except ImportError:
+	try:
+		import launchpad
+	except ImportError:
+		sys.exit("error loading launchpad.py")
+
+
+
+def cmdInput( prompt ):
+	if sys.version_info.major == 2:
+		inName = str(raw_input( prompt ))
+	elif sys.version_info.major == 3:
+		inName = str(input( prompt ))
+	else:
+		print('Meh, please consider running this with either Python 2 or 3')
+		sys.exit(-1)
+
+	return inName
+
+
+def main():
+
+	lp = launchpad.Launchpad()
+
+	print("===\nAvailable MIDI devices:")
+	lp.ListAll(  )
+	print("===")
+
+	print("Enter a part of the device name, that shall be monitored.")
+	print("The string needs to cover the in- and output channels of a device!")
+	print("Otherwise, opening only one input or one output channel will result in an error.")
+	print("The search string is case-insensitive.")
+
+	inName = cmdInput( "  search string:" )
+
+	while True:
+		print("===")
+		lp.ListAll( searchString = inName )
+		print("===")
+		
+		inOk = cmdInput( "  ENTER to continue or new search string:" )
+		if inOk == '':
+			break
+		else:
+			inName = inOk
+
+	try:
+		lp.Open( 0, inName )
+	except:
+		print("error opening this device")
+		sys.exit(-1)
+
+	print("===")
+	print("Now hit the keys, turn the knobs or push the buttons:")
+
+	while(True):
+		events = lp.EventRaw()
+		if events != []:
+			print( events )
+
+	
+if __name__ == '__main__':
+	main()

launchpad_py/launchpad.py

@@ -203,10 +203,10 @@ def SearchDevices( self, name, output = True, input = True, quiet = True ):
 
 			for n in range( midi.get_count() ):
 				md = midi.get_device_info( n )
-				if quiet == False:
-					print(md)
-					sys.stdout.flush()
 				if str( md[1].lower() ).find( name.lower() ) >= 0:
+					if quiet == False:
+						print('%2d' % ( i ), md)
+						sys.stdout.flush()
 					if output == True and md[3] > 0:
 						ret.append( i )
 					if input == True and md[2] > 0:
@@ -302,8 +302,8 @@ def Close( self ):
 	#-------------------------------------------------------------------------------------
 	#-- prints a list of all devices to the console (for debug)
 	#-------------------------------------------------------------------------------------
-	def ListAll( self ):
-		self.midi.SearchDevices( "*", True, True, False )
+	def ListAll( self, searchString = '' ):
+		self.midi.SearchDevices( searchString, True, True, False )
 
 
 	#-------------------------------------------------------------------------------------