# Ascii-Image-Art Documentation with AI & ML
**🌱 ASCII-IMAGE-ART is very simple to use package for converting images into ASCII character strings and ASCII character colored images. Integrated with *AI and Machine Learning* modules as well to provide better and smoother results. Can achieve better compression and smoother edges as well with AI module.**
<img alt="Elephant ASCII Conversion" src="https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/elephant.png?raw=true" width="250" /> <img alt="Human ASCII Conversion" src="https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/human_inverted.png?raw=true" width="250" /> <img alt="Female ASCII Conversion" src="https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/female.png?raw=true" width="250" /> <img alt="Female ASCII Conversion" src="https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/porche.png?raw=true" width="250" />
**Import**
- 🔗 from ascii_image_art import ASCIIArt
**Parameters**
```obj = ASCIIArt( path = 'path to file without dots'[mandatory], scale = 0.1 [optional], chars = 'string of characters'[optional], filename = 'name of file you want to save with without extension'[optional] )```
- 🔗 path = absolute path to image file available locally. Don't use dots in the file name or file path.
- 🔗 filename = name of file you would be saving the final processed results with. Don't provide any extension like '.txt' or '.png' just the name.
- 🔗 scale = from 0.01 to 1. The scaled percentage of image of you want your end text and image with. By default = 0.1 or 10%.
- 🔗 chars = character 'string' you want to recreate the image with.
**Methods**
a.getPath()
a.convert()
a.convertWithAI(depth)
a.printASCII()
- 🔗 getPath() : incase you don't want to pass the mandatory path to image and want to ask for image path at runtime from user.
- 🔗 convert() : to convert image to ascii. Use - `obj.convert()`
- 🔗 convertWithAI() : Uses AI for smoother and more compressed results. Convert image to ascii text and ascii text colored image. Use - `obj.convertWithAI(depth=4)`. depth takes values from 2 to 50. More depth more, color and more time it will take. Less depth will compute the results quicker! This method with create 4 files. One ASCII text file. 3 images -> one compressed.png, output_filename.png and output_inverted_filename.png
- 🔗 getASCII() : returns an ascii image in string format.
- 🔗 printASCII() : prints the ascii string like below.
D..AA.AD
A . S..
S
D AAASSAA
S..AA A..
SSAASAAAAA
AAA..A..A
A ..AA. AD
SDA AS
DDDDDDDA .SDDS
DDDDDDDDS. SASSDDDDD
DDDDDDDDDSSA SDDDDDDD
DDDDDDDDDDDDS DDDDDDDDD
DDDDDSDDDDDDDD. DDDDDDDDD
DDDDDDDDDDDDDD. SDDDDDDDDD
DDDDDDSDDDDDDD .DDDDDDSDDD
DDDDDDDDDDDDDDDS.DDSDDDDDDD
DDDDDDDDDDDDDDDDDDDDDDDDDDD
DDDDDDDDDDDDDDDDDDDDDDDDDDD
DDDDDDDDDDDDDDD DSDDDSDDDD
DDDDDDDDDDDDDDDDSDDDSDDDDD
DSDDDDDDDDDDDDSDDDDDDDDS
DDDDDDDDDDDDSDDDDDDDDD
DDDDDDDDDDDD DDDDDDDD
DSDDDSDSDDDD.DDDDDDD
DDDDDDDDDDDA.AAADDDSS
SDDDDDDDDDAAA .AAADSSS
DDDDDDDDSA.AAAA..SSSSS
DDDDDDDDDS.AA...SSSDDD
SDDDDDDSDDSDDSSDDDD.
DDDSDSDDDDDDDDDDDD
DDDDDDDSDDSDDDDDDDD
DDDDDDDSD DDDDDDDDD
DDDDDDSS DDDDDDDD
DDDDDDDS SDDDDDDD
DDDDDDS DDDDDDDD
DDDDDDS DDDDDDDD
DDDDDDS DDDDDDDD
SDDDSS DDDDDDDDA
DDDDSS DDDDDDDDDD
DDDSSSDDDDDDDDDD
DDDSDDDDDDDDDDS
DSDDDDDDDDDDS
DDDDDDDDDDDD
DDDDDDDDDDD
- 💞️ Thank You. Mohammad ASAD
Raw data
{
"_id": null,
"home_page": "https://github.com/txtasad/Ascii-Image-Art",
"name": "ascii-image-art",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "python, ascii, image to text, image to ascii, color ascii image, text image, ASAD, MOHAMMAD ASAD, ascii_art, ascii-image",
"author": "Mohammad Asad",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/78/6f/4ee6da1030f226273ad86b46be0182e3565905637693e56cfcdb7ea1eb57/ascii_image_art-0.0.5.4.tar.gz",
"platform": null,
"description": "\n# Ascii-Image-Art Documentation with AI & ML\n\n\n**\ud83c\udf31 ASCII-IMAGE-ART is very simple to use package for converting images into ASCII character strings and ASCII character colored images. Integrated with *AI and Machine Learning* modules as well to provide better and smoother results. Can achieve better compression and smoother edges as well with AI module.**\n\n\n<img alt=\"Elephant ASCII Conversion\" src=\"https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/elephant.png?raw=true\" width=\"250\" /> <img alt=\"Human ASCII Conversion\" src=\"https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/human_inverted.png?raw=true\" width=\"250\" /> <img alt=\"Female ASCII Conversion\" src=\"https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/female.png?raw=true\" width=\"250\" /> <img alt=\"Female ASCII Conversion\" src=\"https://raw.githubusercontent.com/txtasad/Ascii-Image-Art/main/porche.png?raw=true\" width=\"250\" />\n\n\n**Import**\n\n- \ud83d\udd17 from ascii_image_art import ASCIIArt\n\n\n**Parameters**\n\n```obj = ASCIIArt( path = 'path to file without dots'[mandatory], scale = 0.1 [optional], chars = 'string of characters'[optional], filename = 'name of file you want to save with without extension'[optional] )```\n\n- \ud83d\udd17 path = absolute path to image file available locally. Don't use dots in the file name or file path. \n- \ud83d\udd17 filename = name of file you would be saving the final processed results with. Don't provide any extension like '.txt' or '.png' just the name.\n- \ud83d\udd17 scale = from 0.01 to 1. The scaled percentage of image of you want your end text and image with. By default = 0.1 or 10%.\n- \ud83d\udd17 chars = character 'string' you want to recreate the image with.\n\n\n**Methods**\n\na.getPath()\na.convert()\na.convertWithAI(depth)\na.printASCII()\n- \ud83d\udd17 getPath() : incase you don't want to pass the mandatory path to image and want to ask for image path at runtime from user. \n- \ud83d\udd17 convert() : to convert image to ascii. Use - `obj.convert()`\n- \ud83d\udd17 convertWithAI() : Uses AI for smoother and more compressed results. Convert image to ascii text and ascii text colored image. Use - `obj.convertWithAI(depth=4)`. depth takes values from 2 to 50. More depth more, color and more time it will take. Less depth will compute the results quicker! This method with create 4 files. One ASCII text file. 3 images -> one compressed.png, output_filename.png and output_inverted_filename.png\n- \ud83d\udd17 getASCII() : returns an ascii image in string format.\n- \ud83d\udd17 printASCII() : prints the ascii string like below.\n\n\n\n \n \n D..AA.AD \n A . S.. \n S \n D AAASSAA \n S..AA A.. \n SSAASAAAAA \n AAA..A..A \n A ..AA. AD \n SDA AS \n DDDDDDDA .SDDS \n DDDDDDDDS. SASSDDDDD \n DDDDDDDDDSSA SDDDDDDD \n DDDDDDDDDDDDS DDDDDDDDD \n DDDDDSDDDDDDDD. DDDDDDDDD \n DDDDDDDDDDDDDD. SDDDDDDDDD \n DDDDDDSDDDDDDD .DDDDDDSDDD \n DDDDDDDDDDDDDDDS.DDSDDDDDDD \n DDDDDDDDDDDDDDDDDDDDDDDDDDD \n DDDDDDDDDDDDDDDDDDDDDDDDDDD \n DDDDDDDDDDDDDDD DSDDDSDDDD \n DDDDDDDDDDDDDDDDSDDDSDDDDD \n DSDDDDDDDDDDDDSDDDDDDDDS \n DDDDDDDDDDDDSDDDDDDDDD \n DDDDDDDDDDDD DDDDDDDD \n DSDDDSDSDDDD.DDDDDDD \n DDDDDDDDDDDA.AAADDDSS \n SDDDDDDDDDAAA .AAADSSS \n DDDDDDDDSA.AAAA..SSSSS \n DDDDDDDDDS.AA...SSSDDD \n SDDDDDDSDDSDDSSDDDD. \n DDDSDSDDDDDDDDDDDD \n DDDDDDDSDDSDDDDDDDD \n DDDDDDDSD DDDDDDDDD \n DDDDDDSS DDDDDDDD \n DDDDDDDS SDDDDDDD \n DDDDDDS DDDDDDDD \n DDDDDDS DDDDDDDD \n DDDDDDS DDDDDDDD \n SDDDSS DDDDDDDDA \n DDDDSS DDDDDDDDDD \n DDDSSSDDDDDDDDDD \n DDDSDDDDDDDDDDS \n DSDDDDDDDDDDS \n DDDDDDDDDDDD \n DDDDDDDDDDD \n\n\n\n- \ud83d\udc9e\ufe0f Thank You. Mohammad ASAD\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple to use Python library to convert images into ASCII characters text file and ASCII characters colored images. Option to use new AI module.",
"version": "0.0.5.4",
"project_urls": {
"Homepage": "https://github.com/txtasad/Ascii-Image-Art"
},
"split_keywords": [
"python",
" ascii",
" image to text",
" image to ascii",
" color ascii image",
" text image",
" asad",
" mohammad asad",
" ascii_art",
" ascii-image"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "66a46d5bb57be4f6c7ea9f8f7dc8b509f00974a805c1deab3e2ead4aee68d418",
"md5": "e5280e3dd4e91c5dd6370f0e7c693a5f",
"sha256": "7f4d63b4f3ae20ea0ec2d3b73607611c6a5cf46bb031a47a9e871786d65f4300"
},
"downloads": -1,
"filename": "ascii_image_art-0.0.5.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e5280e3dd4e91c5dd6370f0e7c693a5f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8270,
"upload_time": "2024-06-30T20:33:05",
"upload_time_iso_8601": "2024-06-30T20:33:05.710253Z",
"url": "https://files.pythonhosted.org/packages/66/a4/6d5bb57be4f6c7ea9f8f7dc8b509f00974a805c1deab3e2ead4aee68d418/ascii_image_art-0.0.5.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "786f4ee6da1030f226273ad86b46be0182e3565905637693e56cfcdb7ea1eb57",
"md5": "d76d2d8bbba172e3ef99dd64bba78b9b",
"sha256": "0d649d60e71160c3e913bd6e4b2046c6fe43184498a8da665b3ea0f52e7119a2"
},
"downloads": -1,
"filename": "ascii_image_art-0.0.5.4.tar.gz",
"has_sig": false,
"md5_digest": "d76d2d8bbba172e3ef99dd64bba78b9b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6658,
"upload_time": "2024-06-30T20:33:07",
"upload_time_iso_8601": "2024-06-30T20:33:07.155849Z",
"url": "https://files.pythonhosted.org/packages/78/6f/4ee6da1030f226273ad86b46be0182e3565905637693e56cfcdb7ea1eb57/ascii_image_art-0.0.5.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-06-30 20:33:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "txtasad",
"github_project": "Ascii-Image-Art",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ascii-image-art"
}
JSON
