HERE Maps API - Utility class Vector3D
hamishwillee
(Talk | contribs) m (Hamishwillee - Automated change of category from Ovi Maps to Nokia Maps) |
hamishwillee
(Talk | contribs) m (Hamishwillee - Bot addition of Template:ArticleMetaData) |
||
| Line 1: | Line 1: | ||
| + | {{ArticleMetaData | ||
| + | |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]]) --> | ||
| + | |devices= <!-- Devices tested against - e.g. ''devices=Nokia 6131 NFC, Nokia C7-00'') --> | ||
| + | |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 --> | ||
| + | |devicecompatability= <!-- Compatible devices e.g.: All* (must have internal GPS) --> | ||
| + | |dependencies= <!-- Any other/external dependencies e.g.: Google Maps Api v1.0 --> | ||
| + | |signing=<!-- Signing requirements - empty or one of: Self-Signed, DevCert, Manufacturer --> | ||
| + | |capabilities= <!-- Capabilities required by the article/code example (e.g. Location, NetworkServices. --> | ||
| + | |keywords= <!-- APIs, classes and methods (e.g. QSystemScreenSaver, QList, CBase --> | ||
| + | |id= <!-- Article Id (Knowledge base articles only) --> | ||
| + | |language= <!-- Language category code for non-English topics - e.g. Lang-Chinese --> | ||
| + | |translated-by= <!-- [[User:XXXX]] --> | ||
| + | |translated-from-title= <!-- Title only --> | ||
| + | |translated-from-id= <!-- Id of translated revision --> | ||
| + | |review-by=<!-- After re-review: [[User:username]] --> | ||
| + | |review-timestamp= <!-- After re-review: YYYYMMDD --> | ||
| + | |update-by= <!-- After significant update: [[User:username]]--> | ||
| + | |update-timestamp= <!-- After significant update: YYYYMMDD --> | ||
| + | |creationdate=20110628 | ||
| + | |author=[[User:Maveric]] | ||
| + | }} | ||
| + | |||
[[Category:Web]][[Category:Browser]][[Category:Nokia Maps]] | [[Category:Web]][[Category:Browser]][[Category:Nokia Maps]] | ||
{{Abstract|This article explains how to use the Vector3D utility class.}} | {{Abstract|This article explains how to use the Vector3D utility class.}} | ||
Revision as of 02:57, 2 January 2012
Article Metadata
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.ovi.com/apireference/symbols/ovi.mapsapi.util.Vector3D.html
Usage examples
Let's create a new Vector3D object:
>>> myVector = new ovi.mapsapi.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 ovi.mapsapi.util.Vector3D (10, 10, 10) ;
>> myVector2 = new ovi.mapsapi.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
Windows XP Professional
Opera 5.0.5
Firefox 5.0
