ZPlay.DetectFileBPM Method

Detect beat-per-minute value of specified file.

Visual Basic

Public Function DetectFileBPM(ByVal FileName As String, ByVal Format As TStreamFormat, ByVal Method As TBPMDetectionMethod) As Integer

Parameters

Parameters	Description
ByVal FileName As String	String specifying file name.
ByVal Format As TStreamFormat	Stream format identifier. Use sfAutodetect if you need to autodetect stream format of specified file.
ByVal Method As TBPMDetectionMethod	Detection method. See valid detection methods.

Returns

BPM value. If algorithm can't detect BPM value, return value is 0.

Remarks

This function will open temporary stream and detect beat-per-minute. When detection process is done, stream will be closed.

Note: Detection process can take some time.

Warning: This function WILL NOT interfere with current playing.

BPM detection algorithm isn't 100 % accurate. Algorithm will stop when first valid BPM value is detected. If BPM value can't be detected, algorithm will try to search whole stream. If this fails, returned BPM value is 0.