Merge pull request #16 from woltapp/polishing

Polishing

.gitignore

@@ -20,5 +20,6 @@ Python/build/
 *.o
 *.pyc
 
-# Typescript
-typescript/node_modules/
+# Website
+Website/node_modules/
+Website/dist/

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "Python"]
+	path = Python
+	url = https://github.com/creditornot/blurhash-python.git

Algorithm.md

@@ -0,0 +1,66 @@
+# BlurHash Algorithm
+
+## Summary
+
+BlurHash applies a simple [DCT transform](https://en.wikipedia.org/wiki/Discrete_cosine_transform) to the image data,
+keeping only the first few components, and then encodes these components using a base 83 encoding, with a JSON,
+HTML and shell-safe character set. The DC component, which represents the average colour of the image, is stored exactly
+as an sRGB value, for easy use without impleneting the full algorithm. The AC components are encoded lossily.
+
+## Reference implementation
+
+[Simplified Swift decoder implemenation.](Swift/BlurHashDecode.swift)
+
+[Simplified Swift encoder implemenation.](Swift/BlurHashEncode.swift)
+
+## Structure
+
+Here follows an example of a BlurHash string, with the different parts labelled:
+
+    Example: LlMF%n00%#MwS|WCWEM{R*bbWBbH
+    Legend:  12333344....................
+
+1. **Number of components, 1 digit.**
+   
+   For a BlurHash with `nx` components along the X axis and `ny` components along the Y axis, this is equal to `(nx - 1) + (ny - 1) * 9`.
+
+2. **Maximum AC component value, 1 digit.**
+   
+   All AC components are scaled by this value. It represents a floating-point value of `(max + 1) / 166`.
+
+3. **Average colour. 4 digits.**
+   
+   The average colour of the image in sRGB space, encoded as a 24-bit RGB value, with R in the most signficant position. This value can
+   be used directly if you only want the average colour rather than the full DCT-encoded image.
+
+4. **AC components, 2 digits each, `nx * ny - 1` components in total.**
+   
+   The AC components of the DCT transform, ordred by increasing X first, then Y. They  are encoded as three values for `R`, `G` and `B`,
+   each between 0 and 18. They are combined together as `R * 19^2 + G * 19 + B`, for a total range of 0 to 6859.
+   
+   Each value represents a floating-point value between -1 and 1. 0-8 represent negative values, 9 represents zero, and 10-18
+   represent positive values. Positive values are encoded as `((X - 9) / 9) ^ 2`, while negative
+   values are encoded as `-((9 - X) / 9 ) ^ 2`. `^` represents exponentiation. This value is then multiplied by the maximum AC
+   component value, field 2 above.
+
+## Base 83
+
+A custom base 83 encoding is used. Values are encoded individually, using 1 to 4 digits, and concatenated together. Multiple-digit
+values are encoded in big-endian order, with the most signficant digit first.
+
+The character used set is `0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz#$%*+,-.:;=?@[]^_{|}~`.
+
+## Discrete Cosine Transform
+
+To decode a single pixel of output, you loop over the DCT components and calculate a weighted sum of cosine functions. In
+pseudocode, for a normalised pixel position `x`, `y`, with each coordinate ranging from 0 to 1, and components `Cij` ,
+you calculate the following for each of R, G and B:
+
+    foreach j in 0 ... ny - 1
+        foreach i in 0 ... nx - 1
+            value = value + Cij * cos(x * i * pi) * cos(y * j * pi)
+
+The `C00` component is the DC component, while the others are the AC components. The DC component must first be converted
+from sRGB to linear RGB space. AC components are already linear.
+
+Once the R, G and B values have been calculated, the must be converted from linear to your output colourspace, usually sRGB.

C/Makefile

@@ -1,13 +1,8 @@
-blurhash: blurhash_stb.c encode.c encode.h stb_image.h
-	$(CC) -o $@ blurhash_stb.c encode.c
+PROGRAM=blurhash
 
-.PHONY: extensions
-extensions: python ruby
+$(PROGRAM): blurhash_stb.c encode.c encode.h stb_image.h
+	$(CC) -o $@ blurhash_stb.c encode.c -lm
 
-.PHONY: python
-python: blurhash.i encode.h
-	swig -outdir ../Python/ -o ../Python/BlurHash.c -python blurhash.i
-
-.PHONY: ruby
-ruby: blurhash.i encode.h
-	swig -outdir ../Ruby/ -o ../Ruby/BlurHash.c -ruby blurhash.i
+.PHONY: clean
+clean:
+	rm -f $(PROGRAM)

C/Readme.md

@@ -0,0 +1,34 @@
+# BlurHash encoder in portable C
+
+This code implements an encoder for the BlurHash algorithm in C. It can be used to integrate into other language
+using an FFI interface. Currently the Python integration uses this code.
+
+## Usage as a library
+
+Include the `encode.c` and `encode.h` files in your project. They have no external dependencies.
+
+A single file function is defined:
+
+    const char *blurHashForPixels(int xComponents, int yComponents, int width, int height, uint8_t *rgb, size_t bytesPerRow) {
+
+This function returns a string containing the BlurHash. This memory is managed by the function, and you should not free it.
+It will be overwritten on the next call into the function, so be careful!
+
+* `xComponents` - The number of components in the X direction. Must be between 1 and 9. 3 to 5 is usually a good range for this.
+* `yComponents` - The number of components in the Y direction. Must be between 1 and 9. 3 to 5 is usually a good range for this.
+* `width` - The width in pixels of the supplied image.
+* `height` - The height in pixels of the supplied image.
+* `rgb` - A pointer to the pixel data. This is supplied in RGB order, with 3 bytes per pixels.
+* `bytesPerRow` - The number of bytes per row of the RGB pixel data.
+
+## Usage as a command-line tool
+
+You can also build a command-line version to test the encoder. However, note that it uses `stb_image` to load images,
+which is not really security-hardened, so it is **not** recommended to use this version in production on untrusted data!
+Use one of the integrations instead, which use more robust image loading libraries.
+
+Nevertheless, if you want to try it out quickly, simply run:
+
+	$ make
+	$ ./blurhash 4 3 ../Swift/BlurHashTest/pic1.png
+	LaJHjmVu8_~po#smR+a~xaoLWCRj

C/blurhash.i

@@ -1,6 +0,0 @@
-%module BlurHash
-%{
-    #include "../C/encode.c"
-%}
-
-extern const char *blurHashForPixels(int xComponents, int yComponents, int width, int height, uint8_t *rgb, size_t bytesPerRow);

C/blurhash_stb.c

@@ -8,37 +8,37 @@
 const char *blurHashForFile(int xComponents, int yComponents,const char *filename);
 
 int main(int argc, const char **argv) {
-    if(argc != 4) {
-        fprintf(stderr, "Usage: %s x_components y_components imagefile\n", argv[0]);
-        return 1;
-    }
+	if(argc != 4) {
+		fprintf(stderr, "Usage: %s x_components y_components imagefile\n", argv[0]);
+		return 1;
+	}
 
-    int xComponents = atoi(argv[1]);
-    int yComponents = atoi(argv[2]);
-    if(xComponents < 1 || xComponents > 8 || yComponents < 1 || yComponents > 8) {
-        fprintf(stderr, "Component counts must be between 1 and 8.\n");
-        return 1;
-    }
+	int xComponents = atoi(argv[1]);
+	int yComponents = atoi(argv[2]);
+	if(xComponents < 1 || xComponents > 8 || yComponents < 1 || yComponents > 8) {
+		fprintf(stderr, "Component counts must be between 1 and 8.\n");
+		return 1;
+	}
 
-    const char *hash = blurHashForFile(xComponents, yComponents, argv[3]);
-    if(!hash) {
-        fprintf(stderr, "Failed to load image file \"%s\".\n", argv[3]);
-        return 1;
-    }
+	const char *hash = blurHashForFile(xComponents, yComponents, argv[3]);
+	if(!hash) {
+		fprintf(stderr, "Failed to load image file \"%s\".\n", argv[3]);
+		return 1;
+	}
 
-    printf("%s\n", hash);
+	printf("%s\n", hash);
 
-    return 0;
+	return 0;
 }
 
 const char *blurHashForFile(int xComponents, int yComponents,const char *filename) {
-    int width, height, channels;
-    unsigned char *data = stbi_load(filename, &width, &height, &channels, 3);
-    if(!data) return NULL;
+	int width, height, channels;
+	unsigned char *data = stbi_load(filename, &width, &height, &channels, 3);
+	if(!data) return NULL;
 
-    const char *hash = blurHashForPixels(xComponents, yComponents, width, height, data, width * 3);
+	const char *hash = blurHashForPixels(xComponents, yComponents, width, height, data, width * 3);
 
-    stbi_image_free(data);
+	stbi_image_free(data);
 
-    return hash;
+	return hash;
 }

C/encode.c

@@ -3,6 +3,10 @@
 #include <string.h>
 #include <math.h>
 
+#ifndef M_PI
+#define M_PI 3.14159265358979323846
+#endif
+
 static float *multiplyBasisFunction(int xComponent, int yComponent, int width, int height, uint8_t *rgb, size_t bytesPerRow);
 static char *encode_int(int value, int length, char *destination);
 
@@ -13,121 +17,121 @@ static int encodeAC(float r, float g, float b, float maximumValue);
 static float signPow(float value, float exp);
 
 const char *blurHashForPixels(int xComponents, int yComponents, int width, int height, uint8_t *rgb, size_t bytesPerRow) {
-    static char buffer[2 + 4 + (9 * 9 - 1) * 2 + 1];
+	static char buffer[2 + 4 + (9 * 9 - 1) * 2 + 1];
 
-    if(xComponents < 1 || xComponents > 9) return NULL;
-    if(yComponents < 1 || yComponents > 9) return NULL;
+	if(xComponents < 1 || xComponents > 9) return NULL;
+	if(yComponents < 1 || yComponents > 9) return NULL;
 
-    float factors[yComponents][xComponents][3];
-    memset(factors, 0, sizeof(factors));
+	float factors[yComponents][xComponents][3];
+	memset(factors, 0, sizeof(factors));
 
-    for(int y = 0; y < yComponents; y++) {
-        for(int x = 0; x < xComponents; x++) {
-            float *factor = multiplyBasisFunction(x, y, width, height, rgb, bytesPerRow);
-            factors[y][x][0] = factor[0];
-            factors[y][x][1] = factor[1];
-            factors[y][x][2] = factor[2];
-        }
-    }
+	for(int y = 0; y < yComponents; y++) {
+		for(int x = 0; x < xComponents; x++) {
+			float *factor = multiplyBasisFunction(x, y, width, height, rgb, bytesPerRow);
+			factors[y][x][0] = factor[0];
+			factors[y][x][1] = factor[1];
+			factors[y][x][2] = factor[2];
+		}
+	}
 
-    float *dc = factors[0][0];
-    float *ac = dc + 3;
-    int acCount = xComponents * yComponents - 1;
-    char *ptr = buffer;
+	float *dc = factors[0][0];
+	float *ac = dc + 3;
+	int acCount = xComponents * yComponents - 1;
+	char *ptr = buffer;
 
-    int sizeFlag = (xComponents - 1) + (yComponents - 1) * 9;
-    ptr = encode_int(sizeFlag, 1, ptr);
+	int sizeFlag = (xComponents - 1) + (yComponents - 1) * 9;
+	ptr = encode_int(sizeFlag, 1, ptr);
 
-    float maximumValue;
-    if(acCount > 0) {
-        float actualMaximumValue = 0;
-        for(int i = 0; i < acCount * 3; i++) {
-            actualMaximumValue = fmaxf(fabsf(ac[i]), actualMaximumValue);
-        }
+	float maximumValue;
+	if(acCount > 0) {
+		float actualMaximumValue = 0;
+		for(int i = 0; i < acCount * 3; i++) {
+			actualMaximumValue = fmaxf(fabsf(ac[i]), actualMaximumValue);
+		}
 
-        int quantisedMaximumValue = fmaxf(0, fminf(82, floorf(actualMaximumValue * 83 - 0.5)));
-        maximumValue = ((float)quantisedMaximumValue + 1) / 83;
-        ptr = encode_int(quantisedMaximumValue, 1, ptr);
-    } else {
-        maximumValue = 1;
-        ptr = encode_int(0, 1, ptr);
-    }
+		int quantisedMaximumValue = fmaxf(0, fminf(82, floorf(actualMaximumValue * 166 - 0.5)));
+		maximumValue = ((float)quantisedMaximumValue + 1) / 166;
+		ptr = encode_int(quantisedMaximumValue, 1, ptr);
+	} else {
+		maximumValue = 1;
+		ptr = encode_int(0, 1, ptr);
+	}
 
-    ptr = encode_int(encodeDC(dc[0], dc[1], dc[2]), 4, ptr);
+	ptr = encode_int(encodeDC(dc[0], dc[1], dc[2]), 4, ptr);
 
-    for(int i = 0; i < acCount; i++) {
-        ptr = encode_int(encodeAC(ac[i * 3 + 0], ac[i * 3 + 1], ac[i * 3 + 2], maximumValue), 2, ptr);
-    }
+	for(int i = 0; i < acCount; i++) {
+		ptr = encode_int(encodeAC(ac[i * 3 + 0], ac[i * 3 + 1], ac[i * 3 + 2], maximumValue), 2, ptr);
+	}
 
-    *ptr = 0;
+	*ptr = 0;
 
-    return buffer;
+	return buffer;
 }
 
 static float *multiplyBasisFunction(int xComponent, int yComponent, int width, int height, uint8_t *rgb, size_t bytesPerRow) {
-    float r = 0, g = 0, b = 0;
-    float normalisation = (xComponent == 0 && yComponent == 0) ? 1 : 2;
+	float r = 0, g = 0, b = 0;
+	float normalisation = (xComponent == 0 && yComponent == 0) ? 1 : 2;
 
-    for(int y = 0; y < height; y++) {
-        for(int x = 0; x < width; x++) {
-            float basis = cosf(M_PI * xComponent * x / width) * cosf(M_PI * yComponent * y / height);
-            r += basis * sRGBToLinear(rgb[3 * x + 0 + y * bytesPerRow]);
-            g += basis * sRGBToLinear(rgb[3 * x + 1 + y * bytesPerRow]);
-            b += basis * sRGBToLinear(rgb[3 * x + 2 + y * bytesPerRow]);
-        }
-    }
+	for(int y = 0; y < height; y++) {
+		for(int x = 0; x < width; x++) {
+			float basis = cosf(M_PI * xComponent * x / width) * cosf(M_PI * yComponent * y / height);
+			r += basis * sRGBToLinear(rgb[3 * x + 0 + y * bytesPerRow]);
+			g += basis * sRGBToLinear(rgb[3 * x + 1 + y * bytesPerRow]);
+			b += basis * sRGBToLinear(rgb[3 * x + 2 + y * bytesPerRow]);
+		}
+	}
 
-    float scale = normalisation / (width * height);
+	float scale = normalisation / (width * height);
 
-    static float result[3];
-    result[0] = r * scale;
-    result[1] = g * scale;
-    result[2] = b * scale;
+	static float result[3];
+	result[0] = r * scale;
+	result[1] = g * scale;
+	result[2] = b * scale;
 
-    return result;
+	return result;
 }
 
 static int linearTosRGB(float value) {
-    float v = fmaxf(0, fminf(1, value));
+	float v = fmaxf(0, fminf(1, value));
 	if(v <= 0.0031308) return v * 12.92 * 255 + 0.5;
 	else return (1.055 * powf(v, 1 / 2.4) - 0.055) * 255 + 0.5;
 }
 
 static float sRGBToLinear(int value) {
-    float v = (float)value / 255;
+	float v = (float)value / 255;
 	if(v <= 0.04045) return v / 12.92;
 	else return powf((v + 0.055) / 1.055, 2.4);
 }
 
 static int encodeDC(float r, float g, float b) {
-    int roundedR = linearTosRGB(r);
-    int roundedG = linearTosRGB(g);
-    int roundedB = linearTosRGB(b);
-    return (roundedR << 16) + (roundedG << 8) + roundedB;
+	int roundedR = linearTosRGB(r);
+	int roundedG = linearTosRGB(g);
+	int roundedB = linearTosRGB(b);
+	return (roundedR << 16) + (roundedG << 8) + roundedB;
 }
 
 static int encodeAC(float r, float g, float b, float maximumValue) {
-    int quantR = fmaxf(0, fminf(18, floorf(signPow(r / maximumValue, 0.5) * 9 + 9.5)));
-    int quantG = fmaxf(0, fminf(18, floorf(signPow(g / maximumValue, 0.5) * 9 + 9.5)));
-    int quantB = fmaxf(0, fminf(18, floorf(signPow(b / maximumValue, 0.5) * 9 + 9.5)));
+	int quantR = fmaxf(0, fminf(18, floorf(signPow(r / maximumValue, 0.5) * 9 + 9.5)));
+	int quantG = fmaxf(0, fminf(18, floorf(signPow(g / maximumValue, 0.5) * 9 + 9.5)));
+	int quantB = fmaxf(0, fminf(18, floorf(signPow(b / maximumValue, 0.5) * 9 + 9.5)));
 
-    return quantR * 19 * 19 + quantG * 19 + quantB;
+	return quantR * 19 * 19 + quantG * 19 + quantB;
 }
 
 static float signPow(float value, float exp) {
-    return copysignf(powf(fabsf(value), exp), value);
+	return copysignf(powf(fabsf(value), exp), value);
 }
 
 static char characters[83]="0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz#$%*+,-.:;=?@[]^_{|}~";
 
 static char *encode_int(int value, int length, char *destination) {
 	int divisor = 1;
-    for(int i = 0; i < length - 1; i++) divisor *= 83;
+	for(int i = 0; i < length - 1; i++) divisor *= 83;
 
-    for(int i = 0; i < length; i++) {
-        int digit = (value / divisor) % 83;
-        divisor /= 83;
-        *destination++ = characters[digit];
-    }
-    return destination;
+	for(int i = 0; i < length; i++) {
+		int digit = (value / divisor) % 83;
+		divisor /= 83;
+		*destination++ = characters[digit];
+	}
+	return destination;
 }

CodeOfConduct.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+education, socio-economic status, nationality, personal appearance, race,
+religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at dag.agren@wolt.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+

Kotlin/.gitignore

@@ -0,0 +1,40 @@
+# Built application files
+*.apk
+*.ap_
+
+# Files for the Dalvik VM
+*.dex
+
+# Java class files
+*.class
+
+# Generated files
+bin/
+gen/
+
+# Gradle files
+.gradle/
+build/
+
+# Local configuration file (sdk path, etc)
+local.properties
+
+# Proguard folder generated by Eclipse
+proguard/
+
+# Log Files
+*.log
+
+.idea/.workspace
+
+# http://stackoverflow.com/questions/16736856/what-should-be-in-my-gitignore-for-an-android-studio-project
+.gradle
+/local.properties
+/.idea/workspace.xml
+/.idea/libraries
+.DS_Store
+/build
+.idea
+**/*.iml
+*.hprof
+**/*.project

Kotlin/BlurHashDecoder.kt

@@ -1,126 +0,0 @@
-package com.wolt.android.presentation.ui.helpers
-
-import android.graphics.Bitmap
-import android.graphics.Color
-import android.graphics.drawable.BitmapDrawable
-import com.wolt.android.WoltApp
-import java.lang.Math.*
-
-/**
- * Created by mike on 31/07/2017.
- */
-object BlurHashDecoder {
-
-    private val digitCharacters = arrayOf(
-        '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
-        'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J',
-        'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T',
-        'U', 'V', 'W', 'X', 'Y', 'Z', 'a', 'b', 'c', 'd',
-        'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n',
-        'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x',
-        'y', 'z', '#', '$', '%', '*', '+', ',', '-', '.',
-        ':', ';', '=', '?', '@', '[', ']', '^', '_', '{',
-        '|', '}', '~'
-    )
-
-    private val MAX_SIZE = 20
-
-    fun decode(blurHash: String?, width: Int, height: Int, punch: Float): Bitmap? {
-        if (blurHash == null || blurHash.length < 6) {
-            return null
-        }
-
-        val sizeFlag = blurHash[0].toString().decode83()
-        val numY = (sizeFlag / 9) + 1
-        val numX = (sizeFlag % 9) + 1
-
-        val quantisedMaximumValue = blurHash[1].toString().decode83()
-        val maximumValue = (quantisedMaximumValue + 1) / 83
-
-        if (blurHash.length != 4 + 2 * numX * numY) {
-            return null
-        }
-
-        val colors = (0..numX * numY - 1).map { i ->
-            if (i == 0) {
-                val value = blurHash.substring(2, 6).decode83()
-                decodeDc(value)
-            } else {
-                val startIndex = 4 + i * 2
-                val value = blurHash.substring(startIndex, startIndex + 2).decode83()
-                decodeAc(value, maximumValue * punch)
-            }
-        }
-
-        val bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888)
-
-        for (y in 0..height - 1) {
-            for (x in 0..width - 1) {
-                var r = 0f
-                var g = 0f
-                var b = 0f
-
-                for (j in 0..numY - 1) {
-                    for (i in 0..numX - 1) {
-                        val basis = (cos(PI * x * i / width) * cos(PI * y * j / height)).toFloat()
-                        val color = colors[i + j * numX]
-                        r += color[0] * basis
-                        g += color[1] * basis
-                        b += color[2] * basis
-                    }
-                }
-
-                bitmap.setPixel(x, y, Color.rgb(linearToSRgb(r), linearToSRgb(g), linearToSRgb(b)))
-            }
-        }
-
-        return bitmap
-    }
-
-    @Suppress("LoopToCallChain")
-    private fun String.decode83(): Int {
-        var value: Int = 0
-        for (i in 0..this.length - 1) {
-            val digit = digitCharacters.indexOf(this[i])
-            if (digit != -1) {
-                value = value * 83 + digit
-            }
-        }
-        return value
-    }
-
-    private fun decodeDc(value: Int): Array<Float> {
-        val intR = value shr 16
-        val intG = (value shr 8) and 255
-        val intB = value and 255
-        return arrayOf(sRgbToLinear(intR), sRgbToLinear(intG), sRgbToLinear(intB))
-    }
-
-    fun sRgbToLinear(value: Int): Float {
-        val v = value / 255f
-        return if (v <= 0.04045) (v / 12.92f) else (pow((v + 0.055) / 1.055, 2.4).toFloat())
-    }
-
-    private fun decodeAc(value: Int, maximumValue: Float): Array<Float> {
-        val quantR = value / (19 * 19)
-        val quantG = (value / 19) % 19
-        val quantB = value % 19
-        return arrayOf(
-                signPow((quantR - 9) / 9.0, 2.0) * maximumValue,
-                signPow((quantG - 9) / 9.0, 2.0) * maximumValue,
-                signPow((quantB - 9) / 9.0, 2.0) * maximumValue
-        )
-    }
-
-    private fun signPow(value: Double, exp: Double) = copySign(pow(abs(value), exp), value).toFloat()
-
-    private fun linearToSRgb(value: Float): Int {
-        val v = max(0f, min(1f, value))
-        if (v <= 0.0031308f) {
-            return (v * 12.92f * 255 + 0.5f).toInt()
-        } else {
-            return ((1.055f * pow(v.toDouble(), 1 / 2.4) - 0.055f) * 255 + 0.5f).toInt()
-        }
-    }
-
-}

Kotlin/Readme.md

@@ -0,0 +1,3 @@
+# BlurHash in Kotlin, for Android
+
+

Kotlin/build.gradle

@@ -0,0 +1,29 @@
+
+buildscript {
+
+    ext.kotlin_version = '1.3.50'
+
+    repositories {
+        google()
+        jcenter()
+    }
+
+    dependencies {
+        classpath 'com.android.tools.build:gradle:3.5.0'
+        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
+    }
+
+}
+
+allprojects {
+
+    repositories {
+        google()
+        jcenter()
+    }
+
+}
+
+task clean(type: Delete) {
+    delete rootProject.buildDir
+}

Kotlin/demo/build.gradle

@@ -0,0 +1,29 @@
+apply plugin: 'com.android.application'
+apply plugin: 'kotlin-android'
+apply plugin: 'kotlin-android-extensions'
+
+android {
+
+    compileSdkVersion 29
+
+    defaultConfig {
+        applicationId "com.wolt.blurhash"
+        minSdkVersion 14
+        targetSdkVersion 29
+        versionCode 1
+        versionName "1.0"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+
+}
+
+dependencies {
+    implementation project(path: ':lib')
+    implementation 'androidx.appcompat:appcompat:1.1.0'
+}

Kotlin/demo/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

Kotlin/demo/src/main/AndroidManifest.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          package="com.wolt.blurhashapp">
+
+    <application
+        android:allowBackup="true"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/AppTheme">
+        <activity android:name="com.wolt.blurhashapp.MainActivity">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN"/>
+
+                <category android:name="android.intent.category.LAUNCHER"/>
+            </intent-filter>
+        </activity>
+    </application>
+
+</manifest>

Kotlin/demo/src/main/java/com/wolt/blurhashapp/MainActivity.kt

@@ -0,0 +1,24 @@
+package com.wolt.blurhashapp
+
+import android.os.Bundle
+import android.view.View
+import android.widget.EditText
+import android.widget.ImageView
+import android.widget.TextView
+import androidx.appcompat.app.AppCompatActivity
+import com.wolt.blurhashkt.BlurHashDecoder
+
+class MainActivity : AppCompatActivity() {
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        setContentView(R.layout.activity_main)
+        val etInput: EditText = findViewById(R.id.etInput)
+        val ivResult: ImageView = findViewById(R.id.ivResult)
+        findViewById<View>(R.id.tvDecode).setOnClickListener {
+            val bitmap = BlurHashDecoder.decode(etInput.text.toString(), 20, 12)
+            ivResult.setImageBitmap(bitmap)
+        }
+    }
+
+}

Kotlin/demo/src/main/res/drawable-v24/ic_launcher_foreground.xml

@@ -0,0 +1,34 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+        xmlns:aapt="http://schemas.android.com/aapt"
+        android:width="108dp"
+        android:height="108dp"
+        android:viewportHeight="108"
+        android:viewportWidth="108">
+    <path
+        android:fillType="evenOdd"
+        android:pathData="M32,64C32,64 38.39,52.99 44.13,50.95C51.37,48.37 70.14,49.57 70.14,49.57L108.26,87.69L108,109.01L75.97,107.97L32,64Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1">
+        <aapt:attr name="android:fillColor">
+            <gradient
+                android:endX="78.5885"
+                android:endY="90.9159"
+                android:startX="48.7653"
+                android:startY="61.0927"
+                android:type="linear">
+                <item
+                    android:color="#44000000"
+                    android:offset="0.0"/>
+                <item
+                    android:color="#00000000"
+                    android:offset="1.0"/>
+            </gradient>
+        </aapt:attr>
+    </path>
+    <path
+        android:fillColor="#FFFFFF"
+        android:fillType="nonZero"
+        android:pathData="M66.94,46.02L66.94,46.02C72.44,50.07 76,56.61 76,64L32,64C32,56.61 35.56,50.11 40.98,46.06L36.18,41.19C35.45,40.45 35.45,39.3 36.18,38.56C36.91,37.81 38.05,37.81 38.78,38.56L44.25,44.05C47.18,42.57 50.48,41.71 54,41.71C57.48,41.71 60.78,42.57 63.68,44.05L69.11,38.56C69.84,37.81 70.98,37.81 71.71,38.56C72.44,39.3 72.44,40.45 71.71,41.19L66.94,46.02ZM62.94,56.92C64.08,56.92 65,56.01 65,54.88C65,53.76 64.08,52.85 62.94,52.85C61.8,52.85 60.88,53.76 60.88,54.88C60.88,56.01 61.8,56.92 62.94,56.92ZM45.06,56.92C46.2,56.92 47.13,56.01 47.13,54.88C47.13,53.76 46.2,52.85 45.06,52.85C43.92,52.85 43,53.76 43,54.88C43,56.01 43.92,56.92 45.06,56.92Z"
+        android:strokeColor="#00000000"
+        android:strokeWidth="1"/>
+</vector>

Kotlin/demo/src/main/res/drawable/bg_blue_rounded_rect_8.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<shape xmlns:android="http://schemas.android.com/apk/res/android"
+       android:shape="rectangle">
+    <solid android:color="#ff009de0"/>
+    <corners android:radius="8dp"/>
+</shape>

Kotlin/demo/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,171 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="108dp"
+    android:height="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108">
+    <path
+        android:fillColor="#26A69A"
+        android:pathData="M0,0h108v108h-108z"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M9,0L9,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,0L19,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,0L29,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,0L39,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,0L49,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,0L59,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,0L69,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,0L79,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M89,0L89,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M99,0L99,108"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,9L108,9"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,19L108,19"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,29L108,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,39L108,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,49L108,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,59L108,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,69L108,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,79L108,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,89L108,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M0,99L108,99"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,29L89,29"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,39L89,39"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,49L89,49"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,59L89,59"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,69L89,69"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M19,79L89,79"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M29,19L29,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M39,19L39,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M49,19L49,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M59,19L59,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M69,19L69,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+    <path
+        android:fillColor="#00000000"
+        android:pathData="M79,19L79,89"
+        android:strokeColor="#33FFFFFF"
+        android:strokeWidth="0.8"/>
+</vector>

Kotlin/demo/src/main/res/layout/activity_main.xml

@@ -0,0 +1,43 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:padding="24dp">
+
+    <EditText
+        android:id="@+id/etInput"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_gravity="center_horizontal"
+        android:gravity="center_horizontal"
+        android:hint="@string/hint_blurhash"
+        android:inputType="text"
+        android:singleLine="true"
+        android:text="LEHV6nWB2yk8pyo0adR*.7kCMdnj"
+        android:textColor="@color/colorAccent" />
+
+    <TextView
+        android:id="@+id/tvDecode"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_gravity="center_horizontal"
+        android:layout_marginTop="12dp"
+        android:background="@color/colorPrimary"
+        android:elevation="8dp"
+        android:paddingStart="12dp"
+        android:paddingTop="8dp"
+        android:paddingEnd="12dp"
+        android:paddingBottom="8dp"
+        android:text="@string/title_button_decode"
+        android:textColor="@color/colorAccent"
+        android:textSize="16sp" />
+
+    <ImageView
+        android:id="@+id/ivResult"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="24dp"
+        android:adjustViewBounds="true" />
+
+</LinearLayout>

Kotlin/demo/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>

Kotlin/demo/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@drawable/ic_launcher_foreground"/>
+</adaptive-icon>

Kotlin/demo/src/main/res/values/colors.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="colorPrimary">#29b6f6</color>
+    <color name="colorPrimaryDark">#0086c3</color>
+    <color name="colorAccent">#444444</color>
+</resources>
+

Kotlin/demo/src/main/res/values/strings.xml

@@ -0,0 +1,5 @@
+<resources>
+    <string name="app_name">BlurHash</string>
+    <string name="hint_blurhash">BlurHash string</string>
+    <string name="title_button_decode">Decode!</string>
+</resources>

Kotlin/demo/src/main/res/values/styles.xml

@@ -0,0 +1,9 @@
+<resources>
+
+    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+        <item name="colorPrimary">@color/colorPrimary</item>
+        <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
+        <item name="colorAccent">@color/colorAccent</item>
+    </style>
+
+</resources>

Kotlin/gradle.properties

@@ -0,0 +1,15 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+android.enableJetifier=true
+android.useAndroidX=true
+org.gradle.jvmargs=-Xmx1536m
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. More details, visit
+# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
+# org.gradle.parallel=true

Kotlin/gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+#Mon Jul 01 10:02:38 EEST 2019
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-5.4.1-all.zip

Kotlin/gradlew

@@ -0,0 +1,172 @@
+#!/usr/bin/env sh
+
+##############################################################################
+##
+##  Gradle start up script for UN*X
+##
+##############################################################################
+
+# Attempt to set APP_HOME
+# Resolve links: $0 may be a link
+PRG="$0"
+# Need this for relative symlinks.
+while [ -h "$PRG" ] ; do
+    ls=`ls -ld "$PRG"`
+    link=`expr "$ls" : '.*-> \(.*\)$'`
+    if expr "$link" : '/.*' > /dev/null; then
+        PRG="$link"
+    else
+        PRG=`dirname "$PRG"`"/$link"
+    fi
+done
+SAVED="`pwd`"
+cd "`dirname \"$PRG\"`/" >/dev/null
+APP_HOME="`pwd -P`"
+cd "$SAVED" >/dev/null
+
+APP_NAME="Gradle"
+APP_BASE_NAME=`basename "$0"`
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS=""
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD="maximum"
+
+warn () {
+    echo "$*"
+}
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+}
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "`uname`" in
+  CYGWIN* )
+    cygwin=true
+    ;;
+  Darwin* )
+    darwin=true
+    ;;
+  MINGW* )
+    msys=true
+    ;;
+  NONSTOP* )
+    nonstop=true
+    ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD="$JAVA_HOME/jre/sh/java"
+    else
+        JAVACMD="$JAVA_HOME/bin/java"
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD="java"
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
+    MAX_FD_LIMIT=`ulimit -H -n`
+    if [ $? -eq 0 ] ; then
+        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
+            MAX_FD="$MAX_FD_LIMIT"
+        fi
+        ulimit -n $MAX_FD
+        if [ $? -ne 0 ] ; then
+            warn "Could not set maximum file descriptor limit: $MAX_FD"
+        fi
+    else
+        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
+    fi
+fi
+
+# For Darwin, add options to specify how the application appears in the dock
+if $darwin; then
+    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
+fi
+
+# For Cygwin, switch paths to Windows format before running java
+if $cygwin ; then
+    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
+    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
+    JAVACMD=`cygpath --unix "$JAVACMD"`
+
+    # We build the pattern for arguments to be converted via cygpath
+    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
+    SEP=""
+    for dir in $ROOTDIRSRAW ; do
+        ROOTDIRS="$ROOTDIRS$SEP$dir"
+        SEP="|"
+    done
+    OURCYGPATTERN="(^($ROOTDIRS))"
+    # Add a user-defined pattern to the cygpath arguments
+    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
+        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
+    fi
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    i=0
+    for arg in "$@" ; do
+        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
+        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
+
+        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
+            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
+        else
+            eval `echo args$i`="\"$arg\""
+        fi
+        i=$((i+1))
+    done
+    case $i in
+        (0) set -- ;;
+        (1) set -- "$args0" ;;
+        (2) set -- "$args0" "$args1" ;;
+        (3) set -- "$args0" "$args1" "$args2" ;;
+        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
+        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
+        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
+        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
+        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
+        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
+    esac
+fi
+
+# Escape application args
+save () {
+    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
+    echo " "
+}
+APP_ARGS=$(save "$@")
+
+# Collect all arguments for the java command, following the shell quoting and substitution rules
+eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
+
+# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
+if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
+  cd "$(dirname "$0")"
+fi
+
+exec "$JAVACMD" "$@"

