# tfg.rendering.camera.perspective.random_rays

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/graphics/blob/master/tensorflow_graphics/rendering/camera/perspective.py#L457-L506) |

Sample rays at random pixel location from a perspective camera.

    tfg.rendering.camera.perspective.random_rays(
        focal: tf.Tensor,
        principal_point: tf.Tensor,
        height: int,
        width: int,
        n_rays: int,
        margin: int = 0,
        name: str = 'random_rays'
    ) -> Tuple[tf.Tensor, tf.Tensor]

<br />

<br />

<br />

| ## Args ||
|---|---|
| `focal` | A tensor of shape `[A1, ..., An, 2]` where the last dimension contains the fx and fy focal length values. |
| `principal_point` | A tensor of shape `[A1, ..., An, 2]` where the last dimension contains the cx and cy principal point values. |
| `height` | The height of the image plane in pixels |
| `width` | The width of the image plane in pixels. |
| `n_rays` | The number M of rays to sample. |
| `margin` | The margin around the borders of the image. |
| `name` | A name for this op that defaults to "random_rays". |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| A tensor of shape `[A1, ..., An, M, 3]` with the ray directions and a tensor of shape `[A1, ..., An, M, 2]` with the pixel x, y locations. ||

<br />