TagLib::ID3v2::RelativeVolumeFrame - An ID3v2 relative volume adjustment frame implementation
use TagLib::ID3v2::RelativeVolumeFrame; my $i = TagLib::ID3v2::RelativeVolumeFrame->new( TagLib::ByteVector->new("")); $i->setChannelType("MasterVolume"); print $i->channelType(), "\n"; # got "MasterVolume"
This is an implementation of ID3v2 relative volume adjustment. The presense of this frame makes it possible to specify an increase in volume for an audio file or specific audio tracks in that file.
Multiple relative volume adjustment frames may be present in the tag each with a unique identification and describing volume adjustment for different channel types.
Constructs a RelativeVolumeFrame. The relevant data should be set manually.
Constructs a RelativeVolumeFrame based on the contents of $data.
Destroys the RelativeVolumeFrame instance.
Returns the frame's identification.
see identification()
Returns a list of channels with information currently in the frame.
NOTE This should be a list of PV which indicates the ChannelType.
see %_ChannelType
Always returns master volume.
deprecated
This method no longer has any effect.
Returns the relative volume adjustment "index". As indicated by the ID3v2 standard this is a 16-bit signed integer that reflects the decibils of adjustment when divided by 512.
This defaults to returning the value for the master volume channel if available and returns 0 if the specified channel does not exist.
see setVolumeAdjustmentIndex()
see volumeAjustment()
Set the volume adjustment to $index. As indicated by the ID3v2 standard this is a 16-bit signed integer that reflects the decibils of adjustment when divided by 512.
By default this sets the value for the master volume.
see volumeAdjustmentIndex()
see setVolumeAdjustment()
Returns the relative volume adjustment in decibels.
NOTE Because this is actually stored internally as an "index" to this value the value returned by this method may not be identical to the value set using setVolumeAdjustment().
Set the relative volume adjustment in decibels to $adjustment.
NOTE Because this is actually stored internally as an "index" to this value the value set by this method may not be identical to the one returned by volumeAdjustment().
Returns the peak volume (represented as a length and a string of bits).
see setPeakVolume()
Sets the peak volume to $peak.
see peakVolume()
This indicates the type of volume adjustment that should be applied. keys %TagLib::ID3v2::RelativeVolumeFrame::_ChannelType lists all available values used in Perl code.
keys %TagLib::ID3v2::RelativeVolumeFrame::_ChannelType
None by default.
TagLib Frame
Dongxu Ma, <dongxu.ma@gmail.com>
Copyright (C) 2005 by Dongxu Ma
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.7 or, at your option, any later version of Perl 5 you may have available.
To install TagLib, copy and paste the appropriate command in to your terminal.
cpanm
cpanm TagLib
CPAN shell
perl -MCPAN -e shell install TagLib
For more information on module installation, please visit the detailed CPAN module installation guide.