Allow attaching 3D elements to the head in Face Tracking mode #23

Author: EddyVerbruggen

Diff for: docs/tag-properties.md

@@ -16,6 +16,7 @@ But to help add behavior to the AR experience, here are the properties and event
 |`debugLevel`|`NONE`|One of the options in the `ARDebugLevel` enum: `NONE`, `WORLD_ORIGIN`, `FEATURE_POINTS`, `PHYSICS_SHAPES`.
 |`detectPlanes`|`false`|You can have the plugin detecting planes right away by setting this to `true`.
 |`showStatistics`|`false`|Draw a few statistics at the bottom.
+|`faceMaterial`|-|A `string` referencing a texture for the face when `trackingMode  is `FACE`.  
 |`planeMaterial`|-|A `string` referencing a texture for the planes. For instance, the demo uses ['tron'](https://github.com/EddyVerbruggen/nativescript-ar/tree/master/demo/app/App_Resources/iOS/Assets.scnassets/Materials/tron). Can also be a `Color` or `ARMaterial` instance. You won't see the planes if not set.  
 |`planeOpacity`|`0.1`|Determines how transparent the planes are, where 0 is invisible, and 1 is 'solid'.
 
@@ -30,7 +31,7 @@ But to help add behavior to the AR experience, here are the properties and event
 |`planeTapped`|`ARPlaneTappedEventData`|Triggered when a plane was tapped by the user. Will return the x, y, and z coordinates in the 3D space.
 |`sceneTapped`|`ARSceneTappedEventData`|Triggered when a scene was tapped by the user. Will return the x and y screen coordinates.
 |`trackingImageDetected`|`ARTrackingImageDetectedEventData`|Only used when `trackingMode` is `IMAGE`. Triggered when one of the images in `trackingImagesBundle` was found. You can make the image interactive in various ways. Currently, I've added the ability to [play a video](https://github.com/EddyVerbruggen/nativescript-ar/blob/fe10b5afe0442df5a941c66568f0cedbd42124d6/demo/app/main-page.ts#L155-L160), [add a model]()https://github.com/EddyVerbruggen/nativescript-ar/blob/fe10b5afe0442df5a941c66568f0cedbd42124d6/demo/app/main-page.ts#L165-L189, or [add a box](https://github.com/EddyVerbruggen/nativescript-ar/blob/fe10b5afe0442df5a941c66568f0cedbd42124d6/demo/app/main-page.ts#L192-L224) at the exact spot the image was found. Please request more features, so I know what to build.
-|`trackingFaceDetected`|`ARTrackingFaceEventData`|Only used when `trackingMode` is `FACE`. Continuously triggered when a face is detected. Dump the returned `properties` property of the `ARTrackingFaceEventData` object to see what's returned. If you need more, let us know.
+|`trackingFaceDetected`|`ARTrackingFaceEventData`|Only used when `trackingMode` is `FACE`. Continuously triggered when a face is detected. Dump the returned `properties` property of the `ARTrackingFaceEventData` object to see what's returned. If you need more properties, let us know. There's also a `faceTrackingActions` which you can use to attach stuff like models and text to the face being tracked. See the demo for an example.
 
 ## Continue reading
 - [Tell me about the API](api.md)

Diff for: src/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nativescript-ar",
-  "version": "0.6.3",
+  "version": "0.7.0",
   "description": "NativeScript Augmented Reality plugin. ARKit on iOS and (in the future) ARCore on Android.",
   "main": "ar",
   "typings": "index.d.ts",