summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorZheng Liu (George) <zheng.g.liu@nokia.com>2012-02-02 13:34:15 +1000
committerSarah Jane Smith <sarah.j.smith@nokia.com>2012-02-08 09:06:54 +0100
commitf6d44c391d17521d95c60de16615e47f66968b62 (patch)
treec5c8a857f16587c19bb236682dcb7f8bc28e8c02
parentbfe05a3711f301cb963592b4570c71a50d69b76a (diff)
Created documentation of Asset Viewer
Change-Id: Ib0fa29397d1b353bc330fbbfa7745ff408e8139a Reviewed-by: Danny Pope <daniel.pope@nokia.com> Reviewed-by: Sarah Jane Smith <sarah.j.smith@nokia.com>
-rw-r--r--util/qt3d/assetviewer/qml/AssetViewer.qml5
-rw-r--r--util/qt3d/assetviewer/qml/ButtonBarPane.qml2
-rw-r--r--util/qt3d/assetviewer/qml/HelpOverlay.qml56
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer.html498
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/Image.pngbin0 -> 11029 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/changevalue.pngbin0 -> 638 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/complexcolor.pngbin0 -> 157442 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/image001.pngbin0 -> 64009 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/interface.pngbin0 -> 107932 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/maximize.pngbin0 -> 326 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/menubar.pngbin0 -> 4431 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/modified.pngbin0 -> 143123 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/origional.pngbin0 -> 300000 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/propertypane.pngbin0 -> 13139 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/result.pngbin0 -> 90662 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/simplecolor.pngbin0 -> 145959 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/statusbar.pngbin0 -> 4435 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/viewport.pngbin0 -> 38631 bytes
-rw-r--r--util/qt3d/assetviewer/qml/assetviewer_files/zoom.pngbin0 -> 454 bytes
19 files changed, 499 insertions, 62 deletions
diff --git a/util/qt3d/assetviewer/qml/AssetViewer.qml b/util/qt3d/assetviewer/qml/AssetViewer.qml
index af5b4b961..150666ba4 100644
--- a/util/qt3d/assetviewer/qml/AssetViewer.qml
+++ b/util/qt3d/assetviewer/qml/AssetViewer.qml
@@ -258,11 +258,6 @@ Rectangle {
visible: false
}
- HelpOverlay {
- id: helpOverlay
- visible: false
- }
-
states: [
State {
name: "3Views"
diff --git a/util/qt3d/assetviewer/qml/ButtonBarPane.qml b/util/qt3d/assetviewer/qml/ButtonBarPane.qml
index bd85d5c8e..dd37c0f9c 100644
--- a/util/qt3d/assetviewer/qml/ButtonBarPane.qml
+++ b/util/qt3d/assetviewer/qml/ButtonBarPane.qml
@@ -44,7 +44,7 @@ Flow {
BlenderToggle {
id: help
width: buttonWidth
- onClicked: helpOverlay.visible = true
+ onClicked: Qt.openUrlExternally("assetviewer.html");
buttonText: "Help!"
imageSrc: "images/help.png"
}
diff --git a/util/qt3d/assetviewer/qml/HelpOverlay.qml b/util/qt3d/assetviewer/qml/HelpOverlay.qml
deleted file mode 100644
index 7b233e6f9..000000000
--- a/util/qt3d/assetviewer/qml/HelpOverlay.qml
+++ /dev/null
@@ -1,56 +0,0 @@
-import QtQuick 1.0
-import Qt3D 1.0
-import AssetViewer 1.0
-
-Rectangle {
- anchors.fill: parent
- color: "#00000000"
-
- Rectangle {
- id: helpScreen
- width: parent.width/2
- height: parent.height/2
- anchors.horizontalCenter: parent.horizontalCenter
- anchors.verticalCenter: parent.verticalCenter
-
- border.width: 4
- radius: 4
- color: "lightyellow"
-
- Text {
- id: header
- font { pixelSize: 32; italic: true }
- text: "3D Asset Viewer Help"
- anchors.top: parent.top
- anchors.topMargin: 16
- anchors.horizontalCenter: parent.horizontalCenter
- }
- Text {
- anchors.top: header.bottom
- anchors.topMargin: 16
- anchors.left: parent.left
- anchors.leftMargin: 16
- anchors.right: parent.right
- anchors.rightMargin: 16
- textFormat: Text.RichText
- wrapMode: Text.WordWrap
- text: "Altering model parameters with the mouse:" +
- "<ul><li>Clicking on one of the panes with the <b>Left Mouse Button</b> and dragging will translate the position.</li>" +
- "<li>Clicking on one of the panes with the <b>Right Mouse Button</b> and dragging will rotate the position.</li>" +
- "<li>Clicking on one of the panes with the <b>Middle Mouse Button</b> and dragging will resize the model."
- }
-
- Text {
- anchors.bottom: parent.bottom
- anchors.bottomMargin: 16
- anchors.horizontalCenter: parent.horizontalCenter
- text: "[ Click to Close ]"
- }
- }
- MouseArea {
- anchors.fill: parent
- acceptedButtons: Qt.LeftButton | Qt.RightButton | Qt.MiddleButton
- onClicked: parent.visible = false
- }
-}
-
diff --git a/util/qt3d/assetviewer/qml/assetviewer.html b/util/qt3d/assetviewer/qml/assetviewer.html
new file mode 100644
index 000000000..412997c16
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer.html
@@ -0,0 +1,498 @@
+<html>
+
+<head>
+<meta http-equiv=Content-Type content="text/html; charset=gb2312">
+<meta name=Generator content="Microsoft Word 14 (filtered)">
+<style>
+<!--
+ /* Font Definitions */
+ @font-face
+ {font-family:ËÎÌå;
+ panose-1:2 1 6 0 3 1 1 1 1 1;}
+@font-face
+ {font-family:ËÎÌå;
+ panose-1:2 1 6 0 3 1 1 1 1 1;}
+@font-face
+ {font-family:Cambria;
+ panose-1:2 4 5 3 5 4 6 3 2 4;}
+@font-face
+ {font-family:Calibri;
+ panose-1:2 15 5 2 2 2 4 3 2 4;}
+@font-face
+ {font-family:Tahoma;
+ panose-1:2 11 6 4 3 5 4 4 2 4;}
+@font-face
+ {font-family:"\@ËÎÌå";
+ panose-1:2 1 6 0 3 1 1 1 1 1;}
+ /* Style Definitions */
+ p.MsoNormal, li.MsoNormal, div.MsoNormal
+ {margin-top:0in;
+ margin-right:0in;
+ margin-bottom:10.0pt;
+ margin-left:0in;
+ line-height:115%;
+ font-size:11.0pt;
+ font-family:"Calibri","sans-serif";}
+h2
+ {mso-style-link:"Heading 2 Char";
+ margin-top:10.0pt;
+ margin-right:0in;
+ margin-bottom:0in;
+ margin-left:0in;
+ margin-bottom:.0001pt;
+ page-break-after:avoid;
+ font-size:13.0pt;
+ font-family:"Cambria","serif";
+ color:#4F81BD;}
+p.MsoTitle, li.MsoTitle, div.MsoTitle
+ {mso-style-link:"Title Char";
+ margin-top:0in;
+ margin-right:0in;
+ margin-bottom:15.0pt;
+ margin-left:0in;
+ border:none;
+ padding:0in;
+ font-size:26.0pt;
+ font-family:"Cambria","serif";
+ color:#17365D;
+ letter-spacing:.25pt;}
+p.MsoTitleCxSpFirst, li.MsoTitleCxSpFirst, div.MsoTitleCxSpFirst
+ {mso-style-link:"Title Char";
+ margin:0in;
+ margin-bottom:.0001pt;
+ border:none;
+ padding:0in;
+ font-size:26.0pt;
+ font-family:"Cambria","serif";
+ color:#17365D;
+ letter-spacing:.25pt;}
+p.MsoTitleCxSpMiddle, li.MsoTitleCxSpMiddle, div.MsoTitleCxSpMiddle
+ {mso-style-link:"Title Char";
+ margin:0in;
+ margin-bottom:.0001pt;
+ border:none;
+ padding:0in;
+ font-size:26.0pt;
+ font-family:"Cambria","serif";
+ color:#17365D;
+ letter-spacing:.25pt;}
+p.MsoTitleCxSpLast, li.MsoTitleCxSpLast, div.MsoTitleCxSpLast
+ {mso-style-link:"Title Char";
+ margin-top:0in;
+ margin-right:0in;
+ margin-bottom:15.0pt;
+ margin-left:0in;
+ border:none;
+ padding:0in;
+ font-size:26.0pt;
+ font-family:"Cambria","serif";
+ color:#17365D;
+ letter-spacing:.25pt;}
+a:link, span.MsoHyperlink
+ {color:blue;
+ text-decoration:underline;}
+a:visited, span.MsoHyperlinkFollowed
+ {color:purple;
+ text-decoration:underline;}
+p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
+ {mso-style-link:"Balloon Text Char";
+ margin:0in;
+ margin-bottom:.0001pt;
+ font-size:8.0pt;
+ font-family:"Tahoma","sans-serif";}
+span.Heading2Char
+ {mso-style-name:"Heading 2 Char";
+ mso-style-link:"Heading 2";
+ font-family:"Cambria","serif";
+ color:#4F81BD;
+ font-weight:bold;}
+span.TitleChar
+ {mso-style-name:"Title Char";
+ mso-style-link:Title;
+ font-family:"Cambria","serif";
+ color:#17365D;
+ letter-spacing:.25pt;}
+span.BalloonTextChar
+ {mso-style-name:"Balloon Text Char";
+ mso-style-link:"Balloon Text";
+ font-family:"Tahoma","sans-serif";}
+.MsoPapDefault
+ {margin-bottom:10.0pt;
+ line-height:115%;}
+@page WordSection1
+ {size:8.5in 11.0in;
+ margin:.5in .5in .5in .5in;}
+div.WordSection1
+ {page:WordSection1;}
+-->
+</style>
+
+</head>
+
+<body lang=EN-US link=blue vlink=purple><center>
+<table width=500 boarder=0><tr><td>
+<div class=WordSection1>
+
+<div style='border:none;border-bottom:solid #4F81BD 1.0pt;padding:0in 0in 4.0pt 0in'>
+
+<p class=MsoTitle align=center style='text-align:center'><a name=3426>3D Asset
+Viewer</a></p>
+
+</div>
+
+<h2>Introduction</h2>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The 3D Asset Viewer is a tool which allows users to edit
+the basic properties of a 3D model, and wrap the resultant asset in a QML file,
+which can be used directly in 3D QML applications.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>It is possible for users to embed 3D models (such as .3ds
+or .obj files) in Qt Quick 3D applications directly. However, in most cases, the
+original scale,rotation, position, or material of the model may not meet the developer's
+requirements. The 3D Asset Viewer exists to remedy this problem, allowing the
+developer to modify a model's properties, and create QML object files for import
+directly into Qt Quick 3D applications.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<h2>How does it work?</h2>
+
+<p class=MsoNormal><span style='font-size:13.5pt;line-height:115%;font-family:
+"Tahoma","sans-serif";color:black'><br>
+<br>
+<span style='orphans: 2;text-align:-webkit-auto;widows: 2;-webkit-border-horizontal-spacing: 0px;
+-webkit-border-vertical-spacing: 0px;-webkit-text-decorations-in-effect: none;
+-webkit-text-size-adjust: auto;-webkit-text-stroke-width: 0px;word-spacing:
+0px'></span></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'><span style='orphans: 2;text-align:-webkit-auto;
+widows: 2;-webkit-border-horizontal-spacing: 0px;-webkit-border-vertical-spacing: 0px;
+-webkit-text-decorations-in-effect: none;-webkit-text-size-adjust: auto;
+-webkit-text-stroke-width: 0px;word-spacing:0px'>The 3D Asset Viewer
+creates a QML file based on the 3D model. The user can visually rotate, scale,
+and translate the model in 3D space, as well as changing the material colour and
+texture for the model. Once saved, the QML file can be used in other Qt3D programs
+as a standard element.</span></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'><br>
+<br>
+<span style='orphans: 2;text-align:-webkit-auto;widows: 2;-webkit-border-horizontal-spacing: 0px;
+-webkit-border-vertical-spacing: 0px;-webkit-text-decorations-in-effect: none;
+-webkit-text-size-adjust: auto;-webkit-text-stroke-width: 0px;word-spacing:
+0px'></span></p>
+
+</span>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'><span style='orphans: 2;text-align:-webkit-auto;
+widows: 2;-webkit-border-horizontal-spacing: 0px;-webkit-border-vertical-spacing: 0px;
+-webkit-text-decorations-in-effect: none;-webkit-text-size-adjust: auto;
+-webkit-text-stroke-width: 0px;word-spacing:0px'>A user may, for example, wish to use
+a 3D model of a car (specified in the file car.3ds) in their Qt Quick 3D application. The
+model specified in the .3ds file, however, is the wrong size, and the user would like to be
+able to change its colour. One option would be to edit the asset file directly using third
+party modeling software. This is a clumsy approach, however, as it does not then lend itself
+to easy modification within the QML application, and requires familiarity with (and access to),
+modeling applications. With 3D Asset Viewer, the user simply loads the asset file, then modifies the
+scale and material for the model. This is now saved as &quot;Car.qml&quot;. The user can now
+simple copy across the Car.qml file together with car.3ds file to their application
+directory, and use the &quot;Car&quot; asset in their QML script. The car will be displayed
+with the correct colour and size in the application.</span></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>Consider, for example, the figures shown below. In the instance
+of 3D Asset Viewer on the left a penguin model is shown as specified directly in the
+asset file. The version on the right, on the other hand, has been adjusted by the user.&nbsp;
+Essentially, the 3D Asset Viewer tool starts with a 3D model, makes some changes to its
+parameters, and outputs a QML asset that can be used in a 3D QML application.</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=320 height=248 src="assetviewer_files/origional.png"
+alt="Description: assetviewer_files\origional.png"></span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=320 height=248 src="assetviewer_files/modified.png"
+alt="Description: assetviewer_files\modified.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<h2>Using 3D Asset Viewer</h2>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The interface of the 3D Asset Viewer (shown in the figure
+below) consists of a number of main components: a menu bar, a status bar, and four
+panels (one viewport each for the x,y, and z axes, and a control panel).&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=685 height=531 src="assetviewer_files/interface.png"
+alt="Description: assetviewer_files\interface.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The menu bar on top has three buttons, for saving QML,
+loading and displaying a 3D asset file, and displaying this help page respectively:</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=585 height=15 src="assetviewer_files/menubar.png"
+alt="Description: assetviewer_files\menubar.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The status bar on the bottom tells user how to use the
+three mouse buttons to adjust the model.&nbsp;</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=610 height=24 src="assetviewer_files/statusbar.png"
+alt="Description: assetviewer_files\statusbar.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>Of the four panels, the bottom-left displays the properties
+of the 3D asset (rotation, scaling, translation, material, etc), and allows user to
+modify them by clicking or typing values. Specific usage of these is discussed later
+in this help document.</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=516 height=346 src="assetviewer_files/propertypane.png"
+alt="Description: assetviewer_files\propertypane.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The remaining panels st displays the &quot;Right&quot;, &quot;Front&quot;, and &quot;Top&quot;
+view of the 3D asset. These panels can be maximised by clicking on the&nbsp;</span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=19 height=19 src="assetviewer_files/maximize.png"
+alt="Description: assetviewer_files\maximize.png"></span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'>&nbsp;button
+on the top right corner, and reduced the the normal view by clicking on the button again.
+It is also possible to change the viewport scale by clicking on the&nbsp;</span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=19 height=36 src="assetviewer_files/zoom.png"
+alt="Description: assetviewer_files\zoom.png"></span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'>&nbsp;button
+on the top right to meet the specific scale needed by the user. Gridlines and measurements are
+provided for scale references in the viewports.</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=513 height=374 src="assetviewer_files/viewport.png"
+alt="Description: assetviewer_files\viewport.png"></span></p>
+
+<h2>&nbsp;</h2>
+
+<h2>&nbsp;</h2>
+
+<h2>Tutorial: create a qml model file and use it in a project</h2>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>1. Loading the Model</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The 3D Asset Viewer executable can be found in the /bin
+directory of the Qt3D directory. On start-up, the 3D Asset Viewer will automatically
+load a penguin model. By clicking on the menu button &quot;Load Asset&quot;, which
+is on the middle of the menu bar, a new asset file can be selected. After choosing
+a model file, the penguin will be replaced with the newly loaded model in the viewport
+panels.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>2. Translating, Rotating, Resizing</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>Now that the model is loaded, the mouse can be used to
+translate, rotate, or resize the object in the views. As indicated in the
+status bar, moving the mouse while holding left button will result in translation,
+holding the middle button will scale the object, and holding the right button will
+rotate the object. By performing this action on each specific viewport, it is possible
+to change the translation, rotation, and sizes of the object in all directions.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>Alternatively, the property pane can be used to change
+these parameters. By clicking on the +/- in the value capsules&nbsp;</span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=117 height=21 src="assetviewer_files/changevalue.png"
+alt="Description: assetviewer_files\changevalue.png"></span><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'>,
+the values can be changed. Likewise the numerical value can be edited direclty
+by clicking in the value field and typing in the desired value &nbsp;precisely.&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>3. Changing Effects</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The term "Effects" refers to the material, texture, and/or
+color of the object. One can change the effect applied to the object using the
+property pane. By default the effects are inherited from the 3D model. However,
+these values can easily be overwritten by un-checking the &quot;From Mesh&quot; box.
+The user is now free to assign simple color(RGBA color) or complex color(ambient, diffused,
+specular, plus&nbsp;shininess) to the object, and change the texture of the
+object by opening an image file.&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The figure below shows a ¡°monkeygod¡± model with simple and
+complex color assigned:</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=596 height=462 src="assetviewer_files/simplecolor.png"
+alt="Description: assetviewer_files\simplecolor.png"></span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=597 height=463 src="assetviewer_files/complexcolor.png"
+alt="Description: assetviewer_files\complexcolor.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>4. Saving as QML asset</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>When the asset is adjusted to meet the user's requirements,
+it can be saved as a QML asset file. Clicking the &quot;Save QML&quot; button on
+the menu bar, will prompt the user to specify a file name. Please note, the first
+letter of the file name must be capitalized, so that it can be used as an element in other
+QML files. For example, &quot;Penguin.qml&quot; is a valid file name, while &quot;penguin.qml&quot;
+is not.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>5. Using generated QML asset in your project</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>To use the QML asset in a 3D QML project, simply copy
+the QML asset into the directory where your QML file exists, together with all
+necessary resources, ie. model files, texture images etc. , and use it as
+a QML element in the application. For example, given an asset saved as
+&quot;Penguin.qml&quot;, the following code can be used to reference it:</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=413 height=391 id="Picture 13" src="assetviewer_files/image001.png"
+alt="Description: assetviewer_files\Image.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The result of this QML file is shown below:</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal align=center style='text-align:center'><span
+style='font-size:10.0pt;line-height:115%;font-family:"Tahoma","sans-serif"'><img
+width=680 height=545 src="assetviewer_files/result.png"
+alt="Description: assetviewer_files\result.png"></span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<h2>Further information</h2>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>In summary, the 3D asset viewer is a useful utility for
+Qt3D developers to wrap 3D models as 3D QML assets. It allows for modification of
+properties of the model in the asset, and makes using assets in other QML projects
+easy.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>The source code of this tool is shipped in Qt3D package,
+residing in &lt;Qt3D_dir&gt;/utils/Qt3D/AssetViewer/.</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>For more information about Qt3D, please visit </span><a
+href="http://doc.qt.nokia.com/"><span style='font-size:10.0pt;line-height:115%;
+font-family:"Tahoma","sans-serif"'>http://doc.qt.nokia.com</span></a></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal><span style='font-size:10.0pt;line-height:115%;font-family:
+"Tahoma","sans-serif"'>&nbsp;</span></p>
+
+<p class=MsoNormal>&nbsp;</p>
+
+</div>
+</td></tr></table>
+</center></body>
+
+</html>
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/Image.png b/util/qt3d/assetviewer/qml/assetviewer_files/Image.png
new file mode 100644
index 000000000..a863d7c8f
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/Image.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/changevalue.png b/util/qt3d/assetviewer/qml/assetviewer_files/changevalue.png
new file mode 100644
index 000000000..02e6be72d
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/changevalue.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/complexcolor.png b/util/qt3d/assetviewer/qml/assetviewer_files/complexcolor.png
new file mode 100644
index 000000000..135421520
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/complexcolor.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/image001.png b/util/qt3d/assetviewer/qml/assetviewer_files/image001.png
new file mode 100644
index 000000000..b53dc46e7
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/image001.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/interface.png b/util/qt3d/assetviewer/qml/assetviewer_files/interface.png
new file mode 100644
index 000000000..4ed0a1c13
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/interface.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/maximize.png b/util/qt3d/assetviewer/qml/assetviewer_files/maximize.png
new file mode 100644
index 000000000..78e633242
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/maximize.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/menubar.png b/util/qt3d/assetviewer/qml/assetviewer_files/menubar.png
new file mode 100644
index 000000000..d81b104d7
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/menubar.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/modified.png b/util/qt3d/assetviewer/qml/assetviewer_files/modified.png
new file mode 100644
index 000000000..5896199b5
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/modified.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/origional.png b/util/qt3d/assetviewer/qml/assetviewer_files/origional.png
new file mode 100644
index 000000000..b1382dfe7
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/origional.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/propertypane.png b/util/qt3d/assetviewer/qml/assetviewer_files/propertypane.png
new file mode 100644
index 000000000..6e698e88b
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/propertypane.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/result.png b/util/qt3d/assetviewer/qml/assetviewer_files/result.png
new file mode 100644
index 000000000..8f79b8f7d
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/result.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/simplecolor.png b/util/qt3d/assetviewer/qml/assetviewer_files/simplecolor.png
new file mode 100644
index 000000000..51ec1f79c
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/simplecolor.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/statusbar.png b/util/qt3d/assetviewer/qml/assetviewer_files/statusbar.png
new file mode 100644
index 000000000..895fda6f0
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/statusbar.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/viewport.png b/util/qt3d/assetviewer/qml/assetviewer_files/viewport.png
new file mode 100644
index 000000000..cc822be7c
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/viewport.png
Binary files differ
diff --git a/util/qt3d/assetviewer/qml/assetviewer_files/zoom.png b/util/qt3d/assetviewer/qml/assetviewer_files/zoom.png
new file mode 100644
index 000000000..49601d7f6
--- /dev/null
+++ b/util/qt3d/assetviewer/qml/assetviewer_files/zoom.png
Binary files differ