diff options
Diffstat (limited to 'translate/BrailleTranslator.java')
-rw-r--r-- | translate/BrailleTranslator.java | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/translate/BrailleTranslator.java b/translate/BrailleTranslator.java new file mode 100644 index 0000000..e7ee9cb --- /dev/null +++ b/translate/BrailleTranslator.java @@ -0,0 +1,35 @@ +/* + * Copyright (C) 2012 Google Inc. + * + * Licensed under the Apache License, Version 2.0 (the "License"); you may not + * use this file except in compliance with the License. You may obtain a copy of + * the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT + * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the + * License for the specific language governing permissions and limitations under + * the License. + */ + +package com.googlecode.eyesfree.braille.translate; + +/** + * Translates from text to braille and the other way according to a + * particular translation table. + */ +public interface BrailleTranslator { + /** + * Translates a string into the corresponding dot patterns and returns the + * resulting byte array. Returns {@code null} on error. + */ + byte[] translate(String text); + + /** + * Translates the braille {@code cells} into the corresponding text, which + * is returned. Returns {@code null} on error. + */ + String backTranslate(byte[] cells); +} |