PasteImage3d

Pastes a three-dimensional image into another at a given location.

Access to parameter description

PasteImage3d pastes an area contained in an input image $I$ at a user-defined location of an output image $O$.
If the input image does not entirely fit into the output image at the given location, only the intersecting area is pasted, and no exception occurs.

See also

Function Syntax

This function returns outputImage.

// Function prototype
std::shared_ptr< iolink::ImageView >
pasteImage3d( std::shared_ptr< iolink::ImageView > inputSource,
              std::shared_ptr< iolink::ImageView > inputDestination,
              iolink::Vector3i32 originSource,
              iolink::Vector3i32 originDestination,
              iolink::Vector3u32 areaSize,
              std::shared_ptr< iolink::ImageView > outputImage = NULL );

This function returns outputImage.

// Function prototype.
paste_image_3d( input_source,
                input_destination,
                origin_source = [0, 0, 0],
                origin_destination = [0, 0, 0],
                area_size = [0, 0, 0],
                output_image = None )

This function returns outputImage.

// Function prototype.
public static IOLink.ImageView
PasteImage3d( IOLink.ImageView inputSource,
              IOLink.ImageView inputDestination,
              int[] originSource = null,
              int[] originDestination = null,
              uint[] areaSize = null,
              IOLink.ImageView outputImage = null );

Class Syntax

// Command constructor.
PasteImage3d();

/// Gets the inputSource parameter.
/// The input source image to be pasted in the destination image.
std::shared_ptr< iolink::ImageView > inputSource() const;
/// Sets the inputSource parameter.
/// The input source image to be pasted in the destination image.
void setInputSource( std::shared_ptr< iolink::ImageView > inputSource );

/// Gets the inputDestination parameter.
/// The input destination image.
std::shared_ptr< iolink::ImageView > inputDestination() const;
/// Sets the inputDestination parameter.
/// The input destination image.
void setInputDestination( std::shared_ptr< iolink::ImageView > inputDestination );

/// Gets the originSource parameter.
/// The origin of the region to select in the source image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.
iolink::Vector3i32 originSource() const;
/// Sets the originSource parameter.
/// The origin of the region to select in the source image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.
void setOriginSource( const iolink::Vector3i32& originSource );

/// Gets the originDestination parameter.
/// The origin of the region to paste in the destination image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.
iolink::Vector3i32 originDestination() const;
/// Sets the originDestination parameter.
/// The origin of the region to paste in the destination image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.
void setOriginDestination( const iolink::Vector3i32& originDestination );

/// Gets the areaSize parameter.
/// The size of the region to select, in voxels.
iolink::Vector3u32 areaSize() const;
/// Sets the areaSize parameter.
/// The size of the region to select, in voxels.
void setAreaSize( const iolink::Vector3u32& areaSize );

/// Gets the outputImage parameter.
/// The output image where the input image is pasted. Its dimensions and type are forced to the same values as the destination input image.
std::shared_ptr< iolink::ImageView > outputImage() const;
/// Sets the outputImage parameter.
/// The output image where the input image is pasted. Its dimensions and type are forced to the same values as the destination input image.
void setOutputImage( std::shared_ptr< iolink::ImageView > outputImage );


// Method to launch the command.
void execute();

# Property of the inputSource parameter.
PasteImage3d.input_source
# Property of the inputDestination parameter.
PasteImage3d.input_destination
# Property of the originSource parameter.
PasteImage3d.origin_source
# Property of the originDestination parameter.
PasteImage3d.origin_destination
# Property of the areaSize parameter.
PasteImage3d.area_size
# Property of the outputImage parameter.
PasteImage3d.output_image

// Method to launch the command.
execute()

// Command constructor.
PasteImage3d()

// Property of the inputSource parameter.
PasteImage3d.inputSource
// Property of the inputDestination parameter.
PasteImage3d.inputDestination
// Property of the originSource parameter.
PasteImage3d.originSource
// Property of the originDestination parameter.
PasteImage3d.originDestination
// Property of the areaSize parameter.
PasteImage3d.areaSize
// Property of the outputImage parameter.
PasteImage3d.outputImage

// Method to launch the command.
Execute()

Parameters

	Description	Type	Supported Values	Default Value
