mindspore.dataset.vision.RandomCropDecodeResize
===============================================

.. image:: https://mindspore-website.obs.cn-north-4.myhuaweicloud.com/website-images/r2.3.q1/resource/_static/logo_source.svg
    :target: https://gitee.com/mindspore/mindspore/blob/r2.3.q1/docs/api/api_python/dataset_vision/mindspore.dataset.vision.RandomCropDecodeResize.rst
    :alt: 查看源文件


.. py:class:: mindspore.dataset.vision.RandomCropDecodeResize(size, scale=(0.08, 1.0), ratio=(3. / 4., 4. / 3.), interpolation=Inter.BILINEAR, max_attempts=10)

    "裁剪"、"解码"和"调整尺寸大小"的组合处理。该操作将在随机位置裁剪输入图像，以 RGB 模式对裁剪后的图像进行解码，并调整解码图像的尺寸大小。针对 JPEG 图像进行了优化, 可以获得更好的性能。

    参数：
        - **size** (Union[int, Sequence[int]]) - 调整后图像的输出尺寸大小。大小值必须为正。
          如果 size 是整数，则返回一个裁剪尺寸大小为 (size, size) 的正方形。
          如果 size 是一个长度为 2 的序列，则以2个元素分别为高和宽放缩至(高度, 宽度)大小。
        - **scale** (Union[list, tuple], 可选) - 要裁剪的原始尺寸大小的各个尺寸的范围[min, max)，必须为非负数。默认值： ``(0.08, 1.0)`` 。
        - **ratio** (Union[list, tuple], 可选) - 宽高比的范围 [min, max) 裁剪，必须为非负数。默认值： ``(3. / 4., 4. / 3.)``。
        - **interpolation** (:class:`~.vision.Inter`, 可选) - 图像插值方法。可选值详见 :class:`mindspore.dataset.vision.Inter` 。
          默认值： ``Inter.BILINEAR``。
        - **max_attempts** (int, 可选) - 生成随机裁剪位置的最大尝试次数，超过该次数时将使用中心裁剪， `max_attempts` 值必须为正数。默认值： ``10`` 。

    异常：
        - **TypeError** - 如果 `size` 不是int或Sequence[int]类型。
        - **TypeError** - 如果 `scale` 不是tuple或list类型。
        - **TypeError** - 如果 `ratio` 不是tuple或list类型。
        - **TypeError** - 如果 `interpolation` 不是 :class:`mindspore.dataset.vision.Inter` 的类型。
        - **TypeError** - 如果 `max_attempts` 不是int类型。
        - **ValueError** - 如果 `size` 不是正数。
        - **ValueError** - 如果 `scale` 为负数。
        - **ValueError** - 如果 `ratio` 为负数。
        - **ValueError** - 如果 `max_attempts` 不是正数。
        - **RuntimeError** - 如果输入图像不是一维序列。

    教程样例：
        - `视觉变换样例库
          <https://www.mindspore.cn/docs/zh-CN/r2.3.0rc1/api_python/samples/dataset/vision_gallery.html>`_