• R/O
  • HTTP
  • SSH
  • HTTPS

playumidi: Résumé du dépôt

playmidiのソースコードなど公開物一式のりぽじとり


Commits Récents RSS

Révision l'heure Auteur Message:
95a6935 2020-08-23 13:41:22 Koine Yuusuke(koinec) master Fixed a problem that guw_division global variable was mis...
78924f8 2019-08-11 10:38:28 Koine Yuusuke(koinec) * Correct my E-mail Address in main.c.
3e77b67 2019-08-11 10:35:36 Koine Yuusuke(koinec) * Correct my E-mail address.
d44bc5c 2019-08-11 08:17:14 Koine Yuusuke(koinec) 2019/08/11(Sun) 08:17 * Micro correction for manual-file...
52454c0 2019-08-11 08:09:30 Koine Yuusuke(koinec) 2019/08/11(Sun) 08:09 * Minor Correction for support Fre...
855f57d 2015-12-24 04:42:51 Koine Yuusuke(koinec) * Fix: Version string in README.jp
2dc857d 2015-12-23 15:14:38 Koine Yuusuke(koinec) * Update: Version 0.8.1 (for Support FreeBSD 10.x: fix sr...
f40ec9b 2014-02-23 20:48:29 koinec(Koine Yuusuke) * Fix Version date (2014/02/09 => 2014/02/23)
8157b8e 2014-02-23 20:45:45 koinec(Koine Yuusuke) * Add README.jp (TCK33146) * Add INSTALL.jp (TCK33142)
86c92fe 2014-02-23 19:55:00 koinec(Koine Yuusuke) * Support WITH_ICONV option in Top-Level Makefile * Add...

Branches

Nom Révision l'heure Auteur Message:
master 95a6935 2020-08-23 13:41:22 Koine Yuusuke(koinec) Fixed a problem that guw_di...

README

playumidi - play standard midi-file format 0/1 for FreeBSD USB-MIDI device
  Version 0.8.3


[Introduction]--------------------------------------------------------------

 "playumidi" is the "SIMPLE" MIDI file player for USB MIDI device on FreeBSD.
 This software is able to direct control for FreeBSD-umidi device(/dev/umidi*.*)
 in the "uaudio" driver.
 Therefore, You don't need to use the "/dev/sequencer" device or the other
 software when listening the MIDI-file music.
 And, Support for auto-judge MIDI-file XG/GS/GM mode & auto add the
 Tone-Generator ReSet code when the ReSet code isn't exist in a MIDI-file.


[Requirement]---------------------------------------------------------------

 "playumid" is able to running following environment.
  * OS: FreeBSD 12.x / 11.x
  * Available /dev/umidi*.* driver Only(integrated uaudio driver)
      (But Can't use /dev/sequencer (old midi driver))
  *  USB-MIDI Device (Support by FreeBSD uaudio driver)
  *  MIDI Tone generator or Compatible Device
      (e.g. YAMAMA MU1000/2000/128/etc... or Roland SC-88xx)
  * Depends on libpthread
      (Usually, libpthread is FreeBSD-default library.
       So, You don't neet to install this library.)
  * Depends on libiconv
      (However, only if you want to play MIDI files with embedded languages
       other than English) 

 Reference Environment:
  * FreeBSD 12.0-RELEASE
  * uaudio driver (umidi)
  * YAMAHA MU1000 Tone Generator (Integrated USB) 


[Install]-------------------------------------------------------------------

 Please read INSTALL text.


[Usage]---------------------------------------------------------------------

 playumidi is command-line software.
 
 SYNOPSIS:
    "playumidi [option] file"

 OPTIONS:
    -d device_name
      * Set the USB MIDI device name (Device Number & Port Number is auto-search)
          (If you want to use the "/dev/umidi0.0" device, you set "-d umidi".
           Don't set the Device Number & Port Number("0.0") )
      * playumidi use the midi device that the device directory is
        "/dev/<device_name>DeviceNumber.Number".
      * DEFAULT: "umidi" 

    -0 device_fullname
      * playumidi use the indicate device as the port-0 midi device.
      * Can't use the "-d"option same time.
           (When use both "-d" option and "-0/1/2/3"option,
            playumidi terminate process)
      * DEFAULT: "umidiX.0" (X is serarched by playumidi from 0 to 15.) 

    -1 device_fullname
      * playumidi use the indicate device as the port-1 midi device.
      * Can't use the "-d"option same time.
           (When use both "-d" option and "-0/1/2/3"option,
            playumidi terminate process)
      * DEFAULT: "umidiX.1" (X is serarched by playumidi from 0 to 15.) 

    -2 device_fullname
      * playumidi use the indicate device as the port-2 midi device.
      * Can't use the "-d"option same time.
           (When use both "-d" option and "-0/1/2/3"option,
            playumidi terminate process)
      * DEFAULT: "umidiX.2" (X is serarched by playumidi from 0 to 15.) 

    -3 device_fullname
      * playumidi use the indicate device as the port-3 midi device.
      * Can't use the "-d"option same time.
           (When use both "-d" option and "-0/1/2/3"option,
            playumidi terminate process)
      * DEFAULT: "umidiX.3" (X is serarched by playumidi from 0 to 15.) 

    -r
      * Disable Auto-Insert XG/GS/GM Reset code. 

    -q
      * Quiet Mode : Don't output the Meta-Event Text to the terminal stdout. 

    -v
      * Verbose Mode : Output the playumidi running status. 

    -h
      * Output Command-Line Help Message (Usage) 

    -l language_code
      * Setting the Text Language-Code of the MIDI-File MetaEvent TextCode.
      * This option is enabled only when you build by giving the "-DWITH_ICONV"
        to make command.
      * The parameter "language_code" of Option -l is abilityto specify a value
        that is displayed in the command "iconv -l"
      * DEFAULT: SHIFT_JISX0213 (Japanese) 

    -t language_code
      * Setting the Output Text Language-Code for Terminal.
      * This option is enabled only when you build by giving the "-DWITH_ICONV"
        to make command.
      * The parameter "language_code" of Option -t is abilityto specify a value
        that is displayed in the command "iconv -l"
      * DEFAULT:
          The string of the back than the "." of the environment variable LANG.
          If isn't setting the LANG variable, the default value is "EUC-JP". 

 The following Playing-Operation are available 

    "Ctrl + C" Key
      * Stop playing music & Terminate playumidi. 


[CAUTION!!]-----------------------------------------------------------------

 playumidi directly opens, writes midi-event data, and closes
 the /dev/<usb-midi device>.
 So, it is necessary to grant the R/W privileges(666) to /dev/<usb-midi device>
 before use playumidi.
 But, the FreeBSD umidi-driver (integraed by uaudio driver) is not granted
 permission only of the root-user R/W and others user/group read-only
 (permission 644) at the default.

 Therefore, there is a need to grant permissions to R/W prior to use.
 I will show some examples below.

  * (Example 1) set permissions every use time
        Do the following command as the root user.
        (Of course, can use sudo command also.)
           "chmod -R 755 /dev/umidi*"

  * (Example 2) Set permanently R/W permission for usb-midi device. (FreeBSD 8/9 only)
        Do the following operation as the root user.
        (Of course, can use sudo command also.) 

      1. Append to /etc/devfs.rules the following two lines.
         (Making /etc/devfs.rules when there is not existing this file.)
            ------------------------------------------
            [system=10]
            add path 'umidi*' mode 0666 group wheel
            ------------------------------------------

      2.  Append to /etc/rc.conf the following three lines.
            ------------------------------------------
            devfs_enable="YES"
            ------------------------------------------

      3.  Reboot FreeBSD (shutdown -r now) 


[AUTHORS]----------------------------------------------------------------

 Koine Yuusuke (koinec@users.osdn.me)


[CHANGELOG]--------------------------------------------------------------

 Version 0.8.3 - 2020/08/23
   * Since a global variable with the same name was defined in midievent.c
     and play_event.c, a fix for a build error occurred.
 Version 0.8.2 - 2019/08/11
   * Minor Correction for support FreeBSD ports. (Makefile)
 Version 0.8.1 - 2015/12/23
   * Support for FreeBSD 10.x (Fix linker program name in src/Makefile)
 Version 0.8.0 - 2014/02/23
   * Initial Public


[LICENSE]----------------------------------------------------------------

 playumidi presented by the "FreeBSD License".
 
 Please read LICENSE text file.


END of README ***********************************************************
Afficher sur ancien navigateur de dépôt.