Create shape-bounded text in script

Hello,

o replicate shape-bounded text in a JSX (JavaScript for Adobe Illustrator) script, you need to work with both TextFrame and shape objects, such as Ellipse (for circles). In Illustrator scripting, these objects interact as follows:

Create the Shape: First, you need to create the shape, such as a circle or any other closed path (for example, using the PathItems.ellipse() method to create an ellipse).
Create Text and Fit It to the Shape: After creating the shape, you need to place text inside it. The TextFrame object can be used to create text. You can then fit the text to the boundaries of the shape (ellipse in this case).

example of how you can create shape-bounded text inside an ellipse in JSX:

// Create a new document
var doc = app.documents.add();

// Define ellipse dimensions (position, width, height)
var x = 200;
var y = 200;
var width = 400;
var height = 200;

// Create an ellipse shape (path item)
var ellipse = doc.pathItems.ellipse(y + height / 2, x - width / 2, width, height);

// Create a text frame inside the ellipse
var textFrame = doc.textFrames.add();
textFrame.contents = "Hello, Illustrator!";

// Set the text frame's position
textFrame.position = [x - width / 2, y + height / 2];

// Fit text inside the shape (ellipse)
textFrame.textPath = ellipse; // Make text follow the path of the ellipse

// Optionally adjust text properties (font, size, etc.)
var textRange = textFrame.textRange;
textRange.characterAttributes.size = 24;
textRange.characterAttributes.textFont = app.textFonts.getByName("Arial");

// Adjust the text to be vertically aligned in the center of the shape
textFrame.textPathJustification = Justification.CENTER;

Ellipse Creation: The ellipse is created using the doc.pathItems.ellipse() method. This takes the y and x positions, followed by the width and height.
TextFrame Creation: The textFrame is added to the document and its contents is set to the text you want to display.
Positioning: The text frame is positioned at the center of the ellipse.
Text Fit to Path: The key part here is textFrame.textPath = ellipse;, which makes the text follow the path of the ellipse (or any shape you create).
Text Adjustments: You can adjust the font, size, and other properties of the text as needed.

The textPath property links the text frame to the path of the shape (ellipse), making the text conform to its outline. dgme paystub
Depending on the text length, you might need to adjust font size or the shape's size to make the text fit properly within the shape.
The textFrame.textPathJustification property is used to align the text inside the path (center, left, or right).