{"id":27911,"library":"large-image-source-pil","title":"large-image-source-pil","description":"A Pillow tilesource for large_image, enabling reading of common image formats (PNG, JPEG, TIFF, etc.) using Pillow. Version 1.34.1 is current, with a maintenance cadence of monthly releases.","status":"active","version":"1.34.1","language":"python","source_language":"en","source_url":"https://github.com/girder/large_image","tags":["large-image","Pillow","tilesource"],"install":[{"cmd":"pip install large-image-source-pil","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"Core large_image framework; tilesource base class","package":"large-image","optional":false},{"reason":"Image reading backend","package":"Pillow","optional":false}],"imports":[{"note":"PILFileTileSource is in large_image_source_pil, not in the core large_image package.","wrong":"from large_image.tilesource import PILFileTileSource","symbol":"PILFileTileSource","correct":"from large_image_source_pil import PILFileTileSource"}],"quickstart":{"code":"from large_image_source_pil import PILFileTileSource\n\nsource = PILFileTileSource('path/to/image.png')\ntile = source.getTile(0, 0, 0)  # get top-left tile at level 0\nprint(tile.shape)","lang":"python","description":"Open an image using the Pillow tilesource and fetch a tile."},"warnings":[{"fix":"Use Python >=3.10","message":"Python 3.10+ only. Python 3.9 and older are not supported (requires_python >=3.10).","severity":"breaking","affected_versions":">=1.34.0"},{"fix":"Check the current API docs; use the new signature.","message":"The 'method' parameter in getRegion() may be removed. The histogram signature changed in 1.34.1.","severity":"deprecated","affected_versions":">=1.34.1"},{"fix":"Use large_image_source_tiff for TIFF, or large_image for more comprehensive support.","message":"PILFileTileSource may not support all image formats that Pillow itself supports (e.g., multi-page TIFF, animated GIF).","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Install large-image-source-pil and use 'from large_image_source_pil import PILFileTileSource'.","cause":"Incorrect import path; the tilesource is in a separate package.","error":"ImportError: cannot import name 'PILFileTileSource' from 'large_image.tilesource'"},{"fix":"pip install large-image-source-pil","cause":"The package large-image-source-pil is not installed.","error":"ModuleNotFoundError: No module named 'large_image_source_pil'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}