Add disable async saving hint

JakubValtar · JakubValtar · commit 77243a1a144d · 2015-09-24T23:24:49.000-04:00
diff --git a/core/src/processing/core/PConstants.java b/core/src/processing/core/PConstants.java
@@ -520,5 +520,8 @@ public interface PConstants {
   static final int DISABLE_KEY_REPEAT         =  11;
   static final int ENABLE_KEY_REPEAT          = -11;
 
-  static final int HINT_COUNT                 =  12;
+  static final int DISABLE_ASYNC_SAVEFRAME    =  12;
+  static final int ENABLE_ASYNC_SAVEFRAME     = -12;
+
+  static final int HINT_COUNT                 =  13;
 }
diff --git a/core/src/processing/core/PGraphics.java b/core/src/processing/core/PGraphics.java
@@ -1126,6 +1126,11 @@ protected void reapplySettings() {
    * (including auto-repeated). Call hint(DISABLE_KEY_REPEAT) to get events
    * only when the key goes physically up or down.
    * <br/> <br/>
+   * hint(DISABLE_ASYNC_SAVEFRAME) - P2D/P3D only - save() and saveFrame()
+   * will not use separate threads for saving and will block until the image
+   * is written to the drive. This was the default behavior in 3.0b7 and before.
+   * To enable, call hint(ENABLE_ASYNC_SAVEFRAME).
+   * <br/> <br/>
    * As of release 0149, unhint() has been removed in favor of adding
    * additional ENABLE/DISABLE constants to reset the default behavior. This
    * prevents the double negatives, and also reinforces which hints can be

Original file line number	Diff line number	Diff line change
`@@ -520,5 +520,8 @@ public interface PConstants {`
`520`	`520`	`static final int DISABLE_KEY_REPEAT = 11;`
`521`	`521`	`static final int ENABLE_KEY_REPEAT = -11;`
`522`	`522`
`523`		`- static final int HINT_COUNT = 12;`
	`523`	`+ static final int DISABLE_ASYNC_SAVEFRAME = 12;`
	`524`	`+ static final int ENABLE_ASYNC_SAVEFRAME = -12;`
	`525`	`+`
	`526`	`+ static final int HINT_COUNT = 13;`
`524`	`527`	`}`