CALL LOAD PCM
This page was last modified 15:04, 17 May 2020 by Mars2000you. Based on work by Gdx.

Contents

Effect

Loads an ADPCM/PCM file from disk, while keeping the original audio format and sampling frequency.

If the file is longer than the length set by CALL SET PCM, only the specified length is loaded.

This instruction uses the BASIC free areas as a buffer during transfer for speeding up. Therefore, the loading time becomes longer when these free areas are smaller.

Note: If the operation is interrupted, the next PCM instruction will not be correctly executed. In this case, use CALL STOPM before any PCM instruction.

Syntax

CALL LOAD PCM("<Device>:\<Path>\<Filename>",<VoiceFile>)

Notes:

  • Character backslash (\) serves as a separator between the folders and the file name in MSX-DOS2. You don't have to put it after the colon of the device name.
  • Character backslash is replaced by the character yen (¥) on Japanese MSX or the character won (₩) on Korean MSX.
  • Parameters can not end with a comma alone.

Parameters

<Device> is the name for used device. (see table below)

Device type Device name Remark
Disk drive A, B, C, D, E, F, G, H A floppy disk interface can control until 2 drives.
Linked computer COM Requires RS-232C interface
Memory disk MEM Created with CALL MEMINI


By default, the loading will be made from the current active drive (generally drive A).

<Path> is used to specify the location in folders of file to load. Each folder name in path are separate by a backslash (\). This parameter is only available in version 2 of Disk BASIC.

<Filename> is the file name that contains the ADPCM/PCM data. The format is 8 characters followed by a point and an extension with 3 characters. (Not case sensitive)

<VoiceFile> is a number between 0 and 15, that is assigned to the loaded ADPCM/PCM file used as instrument (voice).

Examples

CALL LOAD PCM("DEMO2.DAT",2)
CALL LOAD PCM("B:SAMPLE11.SAM",0)
A$="TEST33.CA1": CALL LOAD PCM(A$,1)

Related to

CALL CONVA, CALL CONVP, CALL COPY PCM, CALL MK PCM, CALL PLAY PCM, CALL REC PCM, CALL SAVE PCM, CALL SET PCM, CALL STOPM

Compatibility

MSX-AUDIO BASIC