> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Separator

> Define Separator element properties in the FlexiLayout language: orientation, minimum and maximum length, gap limits, and length penalty settings.

The **Separator** element supports the following parameters in the FlexiLayout language.

## Separator parameters

| Parameter                                    | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Void Mode( Direction )`                     | Separator orientation. See [**Separator**](/flexi-capture/fls/template/separator), **Orientation**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `Void MinQuality( Real )`                    | Sets the minimum quality of the hypothesis.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Void MinRelativeLength( Real )`             | Sets the minimum length of the separator which lies within the search area relative to the length of the search area. See [**Separator**](/flexi-capture/fls/template/separator), **Min relative length**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `Void PenaltyLimitForLength( Real )`         | Specifies the minimum quality that the hypothesis may get for its length when calculating its quality (a number from `0` to `1`). The longer the separator object, the higher the quality. The separator whose length equals the length of the search area has the highest quality of `1`. As the relative length of the separator decreases from `1` to `0`, the quality of the hypotheses decreases in direct proportion from `1` to `PenaltyLimitForLength`. **Note.** This function was introduced to replace `Void MaxPenalty( Real )`, which is obsolete and will be removed in future versions. If you previously used **Max length penalty**, set `PenaltyLimitForLength` to `(1 - [Max length penalty])`. See the **Element Properties** dialog box, [**Separator**](/flexi-capture/fls/template/separator) tab. |
| `Void MinSeparatorLength( Distance )`        | See [**Separator**](/flexi-capture/fls/template/separator), **Min length**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Void MaxSeparatorLength( Distance )`        | See [**Separator**](/flexi-capture/fls/template/separator), **Max length**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `Void MaxSeparatorGap( Distance )`           | See [**Separator**](/flexi-capture/fls/template/separator), **Space**, **Max length**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `Void MaxSeparatorRelativeGap( Real )`       | See [**Separator**](/flexi-capture/fls/template/separator), **Space**, **Max relative length**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `Void MaxSeparatorGap( Distance d, Real r )` | Sets absolute (`d`) and relative (`r`) constraints on the length of the space. See [**Separator**](/flexi-capture/fls/template/separator), **Space**, **Max length**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `Void FitsWithinSearchArea( Logic )`         | Specifies that the separator must fit entirely within the search area. See [**Separator**](/flexi-capture/fls/template/separator), **Fits entirely within search area** property.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `Void MaxSeparatorDistance( Distance )`      | See [**Separator**](/flexi-capture/fls/template/separator), **Space**, **Orthogonal shift**.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

## Examples

### `Mode`

The following code specifies that the separator is horizontal.

```text theme={null}
Mode: Horizontal;
```

### `MaxSeparatorGap`

The following code specifies that several horizontal separators located on one level must be considered as one separator if the gap between them does not exceed 20 dots.

```text theme={null}
Mode: Horizontal;
MaxSeparatorDistance (0mm);
MaxSeparatorGap(20dt);
```

### `MaxSeparatorDistance`

The following code specifies that several vertical separators must be considered as one separator if the distance between them does not exceed 1 mm.

```text theme={null}
Mode: Horizontal;
MaxSeparatorDistance (1mm);
```