Add ktaglib documentation

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@271733 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
David Soria Parra 2008-12-22 01:21:10 +00:00
parent 973e3b802e
commit 326ae0ab3e
43 changed files with 2370 additions and 0 deletions

View file

@ -0,0 +1,59 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="class.audioproperties" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The KTaglib_MPEG_AudioProperties class</title>
<titleabbrev>KTaglib_MPEG_AudioProperties </titleabbrev>
<partintro>
<!-- {{{ ClassName intro -->
<section xml:id="audioproperties.intro">
&reftitle.intro;
<para>
Represents the audio properties of a MPEG file, like length, bitrate or samplerate.
</para>
</section>
<!-- }}} -->
<section xml:id="audioproperties.synopsis">
<title>Class synopsis</title>
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>KTaglib_MPEG_Audioproperties</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>KTaglib_MPEG_AudioProperties</classname>
</ooclass>
</classsynopsisinfo>
</classsynopsis>
</section>
<!-- }}} -->
</partintro>
&reference.ktaglib.entities.audioproperties;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.getBitrate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::getBitrate</refname>
<refpurpose>Returns the bitrate of the MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_MPEG_AudioProperties::getBitrate</methodname>
<void />
</methodsynopsis>
<para>
Returns the bitrate of the MPEG file
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the bitrate as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.getChannels" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::getChannels</refname>
<refpurpose>Returns the amount of channels of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_MPEG_AudioProperties::getChannels</methodname>
<void />
</methodsynopsis>
<para>
Returns the amount of channels of the MPEG file
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the channel count as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.getLayer" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::getLayer</refname>
<refpurpose>Returns the layer of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_MPEG_AudioProperties::getLayer</methodname>
<void />
</methodsynopsis>
<para>
Returns the layer of the MPEG file (usually 3 for MP3).
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the layer as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.getLength" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::getLength</refname>
<refpurpose>Returns the length of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_MPEG_AudioProperties::getLength</methodname>
<void />
</methodsynopsis>
<para>
Returns the length of the MPEG file
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the length as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.getSampleBitrate" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::getSampleBitrate</refname>
<refpurpose>Returns the sample bitrate of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_MPEG_AudioProperties::getSampleBitrate</methodname>
<void />
</methodsynopsis>
<para>
Returns the sample bitrate of the MPEG file
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the sample bitrate as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.getVersion" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::getVersion</refname>
<refpurpose>Returns the version of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_MPEG_AudioProperties::getVersion</methodname>
<void />
</methodsynopsis>
<para>
Returns the version of the MPEG file header. The possible versions are
defined in Tag_MPEG_Header (Version1, Version2, Version2.5).
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the version
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.isCopyrighted" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::isCopyrighted</refname>
<refpurpose>Returns the length of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_MPEG_AudioProperties::isCopyrighted</methodname>
<void />
</methodsynopsis>
<para>
Returns true if the MPEG file is copyrighted
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true if the MPEG file is copyrighted
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.isOriginal" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::isOriginal</refname>
<refpurpose>Returns the length of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_MPEG_AudioProperties::isOriginal</methodname>
<void />
</methodsynopsis>
<para>
Returns true if the file is marked as the original file
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true if the file is marked as the original file
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="audioproperties.isProtectionEnabled" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_AudioProperties::isProtectionEnabled</refname>
<refpurpose>Returns the length of a MPEG file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_MPEG_AudioProperties::isProtectionEnabled</methodname>
<void />
</methodsynopsis>
<para>
Returns true if protection mechanism (like DRM) are enabled for this file
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true if protection mechanism (like DRM) are enabled for this file
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- Purpose: utilspec.audio -->
<!-- Membership: pecl -->
<book xml:id="book.ktaglib" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>KTaglib</title>
<preface xml:id="intro.ktaglib">
&reftitle.intro;
<para>
The module enables you to read and write ID3v1, ID3v2 and Ogg tags.
It is build using the taglib extension from the KDE project.
</para>
<note>
<para>
At the moment ktaglib is able to read and write ID3v1 and ID3v2 tags.
</para>
</note>
</preface>
&reference.ktaglib.setup;
&reference.ktaglib.constants;
&reference.ktaglib.mpegfile;
&reference.ktaglib.audioproperties;
&reference.ktaglib.tag;
&reference.ktaglib.id3v2tag;
&reference.ktaglib.id3v2frame;
&reference.ktaglib.id3v2attachedpictureframe;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,35 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<section xml:id="ktaglib.installation" xmlns="http://docbook.org/ns/docbook">
&reftitle.install;
<para>
KTaglib support in PHP is not enabled by default. You will need to
configure PHP <option role="configure">--with-ktaglib[=DIR]</option>
</para>
<note>
<simpara>
KTaglib is part of PECL.
</simpara>
</note>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,265 @@
<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.1 $ -->
<appendix xml:id="ktaglib.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<para>
KTaglib uses class constants. Most of the constants are mappings to the according
Taglib enums and constants.
</para>
<variablelist>
<varlistentry>
<term><constant>KTaglib_MPEG_Header::Version1</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
ID3 version is 1.0
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_MPEG_Header::Version2</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
ID3 version is 2.0
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_MPEG_Header::Version2_5</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
ID3 version is 2.5
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Other</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Other
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::FileIcon</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type FileIcon
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::OtherFileIcon</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type OtherFileIcon
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::FrontCover</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type FrontCover
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::BackCover</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type BackCover
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::LeafletPage</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type LeafletPage
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Media</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Media
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::LeadArtist</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type LeadArtist
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Artist</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Artist
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Conductor</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Condutor
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Band</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Band
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Composer</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Composer
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Lyricist</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Lyricist
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::RecordingLocation</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type RecordingLocation
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::DuringRecording</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type DuringRecording
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::DuringPerformance</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type DuringPerformance
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::MovieScreenCapture</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type MovieScreenCapture
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::ColouredFish</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type ColouredFish
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::Illustration</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type Illustration
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>KTaglib_ID3v2_AttachedPictureFrame::BandLogo</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Picture type BandLogo
</simpara>
</listitem>
</varlistentry>
</variablelist>
</appendix>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,47 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<chapter xml:id="ktaglib.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
<para>
The example read an ID3v2 tag from an MP3 and saves it's attached
cover.
</para>
<example>
<title>Small Taglib Example</title>
<programlisting role="php">
<![CDATA[
<?php
$ktaglib = new KTaglib_MPEG_File('example.mp3');
$frames = $ktaglib->getID3v2Tag()->getFrameList();
if (isset($frames['APIC'])) {
$frames['APIC']->savePicture('example.png');
} else {
die("No picture frame");
}
?>
]]>
</programlisting>
</example>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,60 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="class.id3v2attachedpictureframe" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The KTaglib_ID3v2_AttachedPictureFrame class</title>
<titleabbrev>KTaglib_ID3v2_AttachedPictureFrame</titleabbrev>
<partintro>
<!-- {{{ ClassName intro -->
<section xml:id="id3v2attachedpictureframe.intro">
&reftitle.intro;
<para>
Represents an ID3v2 frame that can hold a picture.
</para>
</section>
<!-- }}} -->
<section xml:id="id3v2attachedpictureframe.synopsis">
<title>Class synopsis</title>
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>KTaglib_ID3v2_AttachedPictureFrame</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<modifier>extends</modifier>
<classname>KTagLib_ID3v2_Frame</classname>
</ooclass>
</classsynopsisinfo>
</classsynopsis>
</section>
</partintro>
&reference.ktaglib.entities.id3v2attachedpictureframe;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.getDescription" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::getDescription</refname>
<refpurpose>Returns a description for the picture in a picture frame</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::getDescription</methodname>
<void/>
</methodsynopsis>
<para>
Returns the attached description for a picture frame in an ID3v2.x frame.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a description for the picture in a picture frame
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,58 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.getMimeType" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::getMimeType</refname>
<refpurpose>Returns the mime type of the picture</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::getMimeType</methodname>
<void/>
</methodsynopsis>
<para>
Returns the mime type of the image represented by the attached picture frame.
</para>
<para>
Please notice that this method might return different types. While ID3v2.2
have a mime type that doesn't start with "image/", ID3v2.3 and v2.4 usually
start with "image/". Therefore the method might return "image/png" for IDv2.3 frames
and just "PNG" for ID3v2.2 frames.
</para>
<para>
Notice that even the frame is an attached picture, the mime type might not be set
and therefore an empty string might be returned.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the mime type of the image represented by the attached picture frame.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,51 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.getType" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::getType</refname>
<refpurpose>Returns the type of the image</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::getType</methodname>
<void/>
</methodsynopsis>
<para>
Returns the type of the image.
</para>
<para>
The ID3v2 specification allows an AttachedPictureFrame to set the type of an image. This can be e.g. FrontCover or FileIcon. Please refer to the KTagLib_ID3v2_AttachedPictureFrame class description for a list of available types.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the integer representation of the type.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.savePicture" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::savePicture</refname>
<refpurpose>Saves the picture to a file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::savePicture</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Saves the attached picture to the given filename.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true on success, otherwise false
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,42 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.setMimeType" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::setMimeType</refname>
<refpurpose>Set's the mime type of the picture</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>void</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::getMimeType</methodname>
<methodparam><type>string</type><parameter>type</parameter></methodparam>
</methodsynopsis>
<para>
Sets the mime type of the image. This should in most cases be "image/png" or "image/jpeg".
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,51 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.setPicture" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::setPicture</refname>
<refpurpose>Sets the frame picture to the given image</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::setPicture</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Sets the picture to the give image. The image is loaded from the given filename.
Please note that the picture is not saved unless you call the save method of the
corresponding file object.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true on success, otherwise false
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,42 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2attachedpictureframe.setType" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_AttachedPictureFrame::setType</refname>
<refpurpose>Set the type of the image</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>void</type>
<methodname>KTaglib_ID3v2_AttachedPictureFrame::setType</methodname>
<methodparam><type>integer</type><parameter>type</parameter></methodparam>
</methodsynopsis>
<para>
Sets the type of the image. This can be e.g. FrontCover or FileIcon. Please refer to the KTaglib_ID3v2_AttachedPictureFrame class description for a list of available types and their constant mappings.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,61 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="class.id3v2frame" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The KTagLib_ID3v2_Frame class</title>
<titleabbrev>KTaglib_ID3v2_Frame</titleabbrev>
<partintro>
<!-- {{{ ClassName intro -->
<section xml:id="id3v2frame.intro">
&reftitle.intro;
<para>
The base class for ID3v2 frames. ID3v2 tags are separated in various
specialized frames. Some frames can exists multiple times.
</para>
</section>
<!-- }}} -->
<section xml:id="id3v2frame.synopsis">
<title>Class synopsis</title>
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>KTagLib_ID3v2_Frame</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<modifier>extends</modifier>
<classname>KTagLib_Tag</classname>
</ooclass>
</classsynopsisinfo>
</classsynopsis>
</section>
<!-- }}} -->
</partintro>
&reference.ktaglib.entities.id3v2frame;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2frame.getSize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_Frame::getSize</refname>
<refpurpose>Returns the size of the frame in bytes</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_ID3v2_Frame::getSize</methodname>
<void/>
</methodsynopsis>
<para>
Returns the size of the frame in bytes. Please refer to id3.org to see what
ID3v2 frames are and how they are defined.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the size of the frame in bytes
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2frame.toString" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_Frame::__toString</refname>
<refpurpose>Returns a string representation of the frame</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_ID3v2_Frame::__toString</methodname>
<void />
</methodsynopsis>
<para>
Returns a string representation of the frame. This might be just the
frame id, but might contain more information. Please see the ktaglib
documentation for more information
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns a string representation of the frame.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,61 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="class.id3v2tag" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The KTagLib_ID3v2_Tag class</title>
<titleabbrev>KTaglib_ID3v2_Tag </titleabbrev>
<partintro>
<!-- {{{ ClassName intro -->
<section xml:id="id3v2tag.intro">
&reftitle.intro;
<para>
Represents and ID3v2 tag. It provides a list of ID3v2 frames and can be uesd
to add and remove additional frames.
</para>
</section>
<!-- }}} -->
<section xml:id="id3v2tag.synopsis">
<title>Class synopsis</title>
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>KTagLib_ID3v2_Tag</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<modifier>extends</modifier>
<classname>KTagLib_Tag</classname>
</ooclass>
</classsynopsisinfo>
</classsynopsis>
</section>
<!-- }}} -->
</partintro>
&reference.ktaglib.entities.id3v2tag;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,48 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2tag.addFrame" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_Tag::addFrame</refname>
<refpurpose>Add a frame to the ID3v2 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_ID3v2_Tag::addFrame</methodname>
<void/>
</methodsynopsis>
<para>
Adds a frame to the ID3v2 tag. The frame must be a valid KTagLib_ID3v2_Frame object.
To save the tag, the save function needs to be invoked.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true on success, otherwise false.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,47 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="id3v2tag.getFrameList" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_ID3v2_Tag::getFrameList</refname>
<refpurpose>Returns an array of ID3v2 frames, associated with the ID3v2 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_ID3v2_Tag::getFrameList</methodname>
<void/>
</methodsynopsis>
<para>
Returns an array of ID3v2 frames, associated with the ID3v2 tag.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Return an array of KTaglib_ID3v2_Frame objects
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,59 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="class.mpegfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The KTagLib_MPEG_File class</title>
<titleabbrev>KTaglib_MPEG_File</titleabbrev>
<partintro>
<!-- {{{ ClassName intro -->
<section xml:id="mpegfile.intro">
&reftitle.intro;
<para>
Represents an MPEG file. MPEG files can have ID3v1, ID3v2 tags and audio properties.
</para>
</section>
<!-- }}} -->
<section xml:id="mpegfile.synopsis">
<title>Class synopsis</title>
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>KTagLib_MPEG_File</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>KTagLib_MPEG_File</classname>
</ooclass>
</classsynopsisinfo>
</classsynopsis>
</section>
<!-- }}} -->
</partintro>
&reference.ktaglib.entities.mpegfile;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,72 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="mpegfile.construct" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_File::__construct</refname>
<refpurpose>Opens a new file</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<constructorsynopsis>
<methodname>KTaglib_MPEG_File::__construct</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</constructorsynopsis>
<para>
Opens a new MPEG file.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>filename</parameter></term>
<listitem>
<para>
The file to read
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Opens a new MP3 file and read the title</title>
<programlisting role="php">
<![CDATA[
<?php
$mpeg = new KTaglib_MPEG_File('example.mp3');
echo $mpeg->getID3v1Tag()->getTitle();
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="mpegfile.getAudioProperties" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_File::getAudioProperties</refname>
<refpurpose>Returns an object that provides access to the audio properties</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>KTaglib_MPEG_File:</type>
<methodname>KTaglib_MPEG_File::getAudioProperties</methodname>
<void/>
</methodsynopsis>
<para>
Returns an object that provides access to the audio properties of
the mpeg file.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an KTaglib_MPEG_AudioProperties object or false.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="mpegfile.getID3v1Tag" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_File::getID3v1Tag</refname>
<refpurpose>Returns an object representing an ID3v1 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>KTaglib_ID3v1_Tag</type>
<methodname>KTaglib_MPEG_File::getID3v1Tag</methodname>
<void/>
</methodsynopsis>
<para>
Returns an object that represents an ID3v1 tag, which can be used
to get information about the ID3v1 tag.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns an KTaglib_MPEG_ID3v1Tag object or false if there is no ID3v1 tag.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="mpegfile.getId3v2Tag" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_MPEG_File::getID3v2Tag</refname>
<refpurpose>Returns a ID3v2 object</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>KTaglib_ID3v2_Tag</type>
<methodname>KTaglib_MPEG_File::getID3v2Tag</methodname>
<void />
</methodsynopsis>
<para>
Returns a ID3v2 object for the mpeg file. If no ID3v2 Tag is present, an
KTaglib_TagNotFoundException is thrown.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the KTaglib_ID3v2_Tag object of the MPEG file or false if there is
no ID3v2 tag
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,39 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<chapter xml:id="ktaglib.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="ktaglib.requirements">
&reftitle.required;
&no.requirement;
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.ktaglib.configure;
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

59
reference/ktaglib/tag.xml Normal file
View file

@ -0,0 +1,59 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 1.1 $ -->
<reference xml:id="class.tag" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The KTaglib_Tag class</title>
<titleabbrev>KTaglib_Tag</titleabbrev>
<partintro>
<!-- {{{ ClassName intro -->
<section xml:id="tag.intro">
&reftitle.intro;
<para>
Base class for ID3v1 or ID3v2 tags
</para>
</section>
<!-- }}} -->
<section xml:id="tag.synopsis">
<title>Class synopsis</title>
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>KTaglib_Tag</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>KTaglib_Tag</classname>
</ooclass>
</classsynopsisinfo>
</classsynopsis>
</section>
<!-- }}} -->
</partintro>
&reference.ktaglib.entities.tag;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getAlbum" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getAlbum</refname>
<refpurpose>Returns the title string from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_Tag::getAlbum</methodname>
<void />
</methodsynopsis>
<para>
Returns the album string of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the album string
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getArtist" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getArtist</refname>
<refpurpose>Returns the artist string from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_Tag::getArtist</methodname>
<void />
</methodsynopsis>
<para>
Returns the artist string of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the artist string
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getComment" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getComment</refname>
<refpurpose>Returns the comment from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_Tag::getComment</methodname>
<void />
</methodsynopsis>
<para>
Returns the comment of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the comment string
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getGenre" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getGenre</refname>
<refpurpose>Returns the genre from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_Tag::getGenre</methodname>
<void />
</methodsynopsis>
<para>
Returns the genre of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the genre string
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getTitle" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getTitle</refname>
<refpurpose>Returns the title string from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>string</type>
<methodname>KTaglib_Tag::getTitle</methodname>
<void />
</methodsynopsis>
<para>
Returns the title string of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the title string
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getTrack" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getTrack</refname>
<refpurpose>Returns the track number from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_Tag::getTrack</methodname>
<void />
</methodsynopsis>
<para>
Returns the track number of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the track number as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.getYear" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::getYear</refname>
<refpurpose>Returns the year from a ID3 tag</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>integer</type>
<methodname>KTaglib_Tag::getYear</methodname>
<void />
</methodsynopsis>
<para>
Returns the year of an ID3 tag. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns the year as an integer
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

View file

@ -0,0 +1,49 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<refentry xml:id="tag.isEmpty" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>KTaglib_Tag::isEmpty</refname>
<refpurpose>Returns true if the tag is empty</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier>public</modifier>
<type>boolean</type>
<methodname>KTaglib_Tag::isEmpty</methodname>
<void/>
</methodsynopsis>
<para>
Returns true if the tag exists, but is empty. This method is implemented
in ID3v1 and ID3v2 tags.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Returns true if the tag is empty, otherwise false.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->