Write more documentation and examples

[myselfhimself]

• [x] sync tutorial 1 code + readthedocs wiki counterpart
• [x] tutorial 2: add pixel access and finish stylize example with last image selection
• [x] write more user documentation in the docs/ directory for the readthedocs web reader
• [ ] add more examples in the examples/ directory
• [x] add sphinx gmic directive to generate pictures at build time for most gmic commands
• [x] add pythonic badges to README as the python-related ones here
• [ ] finish Installing page
• [ ] finish Quickstart GmicImage section
• [ ] finish Quickstart numpy section
• [ ] write numpy-specific section showcasing the w,h,d,s <=> d,h,w,s inversion between numpy/PIL and gmic
• [ ] add link to hello world example
• [ ] add link to picsum example

Especially target beginners!! The G'MIC language is not so well known compared to how the G'MIC Qt Widget in graphics software suites.

🍕

[myselfhimself]

Especially write the numpy i/o doc related to the LibreGraphicsMeeting video

[myselfhimself]

Notes for easier remote access between computers:

• classe c++ gmic: is_changed: si true (aucun display ni output deja fait): lance le visualisateur interactif

gmic sp lena,duck,bottles _document_gmic # show all buffer images in a single image

gmic sp lena animate blur,0,10,20 a z # scrollable multilayers for TIFF export for example

gmic https://upload.wikimedia.org/wikipedia/commons/c/cb/2016-09-16_20-30-00_eclipse-lunaire-ann2.gif remove[0] repeat $! blur[$>] {$>*5} stars , done frame 40,3 append_tiles ,4 rotate 90 resize_ratio2d 2100,2970 output flipbook.png

si convert absent: https://pillow.readthedocs.io/en/stable/handbook/image-file-formats.html#reading-sequences

g.run("w[] https://gmic.eu/gallery/img/codesamples_full_1.gif remove[0] repeat $! blur[$>] {$>*5} w[$>] done") ou animate

TUTORIELS / EXEMPLES

faire des tutoriels en se mettant à la place d'utilisateurs de filtres, comme si c'était le premier langage et que les gens ne connaissent pas G'MIC, pour expliquer toute l'API, tous les concepts et types doucement

• [ ] STATIC FILE/BUFFER: exemple statique : appeler un filtre qui m'interesse sur 1 fichier lu par Numpy ou PIL, eg. stylize inutilisé ailleurs

• [ ] VIDEO: exemple : stylize sur toutes les frames d'une video, puis travail frame par frame

• [ ] REAL TIME UI & AUTO UPDATE: UI Python avec points clés pour faire de la segmentation ou déformation http://opensource.graphics/tag/image-segmentation/ http://opensource.graphics/how-to-code-a-nice-user-guided-foreground-extraction-algorithm/

• [ ] TIMED VIDEO FILTERING: denoising fonction du temps des frames d'une vidéo

• [ ] VOLUMETRIC: denoising volumes 3d IRM - cf. David

gmic update pour avoir des nouveaux filtres écrits en pur DSL G'MIC

[myselfhimself]

• [ ] tutorial 3 animated media filtering (gif, avi/mpeg)
• [ ] tutorial 4 on segmentation by clicks and .gmic subfile in pygame

[myselfhimself]

• Now facing build issue due to not enough memory on readthedocs.org https://github.com/readthedocs/readthedocs.org/issues/7775

[myselfhimself]

Memory issue is solved, gmic-py's readthedocs jobs have been kindly moved by the admin team from a 4Gb to a 8Gb ram builder.