freesewing/markdown/dev/reference/macros/crossbox/en.md

title
crossBox

The crossbox macro is used to mark a feature on a sewing pattern to attach and reinforce an attachment between two pieces. This is regularly done by sewing along the outside of the pieces that needs to be joined, and then sewing along the diagonals too.

It is provided by plugin-annotations, which is part of core-plugins (so it is available by default).

Signature

macro('crossbox', {
  String id='crossbox',
  Point topLeft,
  Point bottomRight,
  String text,
  Boolean force = false,
})

Example

```js ({ Point, points, Path, paths, macro, part }) => { points.tl = new Point(5,5) points.br = new Point(45,25)

macro('crossbox', { topLeft: new Point(5, 5), bottomRight: new Point(45, 25), text: 'Attach here', })

return part }

</Example>

## Configuration

| Property        | Default  | Type                | Description |
|----------------:|----------|---------------------|-------------|
| `bottomRight`   |          | [Point](/reference/api/point) | The bottom right point of the crossbox |
| `topLeft`       |          | [Point](/reference/api/point) | The top left point of the crossbox |
| `id`            | `crossbox` | `string` | The ID of this macro instance |
| `text`          |          | String   | Optional text to go in the center of the crossbox |
| `force`         | `false`    | `boolean`  | Set this to `true` to display the macro output even when `complete` is `false` |

## Notes

This macro takes the `complete` setting into account and won't output anything when both complete and `force` are `false`.