> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 3d application

> Generate interactive 3D model viewers (GLB/GLTF) with shareable URLs

**Server path:** `/3d-application` | **Type:** Embedded | **PCID required:** No

## Tools

| Tool                                    | Description                                                                                                                          |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| [`3d_viewer_create`](#3d_viewer_create) | Generate an HTML page to display a 3D model (GLB/GLTF) using Google model-viewer. Returns complete HTML that can be saved to a file. |

***

## 3d\_viewer\_create

Generate an HTML page to display a 3D model (GLB/GLTF) using Google model-viewer. Returns complete HTML that can be saved to a file.

**Parameters:**

| Parameter           | Type    | Required | Default             | Description                                                                                                                                 |
| ------------------- | ------- | -------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| `modelUrl`          | string  | Yes      | —                   | Required: URL or path to the GLB/GLTF 3D model file (e.g., "[https://example.com/model.glb](https://example.com/model.glb)" or "model.glb") |
| `title`             | string  | No       | `"3D Model Viewer"` | Title displayed above the viewer (default: "3D Model Viewer")                                                                               |
| `alt`               | string  | No       | `"3D Model"`        | Accessible description of the model (default: "3D Model")                                                                                   |
| `autoRotate`        | boolean | No       | `true`              | Enable automatic rotation of the model (default: true)                                                                                      |
| `autoRotateDelay`   | number  | No       | `3000`              | Delay in milliseconds before auto-rotation starts (default: 3000)                                                                           |
| `rotationPerSecond` | string  | No       | `"30deg"`           | Speed of auto-rotation (default: "30deg")                                                                                                   |
| `shadowIntensity`   | number  | No       | `1`                 | Shadow strength from 0 to 1 (default: 1)                                                                                                    |
| `cameraControls`    | boolean | No       | `true`              | Enable mouse/touch controls for rotating and zooming (default: true)                                                                        |
| `height`            | string  | No       | `"600px"`           | Height of the viewer (default: "600px")                                                                                                     |
| `backgroundColor`   | string  | No       | `"#f8f9fa"`         | Background color of the viewer (default: "#f8f9fa")                                                                                         |
| `showInstructions`  | boolean | No       | `true`              | Show usage instructions below the viewer (default: true)                                                                                    |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "modelUrl": {
        "type": "string",
        "description": "Required: URL or path to the GLB/GLTF 3D model file (e.g., \"https://example.com/model.glb\" or \"model.glb\")"
      },
      "title": {
        "type": "string",
        "default": "3D Model Viewer",
        "description": "Title displayed above the viewer (default: \"3D Model Viewer\")"
      },
      "alt": {
        "type": "string",
        "default": "3D Model",
        "description": "Accessible description of the model (default: \"3D Model\")"
      },
      "autoRotate": {
        "type": "boolean",
        "default": true,
        "description": "Enable automatic rotation of the model (default: true)"
      },
      "autoRotateDelay": {
        "type": "number",
        "default": 3000,
        "description": "Delay in milliseconds before auto-rotation starts (default: 3000)"
      },
      "rotationPerSecond": {
        "type": "string",
        "default": "30deg",
        "description": "Speed of auto-rotation (default: \"30deg\")"
      },
      "shadowIntensity": {
        "type": "number",
        "default": 1,
        "description": "Shadow strength from 0 to 1 (default: 1)"
      },
      "cameraControls": {
        "type": "boolean",
        "default": true,
        "description": "Enable mouse/touch controls for rotating and zooming (default: true)"
      },
      "height": {
        "type": "string",
        "default": "600px",
        "description": "Height of the viewer (default: \"600px\")"
      },
      "backgroundColor": {
        "type": "string",
        "default": "#f8f9fa",
        "description": "Background color of the viewer (default: \"#f8f9fa\")"
      },
      "showInstructions": {
        "type": "boolean",
        "default": true,
        "description": "Show usage instructions below the viewer (default: true)"
      }
    },
    "required": [
      "modelUrl"
    ]
  }
  ```
</Expandable>