Package: scatter-letters
Scatter-LettersA script to write letters with Matplotlib's scatter plots, create transitions from one plot to the other and build a GIF.Why?Because I tought it would be cool.How?It uses OpenCV to create a mask from an image, draw a plot filled with random x/y coordinates, and filter the points inside the mask.Then it uses Matplotlib to draw the plots and transitions and ImageIO to build a gif.How to useInstall:pip install scatter_lettersUse:from scatter_letters import sl
sl.text_to_gif('data_')All parametersfrom scatter_letters import sl

sl.text_to_gif('MAC[MAC]', # text to be converted to gif
            out_path='output', # relative path to save temp files and output
            repeat=True, # repeat first letter at the end
            intensity=40, # more info below*
            rand=True, # True=random points, false= evenly sparced
            gif_name='movie', # name of the output file. -> movie.gif
            n_frames=32, # number of frames in the transition
            bg_color='#ffb400', # background color
            marker='o', # marker style
            marker_color='#2b2300', # marker color 
            marker_size=3, # marker size
            fps=24, # frames per second
            alpha=0.7, # markers opacity
            axis_on=False, # plot spines and grid
            sort_coords=False, # sort points in the transition - options(False, 'x', 'y')
            sort_euclidean=False, # sort by distance (this is very heavy)
            sort_coords_asc=True, # True - sort ascending / False - sort descending
            in_path=None, # for custom input paths
            hold_frames=20,) # hold the complete letter for x frameS

*intensity:  
When plotting random points (rand=True), this is how many times it'll generate 500 points at the start (before applying the mask).  
With randoms, higher intensity means more points.  
When plotting evenly spaced points (rand=False), this is the distance between the points.  
A lower intensity means the points will be closer to each other with even points, so more points are plotted.Other methodsget_masked_data() - Create a list of random x/y coordinates and uses an image/mask to filter them.text_to_data() - Transform a text into a list of lists with the previous method.build_gif() - Uses lists of coordinates to build the scatter plots and the transitions, then save the result in a gif.Creating gif with custom imagesCreate a directory to store the masks, this will be yourin_pathargument;Save a .png file with a mask at images/lettersThe image should be 1000x1000 pixels;The mask should be black with a white background. See the example below;Run text_to_gif() with the name of the images and the parameter in_path pointing to the directory you stored the mask;Files named with more than a character should be refered between brackets;If you want to add just one mask and still use the rest of the letters, you candownload the imagesto the directory you'll be using, add your custom mask, and refer to it with the argumentin_pathExample:- /current_dir
    - /images
        - a.png
        - b.png
        - c.png
        - star.pngtext_to_gif('abc[star]', in_path='images')MoreCheck out the Jupyter Notebook and the Script at theexamples directoryfor more information.You can find more images created with this packagehereDocsGitHubPyPiMedium Article - Basics of GIFs with Pythonâ€™s Matplotlib