https://github.com/getgrinta/meshy.studio

Generate stunning and crispy mesh gradients
https://github.com/getgrinta/meshy.studio

Last synced: 12 months ago
JSON representation

Generate stunning and crispy mesh gradients

• Host: GitHub
• URL: https://github.com/getgrinta/meshy.studio
• Owner: getgrinta
• Created: 2025-04-10T20:09:50.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2025-04-10T20:40:35.000Z (12 months ago)
• Last Synced: 2025-04-10T21:32:32.932Z (12 months ago)
• Language: Svelte
• Size: 62.5 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# Meshy

Meshy is a powerful API designed for generating stunning mesh gradients. It allows users to create visually appealing gradient meshes with optional noise effects, perfect for enhancing digital artwork, web design, and more.

## Features

- **Gradient Mesh Generation:** Create beautiful 512x512 PNG images with gradient mesh effects.

- **Noise Effects:** Optionally apply noise overlays to add texture and depth to your gradients.

- **Consistent Results:** Use seeding to ensure consistent random number generation for reproducible designs.

## API Usage

Meshy provides a simple and intuitive API endpoint to generate gradient meshes:

### `/api/mesh/[seed]`

- **Method:** `GET`

- **Response Type:** `image/png`

- **Caching:** `public, max-age=31536000` (1 year)

#### Route Params:

- **`seed` (optional):**

  - **Type:** `string`

  - **Default:** `'0'`

  - **Description:** Seeds the random number generator for consistent circle placement and color generation.

#### Query Params:

- **`noise` (optional):**

  - **Type:** `string`

  - **Values:** `0`-`32`

  - **Description:** Apply a noise overlay effect if specified.

- **`sharpen` (optional):**

  - **Type:** `number | boolean`

  - **Description:** Apply sharpening filter. If boolean, uses default sigma.

- **`negate` (optional):**

  - **Type:** `boolean`

  - **Description:** Invert image colors.

- **`gammaIn` (optional):**

  - **Type:** `number`

  - **Description:** Apply input gamma correction.

- **`gammaOut` (optional):**

  - **Type:** `number`

  - **Description:** Apply output gamma correction.

- **`brightness` (optional):**

  - **Type:** `number`

  - **Description:** Adjust image brightness.

- **`saturation` (optional):**

  - **Type:** `number`

  - **Description:** Adjust color saturation.

- **`hue` (optional):**

  - **Type:** `number`

  - **Description:** Adjust hue rotation (degrees).

- **`lightness` (optional):**

  - **Type:** `number`

  - **Description:** Adjust image lightness.

- **`blur` (optional):**

  - **Type:** `number`

  - **Description:** Apply blur filter (sigma).

## Examples

- **Random Mesh:** `/api/mesh`

- **Seeded Mesh:** `/api/mesh/hello`

- **Seeded + Noise:** `/api/mesh/hello?noise=8`

- **Seeded + Noise + Sharpen:** `/api/mesh/hello?noise=8&sharpen=5`