mirror of
https://github.com/python-pillow/Pillow.git
synced 2025-10-31 07:57:27 +03:00
7ff78543c8
As "how to port" (make code written for PIL work with Pillow) is likely a FAQ, back to the top.
30 lines
961 B
ReStructuredText
30 lines
961 B
ReStructuredText
Porting
|
|
=======
|
|
|
|
**Porting existing PIL-based code to Pillow**
|
|
|
|
Pillow is a functional drop-in replacement for the Python Imaging Library. To
|
|
run your existing PIL-compatible code with Pillow, it needs to be modified to
|
|
import the ``Image`` module from the ``PIL`` namespace *instead* of the
|
|
global namespace. Change this::
|
|
|
|
import Image
|
|
|
|
to this::
|
|
|
|
from PIL import Image
|
|
|
|
The :py:mod:`_imaging` module has been moved. You can now import it like this::
|
|
|
|
from PIL.Image import core as _imaging
|
|
|
|
The image plugin loading mechanism has changed. Pillow no longer
|
|
automatically imports any file in the Python path with a name ending
|
|
in :file:`ImagePlugin.py`. You will need to import your image plugin
|
|
manually.
|
|
|
|
Pillow will raise an exception if the core extension can't be loaded
|
|
for any reason, including a version mismatch between the Python and
|
|
extension code. Previously PIL allowed Python only code to run if the
|
|
core extension was not available.
|