pictone 1.0.0

Description:

pictone 1.0.0

PicTone


PicTone is a simple, fun Python CLI tool that converts images into vectorscope audios. It supports tweaking multiple parameters and sampling sequences of images.
Installation
To install PicTone, use pip:
pip install pictone

You'll need Python 3.6 or higher.
Usage
PicTone is a command-line tool that converts the images into WAV files using a sampler with edge detection.
You can tweak its parameters and the way the images are passed to it.
Command Line
The basic command structure for using PicTone is as follows:
pictone -i input_path -o output_path [options]

Input can be either an image or a folder with an ordered sequence of them.
In addition to the required input and output paths, there are some optional arguments to shape the result:

-r --rate: Sample rate for the output audio. Default is 44100 Hz.
-d --depth: Bit depth for audio samples. Can be 8, 16, or 24. Default is 16.
-s --samples: Number of samples the inputs should be forced to last. By default, they'll last the minimum. This is useful if you are converting a sequence (e.g. Forcing to 735 with a rate of 44100 would achieve a ~60 fps visualization).
-a --aspect: Boolean value to decide whether to preserve the input aspect ratio. Defaults to True.

As a Library
If you want to experiment, the sampler can be instantiated and configured by yourself. Although it just outputs a single input raw data:
import cv2
from pictone.sampler import EdgeSampler

image = cv2.imread("image.png", 0)
image_edges = cv2.Canny(image, 100, 200)

edge_threshold = 0
byte_depth = 2

sampler = EdgeSampler(edge_threshold, byte_depth) # Basic params

sampled_data = sampler.sample_frames(image_edges)