From d6edc872c5259b34362884bddcec58360a525b73 Mon Sep 17 00:00:00 2001
From: Christopher Gantt <42154517+ganttArt@users.noreply.github.com>
Date: Tue, 9 Oct 2018 15:36:47 -0700
Subject: [PATCH] ASDF Pixel Sort with ControlP5 GUI

The original ASDF Pixel Sort algorithm with a new graphic interface so you can adjust variables, upload and save images in real time.
---
 .../ASDFPixelSort_ControlP5.pde               | 502 ++++++++++++++++++
 ASDFPixelSort_ControlP5/README.md             |  12 +
 .../asdfPixelSortOpening.jpg                  | Bin 0 -> 12044 bytes
 3 files changed, 514 insertions(+)
 create mode 100644 ASDFPixelSort_ControlP5/ASDFPixelSort_ControlP5.pde
 create mode 100644 ASDFPixelSort_ControlP5/README.md
 create mode 100644 ASDFPixelSort_ControlP5/asdfPixelSortOpening.jpg

diff --git a/ASDFPixelSort_ControlP5/ASDFPixelSort_ControlP5.pde b/ASDFPixelSort_ControlP5/ASDFPixelSort_ControlP5.pde
new file mode 100644
index 0000000..fccdb68
--- /dev/null
+++ b/ASDFPixelSort_ControlP5/ASDFPixelSort_ControlP5.pde
@@ -0,0 +1,502 @@
+/* ASDF Pixel Sort
+ Kim Asendorf | 2010 | kimasendorf.com
+ 
+ sorting modes
+ 0 = black
+ 1 = brightness
+ 2 = white
+ */
+
+import controlP5.*;
+ControlP5 cp5;
+
+Toggle sortOrientationToggle;
+boolean horizontallySorted;
+Slider sortIntensitySlider;
+int sort_intensity = -10000000;
+RadioButton styleRadioButton;
+int randomSortIntensity;
+int randomSortOrientation;
+
+int mode = 0;
+
+PImage img;
+PImage unsortedImage;
+PImage savingImage;
+
+String filePath = "";
+
+int loops = 1;
+
+int blackValue = sort_intensity;
+int brightnessValue = sort_intensity;
+int whiteValue = sort_intensity;
+
+int row = 0;
+int column = 0;
+
+void setup() {
+  unsortedImage = img = loadImage("asdfPixelSortOpening.jpg");
+  // use only numbers (not variables) for the size() command, Processing 3
+  size(1, 1);
+
+  PFont verdanaFont = createFont("Verdana", 11); 
+  ControlFont font = new ControlFont(verdanaFont);
+
+  // allow resize and update surface to image dimensions
+  surface.setResizable(true);
+  surface.setSize(img.width, img.height);
+
+  // load image onto surface - scale to the available width,height for display
+  image(img, 0, 0, width, height);
+
+  cp5 = new ControlP5(this); 
+  cp5.setFont(font);
+  cp5.addButton("choose_image")
+    .setPosition(10, 10)
+    .setSize(100, 30)
+    .setLabel("choose image"); 
+    
+  styleRadioButton = cp5.addRadioButton("style")
+    .setPosition(10, 50)
+    .setSize(40, 20)
+    .setSpacingRow(5)
+    .addItem("black", 0)
+    .addItem("brightness", 1)
+    .addItem("white", 2)
+    .activate("black");    
+
+  sortOrientationToggle = cp5.addToggle("sort_orientation")
+    .setPosition(10, 130)
+    .setSize(60, 25)
+    .setMode(ControlP5.SWITCH)
+    .setLabel("orientation");     
+
+  sortIntensitySlider = cp5.addSlider("sort_intensity")
+    .setLabel("")
+    .setSize(100, 30)
+    .setPosition(10, 180)
+    .setRange(-4000000, -16700000)
+    .setValue(-10000000);
+    
+  cp5.addTextlabel("label","SORT INTENSITY",7,213); 
+
+  cp5.addButton("random_sort")
+    .setPosition(10, 235)
+    .setSize(100, 30)
+    .setLabel("random sort");
+    
+  cp5.addButton("save_image")
+    .setPosition(10, 275)
+    .setSize(90, 30)
+    .setLabel("save image");    
+}
+void draw() {
+  image(img, 0, 0, width, height);
+}
+
+void resetImage() {
+  if (filePath == "") {
+    img = unsortedImage;
+  } else {
+    img = loadImage(filePath);
+  }
+  loops = 1;
+  blackValue = sort_intensity;
+  brightnessValue = sort_intensity;
+  whiteValue = sort_intensity;
+  row = 0;
+  column = 0;
+  surface.setSize(img.width, img.height);
+  image(img, 0, 0, width, height);
+}
+
+public void choose_image() {
+  selectInput("Choose an image", "inputFile");
+}
+void inputFile(File selected) {
+  filePath = selected.getAbsolutePath();
+  unsortedImage = loadImage(filePath);
+  img = unsortedImage;
+  //reset variables
+  loops = 1;
+  blackValue = sort_intensity;
+  brightnessValue = sort_intensity;
+  whiteValue = sort_intensity;
+  row = 0;
+  column = 0;
+  //
+  surface.setSize(img.width, img.height);
+  image(img, 0, 0, width, height);
+  verticalSort();
+  //  sortOrientationToggle.setValue(false);
+} 
+
+void style(int a) {
+  resetImage();
+  mode = a;
+  setSliderValues(mode);
+  if (sortOrientationToggle.getBooleanValue()) {
+    horizontalSort();
+  } else {
+    verticalSort();
+  }
+}
+
+void sort_orientation(boolean horizontallySorted) {
+  resetImage();
+  if (horizontallySorted==true) {
+    horizontalSort();
+  } else {
+    verticalSort();
+  }
+}
+
+void controlEvent(ControlEvent theEvent) { 
+  if (theEvent.isController()) {
+    if (theEvent.getController().getName()=="sort_intensity") {
+      resetImage();
+      if (sortOrientationToggle.getBooleanValue()) {
+        horizontalSort();
+      } else {
+        verticalSort();
+      }
+    }
+  }
+}
+
+void random_sort() {
+  mode = int(random(0, 3));
+  if (mode==0) {
+    randomSortIntensity = int(random(-16700000, -4000000));
+    styleRadioButton.activate("black");
+  }
+  if (mode==1) {
+    randomSortIntensity = int(random(0, 200));
+    styleRadioButton.activate("brightness");
+  }
+  if (mode==2) {
+    randomSortIntensity = int(random(-8000000, -1));
+    styleRadioButton.activate("white");
+  }
+  sort_intensity = randomSortIntensity;
+  resetImage();
+  setSliderValues(mode);
+  randomSortOrientation = int(random(2));
+  if (randomSortOrientation==0) {
+    sortOrientationToggle.setValue(false);
+    horizontalSort();
+  } else {
+    sortOrientationToggle.setValue(true);
+    verticalSort();
+  }
+}
+
+void setSliderValues(int mode) {
+  if (mode==0) {
+    sortIntensitySlider.setRange(-4000000, -16700000);
+    sortIntensitySlider.setValue(int(random(-16700000, -4000000)));
+  }
+  if (mode==1) {
+    sortIntensitySlider.setRange(200, 0);
+    sortIntensitySlider.setValue(int(random(0, 200)));
+  }
+  if (mode==2) {
+    sortIntensitySlider.setRange(-8000000, -1);
+    sortIntensitySlider.setValue(int(random(-8000000, -1)));
+  }
+}
+
+void save_image() {
+  savingImage = get(0, 0, img.width, img.height);
+  selectOutput("Select a file to write to:", "fileSelected");
+}
+void fileSelected(File selection) { 
+  savingImage.save(selection.getAbsolutePath()+"."+month()+day()+hour()+minute()+second()+".jpg");
+} 
+
+
+//below is original ASDF Pixel Sort Algorithm
+void horizontalSort() {
+  // loop through columns
+  while (column < img.width-1) {
+    img.loadPixels(); 
+    sortColumn();
+    column++;
+    img.updatePixels();
+  }
+  // loop through rows
+  while (row < img.height-1) {
+    img.loadPixels(); 
+    sortRow();
+    row++;
+    img.updatePixels();
+  }
+} 
+
+void verticalSort() {
+  while (row < img.height-1) {
+    img.loadPixels(); 
+    sortRow();
+    row++;
+    img.updatePixels();
+  } 
+  while (column < img.width-1) {
+    img.loadPixels(); 
+    sortColumn();
+    column++;
+    img.updatePixels();
+  }
+}
+
+void sortRow() {
+  // current row
+  int y = row;
+
+  // where to start sorting
+  int x = 0;
+
+  // where to stop sorting
+  int xend = 0;
+
+  while (xend < img.width-1) {
+    switch(mode) {
+    case 0:
+      x = getFirstNotBlackX(x, y);
+      xend = getNextBlackX(x, y);
+      break;
+    case 1:
+      x = getFirstBrightX(x, y);
+      xend = getNextDarkX(x, y);
+      break;
+    case 2:
+      x = getFirstNotWhiteX(x, y);
+      xend = getNextWhiteX(x, y);
+      break;
+    default:
+      break;
+    }
+
+    if (x < 0) break;
+
+    int sortLength = xend-x;
+
+    color[] unsorted = new color[sortLength];
+    color[] sorted = new color[sortLength];
+
+    for (int i=0; i<sortLength; i++) {
+      unsorted[i] = img.pixels[x + i + y * img.width];
+    }
+
+    sorted = sort(unsorted);
+
+    for (int i=0; i<sortLength; i++) {
+      img.pixels[x + i + y * img.width] = sorted[i];
+    }
+
+    x = xend+1;
+  }
+}
+
+void sortColumn() {
+  // current column
+  int x = column;
+
+  // where to start sorting
+  int y = 0;
+
+  // where to stop sorting
+  int yend = 0;
+
+  while (yend < img.height-1) {
+    switch(mode) {
+    case 0:
+      y = getFirstNotBlackY(x, y);
+      yend = getNextBlackY(x, y);
+      break;
+    case 1:
+      y = getFirstBrightY(x, y);
+      yend = getNextDarkY(x, y);
+      break;
+    case 2:
+      y = getFirstNotWhiteY(x, y);
+      yend = getNextWhiteY(x, y);
+      break;
+    default:
+      break;
+    }
+
+    if (y < 0) break;
+
+    int sortLength = yend-y;
+
+    color[] unsorted = new color[sortLength];
+    color[] sorted = new color[sortLength];
+
+    for (int i=0; i<sortLength; i++) {
+      unsorted[i] = img.pixels[x + (y+i) * img.width];
+    }
+
+    sorted = sort(unsorted);
+
+    for (int i=0; i<sortLength; i++) {
+      img.pixels[x + (y+i) * img.width] = sorted[i];
+    }
+
+    y = yend+1;
+  }
+}
+
+
+// black x
+int getFirstNotBlackX(int x, int y) {
+
+  while (img.pixels[x + y * img.width] < blackValue) {
+    x++;
+    if (x >= img.width) 
+      return -1;
+  }
+
+  return x;
+}
+
+int getNextBlackX(int x, int y) {
+  x++;
+
+  while (img.pixels[x + y * img.width] > blackValue) {
+    x++;
+    if (x >= img.width) 
+      return img.width-1;
+  }
+
+  return x-1;
+}
+
+// brightness x
+int getFirstBrightX(int x, int y) {
+
+  while (brightness(img.pixels[x + y * img.width]) < brightnessValue) {
+    x++;
+    if (x >= img.width)
+      return -1;
+  }
+
+  return x;
+}
+
+int getNextDarkX(int _x, int _y) {
+  int x = _x+1;
+  int y = _y;
+
+  while (brightness(img.pixels[x + y * img.width]) > brightnessValue) {
+    x++;
+    if (x >= img.width) return img.width-1;
+  }
+  return x-1;
+}
+
+// white x
+int getFirstNotWhiteX(int x, int y) {
+
+  while (img.pixels[x + y * img.width] > whiteValue) {
+    x++;
+    if (x >= img.width) 
+      return -1;
+  }
+  return x;
+}
+
+int getNextWhiteX(int x, int y) {
+  x++;
+
+  while (img.pixels[x + y * img.width] < whiteValue) {
+    x++;
+    if (x >= img.width) 
+      return img.width-1;
+  }
+  return x-1;
+}
+
+
+// black y
+int getFirstNotBlackY(int x, int y) {
+
+  if (y < img.height) {
+    while (img.pixels[x + y * img.width] < blackValue) {
+      y++;
+      if (y >= img.height)
+        return -1;
+    }
+  }
+
+  return y;
+}
+
+int getNextBlackY(int x, int y) {
+  y++;
+
+  if (y < img.height) {
+    while (img.pixels[x + y * img.width] > blackValue) {
+      y++;
+      if (y >= img.height)
+        return img.height-1;
+    }
+  }
+
+  return y-1;
+}
+
+// brightness y
+int getFirstBrightY(int x, int y) {
+
+  if (y < img.height) {
+    while (brightness(img.pixels[x + y * img.width]) < brightnessValue) {
+      y++;
+      if (y >= img.height)
+        return -1;
+    }
+  }
+
+  return y;
+}
+
+int getNextDarkY(int x, int y) {
+  y++;
+
+  if (y < img.height) {
+    while (brightness(img.pixels[x + y * img.width]) > brightnessValue) {
+      y++;
+      if (y >= img.height)
+        return img.height-1;
+    }
+  }
+  return y-1;
+}
+
+// white y
+int getFirstNotWhiteY(int x, int y) {
+
+  if (y < img.height) {
+    while (img.pixels[x + y * img.width] > whiteValue) {
+      y++;
+      if (y >= img.height)
+        return -1;
+    }
+  }
+
+  return y;
+}
+
+int getNextWhiteY(int x, int y) {
+  y++;
+
+  if (y < img.height) {
+    while (img.pixels[x + y * img.width] < whiteValue) {
+      y++;
+      if (y >= img.height) 
+        return img.height-1;
+    }
+  }
+
+  return y-1;
+}
diff --git a/ASDFPixelSort_ControlP5/README.md b/ASDFPixelSort_ControlP5/README.md
new file mode 100644
index 0000000..86c1a13
--- /dev/null
+++ b/ASDFPixelSort_ControlP5/README.md
@@ -0,0 +1,12 @@
+ASDFPixelSort
+=============
+
+Processing script to sort portions of pixels in an image.
+
+DEMO:
+http://kimasendorf.com/mountain-tour/
+http://kimasendorf.com/sorted-aerial/
+
+
+Kim Asendorf 2010
+http://kimasendorf.com
\ No newline at end of file
diff --git a/ASDFPixelSort_ControlP5/asdfPixelSortOpening.jpg b/ASDFPixelSort_ControlP5/asdfPixelSortOpening.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..5d737e986f775e8ab3cf6abb93fb4b1e57c8c3f0
GIT binary patch
literal 12044
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
PlgxL$e4!ty2tWP{WX>CM

literal 0
HcmV?d00001