inputSource	The input source image to be pasted in the destination image.	Image	Binary, Label, Grayscale or Multispectral	nullptr
inputDestination	The input destination image.	Image	Binary, Label, Grayscale or Multispectral	nullptr
originSource	The origin of the region to select in the source image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.	Vector3i32	Any value	{0, 0, 0}
originDestination	The origin of the region to paste in the destination image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.	Vector3i32	Any value	{0, 0, 0}
areaSize	The size of the region to select, in voxels. If this value is set to (0, 0, 0), the full size of the source image is used. Only source voxels lying in the overlap between both input images (after translation of the source) are pasted in the destination.	Vector3u32	Any value	{0, 0, 0}
outputImage	The output image where the input image is pasted. Its dimensions and type are forced to the same values as the destination input image.	Image		nullptr

	Description	Type	Supported Values	Default Value
input_source	The input source image to be pasted in the destination image.	image	Binary, Label, Grayscale or Multispectral	None
input_destination	The input destination image.	image	Binary, Label, Grayscale or Multispectral	None
origin_source	The origin of the region to select in the source image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.	vector3i32	Any value	[0, 0, 0]
origin_destination	The origin of the region to paste in the destination image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.	vector3i32	Any value	[0, 0, 0]
area_size	The size of the region to select, in voxels. If this value is set to (0, 0, 0), the full size of the source image is used. Only source voxels lying in the overlap between both input images (after translation of the source) are pasted in the destination.	vector3u32	Any value	[0, 0, 0]
output_image	The output image where the input image is pasted. Its dimensions and type are forced to the same values as the destination input image.	image		None

	Description	Type	Supported Values	Default Value
inputSource	The input source image to be pasted in the destination image.	Image	Binary, Label, Grayscale or Multispectral	null
inputDestination	The input destination image.	Image	Binary, Label, Grayscale or Multispectral	null
originSource	The origin of the region to select in the source image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.	Vector3i32	Any value	{0, 0, 0}
originDestination	The origin of the region to paste in the destination image, expressed in voxel coordinates. If the value is set outside the image, nothing is done.	Vector3i32	Any value	{0, 0, 0}
areaSize	The size of the region to select, in voxels. If this value is set to (0, 0, 0), the full size of the source image is used. Only source voxels lying in the overlap between both input images (after translation of the source) are pasted in the destination.	Vector3u32	Any value	{0, 0, 0}
outputImage	The output image where the input image is pasted. Its dimensions and type are forced to the same values as the destination input image.	Image		null

Object Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

PasteImage3d pasteImage3dAlgo;
pasteImage3dAlgo.setInputSource( foam );
pasteImage3dAlgo.setInputDestination( foam );
pasteImage3dAlgo.setOriginSource( {0, 0, 0} );
pasteImage3dAlgo.setOriginDestination( {10, 10, 10} );
pasteImage3dAlgo.setAreaSize( {100, 100, 100} );
pasteImage3dAlgo.execute();

std::cout << "outputImage:" << pasteImage3dAlgo.outputImage()->toString();

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

paste_image_3d_algo = imagedev.PasteImage3d()
paste_image_3d_algo.input_source = foam
paste_image_3d_algo.input_destination = foam
paste_image_3d_algo.origin_source = [0, 0, 0]
paste_image_3d_algo.origin_destination = [10, 10, 10]
paste_image_3d_algo.area_size = [100, 100, 100]
paste_image_3d_algo.execute()

print( "output_image:", str( paste_image_3d_algo.output_image ) )

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

PasteImage3d pasteImage3dAlgo = new PasteImage3d
{
    inputSource = foam,
    inputDestination = foam,
    originSource = new int[]{0, 0, 0},
    originDestination = new int[]{10, 10, 10},
    areaSize = new uint[]{100, 100, 100}
};
pasteImage3dAlgo.Execute();

Console.WriteLine( "outputImage:" + pasteImage3dAlgo.outputImage.ToString() );

Function Examples

auto foam = readVipImage( std::string( IMAGEDEVDATA_IMAGES_FOLDER ) + "foam.vip" );

auto result = pasteImage3d( foam, foam, {0, 0, 0}, {10, 10, 10}, {100, 100, 100} );

std::cout << "outputImage:" << result->toString();

foam = imagedev.read_vip_image(imagedev_data.get_image_path("foam.vip"))

result = imagedev.paste_image_3d( foam, foam, [0, 0, 0], [10, 10, 10], [100, 100, 100] )

print( "output_image:", str( result ) )

ImageView foam = Data.ReadVipImage( @"Data/images/foam.vip" );

IOLink.ImageView result = Processing.PasteImage3d( foam, foam, new int[]{0, 0, 0}, new int[]{10, 10, 10}, new uint[]{100, 100, 100} );

Console.WriteLine( "outputImage:" + result.ToString() );

PasteImage3d

- Function Syntax

+ Class Syntax

Parameters

Object Examples

Function Examples

Function Syntax

Class Syntax