×
Namespaces

Variants
Actions
(Difference between revisions)

HERE Maps API - Utility class Vector3D

From Nokia Developer Wiki
Jump to: navigation, search
jasfox (Talk | contribs)
m (Jasfox - Corrected Category)
Oskar Bukolt (Talk | contribs)
m (Oskar Bukolt - Update JS Lib + API Link)
Line 3: Line 3:
 
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 
|sourcecode= <!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
 
|installfile= <!-- Link to installation file (e.g. [[Media:The Installation File.sis]]) -->
|devices= Opera 5.0.5, Firefox 5.0
+
|devices= Firefox 12.0
 
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
 
|sdk= <!-- SDK(s) built and tested against (e.g. [http://linktosdkdownload/ Nokia Qt SDK 1.1]) -->
 
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 
|platform= <!-- Compatible platforms - e.g. Symbian^1 and later, Qt 4.6 and later -->
 
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
 
|devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) -->
|dependencies=Nokia Maps 2.1.0
+
|dependencies=Nokia Maps 2.2.1
 
|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 
|signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer -->
 
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
 
|capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. -->
Line 23: Line 23:
 
|author=[[User:Maveric]]
 
|author=[[User:Maveric]]
 
}}
 
}}
 
+
{{SeeAlso|
 +
*  [http://api.maps.nokia.com/en/maps/intro.html Nokia Maps API]
 +
}}
  
 
{{Abstract|This article explains how to use the Vector3D utility class.}}  
 
{{Abstract|This article explains how to use the Vector3D utility class.}}  
Line 31: Line 33:
 
This is a class representing a three dimensional vector. Full description is here:
 
This is a class representing a three dimensional vector. Full description is here:
  
http://api.maps.nokia.com/2.1.0/apireference/symbols/nokia.maps.util.Vector3D.html
+
http://api.maps.nokia.com/2.2.1/apireference/symbols/nokia.maps.util.Vector3D.html
  
 
== Usage examples ==
 
== Usage examples ==
Line 111: Line 113:
 
== Tested with ==
 
== Tested with ==
  
* Opera 5.0.5
+
* Firefox 12.0
 
+
* Firefox 5.0
+

Revision as of 12:11, 12 July 2012

Article Metadata
Tested with
Devices(s): Firefox 12.0
Dependencies: Nokia Maps 2.2.1
Article
Created: Maveric (28 Jun 2011)
Last edited: Oskar Bukolt (12 Jul 2012)
See Also

This article explains how to use the Vector3D utility class.

Introduction

This is a class representing a three dimensional vector. Full description is here:

http://api.maps.nokia.com/2.2.1/apireference/symbols/nokia.maps.util.Vector3D.html

Usage examples

Let's create a new Vector3D object:

>>> myVector = new nokia.maps.util.Vector3D (10, 10, 10) ;

This would return and object containing:

Object { x=10, y=10, z=10}


The "add(other)" method would create a sum of this vector and the added one.

We will create two Vector3D's and then create the third based on adding the 2nd to the 1st Vector3D.

>> myVector1 = new nokia.maps.util.Vector3D (10, 10, 10) ;
>> myVector2 = new nokia.maps.util.Vector3D (20, 20, 20) ;
>> myVector3 = myVector1.add(myVector2);

We would now have myVector3 to contain:

Object { x=30, y=30, z=30 }

With the method "angle" we can request, as the name says the relative angle: angle ([px, [py, [intertX, [intertY]]]]) : Number

Example on requesting angle for the myVector3:

>>> myVector3.angle();

Would return us a numeric value as follows:

45.00000000000001

And let's try one more operation with the "subtract" method. With it we can get the difference between two vectors:

>>> subtracted = myVector3.subtract(myVector1);

Would return us:

Object { x=20, y=20, z=20}

Feel free to try the other methods too, used in a similar manner.

Description of the angle method:

angle ([px, [py, [intertX, [intertY]]]]) : Number
Returns the angle of this vector in decimal degree to the given point within a
coordinate system that goes possitive to top/right.
 
For screen coordinates the Y-axis shall be inverted. For a normalized vector
the method can be called without parameters to return it's normalized angle.
 
Parameters:
{Number} [px]: The x-coordinate of the point to which the angle shall be calculated, if not given zero is used.
{Number} [py]: The y-coordinate of the point to which the angle shall be calculated, if not given zero is used.
{Boolean} [intertX]: If given and true, the x-axis is inverted, therefore the coordinates are increasing to the left and decreasing to the right.
{Boolean} [intertY]: If given and true, the y-axis is inverted, therefore the coordinates are increasing to the bottom and decreasing to the top.
 
Returns:
{Number} The angle of this vector in degree, relative to the given coordinate.

Tested with

  • Firefox 12.0
148 page views in the last 30 days.
×