nvidia.dali.fn.paste#

nvidia.dali.fn.paste(
input,
/,
*,
device=None,
name=None,
bytes_per_sample_hint=[0],
fill_value,
min_canvas_size=0.0,
n_channels=3,
paste_x=0.5,
paste_y=0.5,
preserve=False,
ratio,
)#

Pastes the input images on a larger canvas, where the canvas size is equal to input size * ratio. Only uint8 images of up to 1024 channels are supported.

Supported backends

  • ‘cpu’

  • ‘gpu’

Parameters:

input (TensorList ('HWC')) – Input to the operator.

Keyword Arguments:

  • bytes_per_sample_hint (int or list of int, optional, default = [0]) –

    Output size hint, in bytes per sample.

    If specified, the operator’s outputs residing in GPU or page-locked host memory will be preallocated to accommodate a batch of samples of this size.

  • fill_value (int or list of int) –

    Tuple of the values of the color that is used to fill the canvas.

    The length of the tuple must be equal to n_channels.

  • min_canvas_size (float or TensorList of float, optional, default = 0.0) – Enforces the minimum paste canvas dimension after scaling the input size by the ratio.

  • n_channels (int, optional, default = 3) – Number of channels in the image.

  • paste_x (float or TensorList of float, optional, default = 0.5) – Horizontal position of the paste in (0.0 - 1.0) image coordinates.

  • paste_y (float or TensorList of float, optional, default = 0.5) – Vertical position of the paste in (0.0 - 1.0) image coordinates.

  • preserve (bool, optional, default = False) – Prevents the operator from being removed from the graph even if its outputs are not used.

  • ratio (float or TensorList of float) – Ratio of canvas size to input size. Must be >= 1.

See also

On this page