Metadata-Version: 1.1
Name: PILasOPENCV
Version: 1.6
Summary: Wrapper for Image functions which are used and called in the manner of the famous PIL/Pillow module but work internally with OpenCV.
Home-page: https://github.com/bunkahle/PILasOPENCV
Author: Andreas Bunkahle
Author-email: abunkahle@t-online.de
License: MIT
Description: # PILasOPENCV
        Wrapper for Image functions which are used and called in the manner of the famous PIL module but work internally with OpenCV.
        
        This library can be used to migrate old PIL projects to OPENCV.
        
        You install this module with
        
            pip install PILasOPENCV
            
        or you donwload the module and install it with:
        
            python setup.py install
            
        and then you change the import command at the beginning of your project files from
        
            from PIL import Image
            
        or 
        
            import PIL.Image
            
        or 
        
            import PIL.Image as Image
            
        to
        
            import PILasOPENCV as Image
            
        Internally no PIL or Pillow library is used anymore but the opencv module for doing all the graphical work.
        
        Sample script:
        
            from __future__ import print_function
            import PILasOPENCV as Image
            # was: from PIL import Image
            
            im = new("RGB", (512, 512), "white")
            im.show()
            
            testfile = "lena.jpg"
            im = open(testfile)
            print (type(im))
            # JPEG (512, 512) RGB
            im.save("lena.bmp")
            im.show()
            small = im.copy()
            small.thumbnail(thsize)
            small.show()
            thsize = (128, 128)
            box = (100, 100, 400, 400)
            region = im.crop(box)
            print("region",region.format, region.size, region.mode)
            # region = region.transpose(Image.ROTATE_180)
            region = region.transpose(ROTATE_180)
            region.show()
            im.paste(region, box)
            im.show()
             
        # Export CV2/Numpy images
        You can export the cv2/numpy image from an Image instance with the command getim():
            
            from __future__ import print_function
            import PILasOPENCV as Image
            import cv2
            im = Image.open("lena.jpg")
            numpy_image = im.getim()
            print(type(numpy_image), numpy_image.shape)
            cv2.imshow("numpy_image", numpy_image)
            cv2.waitKey(0)
            
        # Attention:
        This is a very unstable development version. Use with care. Not much testing has been done to it though tests have been done. They can be found in the tests directory.
        
        # TO DO:
        ImageMode, ImageColor, ImageDraw are, ImageFilter, ImageChops are implemented but have not been fully tested.
        Some functions/methods of these classes are missing and are not implemented though.
        If you want to import them, import them with:
        
            import PILasOPENCV as ImageMode
            import PILasOPENCV as ImageColor
            import PILasOPENCV as ImageDraw
            import PILasOPENCV as ImageFilter
            import PILasOPENCV as ImageChops
            import PILasOPENCV as ImageFont
            
        The PIL classes ImageEnhance, ImageFile, ImageFileIO, ImageGrab, ImageMath, ImageOps, ImagePath, ImageQt, ImageSequence, ImageStat, ImageTk, ImageWin, ImageGL have not been implemented.
            
        If you want to use the methods getsize and getmask from ImageFont you have to use them differently:
        
            from __future__ import print_function
            import PILasOPENCV as Image
            import PILasOPENCV as ImageDraw
            import PILasOPENCV as ImageFont
            import cv2
            # from PIL import Image, ImageDraw, ImageFont
            
            font = ImageFont.truetype("ARIAL.ttf".lower(), 18)
            im = Image.open("lena.jpg")
            draw = ImageDraw.Draw(im)
            text = "Lena's image"
            draw.text((249,455), text, font=font, fill=(0, 0, 0))
            # in PIL:
            # print(font.getsize(text))
            # mask = font.getmask(text)
            print(ImageFont.getsize(text, font))
            mask = ImageFont.getmask(text, font)
            print(type(mask))
            cv2.imshow("mask", mask)
            im.show()
        
        If you want to fork this project, feel free to do so. Give me a message in case you are forking and improving the code.
        abunkahle@t-online.de
        
        # Dependencies:
        You need to have numpy, opencv and freetype installed to run the module.
        Install it with 
        
             pip install numpy opencv-python freetype-py
             
        # Licence
        MIT
        
Keywords: PIL OPENCV wrapper
Platform: any
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
