ILMVGamma Interface

Data types

GAMMA_ATTRIBUTES:

typedef struct
{
   long lGamma;
   BOOL bGammaEqualize;
   long lDGamma;
   BOOL bDGammaEqualize;
} GAMMA_ATTRIBUTES;

Describes gamma correction attributes.

 

Member

Description

lGamma

Gamma correction value, range between 1 and 500.

bGammaEqualize

TRUE to enable gamma correction.

lDGamma

Default Gamma correction value.

Original default value is 1.0

bDGammaEqualize

Default gamma correction Enable flag.

 

Interface Methods

HRESULT IsLEADInputPinConnected()

Parameters

None.

Description

Determines whether the filter input pin is currently connected.

Returns

S_OK if connected, S_FALSE otherwise.

 

 

HRESULT IsLEADOutputPinConnected()

Parameters

None.

Description

Determines whether the filter output pin is currently connected.

Returns

S_OK if connected, S_FALSE otherwise.

 

 

HRESULT GetGamma_Attributes(Gamma_ATTRIBUTES* gamma_attributes)

Parameters

gamma_attributes

a valid pointer to a GAMMA_ATTRIBUTES structure.

Description

Gets the current gamma correction attributes.

Returns

S_OK if successful, S_FALSE otherwise.

 

 

HRESULT SetGamma_Attributes(Gamma_ATTRIBUTES gamma_attributes)

Parameters

gamma_attributes

a GAMMA_ATTRIBUTES structure that contains gamma correction attributes to set.

Description

Sets the gamma correction attributes. If the gamma value is out of the permitted range, it is clipped.

Returns

S_OK if successful, S_FALSE otherwise.

 

 

HRESULT GetIODimensions(long *plInWidth, long *plInHeight, long *plOutWidth, long *plOutHeight)

Parameters

plInWidth

A valid pointer to a long variable to be updated with the input media width. NULL can be passed if this value is not needed.

plInHeight

A valid pointer to a long variable to be updated with the input media height. NULL can be passed if this value is not needed.

plOutWidth

A valid pointer to a long variable to be updated with the output media width. NULL can be passed if this value is not needed.

plOutHeight

A valid pointer to a long variable to be updated with the output media height. NULL can be passed if this value is not needed.

Description

Retrieves the current media dimensions.

Returns

S_OK if successful, S_FALSE otherwise.

 

 

HRESULT GetIOBitCount(int *pInBitCount, int *pOutBitCount)

Parameters

pInBitCount

A valid pointer to an integer that will receive the input media bits per pixel value. NULL can be passed if this value is not needed.

pPBitCount

A valid pointer to an integer that will receive the output media bits per pixel value. NULL can be passed if this value is not needed.

Description

Gets the bits per pixel of the current connected input and output media formats.

Returns

S_OK if successful, S_FALSE otherwise.