Keras 3 API documentation
Models API Layers API The base Layer class Layer activations Layer weight initializers Layer weight regularizers Layer weight constraints Core layers Convolution layers Pooling layers Recurrent layers Preprocessing layers Normalization layers Regularization layers Attention layers Reshaping layers Merging layers Activation layers Backend-specific layers Callbacks API Ops API Optimizers Metrics Losses Data loading Built-in small datasets Keras Applications Mixed precision Multi-device distribution RNG API Rematerialization Utilities
Keras 2 API documentation
► Keras 3 API documentation / Layers API / Preprocessing layers / Image augmentation layers / RandomPerspective layer

RandomPerspective layer

[source]

RandomPerspective class

keras.layers.RandomPerspective(
    factor=1.0,
    scale=1.0,
    interpolation="bilinear",
    fill_value=0.0,
    seed=None,
    data_format=None,
    **kwargs
)

A preprocessing layer that applies random perspective transformations.

This layer distorts the perspective of input images by shifting their corner points, simulating a 3D-like transformation. The amount of distortion is controlled by the factor and scale parameters.

Note: This layer is safe to use inside a tf.data or grain pipeline (independently of which backend you're using).

Arguments

  • factor: A float or a tuple of two floats. Represents the probability of applying the perspective transformation to each image in the batch.
    • factor=0.0 ensures no transformation is applied.
    • factor=1.0 means the transformation is always applied.
    • If a tuple (min, max) is provided, a probability is randomly sampled between min and max for each image.
    • If a single float is given, the probability is sampled between 0.0 and the provided float. Default is 1.0.
  • scale: A float defining the relative amount of perspective shift. Determines how much the image corners are displaced, affecting the intensity of the perspective effect.
  • interpolation: Interpolation mode. Supported values: "nearest", "bilinear".
  • fill_value: a float represents the value to be filled outside the boundaries when fill_mode="constant".
  • seed: Integer. Used to create a random seed.
RandomPerspective layer
RandomPerspective class