:shipit: Ambigram

:bookmark: Table of contents

1. About
2. Installation
3. Example
4. Notes

:question: About

Ambigram is a small but powerful library that automates the process of creating 3D Ambigram from two different length (with spaces) strings.

:file_folder: Installation

:penguin: Binary dependencies (Unix)

sudo apt-get install python3 python3-pip python3-setuptools

:snake: Option 1: Pypi

python3 -m pip install ambigram

:hand: Option 2: Git repository (Still connects to Pypi)

pip install git+https://github.com/sivefunc/ambigram.git

:computer: Example

Simple Text

from cadquery.vis import show
from ambigram import Ambigram

ambigram = Ambigram("HELLO", "WORLD")
show(ambigram.assembly)

X Perspective	Y Perspective

Two different length string with a Rectangular Base

from cadquery.vis import show
from ambigram import Ambigram

ambigram = Ambigram("ANDROID", "IOS")
ambigram = ambigram.add_base_rectangle(
    height=ambigram.font_size / 10.0,
    padding=ambigram.font_size / 10.0,
)
show(ambigram.assembly)

X Perspective	Y Perspective

Letter Support + Base

from cadquery.vis import show
from ambigram import Ambigram

ambigram = Ambigram("RECURSIVE", "FUNCTION")

ambigram = ambigram.add_letter_support_to_all(
    cylinder_height=ambigram.font_size / 4.0,
    cylinder_radius=ambigram.font_size / 4.0,
    rect_height=ambigram.font_size / 16.0,
)

ambigram = ambigram.add_base_rectangle(
    height=ambigram.font_size / 10.0,
    padding=ambigram.font_size / 10.0,
)
show(ambigram.assembly)

X Perspective	Y Perspective

:notebook: Notes

• Different Length String are implemented by placing the extra chars behind the shortest one (see it for yourself)
• Spaces are Allowed but needs further testing.
• A new algorithm for bases is need the current ones are rectangular and P2P, P2P is quite good at == string lengt but more improvement is needed.
• Needs further documentation
• Needs further testing

Thanks to

• 2CatTeam That allowed me to see that whitespaces and different string length are allowed.
• Lucandia That allowd me to see that It was possible in Python.

Made by :link: Sivefunc

Licensed under :link: GPLv3