pnewimage

Synopsis

Description

pnewimage creates a new image from the specified dimensions (width,height,depth) with the specified value val for all pixels.

The format of the output image is deduced from the dimension values:

• if h<=0 then im_out is a 1D image;
• if d<=0 then im_out is a 2D image;
• otherwise im_out is a 3D image.

The type of the output image is deduced from the parameter val value:

• if val is an integer < 255 and ≥ 0 then im_out is a Uchar image;
• if val is an integer > 255 or < 0 then im_out is a Long image;
• if val is a real value then im_out is a Float image.

Two other operators can be used to create a new image. psetcst creates a new image from properties of another image. pshapedesign creates a new image from specified dimensions and type.

Parameters

• w,h,d (width, height, depth) defines the dimensions of the output image.

• val specifies the value for all pixels. It can be an integer or a real value.

Outputs

• im_out: an image whose type depends on the parameters values.

Result

Returns SUCCESS or FAILURE.

Examples

Fills hole in regions yields by a simple segmentation process of the tangram.pan image:

   pbinarization 100 1e30 tangram.pan in.pan
   pnewimage 256 256 0 255 i0.pan
   psetborder 1 1 1 1 1 1 0 i0.pan i1.pan
   perosionreconstruction 4 i1.pan in.pan fillhole_out.pan

See also

C++ prototype

Version française

Création d'une nouvelle image à partir de dimensions.