Processing - Revision history

NickMarchuk: /* A New Serial Library with Hardware Flow Control for Processing */

2012-04-23T16:53:38Z

A New Serial Library with Hardware Flow Control for Processing

NickMarchuk at 16:50, 23 April 2012

2012-04-23T16:50:27Z

NickMarchuk: /* Resources */

2010-07-15T19:27:02Z

Resources

NickMarchuk: /* A Graphical User Interface (GUI) with Processing */

2010-03-05T22:31:23Z

A Graphical User Interface (GUI) with Processing

NickMarchuk: /* A Template for a GUI using Serial Communication in Processing */

2010-02-25T18:23:43Z

A Template for a GUI using Serial Communication in Processing

NickMarchuk: /* A Graphical User Interface (GUI) with Processing */

2010-02-25T18:15:49Z

A Graphical User Interface (GUI) with Processing

NickMarchuk: /* A Template for a GUI using Serial Communication in Processing */

2010-02-25T17:00:29Z

A Template for a GUI using Serial Communication in Processing

NickMarchuk: /* A Template for a GUI using Serial Communication in Processing */

2010-02-25T16:58:35Z

A Template for a GUI using Serial Communication in Processing

NickMarchuk: /* A Graphical User Interface (GUI) with Processing */

2010-02-25T16:25:18Z

A Graphical User Interface (GUI) with Processing

NickMarchuk: /* A Graphical User Interface (GUI) with Processing */

2010-02-25T16:16:25Z

A Graphical User Interface (GUI) with Processing

Show changes

@@ Line 570: / Line 570: @@
 == A New Serial Library with Hardware Flow Control for Processing ==
+The Processing serial library does not have an argument to enable Hardware Flow Control, although standard Java does. If you replace the default serial library with a slightly edited one, you can use Hardware Flow Control, and only one line of code changes!
-Open your Processing folder (where the Processing executable is), and go to \modes\java\libraries, and delete the serial folder. Replace it with this serial folder: [[Media:Serial.zip]]
+Open your Processing folder (where the Processing executable is), and go to \modes\java\libraries, and delete the serial folder. Replace it with this serial folder: [[Media:serial.zip]]
 This new serial library behaves exactly the same as the old library, except with an additional argument when opening a port. For example:
-<pre><code>myPort = new Serial(this, portName, 1500000, 'N', 8,1,1);</code></pre>
+<pre>myPort = new Serial(this, portName, 1500000, 'N', 8,1,1);</pre>
 where
 *1500000 is the baud
@@ Line 579: / Line 581: @@
 *8 means 8 bit data
 *The first 1 means 1 stop bit
-*An the last 1 is the new argument - 1 to enable hardware flow control, and 0 to disable
+*And the last 1 is the new argument - 1 to enable hardware flow control, and 0 to disable
 If you open a port without specifying all of the arguments, for example
-<pre><code>myPort = new Serial(this, portName, 9600);</code></pre>
+<pre>myPort = new Serial(this, portName, 9600);</pre>
-Hardware flow control will not be used - **hardware flow control is off by default***
+Hardware Flow Control will not be used - **Hardware Flow Control is off by default***
-You must specify all of the arguments to enable hardware flow control.
+You must specify all of the arguments to enable Hardware Flow Control.

@@ Line 567: / Line 567: @@
 <br clear=all>
+== A New Serial Library with Hardware Flow Control for Processing ==
+Open your Processing folder (where the Processing executable is), and go to \modes\java\libraries, and delete the serial folder. Replace it with this serial folder: [[Media:Serial.zip]]
+This new serial library behaves exactly the same as the old library, except with an additional argument when opening a port. For example:
+<pre><code>myPort = new Serial(this, portName, 1500000, 'N', 8,1,1);</code></pre>
+where
+*1500000 is the baud
+*'N' means no parity
+*8 means 8 bit data
+*The first 1 means 1 stop bit
+*An the last 1 is the new argument - 1 to enable hardware flow control, and 0 to disable
+If you open a port without specifying all of the arguments, for example
+<pre><code>myPort = new Serial(this, portName, 9600);</code></pre>
+Hardware flow control will not be used - **hardware flow control is off by default***
+You must specify all of the arguments to enable hardware flow control.

