rockerBOO-pixel-sorting/examples/README.md

Pixel Sorting Examples

This directory contains comprehensive examples of all pixel sorting modes, sorting functions, and parameter variations.

Source Image: Urban scene with person in pink/purple tones

Total Examples: 31 (including original)

---

Original

• 00_original.png - Original unmodified image

---

Interval Modes

Different ways to define which parts of the image get sorted:

• 01_interval_bright.png - Bright mode - Sorts pixels with brightness ≥ threshold (subtle: 109)
• 02_interval_dark.png - Dark mode - Sorts pixels with brightness ≤ threshold (subtle: 33)
• 03_interval_white.png - White mode - Sorts pixels with value ≥ threshold (ASDF-style)
• 04_interval_black.png - Black mode - Sorts pixels with value ≤ threshold (ASDF-style)
• 05_interval_threshold.png - Threshold mode - Sorts pixels between 0.3-0.7 brightness
• 06_interval_random.png - Random intervals - Randomly generated intervals (char_length=80)
• 07_interval_waves.png - Wave intervals - Uniform wave-like intervals (char_length=60)
• 08_interval_edges.png - Edge detection - Intervals defined by edge detection
• 09_interval_none.png - No intervals - Sorts entire rows without boundaries

---

Sorting Functions

Different ways to sort pixels within intervals (all using bright mode):

• 10_sort_lightness.png - Lightness - Sort by brightness (HLS lightness)
• 11_sort_hue.png - Hue - Sort by color hue (creates rainbow effects)
• 12_sort_saturation.png - Saturation - Sort by color saturation intensity
• 13_sort_intensity.png - Intensity - Sort by sum of RGB values
• 14_sort_minimum.png - Minimum - Sort by minimum RGB channel value
• 15_sort_value.png - Value - Sort by pixel integer value (ASDF original)

---

Angle Variations

Diagonal and vertical sorting effects:

• 16_angle_45.png - 45° diagonal - Diagonal sorting at 45 degrees
• 17_angle_90.png - 90° vertical - Vertical sorting (perpendicular to default)
• 18_angle_-45.png - -45° diagonal - Diagonal sorting in opposite direction

---

Randomness

Skip some intervals randomly for variation:

• 19_randomness_25.png - 25% random skip - Randomly skip 25% of intervals
• 20_randomness_50.png - 50% random skip - Half of intervals left unsorted
• 21_randomness_75.png - 75% random skip - Most intervals skipped (with random mode)

---

Multiple Passes

Apply sorting multiple times:

• 22_loops_2.png - 2 passes - Sort the image twice
• 23_loops_3.png - 3 passes - Sort the image three times (stronger effect)

---

Creative Combinations

Complex effects combining multiple parameters:

• 24_combo_random_hue.png - Random + Hue + 20% randomness

  • Interval: random (char_length=100)
  • Sorting: hue
  • Randomness: 20%

• 25_combo_edges_saturation.png - Edge detection + Saturation

  • Interval: edges (lower_threshold=0.3)
  • Sorting: saturation

• 26_combo_waves_hue.png - Waves + Hue

  • Interval: waves (char_length=50)
  • Sorting: hue

• 27_combo_diagonal_random_hue.png - Diagonal + Random + Hue

  • Interval: random (char_length=80)
  • Sorting: hue
  • Angle: 45°

• 28_combo_dark_lightness_loops.png - Dark + Lightness + Multiple passes

  • Interval: dark (subtle threshold)
  • Sorting: lightness
  • Loops: 2

• 29_combo_bright_saturation_90.png - Bright + Saturation + Vertical

  • Interval: bright (subtle threshold)
  • Sorting: saturation
  • Angle: 90°

• 30_combo_threshold_hue_rand.png - Threshold + Hue + Randomness

  • Interval: threshold (0.2-0.8)
  • Sorting: hue
  • Randomness: 30%

---

Analysis Results

For this image, the analysis suggested:

Brightness thresholds:

• Bright (subtle): 109
• Dark (subtle): 33

These values were used for the examples to ensure good results for this specific image.

---

Regenerating Examples

To regenerate all examples with a different image:

# Edit generate_examples.py to point to your image
uv run python generate_examples.py

The script automatically:

1. Analyzes the image to find optimal thresholds
2. Generates examples for all modes
3. Creates organized, numbered output files