> For the complete documentation index, see [llms.txt](https://docs.augelab.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.augelab.com/function-blocks/blocks-reference/input-output/image-inputs/irayple-camera.md).

# Irayple Camera

This function block connects to Irayple Ethernet cameras using the camera's serial identifier and provides live frames for downstream processing. Use this block when you have an Irayple camera on the network and want a stable image source inside your project.

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

This block does not require any inputs.

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

`Image` The latest frame captured from the Irayple camera.

`Is Active` Boolean flag that indicates whether the camera is currently streaming.

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

`Serial Number` Enter the camera serial identifier shown on your Irayple device. Example format: AB12345XYZ00009.

* Leave this field empty to disconnect the camera and stop streaming.
* Entering a valid serial will make the block attempt to connect automatically.

(how the block reacts) When a valid serial is present the block will try to connect and will start producing frames on the `Image` output while updating `Is Active` accordingly. Clearing the serial will disconnect the camera and stop output.

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

* Automatic connection using the camera serial identifier.
* Live frame output suitable for preview, recording, or analysis.
* Streaming state visible through the `Is Active` output to drive logic or UI.
* Graceful disconnect when the serial is cleared or when the block is removed from the workspace.
* Error feedback is shown in the UI when connection or frame retrieval fails.

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

1. Enter the camera serial into `Serial Number` using the format printed on the device (example: AB12345XYZ00009).
2. Wait a moment for the block to establish the connection. `Is Active` will become True when streaming.
3. Use the `Image` output as your live image source for other blocks (detection, analysis, logging, etc.).
4. To stop streaming, clear the `Serial Number` field — the block will disconnect and `Is Active` will become False.

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

* Preview frames quickly by connecting the `Image` output to the `Show Image` block to confirm camera alignment and exposure before adding processing blocks.
* Save sample frames or recordings by pairing the `Image` output with `Image Logger`, `Image Write` or `Record Video` when you want a dataset or evidence capture.
* For object or pose workflows, feed the `Image` output into detection blocks such as `Object Detection`, `Object Detection - Custom`, `Mask Detection`, `Pose Estimation` or `Skeleton Estimation`.
* Use `Image Resizer` before heavy AI blocks (for example `Depth Estimation (DepthAny. V2)` or `Object Detection (D-FINE)`) to reduce processing time and memory usage.
* If you need perspective calibration for distance or mapping tasks, use `Perspective Transform` and then supply the transform matrix to blocks like `Social Distance Detector`.
* Crop or focus on a region of interest with `Image ROI` or `Image ROI Select` before performing detection to reduce false positives and speed up processing.

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

* No connection or cannot stream:
  * Verify the serial you entered matches exactly the identifier on the camera.
  * Ensure the camera is powered and reachable on the network.
  * Install the camera SDK or drivers recommended by the camera manufacturer if required (consult the camera vendor support).
  * Use the `Show Image` block to verify whether frames are being delivered.
* Intermittent or frozen frames:
  * Clear and re-enter the `Serial Number` to force a reconnect.
  * Check network stability and camera firmware.
  * If you see repeated blank frames, try lowering downstream processing load (use `Image Resizer`) or reduce camera resolution where supported.
* Frame size too large for downstream processing:
  * Add an `Image Resizer` block right after the `Image` output to lower resolution before heavy analysis blocks.

If you need a simple visual check, connect to `Show Image`; for recording choose `Image Logger` or `Record Video`. Use the other analysis blocks listed above to build detection, measurement, or monitoring workflows from the live stream.
