# tf.image.rgb_to_yiq

<br />

|---|
| [![](https://www.tensorflow.org/images/GitHub-Mark-32px.png) View source on GitHub](https://github.com/tensorflow/tensorflow/blob/v2.13.1/tensorflow/python/ops/image_ops_impl.py#L3964-L3991) |

Converts one or more images from RGB to YIQ.

#### View aliases


**Compat aliases for migration**

See
[Migration guide](https://www.tensorflow.org/guide/migrate) for
more details.

[`tf.compat.v1.image.rgb_to_yiq`](https://www.tensorflow.org/api_docs/python/tf/image/rgb_to_yiq)

<br />

    tf.image.rgb_to_yiq(
        images
    )

Outputs a tensor of the same shape as the `images` tensor, containing the YIQ
value of the pixels.
The output is only well defined if the value in images are in \[0,1\].

#### Usage Example:

    x = tf.constant([[[1.0, 2.0, 3.0]]])
    tf.image.rgb_to_yiq(x)
    <tf.Tensor: shape=(1, 1, 3), dtype=float32,
    numpy=array([[[ 1.815     , -0.91724455,  0.09962624]]], dtype=float32)>

<br />

<br />

<br />

| ## Args ||
|---|---|
| `images` | 2-D or higher rank. Image data to convert. Last dimension must be size 3. |

<br />

<br />

<br />

<br />

| ## Returns ||
|---|---|
| `images` | tensor with the same shape as `images`. |

<br />