Usage

On first launch the app already shows 33 demo fabrics fully analyzed — no empty screen.

Right after install — auto-seeding

The first time you open the app, it analyzes the 33 bundled images (1 multi-color + 32 P2-series fabric matrix). Each entry is created with:

• 5 representative colors (HEX)
• 7×7 measurement grid (49 points)
• Memo: 샘플 · {filename} (editable)
• materialType: 샘플 (sample)

1. Pick a photo

Tap the + button in the top right. The system photo picker opens. The chosen photo is copied into the app's private storage (filesDir/captures). No permission requested.

2. Auto color extraction

Each photo goes through two analyses at once:

• Palette — AndroidX Palette extracts the 5 dominant colors. A perceptual view of "what's used most."
• Measurement grid — The image is divided into 3×3, 5×5, or 7×7 cells, and the average RGB of each cell is recorded. A quantitative view of "what the sensor saw, by location."

3. Eyedropper — precise sampling

Tap anywhere on the photo to record that pixel (and its local neighborhood) as a sampled point — separate from grid averages, so you can capture details the grid misses.

4. White-leveling

Tap a known-white spot on the photo. The app treats that color as if it should be white (255,255,255) under the current lighting and corrects every other color accordingly (von Kries transform).

• Raw: pre-correction — colors, measuredGrid, sampledPoints
• WB: post white-leveling — colorsWb, measuredGridWb, sampledPointsWb

Both sets are stored together, so you can compare "before vs after lighting correction" inside the same record.

5. Notes & save

Add fabric name, vendor, material(materialType) and save. Tap a HEX chip to copy straight to clipboard — paste into your design tool.

6. Settings

• Grid size — 3 / 5 / 7 (default 7)
• Palette count — number of representative colors (default 5)
• Load samples — manual reseed if auto-seeding was disabled

Where data lives

• Images: filesDir/captures/IMG_*.jpg · filesDir/captures/sample_*.webp
• Records (JSON): filesDir/entries.json
• Settings: SharedPreferences (colormarker_settings)

All of this is in the app's private storage — deleting the app removes everything. Nothing is transmitted.