How could you build up such expectations and not include samples? I went to the link and the full documentation and only saw one diagram: a circle and a square with an arrow between. Please, demonstrate the capabilities.
My first thought is that it needs more thorough documentation. As you said, it's thin right now.
My second thought is that it really needs text. As it stands, for labels, I'd have to capture the image from the HTML file and use my image editor to add text. Doable, but text on the diagram would be great.
The chessboard was very easy. Took just a few minutes to write once I had some sense of how to use the package. I think there might be a bug in the Square shape initializer. This didn't work:
Square(20, fill='red')
Python complains of a missing "size" parameter. When I wrote it as if it was a Rect:
Square(None, 20, fill='red')
It worked fine. An apparent issue with the dunder init signature, perhaps?
For the process diagram, I had to use "ghost" boxes. I left the stroke visible just to see their location; that could be make white to vanish them completely. But I seemed to need them to get the spacing I wanted. I first tried a Column of Rows but couldn't get columns to line up. Then I tried a Row of Columns, and that worked better. But I still had to use ghost shapes for spacing. A matrix-like layout would be a treat.
Awesome! Thanks for the feedback. Yes definitely a text label is missing, and that square bug 🤦♂️ shame on me. I'm working on better layouts for doing things like grid-based placement. It's going to keep evolving. Thanks a lot for trying it out ;)
In the reverse direction, it would be nice to be able to save as a PNG or other image type. (I suppose with SVG, one would need to specify rendered image size?)
Currently, I can render the images on my browser and do a screen capture to save as a PNG, but with diagrams longer than the screen height I'm a little stuck. Edge does have a screen capture feature that will grab the entire screen, but it insists on leaving a very faint grey line where the screen bottom edge was. No idea of that's a bug or an intended feature; feels like a bug.
What I did for that second image of the process diagram was zoom out until the image fit the screen, but of course then I get a smaller image. So, a "save to image file" feature would be a treat.
Kinda but I believe ggplot is designed from the ground up for the data-to-plot domain. Which means is really good for Altair-like graphics, things like project this dataframe into a barchart domain.
Where are the examples? The gallery?
How could you build up such expectations and not include samples? I went to the link and the full documentation and only saw one diagram: a circle and a square with an arrow between. Please, demonstrate the capabilities.
Show us what you’ve got! Please.
Haha fair, I've been updating the gallery, it's still rather simple but closer to what I intended.
Sweet. I've been wanting something like this. I'll give it a shot ASAP.
Cool! Love to hear whatever feedback you have later on :)
I played with it a bit today. I put two images in a Note:
https://substack.com/@wyrdsmythe/note/c-208066870
My first thought is that it needs more thorough documentation. As you said, it's thin right now.
My second thought is that it really needs text. As it stands, for labels, I'd have to capture the image from the HTML file and use my image editor to add text. Doable, but text on the diagram would be great.
The chessboard was very easy. Took just a few minutes to write once I had some sense of how to use the package. I think there might be a bug in the Square shape initializer. This didn't work:
Square(20, fill='red')
Python complains of a missing "size" parameter. When I wrote it as if it was a Rect:
Square(None, 20, fill='red')
It worked fine. An apparent issue with the dunder init signature, perhaps?
For the process diagram, I had to use "ghost" boxes. I left the stroke visible just to see their location; that could be make white to vanish them completely. But I seemed to need them to get the spacing I wanted. I first tried a Column of Rows but couldn't get columns to line up. Then I tried a Row of Columns, and that worked better. But I still had to use ghost shapes for spacing. A matrix-like layout would be a treat.
Interesting product, if obviously in early days.
Awesome! Thanks for the feedback. Yes definitely a text label is missing, and that square bug 🤦♂️ shame on me. I'm working on better layouts for doing things like grid-based placement. It's going to keep evolving. Thanks a lot for trying it out ;)
Another neat feature would be something like Sprites — bitmap images you could put on the drawing.
Oh, absolutely, and loading SVGs from files
In the reverse direction, it would be nice to be able to save as a PNG or other image type. (I suppose with SVG, one would need to specify rendered image size?)
Currently, I can render the images on my browser and do a screen capture to save as a PNG, but with diagrams longer than the screen height I'm a little stuck. Edge does have a screen capture feature that will grab the entire screen, but it insists on leaving a very faint grey line where the screen bottom edge was. No idea of that's a bug or an intended feature; feels like a bug.
What I did for that second image of the process diagram was zoom out until the image fit the screen, but of course then I get a smaller image. So, a "save to image file" feature would be a treat.
I'll anticipate new features, but it already looks like it will be useful in making some diagrams I need for a project.
Feel free to upgrade whenever you want, you should see text, PNG export and a few goodies on layout.
I upgraded but couldn’t get export to PNG to work. When I run pip:
» pip install tesserax[export]
I get:
» Requirement already satisfied: tesserax[export] in C:\Program Files\Python313\Lib\site-packages (0.5.2)
» WARNING: tesserax 0.5.2 does not provide the extra 'export'
And, indeed, when I run my code, I get an error telling me:
» Export requires 'cairosvg'. Install with: pip install tesserax[export]
Any thoughts?
FWIW, I first upgraded, then tried to run the code, got the above error, and then installed with [export]. Don’t know if that matters.
Cool! Reminds me of ggplot/Grammar of Graphics for figures.
Kinda but I believe ggplot is designed from the ground up for the data-to-plot domain. Which means is really good for Altair-like graphics, things like project this dataframe into a barchart domain.
Could this work for documentation of IT systems, networks and so on?
Maybe a github discussion would make sense