# PhysicsRayCastCategory

## Description

Casts a ray through all physics objects including sprites that have physics turned on and stores the closest item hit. Results of a ray cast can be retrieved using the other ray cast functions such as GetRayCastNormalX.
If the ray starts inside a shape that shape will not be counted in the results.
This function filters the sprites that are checked so only sprites of certain categories are checked. The category parameter is a bitwise field that uses the lower 16 bits to represent each of the possible 16 categories used when setting up a sprite. The default value of all 1s means all categories will be included, whereas a value of all 0s means no categories will be included. You can set individual bits to set which ones should be checked.
Returns 1 if there was a collision, 0 if not.

## Definition

integer PhysicsRayCastCategory( category, x, y, x2, y2 )

int agk::PhysicsRayCastCategory( UINT category, float x, float y, float x2, float y2 )

## Parameters

- category - The categories to check for intersection with the ray, bitwise field using the lower most 16 bits.
- x - The X coordinate of the start point in world coordinates.
- y - The Y coordinate of the start point in world coordinates.
- x2 - The X coordinate of the end point in world coordinates.
- y2 - The Y coordinate of the end point in world coordinates.