Kotlin/gradlew.bat

@@ -0,0 +1,84 @@
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS=
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto init
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto init
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:init
+@rem Get command-line arguments, handling Windows variants
+
+if not "%OS%" == "Windows_NT" goto win9xME_args
+
+:win9xME_args
+@rem Slurp the command line arguments.
+set CMD_LINE_ARGS=
+set _SKIP=2
+
+:win9xME_args_slurp
+if "x%~1" == "x" goto execute
+
+set CMD_LINE_ARGS=%*
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

Kotlin/lib/build.gradle

@@ -0,0 +1,30 @@
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android-extensions'
+apply plugin: 'kotlin-android'
+
+android {
+
+    compileSdkVersion 29
+
+    defaultConfig {
+        minSdkVersion 14
+        targetSdkVersion 29
+        versionCode 1
+        versionName "1.0"
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
+        }
+    }
+
+}
+
+dependencies {
+    implementation fileTree(dir: 'libs', include: ['*.jar'])
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version"
+}

Kotlin/lib/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

Kotlin/lib/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest package="com.wolt.blurhashkt" />

Kotlin/lib/src/main/java/com/wolt/blurhashkt/BlurHashDecoder.kt

@@ -0,0 +1,122 @@
+package com.wolt.blurhashkt
+
+import android.graphics.Bitmap
+import android.graphics.Color
+import kotlin.math.PI
+import kotlin.math.cos
+import kotlin.math.pow
+import kotlin.math.withSign
+
+object BlurHashDecoder {
+
+    fun decode(blurHash: String?, width: Int, height: Int, punch: Float = 1f): Bitmap? {
+        if (blurHash == null || blurHash.length < 6) {
+            return null
+        }
+        val numCompEnc = decode83(blurHash, 0, 1)
+        val numCompX = (numCompEnc % 9) + 1
+        val numCompY = (numCompEnc / 9) + 1
+        if (blurHash.length != 4 + 2 * numCompX * numCompY) {
+            return null
+        }
+        val maxAcEnc = decode83(blurHash, 1, 2)
+        val maxAc = (maxAcEnc + 1) / 166f
+        val colors = Array(numCompX * numCompY) { i ->
+            if (i == 0) {
+                val colorEnc = decode83(blurHash, 2, 6)
+                decodeDc(colorEnc)
+            } else {
+                val from = 4 + i * 2
+                val colorEnc = decode83(blurHash, from, from + 2)
+                decodeAc(colorEnc, maxAc * punch)
+            }
+        }
+        return composeBitmap(width, height, numCompX, numCompY, colors)
+    }
+
+    private fun decode83(str: String, from: Int = 0, to: Int = str.length): Int {
+        var result = 0
+        for (i in from until to) {
+            val index = charMap[str[i]] ?: -1
+            if (index != -1) {
+                result = result * 83 + index
+            }
+        }
+        return result
+    }
+
+    private fun decodeDc(colorEnc: Int): FloatArray {
+        val r = colorEnc shr 16
+        val g = (colorEnc shr 8) and 255
+        val b = colorEnc and 255
+        return floatArrayOf(srgbToLinear(r), srgbToLinear(g), srgbToLinear(b))
+    }
+
+    private fun srgbToLinear(colorEnc: Int): Float {
+        val v = colorEnc / 255f
+        return if (v <= 0.04045f) {
+            (v / 12.92f)
+        } else {
+            ((v + 0.055f) / 1.055f).pow(2.4f)
+        }
+    }
+
+    private fun decodeAc(value: Int, maxAc: Float): FloatArray {
+        val r = value / (19 * 19)
+        val g = (value / 19) % 19
+        val b = value % 19
+        return floatArrayOf(
+                signedPow2((r - 9) / 9.0f) * maxAc,
+                signedPow2((g - 9) / 9.0f) * maxAc,
+                signedPow2((b - 9) / 9.0f) * maxAc
+        )
+    }
+
+    private fun signedPow2(value: Float) = value.pow(2f).withSign(value)
+
+    private fun composeBitmap(
+            width: Int, height: Int,
+            numCompX: Int, numCompY: Int,
+            colors: Array<FloatArray>
+    ): Bitmap {
+        val bitmap = Bitmap.createBitmap(width, height, Bitmap.Config.ARGB_8888)
+        for (y in 0 until height) {
+            for (x in 0 until width) {
+                var r = 0f
+                var g = 0f
+                var b = 0f
+                for (j in 0 until numCompY) {
+                    for (i in 0 until numCompX) {
+                        val basis = (cos(PI * x * i / width) * cos(PI * y * j / height)).toFloat()
+                        val color = colors[j * numCompX + i]
+                        r += color[0] * basis
+                        g += color[1] * basis
+                        b += color[2] * basis
+                    }
+                }
+                bitmap.setPixel(x, y, Color.rgb(linearToSrgb(r), linearToSrgb(g), linearToSrgb(b)))
+            }
+        }
+        return bitmap
+    }
+
+    private fun linearToSrgb(value: Float): Int {
+        val v = value.coerceIn(0f, 1f)
+        return if (v <= 0.0031308f) {
+            (v * 12.92f * 255f + 0.5f).toInt()
+        } else {
+            ((1.055f * v.pow(1 / 2.4f) - 0.055f) * 255 + 0.5f).toInt()
+        }
+    }
+
+    private val charMap = listOf(
+            '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F', 'G',
+            'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X',
+            'Y', 'Z', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o',
+            'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '#', '$', '%', '*', '+', ',',
+            '-', '.', ':', ';', '=', '?', '@', '[', ']', '^', '_', '{', '|', '}', '~'
+    )
+            .mapIndexed { i, c -> c to i }
+            .toMap()
+
+}

