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

Contents

Effect

Saves an ADPCM/PCM file to disk.

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

This instruction uses the BASIC free areas as a buffer during transfer for speeding up. Therefore, the saving 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 SAVE 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 saving will be made to the current active drive (generally drive A).

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

<Filename> is a string that contains the file name of the ADPCM/PCM data to save. 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, corresponding to this ADPCM/PCM file used as instrument (voice).

Examples

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

Related to

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

Compatibility

MSX-AUDIO BASIC