Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antononcube/raku-image-markup-utilities
Raku package for functions that facilitate the import, export, and viewing of images in different Markup types of documents.
https://github.com/antononcube/raku-image-markup-utilities
base64 base64-encoding image markup raku rakulang rendering
Last synced: 17 days ago
JSON representation
Raku package for functions that facilitate the import, export, and viewing of images in different Markup types of documents.
- Host: GitHub
- URL: https://github.com/antononcube/raku-image-markup-utilities
- Owner: antononcube
- License: artistic-2.0
- Created: 2023-12-10T14:33:43.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-17T13:33:49.000Z (about 1 year ago)
- Last Synced: 2024-11-05T18:55:56.970Z (2 months ago)
- Topics: base64, base64-encoding, image, markup, raku, rakulang, rendering
- Language: Raku
- Homepage: https://raku.land/zef:antononcube/Image::Markup::Utilities
- Size: 93.8 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-work.md
- License: LICENSE
Awesome Lists containing this project
README
# Image::Markup::Utilities
Raku package for functions that facilitate the import, export, and viewing of images in different Markup types of documents.
## Installation
From GitHub:
```
zef install https://github.com/antononcube/Raku-Image-Markup-Utilities.git
```
From [Zef ecosystem](https://raku.land):
```
zef install Image::Markup::Utilities;
```
-------
## Usage examples
Import an image and display it:
```perl6, results=asis, output-prompt=NONE, eval=TRUE
use Image::Markup::Utilities;
my $img = image-import($*CWD ~ '/resources/RandomMandala.png', format => 'asis');
image-from-base64($img);
```
**Remark:** GitHub's Markdown renderer does not display the image imported above,
but other Markdown rendering apps, like, One Markdown or Visual Studio Code do show the image.
**Remark:** If this Markdown file is converted into an HTML file, say, with
["Markdown::Grammar"](https://raku.land/zef:antononcube/Markdown::Grammar), [AAp3],
the image is seen any browser.
-------
## Implementation notes
- Initial version of the function `image-from-base64` was implemented in "Text::Plot", [AAp1].
- In order to streamline the presentation material of the video ["Using Wolfram Engine in Raku sessions"](https://www.youtube.com/watch?v=nWeGkJU3wdM), [AAv1].
- Initial versions of the functions `image-encode` and `image-export` were implemented in the package "WWW::OpenAI", [AAp2].
- Now "WWW::OpenAI" depends on this package.
-------
## References
### Packages
[AAp1] Anton Antonov,
[Text::Plot Raku package](https://github.com/antononcube/Raku-Text-Plot),
(2022-2023),
[GitHub/antononcube](https://github.com/antononcube/).
[AAp2] Anton Antonov,
[WWW::OpenAI Raku package](https://github.com/antononcube/Raku-WWW-OpenAI),
(2023),
[GitHub/antononcube](https://github.com/antononcube/).
[AAp2] Anton Antonov,
[Markdown::Grammar Raku package](https://github.com/antononcube/Raku-Markdown-Grammar),
(2023),
[GitHub/antononcube](https://github.com/antononcube/).
### Videos
[AAv1] Anton Antonov,
["Using Wolfram Engine in Raku sessions"](https://www.youtube.com/watch?v=nWeGkJU3wdM),
(2022),
[YouTube/antononcube](https://www.youtube.com/@AAA4prediction).