c.1 Button
I. Overview of Button Tools
Style3D Studio provides a complete Button tool‑set to add, edit and manage buttons on 3D garments. Buttons are an important part of garment trims, widely used for shirts, overcoats, suits, trousers and other apparel styles.
Core Functions of Button Tool | Explanation |
Add Single Button | Place buttons at specified positions on plates |
Add Multiple Buttons Along Path | Add multiple buttons equidistant/equal along the inner line or clear edge |
Edit Button Properties | Adjust parameters such as size, number of holes, material, color, etc. |
Button Positioning | Precisely control the position of the button on the plate (up and down/left and right offset) |
Align Buttons with Buttonholes | Automatic or manual alignment of buttons and buttonholes |
Button Grading | Automatic adjustment of button position and quantity in different sizes |
�Tip: Button files use the .sbtn format, while buttonhole files use the .sbth format. These files can be saved and reused in the asset library.
Ⅱ. Adding a Single Button
Step 1: Select the button tool
Button Tool Access Path
Click Materials / Attachments ▶ Button Tool on the toolbar to enter button‑editing mode.
Step 2: Click to place on the pattern piece
In the 2D viewport, click directly on the target position of the pattern piece. A default button will be generated at this position
Step 3: Adjust position
You can drag‑and‑drop with the mouse to adjust its position after placement.
Step 4: Set Button Properties
After selecting the button, modify parameters in the [Property Editor Viewport] on the right: button width (diameter), button style, button material & color, button thickness, etc.
�Tip: Once added, buttons automatically stick to the pattern‑piece surface and display synchronously with the pattern piece in the 3D viewport.
Ⅲ. Adding Multiple Buttons Along Path
For styles requiring a row of buttons such as shirts and overcoats, use the [Add Buttons Along] Path function to place multiple evenly‑spaced buttons along internal lines or seam allowances in one go.
Step 1: Enter the Button Tool mode
Toolbar ▶ Materials / Attachments ▶ Button Tool
Step 2: Right‑click to select reference line
In the 2D viewport, right‑click the target internal line or seam edge for button placement, and the [Add Buttons Along Internal Line or Seam Edge] window will pop‑up.
Step 3: Configure button parameters
Configure the following items in the pop‑up setting panel:
- Number of buttons
- Spacing Mode (Equal Distance / Equal Division)
- Start offset
- End offset
- Button size and style
Step 4: Confirm and generate
After confirming settings, the system will automatically generate the defined number of buttons evenly distributed along the reference line.
� Tip: It is recommended to use the Equal Division mode. Buttons placed in this mode have no quantity limit during grading; you can freely adjust button counts for different sizes (New feature in V9.2).
Ⅳ. Fasten Buttons
Operation Path: Materials ▶ Fasten Buttons
Operation Instruction: After activating this function, click a button and its matching buttonhole. The button will be fastened onto the buttonhole during simulation.
Ⅴ. Button Property Settings
After selecting a button, configure detailed button parameters in the Property Editor Viewport on the right:
Properties | Description |
Size / Diameter | Controls the diameter size of the button |
Hole Count | Sets button hole count; common options are 2‑hole and 4‑hole |
Thickness | Button thickness, affects 3D rendering appearance |
Material/Color | Sets the material appearance and color of the button |
Collision | Sets whether the button participates in physics‑simulated collision |
Frozen State | Locks button position to prevent displacement during simulation |
� Prompt
Buttons have three collision states:
Buttons have three collision states:
① Do Not Collide — Buttons do not collide with garments or avatar
② Collide Not Frozen (Attachment Participates in Simulation) — Buttons follow fabric for simulation
③ Collide Frozen — Buttons collide while keeping their position fixed
Ⅵ. Button Alignment Button‑to‑buttonhole alignment: When making front plackets, buttons are usually placed on the left front pattern piece and matching buttonholes on the right front piece. Use the Copy Buttonholes to Symmetric Pattern Piece function (V9.2+) to mirror buttons / buttonholes onto symmetric pattern pieces quickly.
Operation Method: Select attachment ▶ Right‑click ▶ Copy Buttonholes to Symmetric Pattern Piece
This function is only available when a symmetry axis has been set for the single pattern. If the left and right front plackets are two separate pattern pieces (unmerged), this function cannot be used; you need to add matching buttonholes manually on the opposite side.
⚠️ Note: Only when the pattern piece is rectangular, dragging the button horizontally will not alter its vertical offset value. Pattern pieces of other shapes will trigger linked value changes according to actual geometry.
Ⅶ. Convert to Button (Trace Contour Mode)
Starting from V7.0, Style3D Studio supports converting holes (created under Trace Contour mode) directly into buttons or buttonholes. This is highly useful for reverse‑generating buttons (imported from 3D models).
Step 1: Enter Trace Contour mode
Use the Trace Contour function for models such as OBJ in the 3D viewport.
Step 2: Right‑click for conversion
Right‑click on the traced hole and select 【Convert to Button】 or 【Convert to Buttonhole】.
Figure: Trace Contour Mode‑Right‑click Menu ‑ Convert to Button / Convert to Buttonhole
Figure: Convert to Button Operation Demo
� Tip: This function is also triggered automatically during intelligent conversion of OBJ files. The system can recognize trim types including zipper slider, zipper pull, zipper teeth, top left stop, bottom left stop, top right stop, bottom right stop, topstitch, buttons and buttonholes.
Ⅷ. Button and Buttonhole Grading
Description: Supports grading for single‑select and multi‑select of buttons, buttonholes and holes; supports grading for buttons along path (grade vertex only); supports importing ET button grading data
Operation Path: Start ▶ Grading ▶ Select objects (buttons, buttonholes, holes) ▶ Edit grading information in property panel
- Standard Button / Buttonhole / Hole Grading ‑ Single‑select / Multi‑select Grading
- Buttons‑along‑path Grading ‑ Internal Line Grading
Ⅸ. Button‑grading Quantity Adjustment (New Feature in V9.2)
V9.2 adds the button‑grading quantity adjustment feature. Buttons and buttonholes placed along paths allow secondary editing of button counts for different sizes.
⚡ It is recommended to add buttons with Equal Division mode. Buttons have no quantity limit during grading, and you can freely adjust button counts for different sizes (New Feature in V9.2).
Step 1: Add buttons along path
Materials ▶ Button / Buttonhole ▶ Right‑click the target reference line ▶ Add Buttons Along Internal Line or Seam Edge
Step 2: Enter grading mode to edit quantity
Edit Pattern Piece, Button / Buttonhole, Grading function ▶ Right‑click the line for path‑added buttons or buttonholes ▶ Modify Button Quantity
Figure: V9.2 Button Grading Quantity Adjustment Interface
Ⅹ. AI‑Generated 3D Buttons (V8.1+)
Starting from V8.1, Style3D Studio supports the AI‑generated 3D trim function. Users can upload images or enter text descriptions to generate 3D button models.
Step 1: Open the AI generation panel
Operation Path: Start ▶ AI Integration ▶ AI Trim
AI Integration
AI Trim
Step 2: Select generation method
Image Generation: Upload button photos (maximum 4 images). The first image shall be the front view (required). Subsequent images shall be uploaded in the order of left → back → right.
Photo requirements: show the complete model, resolution higher than 500×500 pixels, file size under 10 MB; supported formats: WEBP/JPG/JPEG/PNG.
Text Generation: Enter text descriptions (e.g. "Generate a black button"), up to 500 characters.
Figure: AI Text‑Generated Buttons ‑ Description Input Interface
Figure: AI Image Generation ‑ Photo Upload Interface
Step 3: Set parameters and generate
• Face Count Limit: Input range 10k‑1m • Longest Edge Length: Range 0.01cm‑1000cm • Each generation consumes 20 AI credits
� Tip: AI‑generated 3D models share the same capabilities as standard trims. They can be snapped to pattern pieces, participate in collision and support grading just like ordinary buttons.
Ⅺ. Script‑based Button Replacement (V9.2+)
V9.2 adds the Python‑script function for replacing buttons, zippers and trims. Scripts enable batch replacement of buttons within projects, greatly improving trim‑management efficiency for high‑volume styles.
Python Script Entry
Operation Path: Tools ▶ Python Script
Application Scenarios:
- Batch‑replace button styles across multiple styles
- Unified trim replacement in automated pipelines
- Work with marker‑making scripts to realize one‑click production workflow