MultiCam Boards Documentation > MultiCam Documentation > MultiCam Reference > Channel Class > Cluster Category > Adjust Level (Cluster) > ImagePlaneCount

ImagePlaneCount

Description

Type

Integer

Description

Number of image planes

"Set" effect

-

"Get" effect

Returns the current image plane count

Classification

Class

Channel

Category

Cluster

Level

Adjust

Identifiers

String

ImagePlaneCount

C, C++

MC_ImagePlaneCount

.NET

MC.ImagePlaneCount

Numerical

1718

MultiCam creates the surfaces and automatically allocates the memory buffers, if not done by the application. The following channel parameters configure the automatic allocation: BufferSize, BufferPitch, ImagePlaneCount and SurfaceCount. MultiCam decides the adequate number of surfaces for the selected acquisition mode.

This parameter indicates the number of planes required by the frame grabber to store the pixel data.

The channel cannot be activated if all surfaces do not meet this requirement.

Possible values

Although not being of the enumerated type, this parameter is restricted to the following values:

Values

Description

1

The pixel data is stored in a single plane.

3

Each of the 3 pixel component data is stored in a separate plane.

This parameter is get-only, except when channel creation model MC_CHANNEL_ALPHA_STEREOXY is used on Domino Alpha 2. In this case, it specifies the storage method.

Values applicable values with MC_CHANNEL_ALPHA_STEREOXY model on Domino Alpha 2

Values

Description

1

Selects a single-plane surface. Image from camera attached on connector X is stored in the left half of the surface, while image from camera attached on connector Y is stored in the right half. The resulting composite image has a double width, as reflected by parameter ImageSizeX.

2

Selects a two-plane surface. Each plane receives the image from one of the cameras.

3

Selects a three-plane surface. Each plane receives the image from one of the cameras.

4

Selects a four-plane surface. Each plane receives the image from one of the cameras.