text() – text command tutorial

As of OpenSCAD 2019 text has gotten a lot easier to add in OpenSCAD. Basic text can be added with just the bare Command:

text( "Basic Text" );

This command can be translated and rotated just liky any other object in OpenSCAD, but keep in mind it is 2d first and needs to be extruded.

text( "Extruded Text");

So the defaults for size are 10 for text size and 100 for linear_extrude let’s fix that by giving some sizes.

text( "Extruded Text", size= 5);

The text is now 5 Units Tall, and it is extruded 3 units in thickness

Using Different Fonts

We can change the Font Type using the Font keyword.

OpenSCAD can use any of the system fonts found in the installation. To make it easier to use a font stlye you can list fonts from the Help menu.

Click Help-Font List to get this list:

Select the font you would like to use and click “Copy to The Clipboard” This will copy the Font and Style in the correctly formatted string.

linear_extrude( 1)
text( "Text",size=5,font="Uechi:style=Gothic" , $fn=50);

Changing Orientation

We can place text into various orientation, by using the direction keyword. There are four directions we can organize lettering.

text( "Left to Right" ,size=5, direction="ltr");
text( "Up" ,size=5, direction="btt");
text( "Down" ,size=5, direction="ttb");
text( "Right to left" ,size=5, direction="rtt");

Adding Horizontal Alignment

Horizontal alignment is in regard to to origin and the bounding box of the text. It is best explained visual. Take note of where the origin is for each alignment. The alignment is by length of the rendered text NOT by character count.

text( "Left Aligned" ,halign = "left" );
text( "Right Aligned" ,halign = "right" );
text( "Center Aligned" ,halign = "center" );

Below you can see the 3 vertical alignments. The alignment refers to were origin will align with the text.

text( "Text", valign="top");
text( "Text", valign="center");
text( "Text", valign="bottom");



There are a few more options for Text in OpenSCAD but the above are the ones you will use the most.

2 Replies to “text() – text command tutorial”

  1. Bernie Goldberg

    How do you set the color of the text?
    I tried doing this:

    color(“red”) text(text3,direction=”ltr”,size=textsizeA);

    but that does not seem to work.

    Any suggestions would be appreciated.

    • admin

      Your color command is correct.

      This code works:
      text3 = "Some Text";
      textsizeA = 10;


      Do you have values in the variables you are using?

      Perhaps there is an error elsewhere ( preceding the color command. )
      Perhaps, try the code alone in a new design.

Leave a Reply

Your email address will not be published. Required fields are marked *