CreateImageAndSetPixels

Creates an image, allocates an appropriate data buffer and sets all pixels to the specified value. The initial reference count is set to one if a new image interface is created and kept, otherwise.

Syntax

Definition:

HRESULT CreateImageAndSetPixels(
    HRESULT            hrPrev,
    ITcVnImage*&       ipImage,
    ULONG              nWidth,
    ULONG              nHeight,
    ETcVnElementType   ePixelType,
    ULONG              nChannelNum,
    TcVnVector4_LREAL& aValue
)

Parameters

Name

Type

Description

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

ipImage

ITcVnImage*&

Returns the created image (Non-zero interface pointers are reused.)

nWidth

ULONG

Image width

nHeight

ULONG

Image height

ePixelType

ETcVnElementType

Pixel type

nChannelNum

ULONG

Number of channels (1 to 4)

aValue

TcVnVector4_LREAL&

Pixel value

CreateImageAndSetPixels 1: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements