summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README36
1 files changed, 36 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..4a93b1e
--- /dev/null
+++ b/README
@@ -0,0 +1,36 @@
+# rescribe.xyz/preproc package
+
+This package contains various image processing methods which are
+useful for preprocessing page images for OCR. It also contains
+several commands in the cmd/ directory which can be used to
+preprocess images directly.
+
+# Commands
+
+There are several commands in the cmd/ directory which are useful
+in their own right as well as serving as examples of using the
+package.
+
+ - binarize : binarises an image using the sauvola algorithm
+ - preproc : binarises and wipes an image
+ - preprocmulti : binarises and wipes an image with multiple
+ binarisation ksize values
+ - wipe : wipes sections of an image that are outside an
+ area detected as content
+
+# Bugs
+
+The integral image operations don't produce exactly the same result
+as their non-integral image counterparts. The difference is small
+enough that it has little effect on the output images, but it ought
+to be identical.
+
+# Contributions
+
+Any and all comments, bug reports, patches or pull requests would
+be very welcomely received. Please email them to <nick@rescribe.xyz>.
+
+# License
+
+This package is licensed under the GPLv3. See the LICENSE file for
+more details.