Back to FabImage Library website

You are here: Start » Function Reference » Image » Image Basics » EmptyImage

EmptyImage


Header: FIL.h
Namespace: fil
Module: FoundationLite

Creates an image filled with one color.

Applications: Most typically used to prepare a background for image drawing tools.

Syntax

C++
C#
 
void fil::EmptyImage
(
	const int inWidth,
	const int inHeight,
	const fil::Pixel& inColor,
	const int inChannels,
	const fil::PlainType::Type& inPixelType,
	fil::Image& outImage
)

Parameters

Name Type Range Default Description
Input value inWidth const int 1 - 65535 320 Width of the created image
Input value inHeight const int 1 - 65535 240 Height of the created image
Input value inColor const Pixel& Color of all pixels of the created image
Input value inChannels const int 1 - 4 3 Number of channels
Input value inPixelType const PlainType::Type& UInt8
Output value outImage Image& Output image

Description

The operation produces an empty image of desired dimensions and color.

Examples

EmptyImage run with default parameters produces 320x240 black image.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.