Click here to return to the KiXtart HelpDesk main page...

KiXtart Command Reference

PLAY

action

Allows you to play music on the computer's speaker by using the SPK file format described below, or on your sound card by playing a WAV file.

syntax

PLAY [FILE "path\filename.spk"] | "string" | "path\filename.wav"

There are four possible syntax forms:

  • PLAY FILE "Jbond.spk"
  • PLAY "0g256t 0g8d247f 4d165f 247f 8d262f 4d165f 262f 8d277f 4d165f"
  • PLAY FILE "Ding.wav"
  • PLAY "Chimes.wav"

The string or file consists of a sequence of commands indicating the frequency and duration of the tones to play. The following commands are available:

  • frequency

This command causes a tone to be produced at the current frequency. The initial current frequency is 1000Hz. To change the value, indicate the desired frequency immediately followed by the f character. For example, to produce a tone at 1500Hz, specify 1500F.

  • G or g - gap

This command sets the number of timer ticks (1 second = 18 ticks) of silence between individual tones. The number of timer ticks between tones is specified as a number immediately followed by G. The initial value is 0.

  • D or d - duration

This command sets the length (in timer ticks) of each tone. For example, to make each tone last about a third of a second, use the command 6d.

  • T or t - tempo

This command scales the duration of each tone. This allows you to change the duration of a series of tones globally, without having to change each of the individual duration commands.

A tempo value of 256 indicates normal tempo. A value of 4 lasts:

  • 2 timer ticks, when the tempo is set to 128
  • 8 timer ticks, when the tempo is set to 512
remarks

KiXtart automatically selects the appropriate action based on the file name extension you provide.

example

PLAY    "0g256t 0g8d247f 4d165f 247f 8d262f 4d165f 262f 8d277f 4d165f
    277f   8d262f   4d165f 262f 8d247f 4d165f 247f 8d262f 4d165f
    262f   8d277f   4d165f 277f 8d262f"

This plays the part of the James Bond theme.