# Irayple Camera

This function block connects to an Irayple Ethernet camera using its serial number and provides live frames for further processing. It also reports whether the camera is currently active.

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

This block does not require any input sockets.

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

`Image` Image frames captured from the connected Irayple camera.\
`Is Active` Boolean flag indicating whether the camera is currently active and delivering frames.

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

`Serial Number` Enter the camera serial number shown on the device or its label. Use the exact characters (no extra spaces).

Note: Some cameras require a specific vendor prefix in the serial number. If the connection does not work, check the camera label or documentation for the exact serial format.

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

* Simple serial-number based connection for Irayple Ethernet cameras.
* Live image output suitable for visualization, logging or downstream processing.
* `Is Active` output helps downstream blocks react when the camera goes offline.
* Designed to be used alongside image processing and export blocks for monitoring or analysis workflows.

## ⚙️ Running mechanism <a href="#how-it-works" id="how-it-works"></a>

* Provide the camera serial number via the `Serial Number` control.
* The block attempts to establish a connection to that camera and, when successful, continuously provides the latest frames through `Image`.
* The `Is Active` output reflects the current connection and frame availability status so other blocks can adapt (for example, pause logging or retry connection).

## 📝 Usage instructions <a href="#usage" id="usage"></a>

1. Enter the camera identifier into `Serial Number`.
2. Wait for the block to establish the connection. The `Is Active` output will indicate success.
3. Connect the `Image` output to visualization, processing or recording blocks to use live frames.
4. If you change the serial number, the block will reconnect to the new camera automatically.

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

* To preview frames interactively, connect `Image` to the `Show Image` block.
* To save captured frames or recordings, add `Image Logger` or `Record Video` after the `Image` output.
* If you need smaller frames for faster processing, insert `Image Resizer` between `Image` and heavy processing blocks.
* Use `Image ROI Select` or `Image ROI` to focus processing on a region of interest (for example before running `Object Detection` or `Mask Detection`).
* Use the `Is Active` output together with logic/flow blocks to gate logging or alerts when the camera goes offline.

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

* No frames or `Is Active` is false
  * Verify the serial number is entered exactly as on the camera label.
  * Make sure the camera is powered and reachable on the network.
  * Confirm any required camera drivers or SDK provided by the manufacturer are installed.
* Intermittent frames or poor performance
  * Check network stability and bandwidth between host and camera.
  * Reduce resolution using `Image Resizer` to improve frame rate.
  * If frames appear corrupted or blank, try reconnecting the camera by changing the serial number field and re-entering it.
* Unexpected format or compatibility issues
  * Confirm the camera model is supported by the manufacturer’s SDK and uses the expected serial format.
  * If connection still fails, consult the camera documentation or vendor support for SDK/driver requirements.

If problems persist, try combining the block with a simple visualization block like `Show Image` to verify whether frames arrive before adding more 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/irayple-camera.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.