Package: gimpify-watxaut
GimpifyThis repository is intended for creating automatic montages: it pastes
faces onto others faces. That's about it.DISCLAIMERThe aim of this package is not to make it beautiful, it is to make
it a nightmareI know there is still room for improvement on the maths for pasting
images. I will work on it when I have time. Help appreciated!Installationpip3installgimpify-watxautThis package usesface-recognitionfrom Adam Geitgey to get the faces andpillowto modify and paste
them. Both get installed when installing this package.How to run?1. Search for your imagesFirst, you will need two separate folders, one with 'backgrounds'
and another with 'faces'. When I talk about backgrounds I mean
photographs with people AND faces visible. In fact, only the faces are
needed, no need to show any other part of the body. One example of
background:When I talk about faces, I mean PNG images with only the face visible,
like this one:And the final result should be close to this one:As you see, the math is a little off, I know it.When you have this two folders populated, you are ready to start the
second phase.2.1 The fast approachIf you need to test the power of this package fast, you can do the
following:importgimpifymontages_path="path/out/montages"path_to_faces_folder="path/to/folder/faces"path_to_backgrounds_folder="path/to/folder/backgrounds"only_face=Falsemontage_file_path=gimpify.create_random_montage(montages_path,path_to_backgrounds_folder,path_to_faces_folder,only_face)In the montage_file_path variable will be the path to your newly created
montage. This will create a json file inside the images paths so that
the next time will try to get the json instead of loading again the
images.If the function finds that you already have a json file inside these
folders provided (background's and face's), it will try to use this
json files to speed up the execution. If you have new images, it will
only process this new images (= new paths/names). If, instead, you
remove images from the folder, the json will also be updated.If, for any reason, you don't change the name of an image while the
image itself is different, you will have to erase the json (or recreate
it, as shown down below).2.2: The curated wayIf you are more sophisticated, you can create both json files with
the face parameters before creating a montage, and then call one of the
three methods below to obtain the image.
If you put new images programmatically you can recreate this json files
and use this new images right away.2.2.1 First, create_face_json and create_background_jsonThe following code will get the aforementioned done:importgimpifypath_to_faces_folder="path/to/folder/faces"path_to_backgrounds_folder="path/to/folder/backgrounds"json_faces="path/to/json/faces.json"json_backgrounds="path/to/json/backgrounds.json"gimpify.create_face_json(path_to_faces_folder,path_to_faces_folder,just_update=True)gimpify.create_background_json(path_to_backgrounds_folder,path_to_backgrounds_folder)Then use this paths to both json files to create random images
(shown down below). Keep in mind that one the json is created, if you
put new images in the folder, and the option just_update is True and
there is already a json file with the parameters, it
will automatically add only these new images and erase the ones that
were removed. If it is false, it will create the json again.
You have now
3 different options regarding the way you want your montages:2.2.2a Use gimpify.create_random_montageWe saw this method early on, but it's worth mentioning. It takes 4
arguments::param montage_folder_path: {str} folder to save the montage:param b_path: {str} folder background path or json path with the face params. If folder provided, the 'backgrounds.json' file
will be created inside the backgrounds' folder. If json provided, it will use the json to load the params (faster):param f_path: {str} folder face path or json path with the face's params. If folder provided, the 'faces.json' file
will be created inside the faces' folder. If json provided, it will use the json to load the params (faster):param only_face: {bool}. False by default. Will leave hair and chin if False, else will crop the faceThe use for this one is the following:importgimpifyjson_faces="path/to/json/faces.json"json_backgrounds="path/to/json/backgrounds.json"montage_folder_path="path/out/montages"only_face=Falsepath_to_new_image=gimpify.create_random_montage(montage_folder_path,json_backgrounds,json_faces,only_face)This way, the module does not create the json params again and thus
increasing the speed of the creation.2.2.2b Use gimpify.create_montage_for_backgroundUse this method if you want to create a montage for a background of your
pleasing, a new photograph that you just made or you need a fast
processing for just a background and you don't need to process all the
others. E.g.: you send a selfie to a bot and the bot answers with a
montage. It takes 4 arguments::param montage_folder_path: {str} folder to save the montage:param im_b_path: {str} with the background image path:param f_path: {str} folder face path or json path with the face's params. If folder provided, the 'faces.json' file
will be created inside the faces' folder:param only_face: {bool} Whether to crop the hair and chin of the face or notimportgimpifyjson_faces="path/to/json/faces.json"im_b_path="path/to/background_image.png"montage_folder_path="path/out/montages"only_face=Falsepath_to_new_image=gimpify.create_montage_for_background(montage_folder_path,im_b_path,json_faces,only_face)This method will not store the image face parameters json.2.2.2c Use gimpify.create_montageThis method is the lowest level available and it returns a PIL Image. It takes in 3 arguments::param im_background: {str, dict} str if is an image path or dict if it comes from a json read from a background's folder:param json_faces: {dict} json read with all the information about the faces' parameters:param only_face: {bool}. False by default. Will leave hair and chin if False, else will crop the face-> Returns a PIL Image.Image variable with the image for you to do
whatever you want.The use is the following one:importgimpifyimportjsonf_faces=open("path/to/json/faces.json","r")json_faces:dict=json.load(f_faces)f_faces.close()im_background="path/to/background_image.png"only_face=Falsepath_to_new_image=gimpify.create_montage(im_background,json_faces,only_face)