NAME

MIDI::XML::CopyrightNotice - Copyright Notice meta messages.

SYNOPSIS

  use MIDI::XML::CopyrightNotice;

  $Copy = MIDI::XML::CopyrightNotice->new();

  $Copy->delta(0);

  $Copy->value("Copyright 2003 Brian M. Ames");

  @event = $Copy->as_event();

  $midi_track = MIDI::Track->new();

  push( @{$midi_track->events_r},\@event;

  @xml = $Copy->as_MidiXML();

  print join("\n",@xml);

DESCRIPTION

MIDI::XML::CopyrightNotice is a class encapsulating MIDI Copyright Notice

meta messages. A Copyright Notice message includes either a delta time

or absolute time as implemented by MIDI::XML::Message and the MIDI Copyright

Notice event encoded as follows:

0xFF 0x02 length text

EXPORT

None.

METHODS AND ATTRIBUTES

$Copy = MIDI::XML::CopyrightNotice->new()

This creates a new MIDI::XML::CopyrightNotice object.

$Copy = MIDI::XML::CopyrightNotice->new($event);

Creates a new CopyrightNotice object initialized with the values of a

MIDI::Event copyright_text_event array.

$delta_time = $Copy->delta() or $Copy->delta($delta_time);

Returns the message time as a delta time or undef if it is an absolute

time. Optionally sets the message time to the specified delta time. To

avoid contradictory times, the absolute time is set to undef when a delta time

is set.

This functionality is provided by the MIDI::XML::Message base class.

$absolute_time = $Copy->absolute() or $Copy->absolute($absolute_time);

Returns the message time as an absolute time or undef if it is a delta

time. Optionally sets the message time to the specified absolute time. To

avoid contradictory times, the delta time is set to undef when an absolute time

is set. The absolute time should be zero according to the specification.

This functionality is provided by the MIDI::XML::Message base class.

$time = $Copy->time();

Returns the message time, absolute or delta, whichever was last set.

This functionality is provided by the MIDI::XML::Message base class.

$text = $Copy->text() or $Copy->text($text);

Returns and optionally sets the text value.

$ordinal = $Copy->ordinal();

Returns a value to be used to order events that occur at the same time.

@event = $Copy->as_event();

Returns a MIDI::Event copyright_text_event array initialized with the values

of the CopyrightNotice object. MIDI::Event does not expect absolute times

and will interpret them as delta times. Calling this method when the time

is absolute will not generate a warning or error but it is unlikely that

the results will be satisfactory.

@xml = $Copy->as_MidiXML();

Returns an array of elements formatted according to the MidiXML DTD. These

elements may be assembled by track into entire documents with the following

suggested DOCTYPE declaration:

        <!DOCTYPE MIDI PUBLIC

                "-//Recordare//DTD MusicXML 0.7 MIDI//EN"

                "http://www.musicxml.org/dtds/midixml.dtd">

AUTHOR

Brian M. Ames, <bmames@apk.net>

SEE ALSO

MIDI::Event.

COPYRIGHT and LICENSE

Copyright 2002 Brian M. Ames. This software may be used under the terms of

the GPL and Artistic licenses, the same as Perl itself.