[tracker] Doc: First draft of NMM doc. Images and Radio.

[Ivan Frade <ifrade src gnome org>]

commit 00088d6a36ccc1ae34f1fbec6b7a2b30b0251f28
Author: Ivan Frade <ivan frade nokia com>
Date:   Thu Nov 26 16:43:40 2009 +0200

    Doc: First draft of NMM doc. Images and Radio.

 docs/ontologies/nmm/explanation.html    |   38 +++++++++++++++++++++++++++++++
 docs/ontologies/nmm/images-overview.dia |  Bin 0 -> 5152 bytes
 docs/ontologies/nmm/radio-overview.dia  |  Bin 0 -> 3564 bytes
 3 files changed, 38 insertions(+), 0 deletions(-)
---
diff --git a/docs/ontologies/nmm/explanation.html b/docs/ontologies/nmm/explanation.html
new file mode 100644
index 0000000..39811a1
--- /dev/null
+++ b/docs/ontologies/nmm/explanation.html
@@ -0,0 +1,38 @@
+<h2>Introduction</h2>
+
+<p>This ontology extends NIE (Nepomuk Information Element ontology) and NFO (Nepomuk File Ontology) into the domains of multimedia, including Images, Videos, Music and Radio, and includes a couple of properties to support uPnP sharing.</p>
+
+<p>This ontology replaces/complements NID3 and NEXIF. Those ontologies are a direct map of the respective metadata standards, which makes very difficult to map cleanly other standards (like gstreamer metadata, mp4, ogg, and so on). Besides, those ontologies contain a lot of very low level technical information that is useless to the average user of the desktop.</p>
+
+<p>Our approach in NMM is to keep the minimum properties that make sense for the user, and are present in all (or almost all) specific metadata formats. A profesional photographer (or musician) who needs more fine-grained details for its documents, is free to add also nID3 information or other extensions to the ontology.</p>
+
+
+<h2>Images domain</h2>
+
+<p>The core of images in NMM ontology is the class <a href="#Photo.">nmm:Photo.</a> It is (through a long hierarchy) a <a href="../nie/index.html#InformationElement">nie:InformationElement</a>, an interpretation of some bytes. It has properties to store the basic information (camera, metering mode, white balance, flash), and inherits from <a href="../nfo/index.html#Image">nfo:Image</a> orientation (<a href="../nfo/index.html#orientation">nfo:orientation</a>) and resolution (<a href="../nfo/index.html#verticalResolution">nfo:verticalResolution</a> and <a href="../nfo/index.html#horizontalResolution">nfo:horizontalResolution</a>).</p>
+
+<p>Note that for tags, nie:keywords (from nie:InformationElement) can be used, or the <a href="../nao/index.html"/>NAO ontology.</p>
+
+<h3>Graphical Overview (images domain)</h3>
+<img src="./images-overview.png"/><br/>
+<small>Notation defined <a href="../index.html#Notation">in this page</a></small>
+
+<h2>Music domain</h2>
+
+<!-- Dont forget to mention the wa... uPnP -->
+
+<h3>Graphical Overview (music domain)</h3>
+<img src="./music-overview.png"/><br/>
+<small>Notation defined <a href="../index.html#Notation">in this page</a></small>
+
+
+
+<h2>Radio domain</h2>
+<p>NMM includes classes and properties to represent analog and digital radio stations. There is a class <a href="#RadioStation">nmm:RadioStation</a> on the <a href="../nie/index.html#InformationElement">nie:InformationElement</a> side of the ontology, representing what the user sees about that station (genre via PTY codes, icon, plus title inherited from nie:InformationElement)</p>
+<p>A <a href="#RadioStation">nmm:RadioStation</a> can have one or more <a href="#carrier">nmm:carrier</a> properties representing the different frequencies (or links when it is digitial) it can be tuned. This property links the station with <a href="../nfo/index.html#MediaStream">nfo:MediaStream</a>, but usually it will point to one of the subclasses: <a href="#DigitalRadio">nmm:DigitalRadio</a> (if digital) or <a href="#AnalogRadio">nmm:AnalogRadio</a> (if analog). An analog station has properties as modulation and frequency, while the digial station has streaming bitrate, encoding or protocol.</p>
+<p>Note that nfo:MediaStream refers to a flux of bytes/data, and it is on the <a href="../nie/index.html#DataObject">nie:DataObject</a> side of the ontology</p>
+
+<h3>Graphical Overview (radio domain)</h3>
+<img src="./radio-overview.png"/><br/>
+<small>Notation defined <a href="../index.html#Notation">in this page</a></small>
+
diff --git a/docs/ontologies/nmm/images-overview.dia b/docs/ontologies/nmm/images-overview.dia
new file mode 100644
index 0000000..049e1bc
Binary files /dev/null and b/docs/ontologies/nmm/images-overview.dia differ
diff --git a/docs/ontologies/nmm/radio-overview.dia b/docs/ontologies/nmm/radio-overview.dia
new file mode 100644
index 0000000..1b1a047
Binary files /dev/null and b/docs/ontologies/nmm/radio-overview.dia differ