{{htmlmetatags>metatag-robots=()
metatag-title=(LOAD MUSIC | ugBASIC User Manual)
metatag-keywords=(ugBASIC,Commodore 64,Commodore PLUS/4,ZX Spectrum)
metatag-description=(Manual page for LOAD MUSIC)
metatag-media-og:image=(:ugbasic:logo-ugbasic-fb.png)
metatag-og:title=(LOAD MUSIC | ugBASIC User Manual) 
metatag-og:description=(Manual page for LOAD MUSIC)
}}

====== ugBASIC User Manual ======

===== LOAD MUSIC  =====

===== SYNTAX =====
     = LOAD MUSIC( filename )
     = LOAD MUSIC( filename AS alias )

==== PURPOSE ====


The ''LOAD MUSIC'' command allows you to load a music file from the file system 
of the host system and use it, as music, directly in the program. Loading occurs 
at compile time: there is no access to the target system's file system. If multiple 
uploads are made to the same file, a single buffer will still be generated. 

Since it is possible to upload only one file of the same type at a time, it is necessary 
to be able to indicate an "alias" with which to exceed this limit. In this regard, there is also 
the ''AS'' syntax, which allows you to load the same file several times but with different names. 



==== EXAMPLE ====
    fugue = LOAD MUSIC("fugue.imf")
    fugueAnotherCopy = LOAD MUSIC("fugue.imf" as "fugue2")


==== ABBREVIATION ====
   LdMus


==== AVAILABLE ON ====
  * 
  * Atari (400/800)
  * Atari XL/XE
  * Commodore 128 (MOS 8502)
  * Commodore 128 (Zilog Z80)
  * Commodore 64
  * Commodore 64+REU
  * TRS-80 Color Computer
  * TRS-80 Color Computer 3
  * ColecoVision
  * Amstrad CPC 664
  * Dragon 32
  * Dragon 64
  * Thomson MO5
  * Thomson MO5
  * Olivetti Prodest PC128
  * Commodore PLUS/4
  * SEGA SC-3000
  * SEGA SG-1000
  * 
  * VG-5000
  * Commodore VIC-20
  * ZX Spectrum 48


==== ANY PROBLEM? ====
If you have encountered a problem using this command, if you think there is a bug or the explanation is unclear, please [[https://github.com/spotlessmind1975/ugbasic/issues/new?title=ISSUE ON LOAD MUSIC|open an issue]] for this keyword on GitHub. Thank you!===== POWERED BY =====

[[:ugbasic:user:index|{{ :ugbasic:user:logo-ugbasic.png?nolink&600 |}}]]