@@ Line 17: / Line 17: @@
 [http://www.sojamo.de/libraries/controlP5/ GUI Library]
+[[ProcessingPIC32Communication]]
 Processing comes with a large number of great example projects. Go to File->Examples to see example code specific to making 3D objects, Basics, Libraries and Topics. The [http://processing.org/ Processing website] also contains example code and links to other projects that may contain examples.

@@ Line 282: / Line 282: @@
 The following sketch uses a bunch of common GUI objects to demonstrate the library:
-TODO: unique fonts for each object, as it is each has the same font and font size
 <pre>
 // Nick Marchuk
-// 2/25/2010
+// 3/5/2010
 // Show off GUI basics with the controlP5 external library
 // the best help section is at http://www.sojamo.de/libraries/controlP5/reference/index.html?controlP5/package-summary.html, click on index
@@ Line 295: / Line 294: @@
 ControlP5 controlP5; // create the handler to allow for controlP5 objects
-// not required to define each gui object you want, useful for text objects, makes them easier to access to change their text
+// not required to define each gui object you want, but useful for text objects, makes them easier to access to change their text
 Textlabel myTextlabelA; // create a text label, an area of text independent of anything else
 Textarea myTextarea; // a multiline textarea with scrollbar
 ListBox myListbox; // a list that generates an event when you click on an element in the list
+ControlFont font; // a unique font to be applied to an object
 int myColorBackground = color(0,0,0); // background color of window
@@ Line 308: / Line 308: @@
   controlP5 = new ControlP5(this); // initialize the GUI controls
+  // print all of the possible fonts that you can use, uncomment to print the big list
+  //println(PFont.list());
+  // create the font for a specific gui object
+  font = new ControlFont(createFont("Arial",20),14); // ControlFont(the font, font size)
+  font.setSmooth(true);
+  // set the font for all of the other gui objects -> this messes up the text entered in the text field, text typed in is correct but only the last character is shown in the field
+  controlP5.setControlFont(new ControlFont(createFont("Comic Sans MS",20), 12));  // ControlFont(the font, font size)
   // a slider graphically shows its value in relation to its min and max
@@ Line 315: / Line 325: @@
   // a button press will trigger the function with the same name as the button
   controlP5.addButton("buttonA",0,100,100,80,19); // buton(name,value,x,y,width,height)
+  controlP5.controller("buttonA").setCaptionLabel("Button A"); // change what the button says on it
+  // set the font and font size of the button
+  controlP5.controller("buttonA").captionLabel().setControlFont(font);
+  controlP5.controller("buttonA").captionLabel().setControlFontSize(15);
+  controlP5.controller("buttonA").captionLabel().toUpperCase(false);
   // declare the text label this way to make it easier to chage the text in it

@@ Line 408: / Line 408: @@
 <pre>
+// Nick Marchuk
-code here
+// 2/25/2010
+// Template for serial communication and a GUI
+// Puts all available comm ports in a list, initializes the one that is clicked, text entry for output and text area for input
+// serial variables
+import processing.serial.*; // serial library
+Serial[] myPorts = new Serial[1]; // lets only use one port in this sketch
+// GUI variables
+import controlP5.*; // controlP5 library
+ControlP5 controlP5; // create the handler to allow for controlP5 items
+Textlabel txtlblWhichcom; // text label displaying which comm port is being used
+Textarea commTextarea; // text area displaying what has been received on the serial port
+ListBox commListbox; // list of available comm ports
+// setup
+void setup() {
+  size(600,400);
+  frameRate(30);
+  controlP5 = new ControlP5(this); // initialize the GUI controls
+    println(Serial.list()); // print the comm ports to the debug window for debugging purposes
+  // make a listbox and populate it with the available comm ports
+  commListbox = controlP5.addListBox("myList",5,25,120,120); //addListBox(name,x,y,width,height)
+  commListbox.captionLabel().toUpperCase(false);
+  commListbox.captionLabel().set("Listbox label");
+  for(int i=0;i<Serial.list().length;i++) {
+    commListbox.addItem("port: "+Serial.list()[i],i); // addItem(name,value)
+  }
+  // text label for which comm port selected
+  txtlblWhichcom = controlP5.addTextlabel("txtlblWhichcom","No Port Selected",150,25); // textlabel(name,text,x,y)
+  // when triggered, write the text over the serial line
+  controlP5.addTextfield("EnterTextToSend",5,170,200,20); // addTextfield(name,x,y,width,height)
+  // when new info comes into the serial port, write it to this text area
+  commTextarea = controlP5.addTextarea( // addTextarea(name,text,x,y,width,height)
+  "label1textarea",
+  "No data yet...",
+,170,200,30);
+  commTextarea.setColorBackground(0xffff0000);
+  // a button to send the letter a
+  controlP5.addButton("Send_A",1,5,210,80,19); // buton(name,value,x,y,width,height)
+}
+// infinite loop
+void draw() {
+  background(128);
+}
+// print the name of the control being triggered (for debugging) and see if it was a Listbox event
+public void controlEvent(ControlEvent theEvent) {
+  // ListBox is if type ControlGroup, you need to check the Event with if (theEvent.isGroup())to avoid an error message from controlP5
+  if (theEvent.isGroup()) {
+    // an event from a group
+    if (theEvent.name()=="myList") {
+      InitSerial(theEvent.group().value()); // initialize the serial port selected
+      //println("got myList"+"   value = "+theEvent.group().value()); // for debugging
+    }
+  }
+  else {
+    //println(theEvent.controller().name()); // for debugging
+  }
+}
+// run this when there is an enter in the textfield
+public void EnterTextToSend(String theText) {
+  myPorts[0].write(theText+"\n"); // write the text in the field
+  println("sent "+theText); // print it to the debug screen as well
+}
+// run this when buttonA is triggered, send an a
+public void Send_A(int theValue) {
+  myPorts[0].write("a\n"); // write an a
+  println("sent a"); // print it to the debug screen as well
+}
+// initialize the serial port selected in the listBox
+void InitSerial(float portValue) {
+  println("initializing serial " + int(portValue) + " in serial.list()"); // for debugging
+  String portPos = Serial.list()[int(portValue)]; // grab the name of the serial port
+  txtlblWhichcom.setValue("COM Initialized = " + portPos);
+  myPorts[0] = new Serial(this, portPos, 19200); // initialize the port
+  // read bytes into a buffer until you get a linefeed (ASCII 10):
+  myPorts[0].bufferUntil('\n');
+  println("done init serial");
+}
+// serial event, check which port generated the event
+// just in case there are more than 1 ports open
+void serialEvent(Serial thisPort) {
+  // variable to hold the number of the port:
+  int portNumber = -1;
+  // iterate over the list of ports opened, and match the
+  // one that generated this event:
+  for (int p = 0; p < myPorts.length; p++) {
+    if (thisPort == myPorts[p]) {
+      portNumber = p;
+    }
+  }
+  // read the serial buffer until a newline appears
+  String myString = thisPort.readStringUntil('\n');
+  myString = trim(myString); // ditch the newline
+  println("got: " + myString); // print to debug window
+  commTextarea.setText(myString); // put it in the text area
+  // uncomment the following if you are getting streaming packets of data that need to be parsed
+/*
+  // if you got any bytes other than the newline
+  if (myString != null) {
+    //myString = trim(myString); // ditch the newline
+    // split the string at the spaces, save as integers
+    int sensors[] = int(split(myString, ' '));
+    // convert to x and y or whatever
+    if ((sensors.length == 2)&&(portNumber==0)) { // hardcoded portNumber==0 because only using one port in this sketch
+      //float x = sensors[0]/100.0; // whatever conversion you need to do
+      //float y = sensors[1]/100.0;
+    }
+  }
+*/
+} // end serialEvent
 </pre>

@@ Line 411: / Line 411: @@
 </pre>
+This sketch creates the following window:
-image here
+[[Image:processing_serial_gui.jpg|thumb|600px|A template for a Processing sketch using serial communication and a GUI|right]]
+<br clear=all>

@@ Line 405: / Line 405: @@
 == A Template for a GUI using Serial Communication in Processing ==
-This section will describe a template for Processing projects that use a GUI interface and serial communication. It is often a challenge to move code between pcs when the serial port is hard coded for one pc because the name and number of comm ports differs on every pc, particularly when the pc has bluetooth. This template attempts to solve this problem by listing all of the available comm ports and allowing the user to select the port they wish to use when the program loads. It contains all of the framework necessary to setup the serial communication and use common GUI objects.
+This section will describe a template for Processing projects that use a GUI interface and serial communication. It is often a challenge to share code between PCs when the serial port is hard coded for one PC because the name and number of comm ports differs on every PC, particularly when the computer has bluetooth. This template attempts to solve this problem by listing all of the available comm ports and allowing the user to select the port they wish to use when the sketch loads. It contains all of the framework necessary to setup the serial communication and use common GUI objects.
+<pre>
+code here
+</pre>
+image here

@@ Line 395: / Line 395: @@
 The code above creates the following GUI:
-[[Image:processing_controlP5_example_objects.jpg|thumb|400px|A variety of GUI objects available in the controlP5 library|right]]
+[[Image:processing_controlP5_example_objects.jpg|thumb|600px|A variety of GUI objects available in the controlP5 library|right]]
+Two notes about these GUI objects:
+* Holding the ALT key and clicking on an object allows you to drag it around the screen. If you print the location of the object to the debug window when it is triggered, you can initially place the object anywhere and note the position you like after moving it and changing your code to match
+* You can declare your object at the top of your code like "Textarea myTextarea;" and use "myTextarea = controlP5.addTextarea(..." in setup() or directly use "controlP5.addButton("buttonA",0,100,100,80,19);" in setup() to add the object. The former method is better for objects that you want to change dynamically, like the text in a textArea. The later method is good for objects that you will not need to change after they are initialized, like buttons.
 <br clear=all>