---
title: "Imaging"
description: "Learn about Imaging Plugin in BeeGraphy"
url: https://help.beegraphy.com/en/articles/100-imaging
collection: "Plugin"
updated: 2026-03-02
language: en
---

# Imaging

Learn about Imaging Plugin in BeeGraphy

The **Imaging Plugin** in **BeeGraphy** allows you to **work with images as data**, not just visuals. Instead of treating images as static pictures, this plugin lets you **extract information from images** such as color, brightness, position, and edges and use that information to drive geometry, patterns, and logic in your node graph.

The Imaging Plugin is commonly used to create **image-driven patterns and layouts**, where visual information directly controls how geometry is placed and structured. It enables users to **convert images into point clouds or contours**, making it possible to translate visual shapes and features into parametric geometry. By **analyzing brightness and contrast**, image data can be used to drive parameters such as density, size, or variation, allowing designs to respond intelligently to visual intensity. The plugin also supports **mapping image data onto geometry or surfaces**, which is especially useful in texture-based or surface-driven workflows. Altogether, this makes the Imaging Plugin a strong tool for **experimental and generative design**, where images act as active inputs rather than static references.

What makes the Imaging Plugin particularly powerful is its ability to **bridge visual media and parametric logic** within a single environment. It removes the need for external image-processing software by keeping all image analysis **inside the node graph**, ensuring a smooth and connected workflow.

## Image Input

**Image Input** allows you to load image files directly into the node. _Supported formats include_ **_PNG, JPG, JPEG, and WEBP_**_._

-   To add an image, click the **Edit icon** on the node.
    
-   A dialog box will open.
    
-   Select your desired image and click **OK** to confirm.
    

