{"id":21269784,"url":"https://github.com/prashantrahul141/imageeffects","last_synced_at":"2025-03-15T11:44:36.186Z","repository":{"id":65123956,"uuid":"581224946","full_name":"prashantrahul141/ImageEffects","owner":"prashantrahul141","description":"A library to add effects to your images.","archived":false,"fork":false,"pushed_at":"2023-01-03T09:47:06.000Z","size":7169,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-22T11:46:01.764Z","etag":null,"topics":["image-manipulation","image-processing","pillow","python"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/ImageEffects/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prashantrahul141.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-12-22T15:50:31.000Z","updated_at":"2022-12-26T13:50:02.000Z","dependencies_parsed_at":"2023-01-11T17:31:27.184Z","dependency_job_id":null,"html_url":"https://github.com/prashantrahul141/ImageEffects","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prashantrahul141%2FImageEffects","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prashantrahul141%2FImageEffects/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prashantrahul141%2FImageEffects/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prashantrahul141%2FImageEffects/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prashantrahul141","download_url":"https://codeload.github.com/prashantrahul141/ImageEffects/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243725542,"owners_count":20337667,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["image-manipulation","image-processing","pillow","python"],"created_at":"2024-11-21T08:11:52.440Z","updated_at":"2025-03-15T11:44:36.161Z","avatar_url":"https://github.com/prashantrahul141.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align='center'\u003eImage Effects\u003c/h1\u003e\n\n\u003ch6 align='center'\u003eA Simple Library to add effects to images written in python using \u003ca target=\"_blank\" href=\"https://pillow.readthedocs.io/en/stable/\"\u003ePillow\u003c/a\u003e.\u003c/h6\u003e\n\n\u003cbr\u003e\n\n## Quick Example\n\n```py\n# import the EffectsCreator class\nfrom ImageEffects import EffectsCreator\n\n# initialize it\nEC = EffectsCreator()\n\n# use functions to add effects to images\n\n# this functions overlays an image with an emoji\n# the functions returns a PIL.Image.Image object\noutput = EC.emojioverlay('input.png', '🟥')\n\n# save the resulted image\noutput.save('output.png')\n\n# or add effects and save them.\nEC.caption1('input.png', 'testing text here').save('result_two.jpg')\nEC.caption2('input.png', 'testing text here').save('result_three.jpg')\nEC.deepfry('input.png').save('result_four.jpg')\nEC.pixelate('input.png', 2).save('result_five.jpg')\n```\n\ninput file:\n\n\u003cimg width=\"200px\" src='https://raw.githubusercontent.com/prashantrahul141/ImageEffects/main/ImageEffects/resources/meta/test_image.jpg' alt=\"input\"\u003e\n\u003cbr\u003e\n\nemojioverlay:\n\n\u003cimg width=\"200px\" src='https://raw.githubusercontent.com/prashantrahul141/ImageEffects/main/ImageEffects/resources/meta/result_one.png' alt=\"emojioverlay\"\u003e\n\u003cbr\u003e\n\ncaption1:\n\n\u003cimg width=\"200px\" src='https://raw.githubusercontent.com/prashantrahul141/ImageEffects/main/ImageEffects/resources/meta/result_two.jpg' alt=\"caption1\"\u003e\n\u003cbr\u003e\n\ncaption2:\n\n\u003cimg width=\"200px\" src='https://raw.githubusercontent.com/prashantrahul141/ImageEffects/main/ImageEffects/resources/meta/result_three.jpg' alt=\"caption2\"\u003e\n\u003cbr\u003e\n\ndeepfry:\n\n\u003cimg width=\"200px\" src='https://raw.githubusercontent.com/prashantrahul141/ImageEffects/main/ImageEffects/resources/meta/result_four.jpg' alt=\"deepfry\"\u003e\n\u003cbr\u003e\n\npixelate:\n\n\u003cimg width=\"200px\" src='https://raw.githubusercontent.com/prashantrahul141/ImageEffects/main/ImageEffects/resources/meta/result_five.jpg' alt=\"pixelate\"\u003e\n\u003cbr\u003e\n\n## Index\n\n- [Installation](#installation)\n- [What's Next](#whats-next)\n\n##### Functions\n\n- [emojioverlay](#emojioverlay)\n- [deepfry](#deepfry)\n- [caption1](#caption1)\n- [caption2](#caption2)\n- [pixelate](#pixelate)\n- [triggered](#triggered)\n- [cropcircle](#cropcirlce)\n- [blur](#blur)\n- [rotate](#rotate)\n- [ascify](#ascify)\n- [crop](#crop)\n- [resize](#resize)\n- [saturate](#saturate)\n- [grayscale](#grayscale)\n- [flip](#flip)\n- [mirror](#mirror)\n- [invert](#invert)\n\n## More Information\n\n### Installation\n\nInstall using pip.\n\n```sh\npip install ImageEffects\n```\n\n## Functions\n\n### emojioverlay\n\nOverlays an image with an emoji.\n\n```py\nemojioverlay(image: str, emoji: str, alpha: int = 100) -\u003e Image\n```\n\n### deepfry\n\nmakes deepfry meme from image.\n\n```py\ndeepfry(image: str) -\u003e Image\n```\n\n### caption1\n\nadds given text to the image on the top side.\n\n```py\ncaption1(image: str, text: str = 'text here', _font_size_ratio_mul: float = 1.0, _border: bool = False) -\u003e Image\n```\n\n### caption2\n\nadds given text to the image on the bottom side.\n\n```py\ncaption2(image: str, text: str = 'text here', _font_size_ratio_mul: float = 1.0, _border: bool = False) -\u003e Image\n```\n\n### pixelate\n\nadds pixelate effect.\n`scale` should be between 0 to 6 ( including 0 and 6)\n\n```py\npixelate(image: str, scale: int = 0) -\u003e Image\n```\n\n### triggered\n\nmakes triggered meme.\n\n```py\ntriggered(self, image: str) -\u003e Image\n```\n\n### cropcirlce\n\ncrops image in circle.\n\n```py\ncropcircle(image: str) -\u003e Image\n```\n\n### blur\n\nblurs the image using box blur for performance.\n`radius` int value for the radius of blur.\n\n```py\nblur(image: str, radius: int = 1) -\u003e Image\n```\n\n### rotate\n\nrotates the image according to the radius given.\n`rotation_angle` int value in angles.\n\n```py\nrotate(image: str, rotation_angle: int = 90) -\u003e Image\n```\n\n### ascify\n\nmakes ascii art from given text.\n`str` string text,\n\n```py\nasicfy(text: str = 'ascify') -\u003e str\n```\n\n### crop\n\ncrops image automactically in 1:1 ratio.\n\n```py\ncrop(image: str) -\u003e Image\n```\n\n### resize\n\nresize image according to given width and height.\n`width` amd `height` should be atleast 1 and smaller than the original image's width and height.\n\n```py\nresize(image: str, width: int = 0, height: int = 0) -\u003e Image\n```\n\n### saturate\n\nchanges saturation of image.\n`scale` int should be between 0 ( being grayscale ) and 10 ( 10 being 10 times more saturated ).\n\n```py\nsaturate(image: str, scale: int = 0) -\u003e Image\n```\n\n### grayscale\n\ngrayscales an image.\n\n```py\ngrayscale(image: str) -\u003e Image\n```\n\n### flip\n\nflips image vertically.\n\n```py\nflip(image: str) -\u003e Image\n```\n\n### mirror\n\nmirrors the image.\n\n```py\nmirror(image: str) -\u003e Image\n```\n\n### invert\n\ninverts the colors of an image.\n\n```py\ninvert(image: str) -\u003e Image\n```\n\n## What's Next?\n\nI am planing to add a lot more effects to the library, and feel free to contribute to the project with new effects or improvements.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprashantrahul141%2Fimageeffects","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprashantrahul141%2Fimageeffects","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprashantrahul141%2Fimageeffects/lists"}