Welcome to PlantUML Q&A, where you can ask questions and receive answers from other members of the community.

You can also submit new features request and vote for them.

Translate Class Diagram to Braille

0 votes


I have a tutorial that illustrates the creation of class diagrams using UML. I need to print the diagrams of the examples in braille. I can convert the diagrams generated by PlantUML in braille?
asked Jul 15, 2016 by robersonjfa (120 points)

1 Answer

0 votes

Are you talking about the PNG image generated by PlantUML ?
answered Jul 18, 2016 by plantuml (125,190 points)

Can be generated via PNG image, or in any other output format supported by PlantUML.
We have a student with visual impairment and need it to be able to build small diagrams and also reads them.
The idea is to print the diagrams in braille format.

Could you precise the meaning of "to print the diagrams in braille format" ?
Do you wish us to use https://en.wikipedia.org/wiki/Braille_Patterns ?
Or https://en.wikipedia.org/wiki/English_Braille ?

Let's take a simple & concrete example:

class Foo
class Foo extends Bar

This generates a PNG image as follow http://www.plantuml.com/plantuml/png/Iyv9B2vMSClFvqg6iHHIAqfIyrAA5PmIYm00
Could you post here a sample of what you are expecting with this simple example ?


I need something like this:

from text:
class Person
class Client extends Person

to png:


to braille:


Ok, thanks. That's more clear.
Yes, I think we will be able to provide something.
However, this is a new feature, so we need some time (2 months?) to release it, so please be patient :-)

We'll post a message here when we will have a first working version.
BTW, did you use some special software to do your example image ( https://postimg.org/image/s8cguvsn5/ ) ?

To build the example image, in braille, i used this software: PictureBraille - http://www.pentronics.com.au/index_files/PictureBraille.htm.
We are grateful that you have accepted the challenge to add this feature to PlantUML.
I am a Java Developer, if i can hel in some way please call me.

Thanks, Java skill may be useful in some future, when the code would be more consistent.

Right now, we have a first alpha version.
You can download it here https://dl.dropboxusercontent.com/u/13064071/plantuml.jar

We have added some -braille flag that generates PNG image (using braille) [Next version may allow EPS or SVG generation, if needed].

java -jar plantuml.jar -tbraille test.txt

Many things are not working yet. However, we are interested with feedback about:
- The general design of the image (size, grid lines and colors...)
- Conversion to braille text (We have little knowledge about it and we have used information on https://en.wikipedia.org/wiki/English_Braille )

As you will see, the drawing of the schema is not complete yet. Once again, we would like to focus on text first.

Could you test it with some diagrams you'd like to use ?
Eventually, if you could send us (by mail for example) your diagrams, it would help to test with real world example.

Support This Project Offer 250 Mo! Follow PlantUML on Twitter