gives an image of the specified size with constant pixel values of val.


gives an image converted to the specified type.

Details and Options

  • ConstantImage by default chooses a color space compatible with the given value specification val.
  • Constant value val can be any of the following:
  • vgray level from 0 to 1
    {c1,c2,}different channel values ci
    colorany color directive
  • Size specification size can be one of the following:
  • side2D image of size {side,side}
    {width,height}2D image size specification
    {width,depth,height}3D image size specification
  • ConstantImage[val] is equivalent to ConstantImage[val,{150,150}]. »
  • The default "type" is taken to be "Real32".
  • ConstantImage supports all Image and Image3D options.


open allclose all

Basic Examples  (3)

Create a constant gray image:

Create a constant color image:

Create a constant 3D image:

Scope  (4)

Create a constant Lab image:

Create a constant image with an arbitrary number of channels:

If no output image size is specified, a image is returned:

By default, an image of a real type is generated:

Specify the output image type:

Options  (1)

ImageSize  (1)

By default, Automatic image size is used:

Specify the ImageSize:

Applications  (1)

Create a constant black image to construct a marker image:

Replace marker points with white and use for processing:

Properties & Relations  (1)

Construct a constant image using ConstantArray:

Wolfram Research (2014), ConstantImage, Wolfram Language function, (updated 2019).


Wolfram Research (2014), ConstantImage, Wolfram Language function, (updated 2019).


Wolfram Language. 2014. "ConstantImage." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019.


Wolfram Language. (2014). ConstantImage. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2024_constantimage, author="Wolfram Research", title="{ConstantImage}", year="2019", howpublished="\url{}", note=[Accessed: 30-May-2024 ]}


@online{reference.wolfram_2024_constantimage, organization={Wolfram Research}, title={ConstantImage}, year={2019}, url={}, note=[Accessed: 30-May-2024 ]}