# Ciallorize Your Code into ASCII Art!
Ciallorize is a JavaScript library that allows you to convert your bundled JS into ASCII art using a binary mask image.
## To use Ciallorize:
``` bash
npm i ciallorize
```
After installation, prepare your bundled JS file and mask image.
## **Requirements for the bundled JS file:**
- The file must consist of a single line with no `\n` line breaks.
- The file must contain at least 5,000 characters.
- Ciallorize does not guarantee 100% conversion for all JS files. If conversion fails, an error will be thrown, and we apologize for any inconvenience.
## **Requirements for the mask image:**
- Can be in any format supported by sharp.js.
- Does not strictly need to be binary. During processing, the image will first be grayscaled, then binarized using a threshold of 128.
- Black areas represent where you want text to be filled, while white areas represent where you want spaces to be filled.
## How to call Ciallorize:
``` js
const ciallorize = require('ciallorize');
const fs = require('fs');
const code = fs.readFileSync('bundle.js', 'utf-8')
.replaceAll('\n', ''); // No line breaks allowed
ciallorize(
code,
'mask.png', // Path to the mask image
{
// Optional: Represents the width-to-height ratio of each character
fontWidthToHeightRatio: 16/40,
// Optional: Represents compensation for the length of the code string
characterCompensation: 0.95,
}
).then(result=>{
fs.writeFileSync('result.js', result);
})
```
# LICENSE
```
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004
Copyright (C) 2004 Sam Hocevar
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. You just DO WHAT THE FUCK YOU WANT TO.
```