Interactive 3D Shape Viewer & STL Exporter

Welcome to the 3D Shape Viewer, a powerful yet easy-to-use tool for visualizing and customizing common and complex 3D geometric shapes. This application allows you to select from a wide variety of shapes, adjust their dimensions and parameters in real-time, and export your creation as a "water-tight" STL file, ready for 3D printing or use in other CAD software.

How to Use the Viewer

Using the tool is simple. The application is split into a control panel and a 3D viewing window.

1. Select a Shape: Use the left-hand menu to choose a base shape.
2. Adjust Dimensions: Use the "Dimensions" collapsible menu to change the shape. For parametric shapes (like a Ring or Pipe), specific controls will appear.
3. Control the View: Left-click and drag in the 3D window to orbit. Use the scroll wheel to zoom.
4. Export to STL: Click the green "Export as STL" button to download your file.

What is an STL file?

STL (STereoLithography) is a file format native to CAD software. It is widely used for 3D printing. This tool ensures that all exported geometries are "water-tight" (meaning they have no holes), which is critical for 3D printing.

Behind the Code: 3D Mesh Generation Principles

This viewer leverages the power of Three.js, a cross-browser JavaScript library/API used to create and display animated 3D graphics on a WebGL canvas. The process of generating your shape involves several key steps:

• Geometry Creation: Each shape is built using a specific THREE.Geometry or THREE.BufferGeometry class. Simple primitives like the Cube use built-in geometry functions (BoxGeometry).
• Parametric Shapes: Complex shapes like the Ring, Heart, and Star Prism are created **parametrically**. They often start with a 2D THREE.Shape (a series of connected points) which is then converted into a 3D volume using **extrusion** (THREE.ExtrudeGeometry) or **revolution** (lathe geometry for the Diamond). This allows for dynamic adjustments like inner/outer radius or bevel depth.
• Tessellation (Resolution): Curved surfaces (Sphere, Cone, Cylinder) are not mathematically smooth; they are approximated by **triangular facets** (a process called **tessellation**). The “Resolution” slider controls the number of segments (facets) used for this approximation. A higher resolution means a smoother surface but a larger file size and higher computational cost.
• The Mesh Structure: The final object is a THREE.Mesh, which is composed of two main elements:
  • Vertices: The corner points in 3D space that define the shape.
  • Faces (Triangles): Sets of three vertices that form a flat, visible surface. STL files exclusively use this triangular representation.
• Water-Tight Export: For 3D printing, the mesh must be “water-tight,” meaning every edge is shared by exactly two faces, forming a completely enclosed volume. The generation logic ensures this closure, which is critical for successful slicing.

Frequently Asked Questions

Is the tool free to use?

Yes. The 3D Shape Viewer & STL Exporter is completely free. You can generate, customize, and export as many shapes as you like at no cost.

Do I need to install or sign up for anything?

No. There is nothing to install and no account to create. The application runs entirely in your web browser — just open the page and start designing.

What is an STL file used for?

STL (STereoLithography) is the standard file format for 3D printing and CAD software. It describes the surface of a 3D model as a mesh of triangles, which slicing software converts into instructions for a 3D printer.

Can I use the exported files for commercial 3D printing?

Yes. The geometry you create is your own. You are free to print, sell, or otherwise use the exported STL files for personal or commercial projects.

Does the viewer work on mobile devices?

Yes. The interface is responsive and works on modern smartphones and tablets. On touch screens you can drag to orbit the model and pinch to zoom. A larger screen is recommended for fine-tuning detailed parameters.

Is my model data uploaded anywhere?

No. All geometry generation and STL export happen locally in your browser. Nothing is sent to a server — your designs never leave your device.

Tips for Better 3D Prints

A few practical guidelines will help your exported models print cleanly and reliably:

• Choose an appropriate resolution: Higher tessellation produces smoother curved surfaces but larger files. For most prints a moderate Resolution setting is enough — extreme values mainly increase slicing time without visible benefit at typical print scales.
• Mind wall thickness: For parametric shapes such as the Pipe or Ring, keep the difference between the inner and outer radius at or above your nozzle width (commonly 0.4 mm) so the walls are thick enough to print solidly.
• Pick a stable orientation: Position the model so it has a flat, broad face on the print bed. This improves bed adhesion and reduces the need for support material on overhangs.
• Scale before slicing: Confirm the model dimensions in your slicer, since STL files carry geometry but no fixed real-world units. Adjust the scale to match your intended physical size.