# FrameNormalizer

<a id="framenormalizer"></a>

# FrameNormalizer

```cpp
#include <icy/vision/framenormalizer.h>

class FrameNormalizer
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:52](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L52)

> **Inherits:** [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor)

Converts sampled decoded video into owned detector-ready frames.

## List of all members

| Name | Kind | Owner |
|------|------|-------|
| [`emitter`](#emitter-13) | `variable` | Declared here |
| [`FrameNormalizer`](#framenormalizer-1) | `function` | Declared here |
| [`~FrameNormalizer`](#framenormalizer-2) | `function` | Declared here |
| [`setConfig`](#setconfig-1) | `function` | Declared here |
| [`config`](#config-2) | `function` | Declared here |
| [`stats`](#stats-1) | `function` | Declared here |
| [`reset`](#reset-26) | `function` | Declared here |
| [`process`](#process-19) | `function` | Declared here |
| [`accepts`](#accepts-6) | `function` | Declared here |
| [`_config`](#_config-1) | `variable` | Declared here |
| [`_seen`](#_seen-1) | `variable` | Declared here |
| [`_emitted`](#_emitted-1) | `variable` | Declared here |
| [`_dropped`](#_dropped-1) | `variable` | Declared here |
| [`_converted`](#_converted) | `variable` | Declared here |
| [`_frameId`](#_frameid) | `variable` | Declared here |
| [`_state`](#_state-4) | `variable` | Declared here |
| [`normalize`](#normalize-2) | `function` | Declared here |
| [`sanitize`](#sanitize-1) | `function` | Declared here |
| [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor-1) | `function` | Inherited from [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor) |
| [`process`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#process-1) | `function` | Inherited from [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor) |
| [`accepts`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#accepts-1) | `function` | Inherited from [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor) |
| [`operator<<`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#operator-69) | `function` | Inherited from [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor) |
| [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-1) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`~PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-2) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-1) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-2) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-3) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-4) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-5) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`getEmitter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#getemitter) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`retention`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#retention-1) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`onStreamStateChange`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#onstreamstatechange-1) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`_emitter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#_emitter) | `variable` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-3) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`operator=`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#operator-72) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-4) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |
| [`operator=`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#operator-73) | `function` | Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter) |

## Inherited from [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor)

| Kind | Name | Description |
|------|------|-------------|
| `function` | [`PacketProcessor`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#packetprocessor-1) `inline` |  |
| `function` | [`process`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#process-1) `virtual` | This method performs processing on the given packet and emits the result. |
| `function` | [`accepts`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#accepts-1) `virtual` `inline` | This method ensures compatibility with the given packet type. Return false to reject the packet. |
| `function` | [`operator<<`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#operator-69) `virtual` `inline` | [Stream](https://auscaster.com/icey/docs/api-reference/icy-Stream.md#stream) operator alias for [process()](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#process-1) |

## Inherited from [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter)

| Kind | Name | Description |
|------|------|-------------|
| `function` | [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-1)  | Construct the adapter, binding it to the given packet signal. |
| `function` | [`~PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-2) `virtual` `inline` |  |
| `function` | [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-1) `virtual` | Emit a mutable raw buffer as a packet. |
| `function` | [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-2) `virtual` | Emit a read-only raw buffer as a packet (data is copied internally). |
| `function` | [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-3) `virtual` | Emit a string as a packet (data is copied internally). |
| `function` | [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-4) `virtual` | Emit a flag-only packet carrying no payload data. |
| `function` | [`emit`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#emit-5) `virtual` | Emit an existing packet directly onto the outgoing signal. |
| `function` | [`getEmitter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#getemitter)  | Returns a reference to the outgoing packet signal. |
| `function` | [`retention`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#retention-1) `virtual` `const` | Returns how this adapter treats incoming packet lifetime. Most adapters are synchronous and therefore only borrow the packet for the current call chain. Queue-style adapters override this to advertise that they clone before deferred use. Callers may treat the first adapter reporting Cloned or Retained as the explicit ownership boundary in the stream graph. |
| `function` | [`onStreamStateChange`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#onstreamstatechange-1) `virtual` `inline` | Called by the [PacketStream](https://auscaster.com/icey/docs/api-reference/icy-PacketStream.md#packetstream) to notify when the internal [Stream](https://auscaster.com/icey/docs/api-reference/icy-Stream.md#stream) state changes. On receiving the Stopped state, it is the responsibility of the adapter to have ceased all outgoing packet transmission, especially in multi-thread scenarios. |
| `variable` | [`_emitter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#_emitter)  |  |
| `function` | [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-3)  | NonCopyable and NonMovable. |
| `function` | [`operator=`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#operator-72)  | Deleted assignment operator. |
| `function` | [`PacketStreamAdapter`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#packetstreamadapter-4)  | Deleted constructor. |
| `function` | [`operator=`](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#operator-73)  | Deleted assignment operator. |

## Public Attributes

| Return | Name | Description |
|--------|------|-------------|
| [`PacketSignal`](https://auscaster.com/icey/docs/api-reference/base.md#packetsignal) | [`emitter`](#emitter-13)  |  |

---

<a id="emitter-13"></a>

### emitter

```cpp
PacketSignal emitter
```

Type: [`PacketSignal`](https://auscaster.com/icey/docs/api-reference/base.md#packetsignal)

[Defined in src/vision/include/icy/vision/framenormalizer.h:55](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L55)

## Public Methods

| Return | Name | Description |
|--------|------|-------------|
|  | [`FrameNormalizer`](#framenormalizer-1) `explicit` |  |
|  | [`~FrameNormalizer`](#framenormalizer-2) `override` |  |
| `void` | [`setConfig`](#setconfig-1)  |  |
| [`FrameNormalizerConfig`](https://auscaster.com/icey/docs/api-reference/icy-vision-FrameNormalizerConfig.md#framenormalizerconfig) | [`config`](#config-2) `const` |  |
| [`FrameNormalizerStats`](https://auscaster.com/icey/docs/api-reference/icy-vision-FrameNormalizerStats.md#framenormalizerstats) | [`stats`](#stats-1) `const` |  |
| `void` | [`reset`](#reset-26)  |  |
| `void` | [`process`](#process-19) `virtual` `override` | This method performs processing on the given packet and emits the result. |
| `bool` | [`accepts`](#accepts-6) `virtual` `inline` `override` | This method ensures compatibility with the given packet type. Return false to reject the packet. |

---

<a id="framenormalizer-1"></a>

### FrameNormalizer

`explicit`

```cpp
explicit FrameNormalizer(FrameNormalizerConfig config = {})
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:57](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L57)

---

<a id="framenormalizer-2"></a>

### ~FrameNormalizer

`override`

```cpp
~FrameNormalizer() override
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:58](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L58)

---

<a id="setconfig-1"></a>

### setConfig

```cpp
void setConfig(FrameNormalizerConfig config)
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:60](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L60)

---

<a id="config-2"></a>

### config

`const`

```cpp
FrameNormalizerConfig config() const
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:61](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L61)

---

<a id="stats-1"></a>

### stats

`const`

```cpp
FrameNormalizerStats stats() const
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:62](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L62)

---

<a id="reset-26"></a>

### reset

```cpp
void reset()
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:63](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L63)

---

<a id="process-19"></a>

### process

`virtual` `override`

```cpp
virtual void process(IPacket & packet) override
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:65](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L65)

This method performs processing on the given packet and emits the result.

Processors that defer work asynchronously must either clone the packet or retain an owned equivalent. See [retention()](https://auscaster.com/icey/docs/api-reference/icy-PacketStreamAdapter.md#retention-1).

#### Reimplements

- [`PacketProcessor::process`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#process-1)

---

<a id="accepts-6"></a>

### accepts

`virtual` `inline` `override`

```cpp
virtual inline bool accepts(IPacket *) override
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:66](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L66)

This method ensures compatibility with the given packet type. Return false to reject the packet.

#### Reimplements

- [`PacketProcessor::accepts`](https://auscaster.com/icey/docs/api-reference/icy-PacketProcessor.md#accepts-1)

## Private Attributes

| Return | Name | Description |
|--------|------|-------------|
| [`FrameNormalizerConfig`](https://auscaster.com/icey/docs/api-reference/icy-vision-FrameNormalizerConfig.md#framenormalizerconfig) | [`_config`](#_config-1)  |  |
| `std::atomic< uint64_t >` | [`_seen`](#_seen-1)  |  |
| `std::atomic< uint64_t >` | [`_emitted`](#_emitted-1)  |  |
| `std::atomic< uint64_t >` | [`_dropped`](#_dropped-1)  |  |
| `std::atomic< uint64_t >` | [`_converted`](#_converted)  |  |
| `std::atomic< uint64_t >` | [`_frameId`](#_frameid)  |  |
| std::unique_ptr< [`State`](https://auscaster.com/icey/docs/api-reference/icy-State.md#state) > | [`_state`](#_state-4)  |  |

---

<a id="_config-1"></a>

### _config

```cpp
FrameNormalizerConfig _config
```

Type: [`FrameNormalizerConfig`](https://auscaster.com/icey/docs/api-reference/icy-vision-FrameNormalizerConfig.md#framenormalizerconfig)

[Defined in src/vision/include/icy/vision/framenormalizer.h:79](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L79)

---

<a id="_seen-1"></a>

### _seen

```cpp
std::atomic< uint64_t > _seen {0}
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:80](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L80)

---

<a id="_emitted-1"></a>

### _emitted

```cpp
std::atomic< uint64_t > _emitted {0}
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:81](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L81)

---

<a id="_dropped-1"></a>

### _dropped

```cpp
std::atomic< uint64_t > _dropped {0}
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:82](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L82)

---

<a id="_converted"></a>

### _converted

```cpp
std::atomic< uint64_t > _converted {0}
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:83](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L83)

---

<a id="_frameid"></a>

### _frameId

```cpp
std::atomic< uint64_t > _frameId {0}
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:84](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L84)

---

<a id="_state-4"></a>

### _state

```cpp
std::unique_ptr< State > _state
```

Type: std::unique_ptr< [`State`](https://auscaster.com/icey/docs/api-reference/icy-State.md#state) >

[Defined in src/vision/include/icy/vision/framenormalizer.h:85](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L85)

## Private Methods

| Return | Name | Description |
|--------|------|-------------|
| [`VisionFramePacket`](https://auscaster.com/icey/docs/api-reference/icy-vision-VisionFramePacket.md#visionframepacket) | [`normalize`](#normalize-2)  |  |

---

<a id="normalize-2"></a>

### normalize

```cpp
VisionFramePacket normalize(const av::PlanarVideoPacket & packet)
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:77](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L77)

## Private Static Methods

| Return | Name | Description |
|--------|------|-------------|
| [`FrameNormalizerConfig`](https://auscaster.com/icey/docs/api-reference/icy-vision-FrameNormalizerConfig.md#framenormalizerconfig) | [`sanitize`](#sanitize-1) `static` |  |

---

<a id="sanitize-1"></a>

### sanitize

`static`

```cpp
static FrameNormalizerConfig sanitize(FrameNormalizerConfig config)
```

[Defined in src/vision/include/icy/vision/framenormalizer.h:75](https://github.com/auscaster/icey/blob/main/src/vision/include/icy/vision/framenormalizer.h#L75)