Kotlin/settings.gradle

@@ -0,0 +1 @@
+include ':demo', ':lib'

Python

@@ -0,0 +1 @@
+Subproject commit 7469c813ea646ac022ca2879de76cc6e453237a1

Python/BlurHash.py

@@ -1,108 +0,0 @@
-# This file was automatically generated by SWIG (http://www.swig.org).
-# Version 3.0.12
-#
-# Do not make changes to this file unless you know what you are doing--modify
-# the SWIG interface file instead.
-
-from sys import version_info as _swig_python_version_info
-if _swig_python_version_info >= (2, 7, 0):
-    def swig_import_helper():
-        import importlib
-        pkg = __name__.rpartition('.')[0]
-        mname = '.'.join((pkg, '_BlurHash')).lstrip('.')
-        try:
-            return importlib.import_module(mname)
-        except ImportError:
-            return importlib.import_module('_BlurHash')
-    _BlurHash = swig_import_helper()
-    del swig_import_helper
-elif _swig_python_version_info >= (2, 6, 0):
-    def swig_import_helper():
-        from os.path import dirname
-        import imp
-        fp = None
-        try:
-            fp, pathname, description = imp.find_module('_BlurHash', [dirname(__file__)])
-        except ImportError:
-            import _BlurHash
-            return _BlurHash
-        try:
-            _mod = imp.load_module('_BlurHash', fp, pathname, description)
-        finally:
-            if fp is not None:
-                fp.close()
-        return _mod
-    _BlurHash = swig_import_helper()
-    del swig_import_helper
-else:
-    import _BlurHash
-del _swig_python_version_info
-
-try:
-    _swig_property = property
-except NameError:
-    pass  # Python < 2.2 doesn't have 'property'.
-
-try:
-    import builtins as __builtin__
-except ImportError:
-    import __builtin__
-
-def _swig_setattr_nondynamic(self, class_type, name, value, static=1):
-    if (name == "thisown"):
-        return self.this.own(value)
-    if (name == "this"):
-        if type(value).__name__ == 'SwigPyObject':
-            self.__dict__[name] = value
-            return
-    method = class_type.__swig_setmethods__.get(name, None)
-    if method:
-        return method(self, value)
-    if (not static):
-        if _newclass:
-            object.__setattr__(self, name, value)
-        else:
-            self.__dict__[name] = value
-    else:
-        raise AttributeError("You cannot add attributes to %s" % self)
-
-
-def _swig_setattr(self, class_type, name, value):
-    return _swig_setattr_nondynamic(self, class_type, name, value, 0)
-
-
-def _swig_getattr(self, class_type, name):
-    if (name == "thisown"):
-        return self.this.own()
-    method = class_type.__swig_getmethods__.get(name, None)
-    if method:
-        return method(self)
-    raise AttributeError("'%s' object has no attribute '%s'" % (class_type.__name__, name))
-
-
-def _swig_repr(self):
-    try:
-        strthis = "proxy of " + self.this.__repr__()
-    except __builtin__.Exception:
-        strthis = ""
-    return "<%s.%s; %s >" % (self.__class__.__module__, self.__class__.__name__, strthis,)
-
-try:
-    _object = object
-    _newclass = 1
-except __builtin__.Exception:
-    class _object:
-        pass
-    _newclass = 0
-
-
-def blurHashForFile(xComponents, yComponents, filename):
-    return _BlurHash.blurHashForFile(xComponents, yComponents, filename)
-blurHashForFile = _BlurHash.blurHashForFile
-
-def blurHashForPixels(xComponents, yComponents, width, height, rgb, bytesPerRow):
-    return _BlurHash.blurHashForPixels(xComponents, yComponents, width, height, rgb, bytesPerRow)
-blurHashForPixels = _BlurHash.blurHashForPixels
-# This file is compatible with both classic and new-style classes.
-
-

Python/setup.py

@@ -1,17 +0,0 @@
-#!/usr/bin/env python
-
-"""
-setup.py file for BlurHash
-"""
-
-from distutils.core import setup, Extension
-
-module = Extension('_BlurHash', sources=['BlurHash.c'])
-
-setup (name = 'BlurHash',
-       version = '1.0',
-       author      = "Dag Agren",
-       description = """Create tiny image placeholders encoded as strings""",
-       ext_modules = [module],
-       py_modules = ["BlurHash"],
-       )

Readme.md

