The WANALYZER_BUDDY_TEXT structure describes settings applied to a "buddy" text assigned to a graphic item, available on the Waveform Analyzer, through the WaveformAnalyzer.GraphicItemBuddyTextSet method. The current settings of the "buddy" text can be retrieved through the WaveformAnalyzer.GraphicItemBuddyTextParamsGet method and modified through the WaveformAnalyzer.GraphicItemBuddyTextParamsSet method.

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 object section.

Visual C++ definition

typedef struct

{

OLE_COLOR

OLE_COLOR

short

short nTranspFactor;

long nAlignment;

short bKeepVisible;

} WANALYZER_BUDDY_TEXT;

This data structure is defined inside the AdjMmsEngDef.h header file which can be found inside the product's Include directory (default C:\Program Files\Active Sound Editor\include).

Visual Basic definition

Public Type WANALYZER_BUDDY_TEXT

colorText As OLE_COLOR

colorTextOutline As OLE_COLOR

as Integer

nTranspFactor As Integer

bKeepVisible as Boolean

End Type

This data structure is defined inside the AsoedDef.bas module file which can be found inside the product's Include directory (default C:\Program Files\Active Sound Recorder\include).

Member

Description

colorText

Text color

colorTextOutline

Text outline color. If this color is set to a value identical to the colorText field, no outline is rendered.

nOutlineWidth

Text outline width in pixels. If this field is set to 0, no outline is rendered.

nTranspFactor

Transparent factor. This value can range from 0 (total opacity) to 255 (total transparency). Values outside of this range will be automatically capped to the nearest valid value.

nAlignment

Alignment respect to the graphic item.

Supported values are the following:

 Mnemonic constant Value Meaning BUDDY_ALIGN_LEFT_TOP 0 Buddy element is left-top aligned BUDDY_ALIGN_CENTER_TOP 1 Buddy element is center-top aligned BUDDY_ALIGN_RIGHT_TOP 2 Buddy element is right-top aligned BUDDY_ALIGN_LEFT_MIDDLE 3 Buddy element is left-middle aligned BUDDY_ALIGN_CENTER_MIDDLE 4 Buddy element is center-middle aligned BUDDY_ALIGN_RIGHT_MIDDLE 5 Buddy element is right-center aligned BUDDY_ALIGN_LEFT_BOTTOM 6 Buddy element is left-bottom aligned BUDDY_ALIGN_CENTER_BOTTOM 7 Buddy element is center-bottom aligned BUDDY_ALIGN_RIGHT_BOTTOM 8 Buddy element is right-bottom aligned

bKeepVisible

Boolean value that specifies if the buddy text is kept visible when reaching the limits of the waveform visible range.

Supported values are the following:

 Mnemonic constant Meaning False The buddy text is not kept visible True The buddy text is kept visible