# intersect

Intersection of `polyshape`

objects

## Syntax

## Description

`[`

also returns vertex mapping information from the vertices in
`polyout`

,`shapeID`

,`vertexID`

] = intersect(`poly1`

,`poly2`

)`polyout`

to the vertices in `poly1`

and
`poly2`

. The `intersect`

function only
supports this syntax when `poly1`

and `poly2`

are
scalar `polyshape`

objects.

The `shapeID`

elements identify whether the corresponding vertex
in `polyout`

originated in `poly1`

,
`poly2`

, or was created from the intersection.
`vertexID`

maps the vertices of `polyout`

to
the vertices of `poly1`

, `poly2`

, or the
intersection.

`___ = intersect(___,'KeepCollinearPoints',`

specifies whether to keep or remove collinear points in `TF`

)`polyout`

for any of the previous syntaxes.

`[`

returns the line segments of `in`

,`out`

] = intersect(`poly1`

,`lineseg`

)`lineseg`

that are inside and outside
of `poly1`

. The matrix `lineseg`

has two columns.
The first column defines the *x*-coordinates of the line segments
and the second column defines the corresponding
*y*-coordinates.

`intersect`

supports this syntax only when
`poly1`

is a scalar `polyshape`

and
`lineseg`

contains no self-intersections.

## Examples

## Input Arguments

## Output Arguments

## Extended Capabilities

## Version History

**Introduced in R2017b**