From: Ben Beltran <redacted>
Date: Mon, 9 May 2016 05:31:03 +0000 (-0500)
Subject: Updates the README with handy info
X-Git-Tag: 1.0.0~1^2^2
X-Git-Url: https://git.r.bdr.sh/rbdr/tomato-sauce/commitdiff_plain/09ab7e985d46cad6d3c89e37f983e286e9fda2f6?ds=inline;hp=67b718d4042de29991561917fd39597c0a632c6f

Updates the README with handy info
---

diff --git a/README.md b/README.md
index 597eb0f..87f1ae5 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,88 @@
 # tomato-sauce
 Draw stuff via telnet
+
+## How to run
+
+`npm install` and then run ``./bin/server.js`. It will listen on port 9999
+by default.
+
+## Configuration variables
+
+Tomato Sauce can be configured using env variables:
+
+* `TOMATO_SAUCE_PORT`: The port to listen on. Defauts to 9999.
+* `TOMATO_SAUCE_FREQUENCY`: How often it will send a screen in
+  miliseconds. Defaults to 333.
+* `TOMATO_SAUCE_MODULATION`: How much the modulation counter will
+  increase per round. Defaults to 5.
+* `TOMATO_SAUCE_SCREEN_PATH`: Path from which we will load screens. It
+  defaults to `{project_root}/lib/screens`
+* `TOMATO_SAUCE_RENDERER_PATH`: Path from which we will load renderers. It
+  defaults to `{project_root}/lib/renderers`
+
+## Make your own screens
+
+A screen is a function that will receive a modulation value from 0-255,
+the width of the viewport, the height of the viewport, and a renderer
+function, and it returns a string that consists of the commands that
+will be sent to the socket.
+
+  * `TomatoSauce.IScreen(modulation <int>, width <int>, height <int>, renderer
+    <TomatoSauce.IRenderer>) -> payload <string>`
+
+It should output the required commands that telnet needs to move the
+cursor and draw. For convenience, a renderer function is passed so
+calculating color should not be a part of the screen, just moving the
+cursor around and calling specific colors.
+
+## Make your own renderers
+
+The included renderers are wrappers to some common ways of obtaining
+colors in the terminal: ANSI, 256 colors, 24-bit colors, and a fake
+color string that uses incorrect color strings to generate random
+variations.
+
+You can build your own renderer by building a function that receives a
+red, green, and blue component from 0 to 255 and returns the escape
+codes to generate the color.
+
+  * `TomatoSauce.IRenderer(red <int>, green <int>, blue <int>) ->
+    colorString <string>`
+
+## Using as a library
+
+The binary just serves as a wrapper to read configuration, and as a
+bridge to the console. It consumes `lib/tomato_sauce`. All configuration
+is optional, and should be passed as an object on instantiation. The
+instance is an event emitter that will emit a `listening` event with
+the server data, and an `error` event in case something goes wrong.
+
+```
+const TomatoSauce = require('tomato-sauce');
+
+const tomatoSauce = new TomatoSauce(config);
+
+tomatoSauce.on('listening', function () {
+  const address = event.data.server.address();
+  console.log(`Tomato Sauce listening on: ${address.address}:${address.port}`);
+});
+
+tomatoSauce.on('error', function (error) {
+  console.error(error);
+});
+
+tomatoSauce.run();
+
+### Configuration Values
+
+The config object should be a simple object with these keys (All are
+optional.)
+
+  * `port`: The port to listen on (Defaults to 9999)
+  * `frequency`: How often we'll send a new frame in milliseconds
+    (Defaults to 333)
+  * `modulation`: How fast the modulation counter will be increased
+    (Defaults to 5)
+  * `screens`: An array containing the screen functions (Defaults to [])
+  * `renderers`: An array containing the renderer functions (Defaults to [])
+```