![](https://staticfiles.gleap.io/gattachments/L5tC4F6oa8z2WPEi1M4BQBavyHI1XSY8HXjfEDOYGh4E6AInH4QndKoN6odjG6Y0SBZmtXasMuY.png)

![](https://staticfiles.gleap.io/gattachments/WNwVbGMR6VECsXa4qVwhYNwMPEZaKx8uWpORF2uCH51WpRSue8OJDe4nB1qa46nLIq4OHCj4zMj.png)

## **Image Sampler**

The **Image Sampler** reads an image and extracts data from it at regular intervals. It samples pixel positions and retrieves information such as **color values and intensity**. This data can then be used to drive geometry, patterns, or logic based on the image content. It is commonly used when you want image pixels to control parametric designs.

![](https://staticfiles.gleap.io/gattachments/VCV7pSnee3PtKBX8hNCc39lepMW7tbuHFPZc311RC7xCQkdkZosWIVZqpmjRnNR3XUI2TzasNaa.png)

![](https://staticfiles.gleap.io/gattachments/a70rQwvZK1qpLmvqKVSGYDsBaU7S9Md5hUQ2GPnxgiOUt3a2nKu2pCQ8mFK9UwA3VKM9GibIhND.gif)

![](https://staticfiles.gleap.io/gattachments/C5g5chYItjYh8sbnoSi2LANJcplY6c7dxELSr6FNNmFk7SNxRU2evXsBWreKGz8SzRF1EuLvoca.gif)

_Check out the_ [**Image Sampler**](https://beegraphy.com/embed/697b1905c0a9f74b6f8a6f68) _model. Duplicate it to explore and experiment._

## **Image Sampler UV**

The **Image Sampler UV** node samples an image **at specific UV coordinates**, not on a fixed grid like the regular Image Sampler, but at any custom points you supply. These points are in **UV space**, where:

-   **U (x)** goes from left to right.
    
-   **V (y)** goes from bottom to top of the image.
    

Give the node a list of **UV points (x, y)** (for example a grid, curve, or single point), and it returns:

-   **Color** — the exact sampled color at each point (as hex),
    
-   **Hue** — color hue (0 – 1),
    
-   **Saturation** — color saturation,
    
-   **Brightness** — brightness/value.
    

![](https://staticfiles.gleap.io/gattachments/93g00j2CzMFPN7PlfKNHS77tmI9dIT1maxeaVMmrZCyrrAZUPOwQX6QZHUoNmQxOovrlWVbTdgX.png)

### Image Sampler UV Settings

![](https://staticfiles.gleap.io/gattachments/8umzUhvyYEKpMTlPKXzgdjB7HnuTYYJKzHwn4ZxLKYpteE5prLny64CflSh0666pG4oJLiuJwOE.png)

**Channel:** The **Channel** option lets you choose which data is sampled from the image.

-   **RGBA** samples the full color information.
    
-   **Red, Green, Blue** isolate individual color channels for data-driven workflows.
    
-   **Alpha** reads transparency values, commonly used for masking or intensity control.
    

**Preview / Aspect-Ratio Icon:** The small **preview-like icon** preserves the **original aspect ratio of the image**. When enabled, the UV grid automatically matches the image’s true proportions, ensuring the sampling grid aligns correctly without distortion.

**Manual Ratio Control (X & Y Intervals):** To define the sampling region manually, use **X Interval** and **Y Interval** values.

-   **Start (x0 / y0)** and **End (x1 / y1)** points define the UV range.
    
-   This allows custom cropping, scaling, or remapping of the image over the UV grid.
    

**Tiling Modes:** Tiling controls how the image behaves when UVs extend beyond the defined range:

-   **Clamp** – Repeats the edge pixels, stretching the border outward. Best for avoiding seams.
    
-   **Flip** – Mirrors the image at each boundary, creating a back-and-forth pattern.
    
-   **Tile** – Repeats the image continuously in all directions for seamless patterns.
    

Together, these settings give precise control over how image data is sampled, mapped, and reused within parametric definitions.

![](https://staticfiles.gleap.io/gattachments/bW8aCo0VRv5HF2ERRtBeIIM1iprCkz1fKo6EUo1WqNsV1J4gLzuVwylTyvp0e2y9xlDzIZtfUsy.gif)

_Check out the file_ [here](https://beegraphy.com/embed/697b1604c0a9f74b6f8a6e21) _to better understand how it works. Duplicate the script and experiment with it to explore the behavior on your own_.

## **Image Dimensions**

The **Image Dimensions** node outputs basic properties of an image. It provides the **width, height, and aspect ratio**, allowing you to scale or align geometry correctly. This node is especially important when maintaining proportions in image-driven workflows. It helps avoid distortion when mapping images to geometry.

![](https://staticfiles.gleap.io/gattachments/QZtkIjA0fhdivshXm36bE0vBKgJmBk7xlyBgXyMJxeVinAOPbV1sA0hMH0mfuBR8oowcR0taodK.png)

![](https://staticfiles.gleap.io/gattachments/HMGmT8Q2bMPTxtbKvJZJBsIDSwezlYJ44OTyzXUgAXv5z5d8e2HRo2VQ2zyMeC6pheN8qnD2tNL.gif)

## **Image Grayscale**

The **Image Grayscale** node converts a color image into a grayscale image. All color information is reduced to brightness values, simplifying the image data. This is often used before analysis tasks like edge detection or intensity-based sampling. It helps focus only on light–dark variations rather than color.

![](https://staticfiles.gleap.io/gattachments/SmkTf8wRLX2or5SNyjezCKrhg7wg3ShxqjzYGLKPsbMKUoJwzmumO8QO2ocgXntW4TNAynWX01v.png)

![](https://staticfiles.gleap.io/gattachments/nAFocdpchLWcv0xXiRsme3TUIu2B9FCdsGf9Er9ic0bTeJy1EoSoR0BNvRXJARVV9IvJ5gUvwe5.gif)

## **Image Edge Detection**

The **Image Edge Detection** node identifies edges, outlines, and boundaries by detecting contrast transitions. This is useful for extracting shapes, contours, or structural patterns from images. Often used in image-to-geometry or analytical workflows.

![](https://staticfiles.gleap.io/gattachments/JdFIqdyTn6q3XqA0wdFBa5eWQbgCIv7IIxrm9V1CTvpuY94IidUXTWxehihLPLBs7JJJWwLYcZU.png)

![](https://staticfiles.gleap.io/gattachments/dN8F9TilaLBuPRWisAADB8pZnjYz1wB4zjXejqWykTTMTthAPzKN2X4Xkb41WyxJmeRblHKJq0x.gif)

## **Image Preview**

The **Image Preview** node displays the image directly inside the editor. It helps users visually verify which image is being processed at any stage. This node is mainly for **reference and debugging**, not for data extraction. It ensures clarity when working with multiple image transformations.