smfsh(1) [debian man page]

SMFSH(1)																  SMFSH(1)

NAME

       smfsh - SMF shell

SYNOPSIS

       smfsh [ -V ] [ file ]

OPTIONS

       -V     Print libsmf version and exit.

       file   Load the file.

DESCRIPTION

       smfsh,  an "SMF shell", is an interactive, command-driven frontend to libsmf, useful for modifying MIDI files by hand.  It started its life
       as a debugging aid for libsmf.

       There are four groups of commands: SMF level, track level, event level, and others.

SMF LEVEL COMMANDS

       SMF level commands display or change properties of smf (i.e. the MIDI file) as a whole.

       save file
	      Save a file.  If the file name is not given, the last file name is used.

	      Note that this will not ask for confirmation.

       load file
	      Load a file.  If the file name is not given, the last file name is used.

	      Instead of using "load", you can pass the file name on the command line.

       ppqn new-ppqn
	      Show (if used without parameter) or change PPQN (Pulses Per Quarter Note, aka Division).

       format new-format
	      Show (if used without parameter) or change format.

       tempo  Show tempo map.  Tempo map is computed automatically from the SMF contents - to modify a tempo, just add a Tempo Change event  using
	      "add" command.

       length Show total length of the song.  Just like the tempo map, file length is computed from the SMF contents.

TRACK LEVEL COMMANDS

       Track level commands display or change properties of tracks.  SMF may contain one or more tracks.

       tracks Show the list of tracks in the SMF.

       track track-number
	      Show  details  of  a  track  (if	called	without  parameter), or select track with a given number - for example in order to display
	      ("events") the events it contains.

       trackadd
	      Create new track.

       trackrm track-number
	      Remove the track.  If the track number is not given, this will remove the track currently selected.

EVENT LEVEL COMMANDS

       Event level commands display or change properties of events.  Events are grouped into tracks.  Track may  contain  any  number  of  events,
       including zero.

       events Show the list of events in the current track.

       event event-number
	      Show information about a current event (if used without parameter) or select the event.

       add time-in-seconds midi-message-as-hex
	      Add new event to the currently selected track.

       rm event-number
	      Remove the event.  If the event number is not given, this will remove the event currently selected.

OTHER COMMANDS

       There are three commands in the "other" category - "help", "version", and "exit".  Their meaning should be self expanatory.

smfsh 1.3							   21 March 2010							  SMFSH(1)

CD(3pm) 						User Contributed Perl Documentation						   CD(3pm)

NAME

       Audio::CD - Perl interface to libcdaudio (cd + cddb)

SYNOPSIS

	 use Audio::CD ();
	 my $cd = Audio::CD->init;

DESCRIPTION

       Audio::CD provides a Perl interface to libcdaudio by Tony Arcieri, available from http://cdcd.undergrid.net/

       Several classes provide glue for the libcdaudio functions and data structures.

Audio::CD Class
       init
	   Initialize the Audio::CD object:

	    my $cd = Audio::CD->init;

       stat
	   Stat the Audio::CD object, returns an Audio::CD::Info object.

	    my $info = $cd->stat;

       cddb
	   Returns an Audio::CDDB object.

	    my $cddb = $cd->cddb;

       play
	   Play the given cd track (defaults to 1).

	    $cd->play(1);

       stop
	   Stop the cd.

	    $cd->stop;

       pause
	   Pause the cd.

	    $cd->pause;

       resume
	   Resume the cd.

	    $cd->resume;

       eject
	   Eject the cd.

	    $cd->eject;

       close
	   Close the cd tray.

	    $cd->close;

       play_frames
	    $cd->play_frames($startframe, $endframe);

       play_track_pos
	    $cd->play_track_pos($strarttrack, $endtrack, $startpos);

       play_track
	    $cd->play_track($strarttrack, $endtrack);

       track_advance
	    $cd->track_advance($endtrack, $minutes, $seconds);

       advance
	    $cd->advance($minutes, $seconds);

       get_volume
	   Returns an Audio::CD::Volume object.

	    my $vol = $cd->get_volume;

       set_volume
	    $cd->set_volume($vol);

Audio::CDDB Class
       discid
	    my $id = $cddb->discid;

       lookup
	   Does a cddb lookup and returns an Audio::CD::Data object.

	    my $data = $cddb->lookup;

Audio::CD::Data Class
       artist
	    my $artist = $data->artist;

       title
	    my $title = $data->title;

       genre
	    my $genre = $data->genre;

       tracks
	   Returns an array reference of Audio::CD::Track objects.

	    my $foo = $data->tracks($info);
	    my @tracks = @$foo;

Audio::CD::Track Class
       name
	    my $name = $track->name;

Audio::CD::Info Class
       mode
	   Returns the CD mode, one of PLAYING, PAUSED, COMPLETED, NOSTATUS;

	    my $track = $info->mode;
	    print "playing" if $info->mode == Audio::CD::PLAYING;

       present
	   Returns true if a disc is present.

	    $cd->play if $info->present;

       current_track
	   Returns the current track number being played or paused.

	    my $track = $info->current_track;

       first_track
	   Returns the number of the first track on the CD.

	    my $track = $info->first_track;

       total_tracks
	   Returns the total number of tracks on the cd.

	    my $track = $info->total_tracks;

       track_time
	   Returns the current track play time:

	    my($minutes, $seconds) = $info->track_time;

       time
	   Returns the current disc play time:

	    my($minutes, $seconds) = $info->time;

       length
	   Returns the disc length time:

	    my($minutes, $seconds) = $info->length;

       tracks
	   Returns an array reference of Audio::CD::Info::Track objects.

	    my $foo = $info->tracks;
	    my @tracks = @$foo;

Audio::CD::Info::Track Class
       length
	   Returns the track length time:

	    my($minutes, $seconds) = $tinfo->length;

       pos Returns the track position on the CD:

	    my($minutes, $seconds) = $tinfo->pos;

       type
	   Returns the track type (either TRACK_AUDIO or TRACK_DATA):

	    if ($tinfo->type == Audio::CD::TRACK_AUDIO) {
	      print "audio track
";
	    } elsif ($tinfo->type == Audio::CD::TRACK_DATA) {
	      print "data track
";
	    }

       is_audio
	   Returns true if the track is an audio track; equivalent to the test:

	    $tinfo->type == Audio::CD::TRACK_AUDIO ? 1 : 0

       is_data
	   Returns true if the track is a data track; equivalent to the test:

	    $tinfo->type == Audio::CD::TRACK_DATA ? 1 : 0

SEE ALSO

       Xmms(3)

AUTHOR

       Perl interface by Doug MacEachern

       libcdaudio and cddb_lookup.c by Tony Arcieri

perl v5.14.2							    2011-11-15								   CD(3pm)