Humdrum Extras

proll manpage

COMMAND

    proll -- Convert **kern data into graphical piano roll notation.

SYNOPSIS

    proll [-s style] [-K | -k color] [input] [> output]

OPTIONS

    -s style Select the colorizing style. Currently only M for metric colorizing is the only valid colorizing style other than the default.
    -K Do not superimpose a keyboard tablature on the background.
    -k color Color the background keyboard with the specified HTML style color code.

EXAMPLES
    Here is some example input for the proll command:


    MIDI
    proll outputs graphics in the PPM format. To view the graphic image in a web browser, you need to convert the PPM file into a PNG or GIF file using the command-line program convert, or a similar program.

    Here is the simplest usage for proll without any command-line options: 

        proll prelude28-11.krn > prelude28-11.ppm
    convert prelude28-11.ppm relude28-11.png

    This will create the following graphic image:

    piano roll notation of prelude28-11.krn

    Output images can be resized with the convert command: 

        proll prelude28-11.krn > prelude28-11.ppm
    convert prelude28-11.ppm -resize 100 thumbnail.png
    which will generate the following thumbnail image:
    thumbnail image of prelude28-11.png

    By default each major **kern spine in a Humdrum file will be given a different color by voice. To color the notes according to their metric position, you can use the -sM to indicate the metric style of colorizing the picture. 

        proll -sM prelude28-11.krn > prelude28-11M.ppm
    convert prelude28-11M.ppm prelude28-11M.png
    metric image of prelude28-11.png

    By default the background image contains a keyboard tablature. To turn this keyboard off, use the -K option. To make the keyboard image more prominant, change the color of the white keys with the -k option: 

        proll -k 555555 prelude28-11.krn > whitekeys.ppm
    convert whitekeys.ppm whitekeys.png
    white keyboard prelude28-11.png

    More example usages of the proll program are avaliable on the proll examples page

BUGS
    The proll program will not generate images of long pieces with compilcated rhythms because it does not quantize the rhythm data.

DOWNLOAD
    The compiled proll program can be downloaded for the following platforms:
    • Linux (i386 processors) compiled on 20 Aug 2003.
    • Mac OSX (version 10.2 and higher) compiled on 6 Sep 2004.
    • Windows compiled on 1 Jun 2006.

    The source code for the program was last modified on 11 Apr 2002.