# Make Image

This function block creates a new image with the dimensions and fill color you provide. It is useful for generating test images, backgrounds, or canvas areas to draw on before further processing.

## 📥 Inputs (sockets) <a href="#inputs" id="inputs"></a>

`Width`\
Integer width of the output image in pixels.

`Height`\
Integer height of the output image in pixels.

`Color`\
Fill color for the image (pixel color). If no color is provided the image is created with a black background.

## 📤 Outputs (sockets) <a href="#outputs" id="outputs"></a>

`Image Any`\
Generated image with the specified width, height and fill color.

## 🕹️ Controls <a href="#controls" id="controls"></a>

This function block has no additional GUI controls. Configure the output using the input sockets above.

## 🎨 Features <a href="#features" id="features"></a>

* Quickly generate a blank image canvas of any size.
* Optional color fill so the canvas can represent backgrounds, masks or reference fields.
* Simple, deterministic output useful for testing downstream blocks.

## 📝 How to use <a href="#usage" id="usage"></a>

1. Provide a value to `Width` and `Height` to define the canvas size.
2. Optionally provide a value to `Color` to set the fill color.
3. Use the `Image Any` output as input to other function blocks for visualization, annotation or processing.

## 📊 What it does when run <a href="#evaluation" id="evaluation"></a>

When evaluated, the block produces an image matching the requested dimensions. If a fill color is supplied the image will be uniformly filled with that color; otherwise the image will be blank (black).

## 💡 Tips and Tricks <a href="#tips-and-tricks" id="tips-and-tricks"></a>

* Preview the result by connecting the output to the `Show Image` block.
* Create templates or backgrounds and then annotate them with `Draw Point`, `Draw Rectangle` or `Write Text On Image`.
* Combine several generated images into a montage using `Collage Images` or merge them with `Image Concatenate`.
* Make a canvas and then use `Image Resize` or `Image Padding` to match target sizes for other processing blocks.
* Save generated images directly with `Image Write` or include them in recordings via `Record Video`.

## 🛠️ Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* If the output looks empty, double-check that both `Width` and `Height` are positive integers.
* If color does not appear as expected, verify the color input uses the expected color format for the system (provide an RGB/BGR pixel as required by downstream blocks).
* If downstream blocks expect a different channel order or image depth, use `Color Space`, `Normalize Image`, or `Image Resizer` to adapt the generated image before further processing.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.augelab.com/function-blocks/input-output/image-inputs/make-image.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