@@ -0,0 +1,179 @@
+# [BlurHash](http://blurha.sh)
+
+BlurHash is a compact representation of a placeholder for an image.
+
+## Why would you want this?
+
+Does your designer cry every time you load their beautifully designed screen, and it is full of empty boxes because all the
+images have not loaded yet? Does your database engineer cry when you want to solve this by trying to cram little thumbnail
+images into your data to show as placeholders?
+
+BlurHash will solve your problems! How? Like this:
+
+<img src="Media/WhyBlurHash.png" width="600">
+
+You can also see nice examples and try it out yourself at [blurha.sh](http://blurha.sh/)!
+
+## How does it work?
+
+In short, BlurHash takes an image, and gives you a short string (only 20-30 characters!) that represents the placeholder for this
+image. You do this on the backend of your service, and store the string along with the image. When you send data to your
+client, you send both the URL to the image, and the BlurHash string. Your client then takes the string, and decodes it into an
+image that it shows while the real image is loading over the network. The string is short enough that it comfortably fits into
+whatever data format you use. For instance, it can easily be added as a field in a JSON object.
+
+In summary:
+
+<img src="Media/HowItWorks1.jpg" width="250">&nbsp;&nbsp;&nbsp;<img src="Media/HowItWorks2.jpg" width="250">
+
+Want to know all the gory technical details? Read the [algorithm description](Algorithm.md).
+
+Implementing the algorithm is actually quite easy! Implementations are short and easily ported to your favourite language or
+platform.
+
+## Implementations
+
+So far, we have created these implementations:
+
+* [C](C) - An encoder implemenation in portable C code.
+* [Swift](Swift) - Encoder and decoder implementations, and a larger library offering advanced features.
+  There is also an example app to play around with the algorithm.
+* [Kotlin](Kotlin) - A decoder implementation for Android.
+* [TypeScript](TypeScript) - Encoder and decoder implementations, and an example page to test.
+* [Python](https://github.com/woltapp/blurhash-python) - Integration of the C encoder code into Python.
+
+These cover our use cases, but could probably use polishing, extending and improving. There are also these third party implementations that we know of:
+
+* [Pure Python](https://github.com/halcy/blurhash-python) - Implementation of both the encoder and decoder in pure Python.
+* [One version in Go](https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=1&cad=rja&uact=8&ved=2ahUKEwjJ9ueT9pXjAhXRw6YKHfrGBNcQFjAAegQIABAB&url=https%3A%2F%2Fgithub.com%2Fbbrks%2Fgo-blurhash&usg=AOvVaw2alZSHvT7HbublYbpNn9fY), and [another version in Go](https://github.com/buckket/go-blurhash).
+* [PHP](https://github.com/kornrunner/php-blurhash) - Encoder and decoder implementations in pure PHP.
+* [Java](https://github.com/hsch/blurhash-java) - Encoder implementation in Java.
+* [Clojure](https://github.com/siili-core/blurhash) - Encoder and decoder implementations in Clojure.
+* [Nim](https://github.com/SolitudeSF/blurhash) - Encoder and decoder implementation in pure Nim.
+* [Rust and WebAssembly](https://github.com/fpapado/blurhash-rust-wasm) - Encoder and decoder implementations in Rust. Distributed as both native Rust and WebAssembly packages.
+
+Perhaps you'd like to help extend this list? Which brings us to...
+
+## Contributing
+
+We'd love contributions! The algorithm is [very simple](Algorithm.md) - less than two hundred lines of code - and can easily be
+ported to your platform of choice. And having support for more platforms would be wonderful! So, Java decoder? Golang encoder?
+Haskell? Rust? We want them all!
+
+We will also try to tag any issues on our [issue tracker](https://github.com/woltapp/blurhash/issues) that we'd love help with, so
+if you just want to dip in, go have a look.
+
+You can file a pull request with us, or you can start your own repo and project if you want to run everything yourself, we don't mind.
+
+If you do want to contribute to this project, we have a [code of conduct](CodeOfConduct.md).
+
+## Users
+
+Who uses BlurHash? Here are some projects we know about:
+
+* [Wolt](http://wolt.com/) - We are of course using it ourselves. BlurHashes are used in the mobile clients on iOS and Android, as well as on the web, as placeholders during image loading.
+* [Mastodon](https://github.com/tootsuite/mastodon) - The Mastodon decentralised social media network uses BlurHashes both as loading placeholders, as well as for hiding media marked as sensitive.
+
+## Good Questions
+
+### How fast is encoding? Decoding?
+
+These implementations are not very optimised. Running them on very large images can be a bit slow. The performance of
+the encoder and decoder are about the same for the same input or output size, so decoding very large placeholders, especially
+on your UI thread, can also be a bit slow.
+
+However! The trick to using the algorithm efficiently is to not run it on full-sized data. The fine detail of an image is all thrown away,
+so you should scale your images down before running BlurHash on them. If you are creating thumbnails, run BlurHash on those
+instead of the full images.
+
+Similarly, when displaying the placeholders, very small images work very well when scaled up. We usually decode placeholders
+that are 32 or even 20 pixels wide, and then let the UI layer scale them up, which is indistinguishable from decoding them at full size.
+
+### How do I pick the number of X and Y components?
+
+It depends a bit on taste. The more components you pick, the more information is retained in the placeholder, but the longer
+the BlurHash string will be. Also, it doesn't always look good with too many components. We usually go with 4 by 3, which
+seems to strike a nice balance.
+
+However, you should adjust the number of components depending on the aspect ratio of your images. For instance, very wide
+images should have more X components and fewer Y components.
+
+The Swift example project contains a test app where you can play around with the parameters and see the results.
+
+### What is the `punch` parameter in some of these implementations?
+
+It is a parameter that adjusts the contrast on the decoded image. 1 means normal, smaller values will make the effect more subtle,
+and larger values will make it stronger. This is basically a design parameter, which lets you adjust the look.
+
+Technically, what it does is scale the AC components up or down.
+
+### Is this only useful as an image loading placeholder?
+
+Well, that is what it was designed for originally, but it turns out to be useful for a few other things:
+
+* Masking images without having to use expensive blurs - [Mastodon](http://github.com/tootsuite/mastodon) uses it for this.
+* The data representation makes it quite easy to extract colour averages of the image for different areas. You can easily find approximations of things like the average colour of the top edge of the image, or of a corner. There is some code in the Swift BlurHashKit implementation to experiment with this. Also, the average colour of the entire image is just the DC component and can be decoded even without implementing any of the more complicated DCT stuff.
+* We have been meaning to try to implement tinted drop shadows for UI elements by using the BlurHash and extending the borders. Haven't actually had time to implement this yet though.
+
+### Why base 83?
+
+First, 83 seems to be about how many low-ASCII characters you can find that are safe for use in all of JSON, HTML and shells.
+
+Secondly, 83 * 83 is very close to, and a little more than, 19 * 19 * 19, making it ideal for encoding three AC components in two
+characters.
+
+### What about using the full Unicode character set to get a more efficient encoding?
+
+We haven't looked into how much overehead UTF-8 encoding would introduce versus base 83 in single-byte characters, but
+the encoding and decoding would probably be a lot more complicated, so in the spirit of minimalism BlurHash uses the simpler
+option. It might also be awkward to copy-paste, depending on OS capabilities.
+
+If you think it can be done and is worth it, though, do make your own version and show us! We'd love to see it in action.
+
+### What about other basis representations than DCT?
+
+This is something we'd *love* to try. The DCT looks quite ugly when you increase the number of components, probably because
+the shape of the basis functions becomes too visible. Using a different basis with more aesthetically pleasing shape might be
+a big win.
+
+However, we have not managed come up with one. Some experimenting with a [Fourier-Bessel base](https://en.wikipedia.org/wiki/Fourier–Bessel_series),
+targeted at images that are going to be cropped into circles has been done, but without much success. Here again we'd love
+to see what you can come up with!
+
+## Authors
+
+* [Dag Ågren](https://github.com/DagAgren) - Original algorithm design, Swift and C implementations
+* [Mykhailo Shchurov](https://github.com/shchurov) - Kotlin decoder implementation
+* [Hang Duy Khiem](https://github.com/hangduykhiem) - Android demo app
+* [Olli Mahlamäki](https://github.com/omahlama) - TypeScript decoder and encoder implementations
+* [Atte Lautanala](https://github.com/lautat) - Python integration
+* [Lorenz Diener](https://github.com/halcy) - Pure Python implementation
+* [Boris Momčilović](https://github.com/kornrunner) - Pure PHP implementation
+* [Hendrik Schnepel](https://github.com/hsch) - Java encoder implementation
+* [Tuomo Virolainen](https://github.com/tvirolai) - Clojure implementation
+* [Fotis Papadogeorgopoulos](https://github.com/fpapado) - Rust and WebAssembly implementation
+* _Your name here?_
+
+## License
+
+All of these implemenations are licensed under the MIT license:
+
+Copyright (c) 2018 Wolt Enterprises
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Ruby/extconf.rb

@@ -1,2 +0,0 @@
-require 'mkmf'
-create_makefile('BlurHash')

Swift/BlurHash.xcodeproj/project.pbxproj

@@ -22,6 +22,18 @@
 		1B19DF602015E72C00D8FCD7 /* pic6.png in Resources */ = {isa = PBXBuildFile; fileRef = 1B19DF5F2015E72B00D8FCD7 /* pic6.png */; };
 		1B2BA1CA1F0E5EE3006057C1 /* encode.c in Sources */ = {isa = PBXBuildFile; fileRef = 1B2BA1C81F0E5EE3006057C1 /* encode.c */; };
 		1B2BA1CB1F0E5EEA006057C1 /* blurhash_stb.c in Sources */ = {isa = PBXBuildFile; fileRef = 1B2BA1C41F0E5ED6006057C1 /* blurhash_stb.c */; };
+		1B6C71FD2272453D000D3BB1 /* BlurHash.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA60701FF40A2F00E42DD7 /* BlurHash.swift */; };
+		1B6C71FE2272453D000D3BB1 /* FromString.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA60741FF40AF200E42DD7 /* FromString.swift */; };
+		1B6C71FF2272453D000D3BB1 /* ToString.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA60721FF40AEA00E42DD7 /* ToString.swift */; };
+		1B6C72002272453D000D3BB1 /* FromUIImage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA60781FF40C5800E42DD7 /* FromUIImage.swift */; };
+		1B6C72012272453D000D3BB1 /* ToUIImage.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA60761FF40C4C00E42DD7 /* ToUIImage.swift */; };
+		1B6C72022272453D000D3BB1 /* Generation.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BC34D7F20098E2F00A17481 /* Generation.swift */; };
+		1B6C72032272453D000D3BB1 /* TupleMaths.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BC34D7D20098E1500A17481 /* TupleMaths.swift */; };
+		1B6C72042272453D000D3BB1 /* ColourSpace.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA607C1FF422AE00E42DD7 /* ColourSpace.swift */; };
+		1B6C72052272453D000D3BB1 /* StringCoding.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA607A1FF40D8900E42DD7 /* StringCoding.swift */; };
+		1B6C72062272453D000D3BB1 /* ColourProbes.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BDE56D02011EC5F00569DCB /* ColourProbes.swift */; };
+		1B83DED122D88D1500CAA12F /* EscapeSequences.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1B83DED022D88D1500CAA12F /* EscapeSequences.swift */; };
+		1B83DED222D88D1500CAA12F /* EscapeSequences.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1B83DED022D88D1500CAA12F /* EscapeSequences.swift */; };
 		1BAA606D1FF40A0800E42DD7 /* BlurHashEncode.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1B49CD261EC47243006F8E7D /* BlurHashEncode.swift */; };
 		1BAA606E1FF40A0B00E42DD7 /* BlurHashDecode.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1B49CD281EC4724C006F8E7D /* BlurHashDecode.swift */; };
 		1BAA60711FF40A2F00E42DD7 /* BlurHash.swift in Sources */ = {isa = PBXBuildFile; fileRef = 1BAA60701FF40A2F00E42DD7 /* BlurHash.swift */; };
@@ -69,6 +81,15 @@
 			);
 			runOnlyForDeploymentPostprocessing = 1;
 		};
+		1B6C71F42272451E000D3BB1 /* CopyFiles */ = {
+			isa = PBXCopyFilesBuildPhase;
+			buildActionMask = 2147483647;
+			dstPath = "include/$(PRODUCT_NAME)";
+			dstSubfolderSpec = 16;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
 /* End PBXCopyFilesBuildPhase section */
 
 /* Begin PBXFileReference section */
@@ -85,21 +106,34 @@
 		1B0A25271EC5EAB000F25F08 /* pic4.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = pic4.png; sourceTree = "<group>"; };
 		1B0A25281EC5EAB000F25F08 /* pic5.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = pic5.png; sourceTree = "<group>"; };
 		1B19DF5F2015E72B00D8FCD7 /* pic6.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = pic6.png; sourceTree = "<group>"; };
+		1B1B249320C13E9700D8EF03 /* LICENSE */ = {isa = PBXFileReference; lastKnownFileType = text; path = LICENSE; sourceTree = "<group>"; };
+		1B1B249420C13E9700D8EF03 /* dev-requirements.txt */ = {isa = PBXFileReference; lastKnownFileType = text; path = "dev-requirements.txt"; sourceTree = "<group>"; };
+		1B1B249620C13E9700D8EF03 /* pic2.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = pic2.png; sourceTree = "<group>"; };
+		1B1B249720C13E9700D8EF03 /* pic2_bw.png */ = {isa = PBXFileReference; lastKnownFileType = image.png; path = pic2_bw.png; sourceTree = "<group>"; };
+		1B1B249820C13E9700D8EF03 /* test_encode.py */ = {isa = PBXFileReference; lastKnownFileType = text.script.python; path = test_encode.py; sourceTree = "<group>"; };
+		1B1B249920C13E9700D8EF03 /* MANIFEST.in */ = {isa = PBXFileReference; lastKnownFileType = text; path = MANIFEST.in; sourceTree = "<group>"; };
+		1B1B249A20C13E9700D8EF03 /* README.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = README.md; sourceTree = "<group>"; };
+		1B1B249B20C13E9700D8EF03 /* setup.py */ = {isa = PBXFileReference; lastKnownFileType = text.script.python; path = setup.py; sourceTree = "<group>"; };
+		1B1B249D20C13E9700D8EF03 /* tox.ini */ = {isa = PBXFileReference; lastKnownFileType = text; path = tox.ini; sourceTree = "<group>"; };
+		1B1B249E20C13E9700D8EF03 /* setup.cfg */ = {isa = PBXFileReference; lastKnownFileType = text; path = setup.cfg; sourceTree = "<group>"; };
+		1B1B24FF20C13E9700D8EF03 /* config.yml */ = {isa = PBXFileReference; lastKnownFileType = text; path = config.yml; sourceTree = "<group>"; };
+		1B1B250220C13E9700D8EF03 /* __init__.py */ = {isa = PBXFileReference; lastKnownFileType = text.script.python; path = __init__.py; sourceTree = "<group>"; };
+		1B1B250320C13E9700D8EF03 /* encode.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; path = encode.c; sourceTree = "<group>"; };
+		1B1B250420C13E9700D8EF03 /* build_blurhash.py */ = {isa = PBXFileReference; lastKnownFileType = text.script.python; path = build_blurhash.py; sourceTree = "<group>"; };
+		1B1B250520C13E9700D8EF03 /* encode.h */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.h; path = encode.h; sourceTree = "<group>"; };
+		1B1B250620C1491900D8EF03 /* Readme.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = Readme.md; sourceTree = "<group>"; };
 		1B2BA1BD1F0E5EC5006057C1 /* blurhash */ = {isa = PBXFileReference; explicitFileType = "compiled.mach-o.executable"; includeInIndex = 0; path = blurhash; sourceTree = BUILT_PRODUCTS_DIR; };
 		1B2BA1C41F0E5ED6006057C1 /* blurhash_stb.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = blurhash_stb.c; sourceTree = "<group>"; };
 		1B2BA1C81F0E5EE3006057C1 /* encode.c */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.c; path = encode.c; sourceTree = "<group>"; };
 		1B2BA1C91F0E5EE3006057C1 /* encode.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = encode.h; sourceTree = "<group>"; };
 		1B2BA1CC1F0E692F006057C1 /* stb_image.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = stb_image.h; sourceTree = "<group>"; };
-		1B2BA1D21F0F81B8006057C1 /* blurhash.i */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c.preprocessed; path = blurhash.i; sourceTree = "<group>"; };
-		1B2BA1D41F0F8A64006057C1 /* BlurHash.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; path = BlurHash.c; sourceTree = "<group>"; };
-		1B2BA1D51F0F8A64006057C1 /* BlurHash.py */ = {isa = PBXFileReference; lastKnownFileType = text.script.python; path = BlurHash.py; sourceTree = "<group>"; };
-		1B2BA1DA1F0F8A64006057C1 /* setup.py */ = {isa = PBXFileReference; lastKnownFileType = text.script.python; path = setup.py; sourceTree = "<group>"; };
-		1B2BA1DB1F0F8E2E006057C1 /* BlurHash.c */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.c.c; name = BlurHash.c; path = ../../BlurHash/Ruby/BlurHash.c; sourceTree = "<group>"; };
-		1B2BA1DC1F0F8E2E006057C1 /* extconf.rb */ = {isa = PBXFileReference; lastKnownFileType = text.script.ruby; name = extconf.rb; path = ../../BlurHash/Ruby/extconf.rb; sourceTree = "<group>"; };
 		1B49CD1B1EC4721A006F8E7D /* BlurHashKit.framework */ = {isa = PBXFileReference; explicitFileType = wrapper.framework; includeInIndex = 0; path = BlurHashKit.framework; sourceTree = BUILT_PRODUCTS_DIR; };
 		1B49CD1F1EC4721A006F8E7D /* Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; path = Info.plist; sourceTree = "<group>"; };
 		1B49CD261EC47243006F8E7D /* BlurHashEncode.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BlurHashEncode.swift; sourceTree = "<group>"; };
 		1B49CD281EC4724C006F8E7D /* BlurHashDecode.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = BlurHashDecode.swift; sourceTree = "<group>"; };
+		1B6C71F122724500000D3BB1 /* BlurHashKit copy-Info.plist */ = {isa = PBXFileReference; lastKnownFileType = text.plist.xml; name = "BlurHashKit copy-Info.plist"; path = "/Users/dag/Code/Toot/BlurHash/BlurHashKit copy-Info.plist"; sourceTree = "<absolute>"; };
+		1B6C71F62272451E000D3BB1 /* libBlurHashKit.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libBlurHashKit.a; sourceTree = BUILT_PRODUCTS_DIR; };
+		1B83DED022D88D1500CAA12F /* EscapeSequences.swift */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.swift; path = EscapeSequences.swift; sourceTree = "<group>"; };
 		1BAA60701FF40A2F00E42DD7 /* BlurHash.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = BlurHash.swift; sourceTree = "<group>"; };
 		1BAA60721FF40AEA00E42DD7 /* ToString.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ToString.swift; sourceTree = "<group>"; };
 		1BAA60741FF40AF200E42DD7 /* FromString.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FromString.swift; sourceTree = "<group>"; };
@@ -123,6 +157,13 @@
 		1BEFFFBE20BEE66400187F3F /* base83.ts */ = {isa = PBXFileReference; explicitFileType = sourcecode.javascript; path = base83.ts; sourceTree = "<group>"; };
 		1BEFFFBF20BFDC1600187F3F /* Makefile */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.make; path = Makefile; sourceTree = "<group>"; };
 		1BEFFFC120BFE05600187F3F /* BlurHashDecoder.kt */ = {isa = PBXFileReference; lastKnownFileType = text; path = BlurHashDecoder.kt; sourceTree = "<group>"; };
+		1BEFFFC220BFE33E00187F3F /* Readme.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = Readme.md; sourceTree = "<group>"; };
+		1BEFFFC320BFE34800187F3F /* Readme.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; name = Readme.md; path = ../Readme.md; sourceTree = "<group>"; };
+		1BEFFFC420BFE35300187F3F /* Readme.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = Readme.md; sourceTree = "<group>"; };
+		1BEFFFC520BFE35D00187F3F /* Readme.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; path = Readme.md; sourceTree = "<group>"; };
+		1BEFFFC620BFF7B100187F3F /* Algorithm.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; name = Algorithm.md; path = ../Algorithm.md; sourceTree = "<group>"; };
+		1BEFFFC720BFF7B100187F3F /* CodeOfConduct.md */ = {isa = PBXFileReference; lastKnownFileType = net.daringfireball.markdown; name = CodeOfConduct.md; path = ../CodeOfConduct.md; sourceTree = "<group>"; };
+		1BEFFFC820C000DE00187F3F /* License.txt */ = {isa = PBXFileReference; lastKnownFileType = text; path = License.txt; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -148,6 +189,13 @@
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
+		1B6C71F32272451E000D3BB1 /* Frameworks */ = {
+			isa = PBXFrameworksBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
 /* End PBXFrameworksBuildPhase section */
 
 /* Begin PBXGroup section */
@@ -180,6 +228,61 @@
 			name = Images;
 			sourceTree = "<group>";
 		};
+		1B1B249220C13E9700D8EF03 /* Python */ = {
+			isa = PBXGroup;
+			children = (
+				1B1B250020C13E9700D8EF03 /* src */,
+				1B1B249520C13E9700D8EF03 /* tests */,
+				1B1B24FE20C13E9700D8EF03 /* .circleci */,
+				1B1B249420C13E9700D8EF03 /* dev-requirements.txt */,
+				1B1B249320C13E9700D8EF03 /* LICENSE */,
+				1B1B249920C13E9700D8EF03 /* MANIFEST.in */,
+				1B1B249A20C13E9700D8EF03 /* README.md */,
+				1B1B249E20C13E9700D8EF03 /* setup.cfg */,
+				1B1B249B20C13E9700D8EF03 /* setup.py */,
+				1B1B249D20C13E9700D8EF03 /* tox.ini */,
+			);
+			name = Python;
+			path = ../Python;
+			sourceTree = "<group>";
+		};
+		1B1B249520C13E9700D8EF03 /* tests */ = {
+			isa = PBXGroup;
+			children = (
+				1B1B249620C13E9700D8EF03 /* pic2.png */,
+				1B1B249720C13E9700D8EF03 /* pic2_bw.png */,
+				1B1B249820C13E9700D8EF03 /* test_encode.py */,
+			);
+			path = tests;
+			sourceTree = "<group>";
+		};
+		1B1B24FE20C13E9700D8EF03 /* .circleci */ = {
+			isa = PBXGroup;
+			children = (
+				1B1B24FF20C13E9700D8EF03 /* config.yml */,
+			);
+			path = .circleci;
+			sourceTree = "<group>";
+		};
+		1B1B250020C13E9700D8EF03 /* src */ = {
+			isa = PBXGroup;
+			children = (
+				1B1B250120C13E9700D8EF03 /* blurhash */,
+				1B1B250420C13E9700D8EF03 /* build_blurhash.py */,
+				1B1B250320C13E9700D8EF03 /* encode.c */,
+				1B1B250520C13E9700D8EF03 /* encode.h */,
+			);
+			path = src;
+			sourceTree = "<group>";
+		};
+		1B1B250120C13E9700D8EF03 /* blurhash */ = {
+			isa = PBXGroup;
+			children = (
+				1B1B250220C13E9700D8EF03 /* __init__.py */,
+			);
+			path = blurhash;
+			sourceTree = "<group>";
+		};
 		1B2BA1B81F0E5E91006057C1 /* C */ = {
 			isa = PBXGroup;
 			children = (
@@ -187,44 +290,27 @@
 				1B2BA1C81F0E5EE3006057C1 /* encode.c */,
 				1B2BA1C91F0E5EE3006057C1 /* encode.h */,
 				1B2BA1CC1F0E692F006057C1 /* stb_image.h */,
-				1B2BA1D21F0F81B8006057C1 /* blurhash.i */,
 				1BEFFFBF20BFDC1600187F3F /* Makefile */,
+				1B1B250620C1491900D8EF03 /* Readme.md */,
 			);
 			name = C;
 			path = ../C;
 			sourceTree = "<group>";
 		};
-		1B2BA1CD1F0F7AF3006057C1 /* Ruby */ = {
-			isa = PBXGroup;
-			children = (
-				1B2BA1DC1F0F8E2E006057C1 /* extconf.rb */,
-				1B2BA1DB1F0F8E2E006057C1 /* BlurHash.c */,
-			);
-			name = Ruby;
-			path = ../Ruby;
-			sourceTree = "<group>";
-		};
-		1B2BA1D31F0F8A64006057C1 /* Python */ = {
-			isa = PBXGroup;
-			children = (
-				1B2BA1DA1F0F8A64006057C1 /* setup.py */,
-				1B2BA1D41F0F8A64006057C1 /* BlurHash.c */,
-				1B2BA1D51F0F8A64006057C1 /* BlurHash.py */,
-			);
-			name = Python;
-			path = ../Python;
-			sourceTree = "<group>";
-		};
 		1B49CD111EC4721A006F8E7D = {
 			isa = PBXGroup;
 			children = (
 				1B49CD1D1EC4721A006F8E7D /* Swift */,
 				1B2BA1B81F0E5E91006057C1 /* C */,
 				1BEFFFC020BFE05600187F3F /* Kotlin */,
-				1B2BA1CD1F0F7AF3006057C1 /* Ruby */,
-				1B2BA1D31F0F8A64006057C1 /* Python */,
-				1BEFFFA420BEE66400187F3F /* Typescript */,
+				1BEFFFA420BEE66400187F3F /* TypeScript */,
+				1B1B249220C13E9700D8EF03 /* Python */,
+				1BEFFFC620BFF7B100187F3F /* Algorithm.md */,
+				1BEFFFC720BFF7B100187F3F /* CodeOfConduct.md */,
+				1BEFFFC820C000DE00187F3F /* License.txt */,
+				1BEFFFC320BFE34800187F3F /* Readme.md */,
 				1B49CD1C1EC4721A006F8E7D /* Products */,
+				1B6C71F122724500000D3BB1 /* BlurHashKit copy-Info.plist */,
 			);
 			sourceTree = "<group>";
 		};
@@ -234,6 +320,7 @@
 				1B49CD1B1EC4721A006F8E7D /* BlurHashKit.framework */,
 				1B0A250C1EC5E90C00F25F08 /* BlurHashTest.app */,
 				1B2BA1BD1F0E5EC5006057C1 /* blurhash */,
+				1B6C71F62272451E000D3BB1 /* libBlurHashKit.a */,
 			);
 			name = Products;
 			sourceTree = "<group>";
@@ -245,6 +332,7 @@
 				1BAA606F1FF40A1E00E42DD7 /* BlurHashKit */,
 				1B49CD261EC47243006F8E7D /* BlurHashEncode.swift */,
 				1B49CD281EC4724C006F8E7D /* BlurHashDecode.swift */,
+				1BEFFFC420BFE35300187F3F /* Readme.md */,
 			);
 			name = Swift;
 			sourceTree = "<group>";
@@ -253,6 +341,7 @@
 			isa = PBXGroup;
 			children = (
 				1BAA60701FF40A2F00E42DD7 /* BlurHash.swift */,
+				1B83DED022D88D1500CAA12F /* EscapeSequences.swift */,
 				1BAA60741FF40AF200E42DD7 /* FromString.swift */,
 				1BAA60721FF40AEA00E42DD7 /* ToString.swift */,
 				1BAA60781FF40C5800E42DD7 /* FromUIImage.swift */,
@@ -267,7 +356,7 @@
 			path = BlurHashKit;
 			sourceTree = "<group>";
 		};
-		1BEFFFA420BEE66400187F3F /* Typescript */ = {
+		1BEFFFA420BEE66400187F3F /* TypeScript */ = {
 			isa = PBXGroup;
 			children = (
 				1BEFFFA620BEE66400187F3F /* demo */,
@@ -275,9 +364,10 @@
 				1BEFFFB520BEE66400187F3F /* webpack.config.js */,
 				1BEFFFB720BEE66400187F3F /* package.json */,
 				1BEFFFB820BEE66400187F3F /* tsconfig.json */,
+				1BEFFFC520BFE35D00187F3F /* Readme.md */,
 			);
-			name = Typescript;
-			path = ../Typescript;
+			name = TypeScript;
+			path = ../TypeScript;
 			sourceTree = "<group>";
 		};
 		1BEFFFA620BEE66400187F3F /* demo */ = {
@@ -304,6 +394,7 @@
 			isa = PBXGroup;
 			children = (
 				1BEFFFC120BFE05600187F3F /* BlurHashDecoder.kt */,
+				1BEFFFC220BFE33E00187F3F /* Readme.md */,
 			);
 			name = Kotlin;
 			path = ../Kotlin;
@@ -376,13 +467,31 @@
 			productReference = 1B49CD1B1EC4721A006F8E7D /* BlurHashKit.framework */;
 			productType = "com.apple.product-type.framework";
 		};
+		1B6C71F52272451E000D3BB1 /* libBlurHashKit */ = {
+			isa = PBXNativeTarget;
+			buildConfigurationList = 1B6C71FA2272451E000D3BB1 /* Build configuration list for PBXNativeTarget "libBlurHashKit" */;
+			buildPhases = (
+				1B6C71F22272451E000D3BB1 /* Sources */,
+				1B6C71F32272451E000D3BB1 /* Frameworks */,
+				1B6C71F42272451E000D3BB1 /* CopyFiles */,
+			);
+			buildRules = (
+			);
+			dependencies = (
+			);
+			name = libBlurHashKit;
+			productName = libBlurHash;
+			productReference = 1B6C71F62272451E000D3BB1 /* libBlurHashKit.a */;
+			productType = "com.apple.product-type.library.static";
+		};
 /* End PBXNativeTarget section */
 
 /* Begin PBXProject section */
 		1B49CD121EC4721A006F8E7D /* Project object */ = {
 			isa = PBXProject;
 			attributes = {
-				LastSwiftUpdateCheck = 0830;
+				DefaultBuildSystemTypeForWorkspace = Latest;
+				LastSwiftUpdateCheck = 1020;
 				LastUpgradeCheck = 0930;
 				ORGANIZATIONNAME = "Dag Ågren";
 				TargetAttributes = {
@@ -403,6 +512,11 @@
 						LastSwiftMigration = 0920;
 						ProvisioningStyle = Automatic;
 					};
+					1B6C71F52272451E000D3BB1 = {
+						CreatedOnToolsVersion = 10.2;
+						DevelopmentTeam = M9KXCWYWYR;
+						ProvisioningStyle = Automatic;
+					};
 				};
 			};
 			buildConfigurationList = 1B49CD151EC4721A006F8E7D /* Build configuration list for PBXProject "BlurHash" */;
@@ -410,6 +524,7 @@
 			developmentRegion = English;
 			hasScannedForEncodings = 0;
 			knownRegions = (
+				English,
 				en,
 				Base,
 			);
@@ -419,6 +534,7 @@
 			projectRoot = "";
 			targets = (
 				1B49CD1A1EC4721A006F8E7D /* BlurHashKit */,
+				1B6C71F52272451E000D3BB1 /* libBlurHashKit */,
 				1B0A250B1EC5E90C00F25F08 /* BlurHashTest */,
 				1B2BA1BC1F0E5EC5006057C1 /* blurhash */,
 			);
@@ -484,6 +600,7 @@
 				1BAA60751FF40AF200E42DD7 /* FromString.swift in Sources */,
 				1BAA607B1FF40D8900E42DD7 /* StringCoding.swift in Sources */,
 				1BAA60771FF40C4C00E42DD7 /* ToUIImage.swift in Sources */,
+				1B83DED122D88D1500CAA12F /* EscapeSequences.swift in Sources */,
 				1BAA60731FF40AEA00E42DD7 /* ToString.swift in Sources */,
 				1BC34D8020098E2F00A17481 /* Generation.swift in Sources */,
 				1BDE56D12011EC5F00569DCB /* ColourProbes.swift in Sources */,
@@ -491,6 +608,24 @@
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
+		1B6C71F22272451E000D3BB1 /* Sources */ = {
+			isa = PBXSourcesBuildPhase;
+			buildActionMask = 2147483647;
+			files = (
+				1B6C71FE2272453D000D3BB1 /* FromString.swift in Sources */,
+				1B6C72022272453D000D3BB1 /* Generation.swift in Sources */,
+				1B6C72032272453D000D3BB1 /* TupleMaths.swift in Sources */,
+				1B6C72002272453D000D3BB1 /* FromUIImage.swift in Sources */,
+				1B6C72042272453D000D3BB1 /* ColourSpace.swift in Sources */,
+				1B6C72052272453D000D3BB1 /* StringCoding.swift in Sources */,
+				1B83DED222D88D1500CAA12F /* EscapeSequences.swift in Sources */,
+				1B6C71FF2272453D000D3BB1 /* ToString.swift in Sources */,
+				1B6C71FD2272453D000D3BB1 /* BlurHash.swift in Sources */,
+				1B6C72062272453D000D3BB1 /* ColourProbes.swift in Sources */,
+				1B6C72012272453D000D3BB1 /* ToUIImage.swift in Sources */,
+			);
+			runOnlyForDeploymentPostprocessing = 0;
+		};
 /* End PBXSourcesBuildPhase section */
 
 /* Begin PBXTargetDependency section */
@@ -528,7 +663,6 @@
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				DEVELOPMENT_TEAM = 6GE6LAAR8V;
 				INFOPLIST_FILE = BlurHashTest/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 10.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				PRODUCT_BUNDLE_IDENTIFIER = com.wolt.BlurHashTest;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -543,7 +677,6 @@
 				ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
 				DEVELOPMENT_TEAM = 6GE6LAAR8V;
 				INFOPLIST_FILE = BlurHashTest/Info.plist;
-				IPHONEOS_DEPLOYMENT_TARGET = 10.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks";
 				PRODUCT_BUNDLE_IDENTIFIER = com.wolt.BlurHashTest;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -623,7 +756,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 10.3;
+				IPHONEOS_DEPLOYMENT_TARGET = 10.0;
 				MTL_ENABLE_DEBUG_INFO = YES;
 				ONLY_ACTIVE_ARCH = YES;
 				SDKROOT = iphoneos;
@@ -679,7 +812,7 @@
 				GCC_WARN_UNINITIALIZED_AUTOS = YES_AGGRESSIVE;
 				GCC_WARN_UNUSED_FUNCTION = YES;
 				GCC_WARN_UNUSED_VARIABLE = YES;
-				IPHONEOS_DEPLOYMENT_TARGET = 10.3;
+				IPHONEOS_DEPLOYMENT_TARGET = 10.0;
 				MTL_ENABLE_DEBUG_INFO = NO;
 				SDKROOT = iphoneos;
 				SWIFT_OPTIMIZATION_LEVEL = "-Owholemodule";
@@ -702,7 +835,6 @@
 				DYLIB_INSTALL_NAME_BASE = "@rpath";
 				INFOPLIST_FILE = BlurHashKit/Info.plist;
 				INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks";
-				IPHONEOS_DEPLOYMENT_TARGET = 9.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
 				PRODUCT_BUNDLE_IDENTIFIER = com.wolt.BlurHashKit;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -724,7 +856,6 @@
 				DYLIB_INSTALL_NAME_BASE = "@rpath";
 				INFOPLIST_FILE = BlurHashKit/Info.plist;
 				INSTALL_PATH = "$(LOCAL_LIBRARY_DIR)/Frameworks";
-				IPHONEOS_DEPLOYMENT_TARGET = 9.0;
 				LD_RUNPATH_SEARCH_PATHS = "$(inherited) @executable_path/Frameworks @loader_path/Frameworks";
 				PRODUCT_BUNDLE_IDENTIFIER = com.wolt.BlurHashKit;
 				PRODUCT_NAME = "$(TARGET_NAME)";
@@ -733,6 +864,45 @@
 			};
 			name = Release;
 		};
+		1B6C71FB2272451E000D3BB1 /* Debug */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+				CLANG_ENABLE_OBJC_WEAK = YES;
+				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+				CODE_SIGN_IDENTITY = "iPhone Developer";
+				CODE_SIGN_STYLE = Automatic;
+				DEVELOPMENT_TEAM = M9KXCWYWYR;
+				GCC_C_LANGUAGE_STANDARD = gnu11;
+				MTL_ENABLE_DEBUG_INFO = INCLUDE_SOURCE;
+				MTL_FAST_MATH = YES;
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = BlurHashKit;
+				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.0;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = Debug;
+		};
+		1B6C71FC2272451E000D3BB1 /* Release */ = {
+			isa = XCBuildConfiguration;
+			buildSettings = {
+				CLANG_CXX_LANGUAGE_STANDARD = "gnu++14";
+				CLANG_ENABLE_OBJC_WEAK = YES;
+				CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE;
+				CODE_SIGN_IDENTITY = "iPhone Developer";
+				CODE_SIGN_STYLE = Automatic;
+				DEVELOPMENT_TEAM = M9KXCWYWYR;
+				GCC_C_LANGUAGE_STANDARD = gnu11;
+				MTL_FAST_MATH = YES;
+				OTHER_LDFLAGS = "-ObjC";
+				PRODUCT_NAME = BlurHashKit;
+				SKIP_INSTALL = YES;
+				SWIFT_VERSION = 5.0;
+				TARGETED_DEVICE_FAMILY = "1,2";
+			};
+			name = Release;
+		};
 /* End XCBuildConfiguration section */
 
 /* Begin XCConfigurationList section */
