Delete pillow-simd/pillow_simd_USER_GUIDE.txt
Browse files
pillow-simd/pillow_simd_USER_GUIDE.txt
DELETED
|
@@ -1,77 +0,0 @@
|
|
| 1 |
-
================================================================================
|
| 2 |
-
pillow_simd - USER GUIDE (Android Python STB) - Generated by RIMI
|
| 3 |
-
================================================================================
|
| 4 |
-
|
| 5 |
-
Package: pillow_simd
|
| 6 |
-
Description: SIMD-optimized Pillow fork for fast image processing (8 C modules).
|
| 7 |
-
Extension: pillow_simd.pyd
|
| 8 |
-
Language: C
|
| 9 |
-
Dependencies: NumPy, libjpeg-turbo, libpng, zlib
|
| 10 |
-
|
| 11 |
-
================================================================================
|
| 12 |
-
1. OVERVIEW
|
| 13 |
-
================================================================================
|
| 14 |
-
|
| 15 |
-
Pillow-SIMD is a SIMD-optimized fork of the Pillow image processing library.
|
| 16 |
-
It provides the same API as Pillow but with significantly improved performance
|
| 17 |
-
through SIMD instruction optimizations. This build produces 8 C extension
|
| 18 |
-
modules for comprehensive image processing support.
|
| 19 |
-
|
| 20 |
-
================================================================================
|
| 21 |
-
2. INSTALLATION
|
| 22 |
-
================================================================================
|
| 23 |
-
|
| 24 |
-
From Android shell or Termux:
|
| 25 |
-
|
| 26 |
-
pip install /path/to/pillow_simd-*.whl
|
| 27 |
-
|
| 28 |
-
Or from within a build environment:
|
| 29 |
-
|
| 30 |
-
python -m pip install --no-build-isolation pillow_simd
|
| 31 |
-
|
| 32 |
-
================================================================================
|
| 33 |
-
3. VERIFICATION
|
| 34 |
-
================================================================================
|
| 35 |
-
|
| 36 |
-
After installation, verify the package loads correctly:
|
| 37 |
-
|
| 38 |
-
python -c "from PIL import Image; print('OK')"
|
| 39 |
-
|
| 40 |
-
Run the pre-built test script (if available):
|
| 41 |
-
|
| 42 |
-
python Scripts/test_pillow_simd.py
|
| 43 |
-
|
| 44 |
-
================================================================================
|
| 45 |
-
4. USAGE EXAMPLE
|
| 46 |
-
================================================================================
|
| 47 |
-
|
| 48 |
-
from PIL import Image, ImageFilter
|
| 49 |
-
|
| 50 |
-
# Open an image
|
| 51 |
-
img = Image.open("photo.jpg")
|
| 52 |
-
|
| 53 |
-
# Resize with SIMD-optimized resampling
|
| 54 |
-
resized = img.resize((800, 600), Image.LANCZOS)
|
| 55 |
-
|
| 56 |
-
# Apply filter
|
| 57 |
-
blurred = img.filter(ImageFilter.GaussianBlur(radius=5))
|
| 58 |
-
|
| 59 |
-
# Save
|
| 60 |
-
resized.save("output.webp", "WEBP", quality=85)
|
| 61 |
-
|
| 62 |
-
================================================================================
|
| 63 |
-
5. TROUBLESHOOTING
|
| 64 |
-
================================================================================
|
| 65 |
-
|
| 66 |
-
- If import fails with "cannot find shared library" the wheel was not
|
| 67 |
-
built with a static linking strategy. Rebuild with the correct
|
| 68 |
-
build script.
|
| 69 |
-
- Ensure NumPy, libjpeg-turbo, libpng, and zlib are available during
|
| 70 |
-
the build process.
|
| 71 |
-
- Ensure your Android Python STB environment matches the ABI that
|
| 72 |
-
the wheel was compiled for (typically arm64_v8a / aarch64).
|
| 73 |
-
- Note: The import name is "PIL", not "pillow_simd".
|
| 74 |
-
|
| 75 |
-
================================================================================
|
| 76 |
-
Generated by RIMI
|
| 77 |
-
================================================================================
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|