HERE Maps API - Utility class Vector3D
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= | + | |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. | + | |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. | + | 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 == | ||
| − | + | * Firefox 12.0 | |
| − | + | ||
| − | * Firefox | + | |
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.00000000000001And 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
