Skip to content

Latest commit

 

History

History
160 lines (124 loc) · 6.23 KB

README-en.md

File metadata and controls

160 lines (124 loc) · 6.23 KB
Raw

これは英語のドキュメントです.日本語のドキュメントはREADME.mdあります.

This document is a best-effort attempt at an English introduction by massaging an auto-translated version of README.md. It is accurate (to the extent auto-translate is accurate) as of commit 1f306b3, but does not strictly follow changes to README.md.

About the OPEN MUCOM 88 Project

A Windows version of MUCOM 88 is released as part of the OPEN MUCOM 88 project. For more information, see Open MUCOM 88 Wiki
https://github.com/onitama/mucom88/wiki/Home-en

MUCOM 88 for Windows is primarily distributed at the following site:

MUCOM 88 Windows
https://onitama.tv/mucom88/index_en.html

MUCOM 88 is a Music Macro Language (MML) compiler and music creation tool for the NEC PC-8801 platform developed by Yuzo Koshiro in 1987. In addition to a compiler, MUCOM 88 provides an FM synthesis driver written in z80 machine code that understands the MML compiler output, giving an environment for playback and feedback for the composer.

The OPEN MUCOM88 project aims to be widely used and extended by releasing the original MUCOM 88 source code alongside OPEN MUCOM 88. Source code and assets are released free of charge with an open license. License details are summarized in the "License and Contact" section and "license.txt".

Disk images for the original MUCOM 88 distribution can be found on Ancient Corp.'s website.

Building

  • The src folder contains project files for Visual Studio 2017.
  • The xcode folder contains a project file for Mac OS X XCode.
  • Support for Hot Soup Processor (Japanese only) is found in the hspplugin folder. English information for HSP is on Wikipedia.
  • A Makefile is also provided in src- it works on Linux and Win32 if using msys2.

When compiling using the Makefile, Linux builds require SDL 1.2. Using SDL is optional on Windows, and is disabled by setting OS_WIN32 = 1 in Makefile.settings. make must be invoked while src is your working directory.

Raspberry Pi Example (Assuming a Debian-based Linux variant- adjust accordingly if you use a different Linux distribution.):

sudo apt-get install libsdl1.2-dev
git clone https://github.com/onitama/mucom88
cd src
make
make mini

Several companion tools are available: @BouKiCHi provides Mac OS X binaries.
https://github.com/BouKiCHi/mucom88/tags

@kuma4649/kumatan provides a versatile video game music format music player (including VGM), and a utility to convert OPEN MUCOM 88 .muc files to VGM format (particularly using the Sega Genesis chips).
https://github.com/kuma4649/MDPlayer
https://github.com/kuma4649/mucomMD2vgm/releases

License and Contact

(This section mirrors both README.md and a majority of license.txt)

MUCOM 88 Windows depends on the following libraries, with credit given to the authors:

Special thanks to Makoto Wada (Ancient Corporation), WING ☆, OXYGEN, Gashi 3 (gasshi), MUCOM88, and UME-3 for their help in creating OPEN MUCOM 88. And special thanks to Yuzo Koshiro and Ancient for creating the original MUCOM 88 software for PC-8801.

Additional thanks goes to boukichi_numloc for WAV file output support and cross-platform support of OPEN MUCOM 88.

OPEN MUCOM 88 for Windows (and its source code) are released under a CC BY-NC-SA 4.0 license:
https://creativecommons.org/licenses/by-nc-sa/4.0/

You can modify, copy, and redistribute this software and source code freely for non-commercial (i.e. non-profit) purposes, provided you include license.txt.

The sample songs (sampl1.muc, sampl2.muc, sampl3.muc) and the accompanying data (mucompcm.bin, voice.dat) are provided by Yuzo Koshiro of Ancient Corporation (Japanese link only).
https://www.ancient.co.jp/yuzo.html

Please make sure to include a copyright license for the sample music provided by Yuzo Koshiro. An example attribution:

"Song title (or file name) / Copyright (C) by Yuzo Koshiro"

OPEN MUCOM 88 for Windows is created by Onion Software.

ONION software Homepage
https://www.onionsoft.net/

A user of OPEN MUCOM 88 retains the rights of MML files they create using OPEN MUCOM 88.

Onion Software does is not responsible for damages caused by this program. Use at your own risk. Also, you can freely modify and publish the Hot Soup Processor scripts associated with OPEN MUCOM 88.

The distribution rules for the fmgen source code should follow the license of the author, cisc. The distribution rules are as follows (note that original text was in Japanese, and condition 4 suggests we need the original license text):

The fmgen source code is copyrighted by the author (cisc@retropc.net).

This source code is provided as it is, without any implied or explicit
warranties. The author is not liable for any damages.

The source code can freely modified / embedded, distributed, and used as
long as the following conditions are met:

1. Specify the origin (author, copyright) of this software.
2. The distributed software shall remain free.
3. Document all modifications when distributing the modified source code.
4. Do not alter this text when distributing the source code; include
as-is.

The author would be happy to hear from you when you publish your
derivative work.

You must get permission from the author to use this source code,
in whole or in part, in a commercial product.

For more information about each library, please refer to the respective source code and documentation. For distribution for commercial use, please contact each author individually.