@@ -772,6 +942,15 @@
 			defaultConfigurationIsVisible = 0;
 			defaultConfigurationName = Release;
 		};
+		1B6C71FA2272451E000D3BB1 /* Build configuration list for PBXNativeTarget "libBlurHashKit" */ = {
+			isa = XCConfigurationList;
+			buildConfigurations = (
+				1B6C71FB2272451E000D3BB1 /* Debug */,
+				1B6C71FC2272451E000D3BB1 /* Release */,
+			);
+			defaultConfigurationIsVisible = 0;
+			defaultConfigurationName = Release;
+		};
 /* End XCConfigurationList section */
 	};
 	rootObject = 1B49CD121EC4721A006F8E7D /* Project object */;

Swift/BlurHashDecode.swift

@@ -9,7 +9,7 @@ extension UIImage {
 		let numX = (sizeFlag % 9) + 1
 
 		let quantisedMaximumValue = String(blurHash[1]).decode83()
-		let maximumValue = Float(quantisedMaximumValue + 1) / 83
+        let maximumValue = Float(quantisedMaximumValue + 1) / 166
 
         guard blurHash.count == 4 + 2 * numX * numY else { return nil }
 

Swift/BlurHashEncode.swift

@@ -38,8 +38,8 @@ extension UIImage {
 		let maximumValue: Float
 		if ac.count > 0 {
 			let actualMaximumValue = ac.map({ max(abs($0.0), abs($0.1), abs($0.2)) }).max()!
-			let quantisedMaximumValue = Int(max(0, min(82, floor(actualMaximumValue * 83 - 0.5))))
-			maximumValue = Float(quantisedMaximumValue + 1) / 83
+			let quantisedMaximumValue = Int(max(0, min(82, floor(actualMaximumValue * 166 - 0.5))))
+			maximumValue = Float(quantisedMaximumValue + 1) / 166
 			hash += quantisedMaximumValue.encode83(length: 1)
 		} else {
 			maximumValue = 1

Swift/BlurHashKit/ColourProbes.swift

@@ -1,21 +1,21 @@
 import Foundation
 
-public extension BlurHash {
-    public func linearRGB(atX: Float) -> (Float, Float, Float) {
+extension BlurHash {
+    public func linearRgb(atX: Float) -> (Float, Float, Float) {
         return components[0].enumerated().reduce((0, 0, 0)) { (sum, xEnumerated) in
             let (x, component) = xEnumerated
             return sum + component * cos(Float.pi * Float(x) * atX)
         }
     }
 
-    public func linearRGB(atY: Float) -> (Float, Float, Float) {
+    public func linearRgb(atY: Float) -> (Float, Float, Float) {
         return components.enumerated().reduce((0, 0, 0)) { (sum, yEnumerated) in
             let (y, xComponents) = yEnumerated
             return sum + xComponents[0] * cos(Float.pi * Float(y) * atY)
         }
     }
 
-    public func linearRGB(at position: (Float, Float)) -> (Float, Float, Float) {
+    public func linearRgb(at position: (Float, Float)) -> (Float, Float, Float) {
         return components.enumerated().reduce((0, 0, 0)) { (sum, yEnumerated) in
             let (y, xComponents) = yEnumerated
             return xComponents.enumerated().reduce(sum) { (sum, xEnumerated) in
@@ -25,30 +25,48 @@ public extension BlurHash {
         }
     }
 
-    public var averageLinearRGB: (Float, Float, Float) {
+    public func linearRgb(from upperLeft: (Float, Float), to lowerRight: (Float, Float)) -> (Float, Float, Float) {
+        return components.enumerated().reduce((0, 0, 0)) { (sum, yEnumerated) in
+            let (y, xComponents) = yEnumerated
+            return xComponents.enumerated().reduce(sum) { (sum, xEnumerated) in
+                let (x, component) = xEnumerated
+                let horizontalAverage: Float = x == 0 ? 1 : (sin(Float.pi * Float(x) * lowerRight.0) - sin(Float.pi * Float(x) * upperLeft.0)) / (Float(x) * Float.pi * (lowerRight.0 - upperLeft.0))
+                let veritcalAverage: Float = y == 0 ? 1 : (sin(Float.pi * Float(y) * lowerRight.1) - sin(Float.pi * Float(y) * upperLeft.1)) / (Float(y) * Float.pi * (lowerRight.1 - upperLeft.1))
+                return sum + component * horizontalAverage * veritcalAverage
+            }
+        }
+    }
+
+    public func linearRgb(at upperLeft: (Float, Float), size: (Float, Float)) -> (Float, Float, Float) {
+        return linearRgb(from: upperLeft, to: (upperLeft.0 + size.0, upperLeft.1 + size.1))
+    }
+
+    public var averageLinearRgb: (Float, Float, Float) {
         return components[0][0]
     }
 
-    public var leftEdgeLinearRGB: (Float, Float, Float) { return linearRGB(atX: 0) }
-    public var rightEdgeLinearRGB: (Float, Float, Float) { return linearRGB(atX: 1) }
-    public var topEdgeLinearRGB: (Float, Float, Float) { return linearRGB(atY: 0) }
-    public var bottomEdgeLinearRGB: (Float, Float, Float) { return linearRGB(atY: 1) }
-    public var topLeftCornerLinearRGB: (Float, Float, Float) { return linearRGB(at: (0, 0)) }
-    public var topRightCornerLinearRGB: (Float, Float, Float) { return linearRGB(at: (1, 0)) }
-    public var bottomLeftCornerLinearRGB: (Float, Float, Float) { return linearRGB(at: (0, 1)) }
-    public var bottomRightCornerLinearRGB: (Float, Float, Float) { return linearRGB(at: (1, 1)) }
+    public var leftEdgeLinearRgb: (Float, Float, Float) { return linearRgb(atX: 0) }
+    public var rightEdgeLinearRgb: (Float, Float, Float) { return linearRgb(atX: 1) }
+    public var topEdgeLinearRgb: (Float, Float, Float) { return linearRgb(atY: 0) }
+    public var bottomEdgeLinearRgb: (Float, Float, Float) { return linearRgb(atY: 1) }
+    public var topLeftCornerLinearRgb: (Float, Float, Float) { return linearRgb(at: (0, 0)) }
+    public var topRightCornerLinearRgb: (Float, Float, Float) { return linearRgb(at: (1, 0)) }
+    public var bottomLeftCornerLinearRgb: (Float, Float, Float) { return linearRgb(at: (0, 1)) }
+    public var bottomRightCornerLinearRgb: (Float, Float, Float) { return linearRgb(at: (1, 1)) }
 }
 
-public extension BlurHash {
-    public func isDark(linearRGB rgb: (Float, Float, Float)) -> Bool {
+extension BlurHash {
+    public func isDark(linearRgb rgb: (Float, Float, Float)) -> Bool {
         return rgb.0 * 0.299 + rgb.1 * 0.587 + rgb.2 * 0.114 < 0.5
     }
 
-    public var isDark: Bool { return isDark(linearRGB: averageLinearRGB) }
+    public var isDark: Bool { return isDark(linearRgb: averageLinearRgb) }
 
-    public func isDark(atX x: Float) -> Bool { return isDark(linearRGB: linearRGB(atX: x)) }
-    public func isDark(atY y: Float) -> Bool { return isDark(linearRGB: linearRGB(atY: y)) }
-    public func isDark(at position: (Float, Float)) -> Bool { return isDark(linearRGB: linearRGB(at: position)) }
+    public func isDark(atX x: Float) -> Bool { return isDark(linearRgb: linearRgb(atX: x)) }
+    public func isDark(atY y: Float) -> Bool { return isDark(linearRgb: linearRgb(atY: y)) }
+    public func isDark(at position: (Float, Float)) -> Bool { return isDark(linearRgb: linearRgb(at: position)) }
+    public func isDark(from upperLeft: (Float, Float), to lowerRight: (Float, Float)) -> Bool { return isDark(linearRgb: linearRgb(from: upperLeft, to: lowerRight)) }
+    public func isDark(at upperLeft: (Float, Float), size: (Float, Float)) -> Bool { return isDark(linearRgb: linearRgb(at: upperLeft, size: size)) }
 
     public var isLeftEdgeDark: Bool { return isDark(atX: 0) }
     public var isRightEdgeDark: Bool { return isDark(atX: 1) }

Swift/BlurHashKit/EscapeSequences.swift

@@ -0,0 +1,36 @@
+import Foundation
+
+extension BlurHash {
+    var twoByThreeEscapeSequence: String {
+        let areas: [(from: (Float, Float), to: (Float, Float))] = [
+            (from: (0, 0), to: (0.333, 0.5)),
+            (from: (0, 0.5), to: (0.333, 1.0)),
+            (from: (0.333, 0), to: (0.666, 0.5)),
+            (from: (0.333, 0.5), to: (0.666, 1.0)),
+            (from: (0.666, 0), to: (1.0, 0.5)),
+            (from: (0.666, 0.5), to: (1.0, 1.0)),
+        ]
+
+        let rgb: [(Float, Float, Float)] = areas.map { area in
+            linearRgb(from: area.from, to: area.to)
+        }
+
+        let maxRgb: (Float, Float, Float) = rgb.reduce((-Float.infinity, -Float.infinity, -Float.infinity), max)
+        let minRgb: (Float, Float, Float) = rgb.reduce((Float.infinity, Float.infinity, Float.infinity), min)
+
+        let positiveScale: (Float, Float, Float) = ((1, 1, 1) - averageLinearRgb) / (maxRgb - averageLinearRgb)
+        let negativeScale: (Float, Float, Float) = averageLinearRgb / (averageLinearRgb - minRgb)
+        let scale: (Float, Float, Float) = min(positiveScale, negativeScale)
+
+        let scaledRgb: [(Float, Float, Float)] = rgb.map { rgb in
+            return (rgb - averageLinearRgb) * scale + averageLinearRgb
+        }
+
+        let c = scaledRgb.map { rgb in
+            return (linearTosRGB(rgb.0) / 51) * 36 + (linearTosRGB(rgb.1) / 51) * 6 + (linearTosRGB(rgb.2) / 51) + 16
+        }
+
+        return "\u{1b}[38;5;\(c[1]);48;5;\(c[0])m▄\u{1b}[38;5;\(c[3]);48;5;\(c[2])m▄\u{1b}[38;5;\(c[5]);48;5;\(c[4])m▄\u{1b}[m"
+    }
+}
+

Swift/BlurHashKit/FromString.swift

@@ -9,7 +9,7 @@ public extension BlurHash {
 		let numX = (sizeFlag % 9) + 1
 
 		let quantisedMaximumValue = String(string[1]).decode83()
-		let maximumValue = Float(quantisedMaximumValue + 1) / 83
+		let maximumValue = Float(quantisedMaximumValue + 1) / 166
 
 		guard string.count == 4 + 2 * numX * numY else { return nil }
 

Swift/BlurHashKit/Generation.swift

@@ -1,6 +1,6 @@
 import UIKit
 
-public extension BlurHash {
+extension BlurHash {
 	public init(horizontalGradientFrom leftColour: UIColor, to rightColour: UIColor) {
 		let average = (leftColour.linear + rightColour.linear) / 2
 		let difference = (leftColour.linear - rightColour.linear) / 2

Swift/BlurHashKit/ToString.swift

@@ -14,8 +14,8 @@ public extension BlurHash {
 		let maximumValue: Float
 		if ac.count > 0 {
 			let actualMaximumValue = ac.map({ max(abs($0.0), abs($0.1), abs($0.2)) }).max()!
-			let quantisedMaximumValue = Int(max(0, min(82, floor(actualMaximumValue * 83 - 0.5))))
-			maximumValue = Float(quantisedMaximumValue + 1) / 83
+			let quantisedMaximumValue = Int(max(0, min(82, floor(actualMaximumValue * 166 - 0.5))))
+			maximumValue = Float(quantisedMaximumValue + 1) / 166
 			hash += quantisedMaximumValue.encode83(length: 1)
 		} else {
 			maximumValue = 1

Swift/BlurHashKit/ToUIImage.swift

@@ -1,6 +1,6 @@
 import UIKit
 
-public extension BlurHash {
+extension BlurHash {
 	public func cgImage(size: CGSize) -> CGImage? {
 		let width = Int(size.width)
 		let height = Int(size.height)
@@ -42,22 +42,40 @@ public extension BlurHash {
 		return cgImage
 	}
 
+	public func cgImage(numberOfPixels: Int = 1024, originalSize size: CGSize) -> CGImage? {
+		let width: CGFloat
+		let height: CGFloat
+		if size.width > size.height {
+			width = floor(sqrt(CGFloat(numberOfPixels) * size.width / size.height) + 0.5)
+			height = floor(CGFloat(numberOfPixels) / width + 0.5)
+		} else {
+			height = floor(sqrt(CGFloat(numberOfPixels) * size.height / size.width) + 0.5)
+			width = floor(CGFloat(numberOfPixels) / height + 0.5)
+		}
+		return cgImage(size: CGSize(width: width, height: height))
+	}
+
 	public func image(size: CGSize) -> UIImage? {
 		guard let cgImage = cgImage(size: size) else { return nil }
 		return UIImage(cgImage: cgImage)
 	}
 
 	public func image(numberOfPixels: Int = 1024, originalSize size: CGSize) -> UIImage? {
-		let width: CGFloat
-		let height: CGFloat
-		if size.width > size.height {
-			width = floor(sqrt(CGFloat(numberOfPixels)) * size.width / size.height + 0.5)
-			height = floor(CGFloat(numberOfPixels) / width + 0.5)
-		} else {
-			height = floor(sqrt(CGFloat(numberOfPixels)) * size.height / size.width + 0.5)
-			width = floor(CGFloat(numberOfPixels) / height + 0.5)
-		}
-		return image(size: CGSize(width: width, height: height))
+		guard let cgImage = cgImage(numberOfPixels: numberOfPixels, originalSize: size) else { return nil }
+		return UIImage(cgImage: cgImage)
 	}
 }
 
+@objc extension UIImage {
+    public convenience init?(blurHash string: String, size: CGSize, punch: Float = 1) {
+        guard let blurHash = BlurHash(string: string),
+        let cgImage = blurHash.punch(punch).cgImage(size: size) else { return nil }
+        self.init(cgImage: cgImage)
+    }
+
+    public convenience init?(blurHash string: String, numberOfPixels: Int = 1024, originalSize size: CGSize, punch: Float = 1) {
+        guard let blurHash = BlurHash(string: string),
+        let cgImage = blurHash.punch(punch).cgImage(numberOfPixels: numberOfPixels, originalSize: size) else { return nil }
+        self.init(cgImage: cgImage)
+    }
+}

Swift/BlurHashKit/TupleMaths.swift

@@ -8,6 +8,10 @@ func -(lhs: (Float, Float, Float), rhs: (Float, Float, Float)) -> (Float, Float,
 	return (lhs.0 - rhs.0, lhs.1 - rhs.1, lhs.2 - rhs.2)
 }
 
+func *(lhs: (Float, Float, Float), rhs: (Float, Float, Float)) -> (Float, Float, Float) {
+    return (lhs.0 * rhs.0, lhs.1 * rhs.1, lhs.2 * rhs.2)
+}
+
 func *(lhs: (Float, Float, Float), rhs: Float) -> (Float, Float, Float) {
 	return (lhs.0 * rhs, lhs.1 * rhs, lhs.2 * rhs)
 }
@@ -16,6 +20,10 @@ func *(lhs: Float, rhs: (Float, Float, Float)) -> (Float, Float, Float) {
 	return (lhs * rhs.0, lhs * rhs.1, lhs * rhs.2)
 }
 
+func /(lhs: (Float, Float, Float), rhs: (Float, Float, Float)) -> (Float, Float, Float) {
+    return (lhs.0 / rhs.0, lhs.1 / rhs.1, lhs.2 / rhs.2)
+}
+
 func /(lhs: (Float, Float, Float), rhs: Float) -> (Float, Float, Float) {
 	return (lhs.0 / rhs, lhs.1 / rhs, lhs.2 / rhs)
 }
@@ -35,3 +43,11 @@ func *=(lhs: inout (Float, Float, Float), rhs: Float) {
 func /=(lhs: inout (Float, Float, Float), rhs: Float) {
 	lhs = lhs / rhs
 }
+
+func min(_ a: (Float, Float, Float), _ b: (Float, Float, Float)) -> (Float, Float, Float) {
+    return (min(a.0, b.0), min(a.1, b.1), min(a.2, b.2))
+}
+
+func max(_ a: (Float, Float, Float), _ b: (Float, Float, Float)) -> (Float, Float, Float) {
+    return (max(a.0, b.0), max(a.1, b.1), max(a.2, b.2))
+}

Swift/License.txt

@@ -0,0 +1,19 @@
+Copyright (c) 2018 Wolt Enterprises
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Swift/Readme.md

@@ -0,0 +1,45 @@
+# BlurHash for iOS, in Swift
+
+## Standalone decoder and encoder
+
+[BlurHashDecode.swift](BlurHashDecode.swift) and [BlurHashEncode.swift](BlurHashEncode.swift) contain a decoder
+and encoder for BlurHash to and from `UIImage`. Both files are completeiy standalone, and can simply be copied into your
+project directly.
+
+### Decoding
+
+[BlurHashDecode.swift](BlurHashDecode.swift) implements the following extension on `UIImage`:
+
+	public convenience init?(blurHash: String, size: CGSize, punch: Float = 1)
+
+This creates a UIImage containing the placeholder image decoded from the BlurHash string, or returns nil if decoding failed.
+The parameters are:
+
+* `blurHash` - A string containing the BlurHash.
+* `size` - The requested output size. You should keep this small, and let UIKit scale it up for you. 32 pixels wide is plenty.
+* `punch` - Adjusts the contrast of the output image. Tweak it if you want a different look for your placeholders.
+
+### Encoding
+
+ [BlurHashEncode.swift](BlurHashEncode.swift) implements the following extension on `UIImage`:
+
+	public func blurHash(numberOfComponents components: (Int, Int)) -> String?
+
+This returns a string containing the BlurHash for the image, or nil if the image was in a weird format that is not supported.
+The parameters are:
+
+* `numberOfComponents` - a Tuple of integers specifying the number of components in the X and Y directions. Both must be
+between 1 and 9 inclusive, or the function will return nil.  3 to 5 is usually a good range.
+
+## BlurHashKit
+
+This is a more advanced library, currently in development. It will let you do more advanced operations using BlurHashes,
+such testing whether various parts of an image are dark and light, or generating BlurHashes as gradients from corner colours.
+
+It is currently not documented or finalised, but feel free to look into the different files and what they implement, or look at
+how it is used by the test app.
+
+## BlurHashTest.app
+
+This is a simple test app that shows how to use the various pieces of BlurHash functionality, and lets you play with the
+algorithm.

TypeScript/.gitignore

@@ -0,0 +1,2 @@
+node_modules/
+dist/

TypeScript/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "printWidth": 80,
+  "overrides": [
+    {
+      "files": ["*.ts"],
+      "options": {}
+    }
+  ]
+}

TypeScript/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 1.1.2 (June 29, 2019)
+
+- added `isBlurhashValid()` utility
+
+## 1.1.1 (June 29, 2019)
+
+- fixed incorrect type declaration path in package.json
+- improved error handling

TypeScript/README.md

@@ -0,0 +1,78 @@
+# blurhash
+
+[![NPM Version](https://img.shields.io/npm/v/blurhash.svg?style=flat)](https://npmjs.org/package/blurhash)
+[![NPM Downloads](https://img.shields.io/npm/dm/blurhash.svg?style=flat)](https://npmjs.org/package/blurhash)
+
+> JavaScript encoder and decoder for the [Wolt BlurHash](https://github.com/woltapp/blurhash) algorithm
+
+## Install
+
+```sh
+npm install --save blurhash
+```
+
+See [react-blurhash](https://github.com/woltapp/react-blurhash) to use blurhash with React.
+
+## API
+
+### `decode(blurhash: string, width: number, height: number, punch?: number) => Uint8ClampedArray`
+
+> Decodes a blurhash string to pixels
+
+#### Example
+
+```js
+import { decode } from "blurhash";
+
+const pixels = decode("LEHV6nWB2yk8pyo0adR*.7kCMdnj", 32, 32);
+
+const canvas = document.createElement("canvas");
+const ctx = canvas.getContext("2d");
+const imageData = ctx.createImageData(width, height);
+imageData.data.set(pixels);
+ctx.putImageData(imageData, 0, 0);
+document.body.append(canvas);
+```
+
+### `encode(pixels: Uint8ClampedArray, width: number, height: number, componentX: number, componentY: number) => string`
+
+> Encodes pixels to a blurhash string
+
+```js
+import { encode } from "blurhash";
+
+const loadImage = async src =>
+  new Promise((resolve, reject) => {
+    const img = new Image();
+    img.onload = () => resolve(img);
+    img.onerror = (...args) => reject(args);
+    img.src = src;
+  });
+
+const getImageData = image => {
+  const canvas = document.createElement("canvas");
+  canvas.width = image.width;
+  canvas.height = image.height;
+  const context = canvas.getContext("2d");
+  context.drawImage(image, 0, 0);
+  return context.getImageData(0, 0, image.width, image.height);
+};
+
+const encodeImageToBlurhash = async imageUrl => {
+  const image = await loadImage(imageUrl);
+  const imageData = getImageData(image);
+  return encode(imageData.data, imageData.width, imageData.height, 4, 4);
+};
+```
+
+### `isBlurhashValid(blurhash: string) => { result: boolean; errorReason?: string }`
+
+```js
+import { isBlurhashValid } from "blurhash";
+
+const validRes = isBlurhashValid("LEHV6nWB2yk8pyo0adR*.7kCMdnj");
+// { result: true }
+
+const invalidRes = isBlurhashValid("???");
+// { result: false, errorReason: "The blurhash string must be at least 6 characters" }
+```

TypeScript/demo/index.html

@@ -0,0 +1,74 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+    <title>Blurhash test file</title>
+    <style>
+        * {
+            box-sizing: border-box;
+        }
+
+        .wrapper {
+            display: flex;
+            align-items: flex-start;
+        }
+
+        .blurhashWrapper {
+            padding: 0 20px;
+        }
+
+        canvas {
+            display: block;
+            width: 632px;
+            height: 356px;
+            background: #ccc;
+        }
+
+        #blurhash {
+            margin-top: 20px;
+            font-size: 24px;
+            width: 632px;
+        }
+
+        label {
+            display: block;
+            padding: 10px 0;
+        }
+
+        label > span {
+            display: inline-block;
+            width: 100px;
+        }
+    </style>
+</head>
+
+<body>
+    <h1>BlurHash demo</h1>
+    <div class="wrapper">
+        <div>
+            <h2>Encode</h2>
+            <canvas id="original" width="100" height="100"></canvas>
+            <label>
+                <span>File:</span>
+                <input id="fileinput" type="file" accept="image/*" />
+            </label>
+            <label>
+                <span>Components</span>
+                <input type="number" id="x" value="4" min="1" max="9" />
+                ×
+                <input type="number" id="y" value="3" min="1" max="9" />
+            </label>
+        </div>
+        <div class="blurhashWrapper">
+            <h2>Blurhash</h2>
+            <input id="blurhash" type="text" value="" />
+        </div>
+        <div>
+            <h2>Decode</h2>
+            <canvas id="canvas" width="32" height="32"></canvas>
+        </div>
+    </div>
+    <script src="./demo.js"></script>
+</body>
+
+</html>

TypeScript/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "blurhash",
+  "version": "1.1.3",
+  "description": "Encoder and decoder for the Wolt BlurHash algorithm.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/woltapp/blurhash/tree/master/TypeScript"
+  },
+  "homepage": "http://blurhash.com",
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "npm run ts",
+    "demo": "webpack-dev-server --mode development",
+    "prettier": "prettier src/**/*.ts",
+    "prettier-fix": "npm run prettier -- --write",
+    "ts": "tsc",
+    "ts:watch": "npm run ts -- --noEmit --watch"
+  },
+  "keywords": [
+    "blurhash",
+    "blur",
+    "hash",
+    "image"
+  ],
+  "author": "omahlama",
+  "license": "MIT",
+  "devDependencies": {
+    "prettier": "1.18.2",
+    "ts-loader": "6.0.4",
+    "typescript": "3.5.3",
+    "webpack": "4.38.0",
+    "webpack-cli": "^3.3.6",
+    "webpack-dev-server": "3.7.2"
+  }
+}

TypeScript/src/base83.ts

@@ -0,0 +1,104 @@
+const digitCharacters = [
+  "0",
+  "1",
+  "2",
+  "3",
+  "4",
+  "5",
+  "6",
+  "7",
+  "8",
+  "9",
+  "A",
+  "B",
+  "C",
+  "D",
+  "E",
+  "F",
+  "G",
+  "H",
+  "I",
+  "J",
+  "K",
+  "L",
+  "M",
+  "N",
+  "O",
+  "P",
+  "Q",
+  "R",
+  "S",
+  "T",
+  "U",
+  "V",
+  "W",
+  "X",
+  "Y",
+  "Z",
+  "a",
+  "b",
+  "c",
+  "d",
+  "e",
+  "f",
+  "g",
+  "h",
+  "i",
+  "j",
+  "k",
+  "l",
+  "m",
+  "n",
+  "o",
+  "p",
+  "q",
+  "r",
+  "s",
+  "t",
+  "u",
+  "v",
+  "w",
+  "x",
+  "y",
+  "z",
+  "#",
+  "$",
+  "%",
+  "*",
+  "+",
+  ",",
+  "-",
+  ".",
+  ":",
+  ";",
+  "=",
+  "?",
+  "@",
+  "[",
+  "]",
+  "^",
+  "_",
+  "{",
+  "|",
+  "}",
+  "~"
+];
+
+export const decode83 = (str: String) => {
+  let value = 0;
+  for (let i = 0; i < str.length; i++) {
+    const c = str[i];
+    const digit = digitCharacters.indexOf(c);
+    value = value * 83 + digit;
+  }
+  return value;
+};
+
+export const encode83 = (n: number, length: number): string => {
+  var result = "";
+  for (let i = 1; i <= length; i++) {
+    let digit = (Math.floor(n) / Math.pow(83, length - i)) % 83;
+    result += digitCharacters[Math.floor(digit)];
+  }
+  return result;
+};

TypeScript/src/decode.ts

@@ -1,5 +1,42 @@
-import { decode83 } from './base83';
-import { sRGBToLinear, signPow, linearTosRGB } from './utils';
+import { decode83 } from "./base83";
+import { sRGBToLinear, signPow, linearTosRGB } from "./utils";
+import { ValidationError } from "./error";
+
+/**
+ * Returns an error message if invalid or undefined if valid
+ * @param blurhash
+ */
+const validateBlurhash = (blurhash: string) => {
+  if (!blurhash || blurhash.length < 6) {
+    throw new ValidationError(
+      "The blurhash string must be at least 6 characters"
+    );
+  }
+
+  const sizeFlag = decode83(blurhash[0]);
+  const numY = Math.floor(sizeFlag / 9) + 1;
+  const numX = (sizeFlag % 9) + 1;
+
+  if (blurhash.length !== 4 + 2 * numX * numY) {
+    throw new ValidationError(
+      `blurhash length mismatch: length is ${
+        blurhash.length
+      } but it should be ${4 + 2 * numX * numY}`
+    );
+  }
+};
+
+export const isBlurhashValid = (
+  blurhash: string
+): { result: boolean; errorReason?: string } => {
+  try {
+    validateBlurhash(blurhash);
+  } catch (error) {
+    return { result: false, errorReason: error.message };
+  }
+
+  return { result: true };
+};
 
 const decodeDC = (value: number) => {
   const intR = value >> 16;
@@ -16,33 +53,31 @@ const decodeAC = (value: number, maximumValue: number) => {
   const rgb = [
     signPow((quantR - 9) / 9, 2.0) * maximumValue,
     signPow((quantG - 9) / 9, 2.0) * maximumValue,
-    signPow((quantB - 9) / 9, 2.0) * maximumValue,
+    signPow((quantB - 9) / 9, 2.0) * maximumValue
   ];
 
   return rgb;
 };
 
-const decode = (blurhash: string, width: number, height: number, punch?: number) => {
-  punch = punch | 1;
+const decode = (
+  blurhash: string,
+  width: number,
+  height: number,
+  punch?: number
+) => {
+  validateBlurhash(blurhash);
 
-  if (blurhash.length < 6) {
-    console.error('too short blurhash');
-    return null;
-  }
+  punch = punch | 1;
 
   const sizeFlag = decode83(blurhash[0]);
   const numY = Math.floor(sizeFlag / 9) + 1;
   const numX = (sizeFlag % 9) + 1;
 
   const quantisedMaximumValue = decode83(blurhash[1]);
-  const maximumValue = (quantisedMaximumValue + 1) / 83;
-
-  if (blurhash.length !== 4 + 2 * numX * numY) {
-    console.error('blurhash length mismatch', blurhash.length, 4 + 2 * numX * numY);
-    return null;
-  }
+  const maximumValue = (quantisedMaximumValue + 1) / 166;
 
   const colors = new Array(numX * numY);
+
   for (let i = 0; i < colors.length; i++) {
     if (i === 0) {
       const value = decode83(blurhash.substring(2, 6));
@@ -64,7 +99,9 @@ const decode = (blurhash: string, width: number, height: number, punch?: number)
 
       for (let j = 0; j < numY; j++) {
         for (let i = 0; i < numX; i++) {
-          const basis = Math.cos(Math.PI * x * i / width) * Math.cos(Math.PI * y * j / height);
+          const basis =
+            Math.cos((Math.PI * x * i) / width) *
+            Math.cos((Math.PI * y * j) / height);
           let color = colors[i + j * numX];
           r += color[0] * basis;
           g += color[1] * basis;

TypeScript/src/demo.ts

@@ -0,0 +1,66 @@
+import decode from "./decode";
+import encode from "./encode";
+
+const blurhashElement = document.getElementById("blurhash") as HTMLInputElement;
+const canvas = document.getElementById("canvas") as HTMLCanvasElement;
+const originalCanvas = document.getElementById("original") as HTMLCanvasElement;
+const fileInput = document.getElementById("fileinput") as HTMLInputElement;
+const componentXElement = document.getElementById("x") as HTMLInputElement;
+const componentYElement = document.getElementById("y") as HTMLInputElement;
+
+function render() {
+  const blurhash = blurhashElement.value;
+  if (blurhash) {
+    const pixels = decode(blurhash, 32, 32);
+    if (pixels) {
+      const ctx = canvas.getContext("2d");
+
+      const imageData = new ImageData(pixels, 32, 32);
+      ctx.putImageData(imageData, 0, 0);
+    }
+  }
+}
+
+function clamp(n: number) {
+  return Math.min(9, Math.max(1, n));
+}
+
+function doEncode() {
+  const file = fileInput.files[0];
+  const componentX = clamp(+componentXElement.value);
+  const componentY = clamp(+componentYElement.value);
+  if (file) {
+    const ctx = originalCanvas.getContext("2d");
+    var img = new Image();
+    img.onload = function() {
+      ctx.drawImage(img, 0, 0, originalCanvas.width, originalCanvas.height);
+      URL.revokeObjectURL(img.src);
+
+      setTimeout(() => {
+        const imageData = ctx.getImageData(
+          0,
+          0,
+          originalCanvas.width,
+          originalCanvas.height
+        );
+        const blurhash = encode(
+          imageData.data,
+          imageData.width,
+          imageData.height,
+          componentX,
+          componentY
+        );
+        blurhashElement.value = blurhash;
+        render();
+      }, 0);
+    };
+    img.src = URL.createObjectURL(fileInput.files[0]);
+  }
+}
+
+blurhashElement.addEventListener("keyup", render);
+fileInput.addEventListener("change", doEncode);
+componentXElement.addEventListener("change", doEncode);
+componentYElement.addEventListener("change", doEncode);
+
+render();

TypeScript/src/encode.ts

@@ -0,0 +1,128 @@
+import { encode83 } from "./base83";
+import { sRGBToLinear, signPow, linearTosRGB } from "./utils";
+import { ValidationError } from "./error";
+
+type NumberTriplet = [number, number, number];
+
+const bytesPerPixel = 4;
+
+const multiplyBasisFunction = (
+  pixels: Uint8ClampedArray,
+  width: number,
+  height: number,
+  basisFunction: (i: number, j: number) => number
+): NumberTriplet => {
+  let r = 0;
+  let g = 0;
+  let b = 0;
+  const bytesPerRow = width * bytesPerPixel;
+
+  for (let x = 0; x < width; x++) {
+    for (let y = 0; y < height; y++) {
+      const basis = basisFunction(x, y);
+      r +=
+        basis * sRGBToLinear(pixels[bytesPerPixel * x + 0 + y * bytesPerRow]);
+      g +=
+        basis * sRGBToLinear(pixels[bytesPerPixel * x + 1 + y * bytesPerRow]);
+      b +=
+        basis * sRGBToLinear(pixels[bytesPerPixel * x + 2 + y * bytesPerRow]);
+    }
+  }
+
+  let scale = 1 / (width * height);
+
+  return [r * scale, g * scale, b * scale];
+};
+
+const encodeDC = (value: NumberTriplet): number => {
+  const roundedR = linearTosRGB(value[0]);
+  const roundedG = linearTosRGB(value[1]);
+  const roundedB = linearTosRGB(value[2]);
+  return (roundedR << 16) + (roundedG << 8) + roundedB;
+};
+
+const encodeAC = (value: NumberTriplet, maximumValue: number): number => {
+  let quantR = Math.floor(
+    Math.max(
+      0,
+      Math.min(18, Math.floor(signPow(value[0] / maximumValue, 0.5) * 9 + 9.5))
+    )
+  );
+  let quantG = Math.floor(
+    Math.max(
+      0,
+      Math.min(18, Math.floor(signPow(value[1] / maximumValue, 0.5) * 9 + 9.5))
+    )
+  );
+  let quantB = Math.floor(
+    Math.max(
+      0,
+      Math.min(18, Math.floor(signPow(value[2] / maximumValue, 0.5) * 9 + 9.5))
+    )
+  );
+
+  return quantR * 19 * 19 + quantG * 19 + quantB;
+};
+
+const encode = (
+  pixels: Uint8ClampedArray,
+  width: number,
+  height: number,
+  componentX: number,
+  componentY: number
+): string => {
+  if (componentX < 1 || componentX > 9 || componentY < 1 || componentY > 9) {
+    throw new ValidationError("BlurHash must have between 1 and 9 components");
+  }
+  if (width * height * 4 !== pixels.length) {
+    throw new ValidationError("Width and height must match the pixels array");
+  }
+
+  let factors: Array<[number, number, number]> = [];
+  for (let y = 0; y < componentY; y++) {
+    for (let x = 0; x < componentX; x++) {
+      const normalisation = x == 0 && y == 0 ? 1 : 2;
+      const factor = multiplyBasisFunction(
+        pixels,
+        width,
+        height,
+        (i: number, j: number) =>
+          normalisation *
+          Math.cos((Math.PI * x * i) / width) *
+          Math.cos((Math.PI * y * j) / height)
+      );
+      factors.push(factor);
+    }
+  }
+
+  const dc = factors[0];
+  const ac = factors.slice(1);
+
+  let hash = "";
+
+  let sizeFlag = componentX - 1 + (componentY - 1) * 9;
+  hash += encode83(sizeFlag, 1);
+
+  let maximumValue: number;
+  if (ac.length > 0) {
+    let actualMaximumValue = Math.max(...ac.map(val => Math.max(...val)));
+    let quantisedMaximumValue = Math.floor(
+      Math.max(0, Math.min(82, Math.floor(actualMaximumValue * 166 - 0.5)))
+    );
+    maximumValue = (quantisedMaximumValue + 1) / 166;
+    hash += encode83(quantisedMaximumValue, 1);
+  } else {
+    maximumValue = 1;
+    hash += encode83(0, 1);
+  }
+
+  hash += encode83(encodeDC(dc), 4);
+
+  ac.forEach(factor => {
+    hash += encode83(encodeAC(factor, maximumValue), 2);
+  });
+
+  return hash;
+};
+
+export default encode;

TypeScript/src/error.ts

@@ -0,0 +1,7 @@
+export class ValidationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "ValidationError";
+    this.message = message;
+  }
+}

TypeScript/src/index.ts

@@ -0,0 +1,3 @@
+export { default as decode, isBlurhashValid } from "./decode";
+export { default as encode } from "./encode";
+export * from "./error";

TypeScript/src/utils.ts

@@ -18,4 +18,5 @@ export const linearTosRGB = (value: number) => {
 
 export const sign = (n: number) => (n < 0 ? -1 : 1);
 
-export const signPow = (val: number, exp: number) => sign(val) * Math.pow(Math.abs(val), exp);
+export const signPow = (val: number, exp: number) =>
+  sign(val) * Math.pow(Math.abs(val), exp);

TypeScript/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "es5",
+    "lib": ["es5", "dom"],
+    "declaration": true,
+    "outDir": "./dist/",
+    "sourceMap": true,
+    "noImplicitAny": true
+  },
+  "include": ["src/index.ts"]
+}

Typescript/demo/index.html

@@ -1,28 +0,0 @@
-<!DOCTYPE html>
-<html>
-    <head>
-        <title>Blurhash test file</title>
-        <style>
-            * {
-                box-sizing: border-box;
-            }
-
-            #canvas {
-                display: block;
-                width: 632px;
-                height: 356px;
-            }
-
-            #blurhash {
-                margin-top: 20px;
-                font-size: 24px;
-                width: 632px;
-            }
-        </style>
-    </head>
-    <body>
-        <canvas id="canvas" width="32" height="32"></canvas>
-        <input id="blurhash" type="text" value="LNMF%n00%#MwS|WCWEM{R*bbWBbH" />
-        <script src="./demo.js"></script>
-    </body>
-</html>

Typescript/dist/base64.d.ts

@@ -1 +0,0 @@
-export declare const decode64: (str: String) => number;

Typescript/dist/base64.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var digitCharacters = [
-    "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
-    "a", "b", "c", "d", "e", "f", "g", "h", "i", "j",
-    "k", "l", "m", "n", "o", "p", "q", "r", "s", "t",
-    "u", "v", "w", "x", "y", "z", "A", "B", "C", "D",
-    "E", "F", "G", "H", "I", "J", "K", "L", "M", "N",
-    "O", "P", "Q", "R", "S", "T", "U", "V", "W", "X",
-    "Y", "Z", ":", ";"
-];
-exports.decode64 = function (str) {
-    var value = 0;
-    for (var i = 0; i < str.length; i++) {
-        var c = str[i];
-        var digit = digitCharacters.indexOf(c);
-        value = (value << 6) + digit;
-    }
-    return value;
-};
-//# sourceMappingURL=base64.js.map

Typescript/dist/base64.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base64.js","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":";;AAAA,IAAM,eAAe,GAAG;IACpB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAChD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAChD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAChD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAChD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAChD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;IAChD,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;CACrB,CAAA;AAEY,QAAA,QAAQ,GAAG,UAAC,GAAW;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAI,IAAI,CAAC,GAAC,CAAC,EAAE,CAAC,GAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QAC5B,IAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QACjB,IAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACzC,KAAK,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;KAChC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAA"}

Typescript/dist/decode.d.ts

@@ -1,2 +0,0 @@
-declare const decode: (blurhash: string, width: number, height: number, punch?: number) => Uint8ClampedArray;
-export default decode;

Typescript/dist/decode.js

@@ -1,76 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var base64_1 = require("./base64");
-var utils_1 = require("./utils");
-var decodeDC = function (value) {
-    var intR = value >> 16;
-    var intG = (value >> 8) & 255;
-    var intB = value & 255;
-    return [utils_1.sRGBToLinear(intR), utils_1.sRGBToLinear(intG), utils_1.sRGBToLinear(intB)];
-};
-var decodeAC = function (value, maximumValue) {
-    var quantR = value >> 8;
-    var quantG = (value >> 4) & 15;
-    var quantB = value & 15;
-    var rgb = [
-        utils_1.signPow((quantR - 8) / 8, 3.0) * maximumValue * 2,
-        utils_1.signPow((quantG - 8) / 8, 3.0) * maximumValue * 2,
-        utils_1.signPow((quantB - 8) / 8, 3.0) * maximumValue * 2,
-    ];
-    return rgb;
-};
-var decode = function (blurhash, width, height, punch) {
-    punch = punch | 1;
-    if (blurhash.length < 6) {
-        console.error('too short blurhash');
-        return null;
-    }
-    var sizeFlag = base64_1.decode64(blurhash[0]);
-    var numY = (sizeFlag >> 3) + 1;
-    var numX = (sizeFlag & 7) + 1;
-    var quantisedMaximumValue = base64_1.decode64(blurhash[1]);
-    var maximumValue = (quantisedMaximumValue + 1) / 128;
-    if (blurhash.length !== 4 + 2 * numX * numY) {
-        console.error('blurhash length mismatch', blurhash.length, 4 + 2 * numX * numY);
-        return null;
-    }
-    var colors = new Array(numX * numY);
-    for (var i = 0; i < colors.length; i++) {
-        if (i === 0) {
-            var value = base64_1.decode64(blurhash.substring(2, 6));
-            colors[i] = decodeDC(value);
-        }
-        else {
-            var value = base64_1.decode64(blurhash.substring(4 + i * 2, 6 + i * 2));
-            colors[i] = decodeAC(value, maximumValue * punch);
-        }
-    }
-    var bytesPerRow = width * 4;
-    var pixels = new Uint8ClampedArray(bytesPerRow * height);
-    for (var y = 0; y < height; y++) {
-        for (var x = 0; x < width; x++) {
-            var r = 0;
-            var g = 0;
-            var b = 0;
-            for (var j = 0; j < numY; j++) {
-                for (var i = 0; i < numX; i++) {
-                    var basis = Math.cos(Math.PI * x * i / width) * Math.cos(Math.PI * y * j / height);
-                    var color = colors[i + j * numX];
-                    r += color[0] * basis;
-                    g += color[1] * basis;
-                    b += color[2] * basis;
-                }
-            }
-            var intR = utils_1.linearTosRGB(r);
-            var intG = utils_1.linearTosRGB(g);
-            var intB = utils_1.linearTosRGB(b);
-            pixels[4 * x + 0 + y * bytesPerRow] = intR;
-            pixels[4 * x + 1 + y * bytesPerRow] = intG;
-            pixels[4 * x + 2 + y * bytesPerRow] = intB;
-            pixels[4 * x + 3 + y * bytesPerRow] = 255; // alpha
-        }
-    }
-    return pixels;
-};
-exports.default = decode;
-//# sourceMappingURL=decode.js.map

Typescript/dist/decode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"decode.js","sourceRoot":"","sources":["../src/decode.ts"],"names":[],"mappings":";;AAAA,mCAAoC;AACpC,iCAA8D;AAE9D,IAAM,QAAQ,GAAG,UAAC,KAAa;IAC7B,IAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;IACzB,IAAM,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC;IAChC,IAAM,IAAI,GAAG,KAAK,GAAG,GAAG,CAAC;IACzB,OAAO,CAAC,oBAAY,CAAC,IAAI,CAAC,EAAE,oBAAY,CAAC,IAAI,CAAC,EAAE,oBAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC,CAAC;AAEF,IAAM,QAAQ,GAAG,UAAC,KAAa,EAAE,YAAoB;IACnD,IAAM,MAAM,GAAG,KAAK,IAAI,CAAC,CAAC;IAC1B,IAAM,MAAM,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IACjC,IAAM,MAAM,GAAG,KAAK,GAAG,EAAE,CAAC;IAE1B,IAAM,GAAG,GAAG;QACV,eAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC;QACjD,eAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC;QACjD,eAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,YAAY,GAAG,CAAC;KAClD,CAAC;IAEF,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,IAAM,MAAM,GAAG,UAAC,QAAgB,EAAE,KAAa,EAAE,MAAc,EAAE,KAAc;IAC7E,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IAElB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;KACb;IAED,IAAM,QAAQ,GAAG,iBAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,IAAM,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,IAAM,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAEhC,IAAM,qBAAqB,GAAG,iBAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAM,YAAY,GAAG,CAAC,qBAAqB,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IAEvD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE;QAC3C,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;KACb;IAED,IAAM,MAAM,GAAG,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACtC,IAAI,CAAC,KAAK,CAAC,EAAE;YACX,IAAM,KAAK,GAAG,iBAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC7B;aAAM;YACL,IAAM,KAAK,GAAG,iBAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjE,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,CAAC,CAAC;SACnD;KACF;IAED,IAAM,WAAW,GAAG,KAAK,GAAG,CAAC,CAAC;IAC9B,IAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE;YAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,CAAC;YAEV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE;gBAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE;oBAC7B,IAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;oBACrF,IAAI,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;oBACjC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;oBACtB,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;oBACtB,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;iBACvB;aACF;YAED,IAAI,IAAI,GAAG,oBAAY,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,IAAI,GAAG,oBAAY,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,IAAI,GAAG,oBAAY,CAAC,CAAC,CAAC,CAAC;YAE3B,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;YAC3C,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;YAC3C,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC;YAC3C,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ;SACpD;KACF;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,kBAAe,MAAM,CAAC"}

Typescript/dist/index.d.ts

@@ -1 +0,0 @@
-export { default as decode } from './decode';

Typescript/dist/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-var decode_1 = require("./decode");
-exports.decode = decode_1.default;
-//# sourceMappingURL=index.js.map

Typescript/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAAA,mCAA6C;AAApC,0BAAA,OAAO,CAAU"}

Typescript/dist/utils.d.ts

@@ -1,4 +0,0 @@
-export declare const sRGBToLinear: (value: number) => number;
-export declare const linearTosRGB: (value: number) => number;
-export declare const sign: (n: number) => 1 | -1;
-export declare const signPow: (val: number, exp: number) => number;

Typescript/dist/utils.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sRGBToLinear = function (value) {
-    var v = value / 255;
-    if (v <= 0.04045) {
-        return v / 12.92;
-    }
-    else {
-        return Math.pow((v + 0.055) / 1.055, 2.4);
-    }
-};
-exports.linearTosRGB = function (value) {
-    var v = Math.max(0, Math.min(1, value));
-    if (v <= 0.0031308) {
-        return Math.round(v * 12.92 * 255 + 0.5);
-    }
-    else {
-        return Math.round((1.055 * Math.pow(v, 1 / 2.4) - 0.055) * 255 + 0.5);
-    }
-};
-exports.sign = function (n) { return (n < 0 ? -1 : 1); };
-exports.signPow = function (val, exp) { return exports.sign(val) * Math.pow(Math.abs(val), exp); };
-//# sourceMappingURL=utils.js.map