###### (This is the legacy documentation for stable SDL2, the current stable version; [SDL3](https://wiki.libsdl.org/SDL3/) is the current development version.)
# SDL_IntersectFRectAndLine

Calculate the intersection of a rectangle and line segment with float precision.

## Header File

Defined in [SDL_rect.h](https://github.com/libsdl-org/SDL/blob/SDL2/include/SDL_rect.h)

## Syntax

```c
SDL_bool SDL_IntersectFRectAndLine(const SDL_FRect *
                                   rect, float *X1,
                                   float *Y1, float *X2,
                                   float *Y2);

```

## Function Parameters

|              |                                                                             |
| ------------ | --------------------------------------------------------------------------- |
| **rect**     | an [SDL_FRect](SDL_FRect) structure representing the rectangle to intersect |
| **X1**       | a pointer to the starting X-coordinate of the line                          |
| **Y1**       | a pointer to the starting Y-coordinate of the line                          |
| **X2**       | a pointer to the ending X-coordinate of the line                            |
| **Y2**       | a pointer to the ending Y-coordinate of the line                            |

## Return Value

Returns [SDL_TRUE](SDL_TRUE) if there is an intersection,
[SDL_FALSE](SDL_FALSE) otherwise.

## Remarks

This function is used to clip a line segment to a rectangle. A line segment
contained entirely within the rectangle or that does not intersect will
remain unchanged. A line segment that crosses the rectangle at either or
both ends will be clipped to the boundary of the rectangle and the new
coordinates saved in `X1`, `Y1`, `X2`, and/or `Y2` as necessary.

## Version

This function is available since SDL 2.0.22.

----
[CategoryAPI](CategoryAPI), [CategoryAPIFunction](CategoryAPIFunction)