# KX_RaySensor(SCA_ISensor)

base class — `SCA_ISensor`

class `bge.types.``KX_RaySensor`(SCA_ISensor)

  A ray sensor detects the first object in a given direction.

  `propName`

    The property the ray is looking for.

    Type: | string

  `range`

    The distance of the ray.

    Type: | float

  `useMaterial`

    Whether or not to look for a material (false = property).

    Type: | boolean

  `useXRay`

    Whether or not to use XRay.

    Type: | boolean

  `hitObject`

    The game object that was hit by the ray. (read-only).

    Type: | `KX_GameObject`

  `hitPosition`

    The position (in worldcoordinates) where the object was hit by the ray. (read-only).

    Type: | list [x, y, z]

  `hitNormal`

    The normal (in worldcoordinates) of the object at the location where the object was hit by the ray. (read-only).

    Type: | list [x, y, z]

  `hitMaterial`

    The material of the object in the face hit by the ray. (read-only).

    Type: | string

  `rayDirection`

    The direction from the ray (in worldcoordinates). (read-only).

    Type: | list [x, y, z]

  `axis`

    The axis the ray is pointing on.

    Type: | integer from 0 to 5

    - KX_RAY_AXIS_POS_X
    - KX_RAY_AXIS_POS_Y
    - KX_RAY_AXIS_POS_Z
    - KX_RAY_AXIS_NEG_X
    - KX_RAY_AXIS_NEG_Y
    - KX_RAY_AXIS_NEG_Z