Merge origin/master

examples/src/OpenDis7Examples/PduListenerSaver.java

@@ -17,7 +17,7 @@ import java.util.Scanner;
  */
 public class PduListenerSaver
 {
-  private final static String DEFAULT_OUTPUTDIR = "./pduLog";
+  private final static String DEFAULT_OUTPUTDIR = "pduLog";
   private final static String MCAST_ADDR = "239.1.2.3";
   private final static int DIS_PORT = 3000;
 
@@ -32,6 +32,8 @@ public class PduListenerSaver
     String outDir = DEFAULT_OUTPUTDIR;
     String mcast = MCAST_ADDR;
     int port = DIS_PORT;
+    
+    System.out.println("DisExamplesOpenDis7.PduListenerSaver started...");
 
     switch (args.length) {
       case 0:
@@ -55,28 +57,33 @@ public class PduListenerSaver
 
       recorder.startResume();
       mystate state = mystate.RUNNING;
+      System.out.println("* recorder.startResume(), state=RUNNING, recording in progress...");
       Scanner scan = new Scanner(System.in);
 
       while (true) {
-        System.out.println("Type p/enter to pause, r/enter to resume, q/enter to quit");
+        System.out.println("Warning: you must quit when complete, otherwise recorded PDUs are lost!");
+        System.out.println("Type p/enter to pause, r/enter to resume, q/enter to stop recording, save and quit");
         String line = scan.nextLine();
         if (line.equalsIgnoreCase("p") && state == mystate.RUNNING) {
           recorder.stopPause();
           state = mystate.PAUSED;
+          System.out.println("* recorder.stopPause(), state=PAUSED, recording paused...");
         }
         else if (line.equalsIgnoreCase("r") && state == mystate.PAUSED) {
           recorder.startResume();
           state = mystate.RUNNING;
+          System.out.println("* recorder.startResume(), state=RUNNING, recording in progress...");
         }
         else if (line.equalsIgnoreCase("q")) {
           recorder.end();
+          System.out.println("* recorder.end(), recording complete.");
           break;
         }
       }
       System.out.println("Ending pdu save to "+recorder.getLogFile());
     }
     catch (IOException ex) {
-      System.err.println("Exception: " + ex.getClass().getSimpleName() + ": " + ex.getLocalizedMessage());
+      System.err.println("*** Exception: " + ex.getClass().getSimpleName() + ": " + ex.getLocalizedMessage());
     }
   }
 }

examples/src/OpenDis7Examples/PduListenerSaverLog.txt

+Invocation instructions:
+
+1. run or debug PduListenerSaver.java
+2. send PDUs from another program such as AllPduSender.java (used here)
+3. also running AllPduReceiver can confirm that DIS replay actually occurs.
+4. Type p/enter to pause, r/enter to resume, q/enter to quit
+5. if Pdusave.dislog file(s) already exist, your recording will be added.
+6. note existence of recorded files in directory, e.g. examples/pduLog/Pdusave.dislog
+7. rename/cut/paste your recording file to keep track of your results.
+
+Program response:
+
+===================================================
+
+DisExamplesOpenDis7.PduListenerSaver started...
+Beginning pdu save to directory pduLog
+* recorder.startResume(), state=RUNNING
+Warning: you must quit when complete, otherwise recorded PDUs are lost!
+Type p/enter to pause, r/enter to resume, q/enter to quit
+q
+
+Recorder log file closed
+* recorder.end(), recording complete.
+Ending pdu save to C:\x-nps-gitlab\NetworkedGraphicsMV3500\examples\pduLog\Pdusave2.dislog
+BUILD SUCCESSFUL (total time: 33 seconds)