Copyright © 2008-2015 MultiMedia Soft

WaveformAnalyzer.GraphicItemBuddyPictureSetFromMemory method

Previous pageReturn to chapter overviewNext page

Remarks

 

Sets a picture taken from a memory stream that will be displayed as a buddy picture of a graphic item over the waveform's graphics. The HBITMAP of the current buddy picture can be obtained through the WaveformAnalyzer.GraphicItemBuddyPictureGet method.

Settings of the buddy picture can be obtained and modified through the WaveformAnalyzer.GraphicItemBuddyPictureParamsGet and WaveformAnalyzer.GraphicItemBuddyPictureParamsSet methods.

 

On the screenshot below you can see a set of vertical lines displayed over the waveform, each with its buddy picture aligned on the bottom right of the vertical line:

 

 

In this case vertical lines are set to be rendered over time rulers, allowing buddy pictures to be rendered outside of the waveform area.

 

An existing buddy picture can be removed at a later time by calling the WaveformAnalyzer.GraphicItemBuddyPictureSetFromFile method with an empty pathname.

 

For details about graphic items management on the waveform analyzer refer to the How to add graphic items to the Waveform analyzer section.

For details about the use of the Waveform Analyzer refer to the How to use the Waveform Analyzer section.

For further details about methods of the Waveform Analyzer refer to the WaveformAnalyzer class section.

 

 

Syntax

 

[Visual Basic]

Public Function GraphicItemBuddyPictureSetFromMemory (

nUniqueId as Int32,

ms as MemoryStream,

settings as WANALYZER_BUDDY_PICTURE

) as enumErrorCodes


 

[C#]

public enumErrorCodes GraphicItemBuddyPictureSetFromMemory (

Int32 nUniqueId,

MemoryStream ms,

WANALYZER_BUDDY_PICTURE settings

);


 

[C++]

public: enumErrorCodes GraphicItemBuddyPictureSetFromMemory (

Int32 nUniqueId,

MemoryStream ms,

WANALYZER_BUDDY_PICTURE settings

);


 

 

Parameter

Description

 

 

nUniqueId

Unique identification number assigned to the graphic item.

The unique identification number of a graphic item is generated using one of the following methods:

ms

Memory stream containing the buddy picture.

Supported graphic formats are BMP, ICO, GIF, JPG, TIF and PNG.

settings

Settings for the buddy picture.

These settings can be modified or retrieved at a later time through the WaveformAnalyzer.GraphicItemBuddyPictureParamsSet and WaveformAnalyzer.GraphicItemBuddyPictureParamsGet methods.

 

 

Return value

 

Value

Meaning

 

 

Negative value

An error occurred (see the LastError property for further error details)

enumErrorCodes.ERR_NOERROR (0)

The method call was successful.