{"_id":"5a8356d8d3dc0f008636c6dc","category":{"_id":"5a8356d8d3dc0f008636c6d5","version":"5a8356d8d3dc0f008636c6d4","project":"5a065a6134873d0010b396ab","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-10-25T23:36:45.975Z","from_sync":false,"order":0,"slug":"basics","title":"Getting Started"},"user":"57bb7e47afc18c0e00529cf3","project":"5a065a6134873d0010b396ab","parentDoc":null,"version":{"_id":"5a8356d8d3dc0f008636c6d4","project":"5a065a6134873d0010b396ab","__v":1,"createdAt":"2018-02-13T21:21:28.228Z","releaseDate":"2018-02-13T21:21:28.228Z","categories":["5a8356d8d3dc0f008636c6d5","5a8356d8d3dc0f008636c6d6","5a8356d8d3dc0f008636c6d7","5a8356d8d3dc0f008636c6d8"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.3.0","version":"1.3.0"},"__v":0,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-11-16T00:32:47.911Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":3,"body":"#ViroCore v1.3\nNew release with some big new features!\n\n### New Features\n* Support for [Physically Based Rendering](doc:physically-based-rendering) (PBR)\n* New [metalness][1], [roughness][2], and [ambient occlusion][3] Material properties\n* [Image-based][4] diffuse and specular lighting\n* Lights can now be specified physically through [temperature][13] (Kelvins) and [intensity][12] (Lumens)\n* Textures and materials from loaded OBJ and FBX files can now be [dynamically changed][14]\n* Textures can now be [tiled over Surfaces][9]\n* [Screenshots][5] can be sent directly to an in-memory Bitmap\n* Exposed [projectPoint][6] and [unprojectPoint][7] methods on ViroView\n* API to [set the field of view][8] on the Camera\n* You can now [extract][11] raw point cloud data\n* New [renderer configurations][10] allow you to dynamically enable or disable shadows, HDR, Bloom, and PBR \n\n[1]:https://developer.viromedia.com/virocore/reference/com/viro/core/Material.html#setMetalnessMap(com.viro.core.Texture)\n[2]:https://developer.viromedia.com/virocore/reference/com/viro/core/Material.html#setRoughnessMap(com.viro.core.Texture)\n[3]:https://developer.viromedia.com/virocore/reference/com/viro/core/Material.html#setAmbientOcclusionMap(com.viro.core.Texture)\n[4]:https://virocore.viromedia.com/docs/physically-based-rendering#image-based-lighting\n[5]:https://developer.viromedia.com/virocore/reference/com/viro/core/ViroMediaRecorder.html\n[6]:https://developer.viromedia.com/virocore/reference/com/viro/core/ViroView.html#projectPoint(com.viro.core.Vector)\n[7]:https://developer.viromedia.com/virocore/reference/com/viro/core/ViroView.html#unprojectPoint(com.viro.core.Vector)\n[8]:https://developer.viromedia.com/virocore/reference/com/viro/core/Camera.html#setFieldOfView(float)\n[9]:https://developer.viromedia.com/virocore/reference/com/viro/core/Surface.html\n[10]:https://developer.viromedia.com/virocore/reference/com/viro/core/RendererConfiguration.html\n[11]:https://developer.viromedia.com/virocore/reference/com/viro/core/ARScene.html#setPointCloudUpdateListener(com.viro.core.PointCloudUpdateListener)\n[12]:https://developer.viromedia.com/virocore/reference/com/viro/core/Light.html#setIntensity(float)\n[13]:https://developer.viromedia.com/virocore/reference/com/viro/core/Light.html#setTemperature(float)\n[14]:https://developer.viromedia.com/virocore/reference/com/viro/core/Object3D.html#getMaterials()\n\n### Bug Fixes\n* Fixed: Framerate drop in AR scene with large 3D models.\n* Fixed: Weak global reference crash if device was idle for extended time\n* Fixed: Black screen on Mail-T720 GPU devices (i.e. A5 2016)\n* Fixed: Crash on invalid URIs\n* Fixed: various FBX keyframe and skeletal animation bugs\n\n### Breaking API Changes\n* Spotlight: the inner angle and outer angle of spotlights have changed! Now the inner angle represents the angle from edge to edge of the fully lit cone, and the outer angle represents the angle from edge to edge of the attenuated cone.\n\n* Field of view: For ViroSceneView, the default field of view is now 60 degrees across the major axis (which is the Y axis in portrait mode, and the X axis in landscape mode). The field of view can now be set, so you can change this if desired.\n\n* ViroMediaRecorder: The name of the listeners and the signatures of the listener methods have slightly changed to accommodate saving screenshots to Bitmaps. See the [Javadoc](https://developer.viromedia.com/virocore/reference/com/viro/core/ViroMediaRecorder.html) for details.\n\n### Upgrade instructions\nIf upgrading from ViroCore 1.1, first follow the instructions for ViroCore 1.2, then follow the instruction below.\n\nIf upgrading from ViroCore 1.2, simply download the new ViroCore AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_3_0/app-viro_core-release.aar), and use it to replace your existing ViroCore AAR file.\n\n#ViroCore v1.2\nA new release with the following features:\n- Support for ARCore Preview 2.\n- Added setCameraARHitTestListener to ViroViewARCore.\n- Enabled transparent backgrounds for ViroViewScene.\n- Enabled events for ViroSceneRenderer.\n\n### Upgrade instructions\n1. To use the latest ViroCore, download the new ViroCore AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/app-viro_core-release.aar), and use it to replace your existing ViroCore AAR file.\n\n2. Replace the build.gradle file in your arcore_client directory of your project with this [build.gradle](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/build.gradle).\n\n3. Add [core-0.91.0.aar](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/core-0.91.0.aar) to your arcore_client directory.\n\n4. Due to ARCore Preview 2 changes, you'll also need to download our new GVR library [here](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/sdk-common-1.101.0.aar), and replace your existing GVR SDK AAR (this should be in your project's gvr_common directory).\n\n5. **Do this step only if you are developing for ARCore**. Install Google's ARCore Preview 2 client on your device. Instructions from Google are [here](https://developers.google.com/ar/develop/java/getting-started) under 'Prepare your device'.\n\n\n\n6. Finally, add the following line to your app's build.gradle under defaultConfig in the android section:\n```\nndk {\n           abiFilters \"armeabi-v7a\", \"x86\", \"armeabi\", \"mips\"\n       }\n```\nYour new project should be good to go!\n\n#ViroCore v1.1\n\nA new release with a size reduction, updates to our underlying platforms, a handful of new features, and some bug fixes! \n\n### Updates\n\nThe ViroCore AAR file is now just 4.2 MB. \n\nVR underlying platform SDKs have been updated:\n- Updated Google VR (Android) to version 1.101\n- Updated Google VR (iOS) to version 1.100\n- Updated Oculus VR Mobile SDK to 1.9.0\n\nNew features:\n- Add AR shadows: virtual shadows on real-world planes via the new [ShadowMode](https://developer.viromedia.com/virocore/reference/com/viro/core/Material.ShadowMode.html) Material property\n- New [CameraListener](https://developer.viromedia.com/virocore/reference/com/viro/core/CameraListener.html) for responding to camera movement\n- Linear rendering (sRGB) support on Oculus VR, for more realistic shading and lighting\n- AnimationTransaction animations can now be looped\n\nFixed bugs:\n\n- Fixed bug with reticle scaling\n- Print out native exceptions to console\n- Fix issue with collision normals in physics system\n- Fix freezing issue when loading FBX models on Oculus VR\n\nAnd of course, numerous performance improvements.\n\n### Upgrade instructions\nTo use the latest ViroCore, download the new AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_1_0/app-viro_core-release.aar), and use it to replace your existing ViroCore AAR file.\n\nIf you are using GVR, you will also have to update your GVR SDK. To do this:\n\n1. Download the 1.101 GVR SDK AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_1_0/sdk-common-1.101.0.aar), and replace your existing GVR SDK AAR (this should be in your project's gvr_common directory).\n\n2. Open your project's GVR gradle file and set it to point to this new AAR file, as follows:\n```\nconfigurations.create(\"default\")\nartifacts.add(\"default\", file('sdk-common-1.101.0.aar'))\n```","excerpt":"","slug":"releases","type":"basic","title":"Releases"}
#ViroCore v1.3 New release with some big new features! ### New Features * Support for [Physically Based Rendering](doc:physically-based-rendering) (PBR) * New [metalness][1], [roughness][2], and [ambient occlusion][3] Material properties * [Image-based][4] diffuse and specular lighting * Lights can now be specified physically through [temperature][13] (Kelvins) and [intensity][12] (Lumens) * Textures and materials from loaded OBJ and FBX files can now be [dynamically changed][14] * Textures can now be [tiled over Surfaces][9] * [Screenshots][5] can be sent directly to an in-memory Bitmap * Exposed [projectPoint][6] and [unprojectPoint][7] methods on ViroView * API to [set the field of view][8] on the Camera * You can now [extract][11] raw point cloud data * New [renderer configurations][10] allow you to dynamically enable or disable shadows, HDR, Bloom, and PBR [1]:https://developer.viromedia.com/virocore/reference/com/viro/core/Material.html#setMetalnessMap(com.viro.core.Texture) [2]:https://developer.viromedia.com/virocore/reference/com/viro/core/Material.html#setRoughnessMap(com.viro.core.Texture) [3]:https://developer.viromedia.com/virocore/reference/com/viro/core/Material.html#setAmbientOcclusionMap(com.viro.core.Texture) [4]:https://virocore.viromedia.com/docs/physically-based-rendering#image-based-lighting [5]:https://developer.viromedia.com/virocore/reference/com/viro/core/ViroMediaRecorder.html [6]:https://developer.viromedia.com/virocore/reference/com/viro/core/ViroView.html#projectPoint(com.viro.core.Vector) [7]:https://developer.viromedia.com/virocore/reference/com/viro/core/ViroView.html#unprojectPoint(com.viro.core.Vector) [8]:https://developer.viromedia.com/virocore/reference/com/viro/core/Camera.html#setFieldOfView(float) [9]:https://developer.viromedia.com/virocore/reference/com/viro/core/Surface.html [10]:https://developer.viromedia.com/virocore/reference/com/viro/core/RendererConfiguration.html [11]:https://developer.viromedia.com/virocore/reference/com/viro/core/ARScene.html#setPointCloudUpdateListener(com.viro.core.PointCloudUpdateListener) [12]:https://developer.viromedia.com/virocore/reference/com/viro/core/Light.html#setIntensity(float) [13]:https://developer.viromedia.com/virocore/reference/com/viro/core/Light.html#setTemperature(float) [14]:https://developer.viromedia.com/virocore/reference/com/viro/core/Object3D.html#getMaterials() ### Bug Fixes * Fixed: Framerate drop in AR scene with large 3D models. * Fixed: Weak global reference crash if device was idle for extended time * Fixed: Black screen on Mail-T720 GPU devices (i.e. A5 2016) * Fixed: Crash on invalid URIs * Fixed: various FBX keyframe and skeletal animation bugs ### Breaking API Changes * Spotlight: the inner angle and outer angle of spotlights have changed! Now the inner angle represents the angle from edge to edge of the fully lit cone, and the outer angle represents the angle from edge to edge of the attenuated cone. * Field of view: For ViroSceneView, the default field of view is now 60 degrees across the major axis (which is the Y axis in portrait mode, and the X axis in landscape mode). The field of view can now be set, so you can change this if desired. * ViroMediaRecorder: The name of the listeners and the signatures of the listener methods have slightly changed to accommodate saving screenshots to Bitmaps. See the [Javadoc](https://developer.viromedia.com/virocore/reference/com/viro/core/ViroMediaRecorder.html) for details. ### Upgrade instructions If upgrading from ViroCore 1.1, first follow the instructions for ViroCore 1.2, then follow the instruction below. If upgrading from ViroCore 1.2, simply download the new ViroCore AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_3_0/app-viro_core-release.aar), and use it to replace your existing ViroCore AAR file. #ViroCore v1.2 A new release with the following features: - Support for ARCore Preview 2. - Added setCameraARHitTestListener to ViroViewARCore. - Enabled transparent backgrounds for ViroViewScene. - Enabled events for ViroSceneRenderer. ### Upgrade instructions 1. To use the latest ViroCore, download the new ViroCore AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/app-viro_core-release.aar), and use it to replace your existing ViroCore AAR file. 2. Replace the build.gradle file in your arcore_client directory of your project with this [build.gradle](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/build.gradle). 3. Add [core-0.91.0.aar](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/core-0.91.0.aar) to your arcore_client directory. 4. Due to ARCore Preview 2 changes, you'll also need to download our new GVR library [here](https://s3-us-west-2.amazonaws.com/virocore/1_2_0/sdk-common-1.101.0.aar), and replace your existing GVR SDK AAR (this should be in your project's gvr_common directory). 5. **Do this step only if you are developing for ARCore**. Install Google's ARCore Preview 2 client on your device. Instructions from Google are [here](https://developers.google.com/ar/develop/java/getting-started) under 'Prepare your device'. 6. Finally, add the following line to your app's build.gradle under defaultConfig in the android section: ``` ndk { abiFilters "armeabi-v7a", "x86", "armeabi", "mips" } ``` Your new project should be good to go! #ViroCore v1.1 A new release with a size reduction, updates to our underlying platforms, a handful of new features, and some bug fixes! ### Updates The ViroCore AAR file is now just 4.2 MB. VR underlying platform SDKs have been updated: - Updated Google VR (Android) to version 1.101 - Updated Google VR (iOS) to version 1.100 - Updated Oculus VR Mobile SDK to 1.9.0 New features: - Add AR shadows: virtual shadows on real-world planes via the new [ShadowMode](https://developer.viromedia.com/virocore/reference/com/viro/core/Material.ShadowMode.html) Material property - New [CameraListener](https://developer.viromedia.com/virocore/reference/com/viro/core/CameraListener.html) for responding to camera movement - Linear rendering (sRGB) support on Oculus VR, for more realistic shading and lighting - AnimationTransaction animations can now be looped Fixed bugs: - Fixed bug with reticle scaling - Print out native exceptions to console - Fix issue with collision normals in physics system - Fix freezing issue when loading FBX models on Oculus VR And of course, numerous performance improvements. ### Upgrade instructions To use the latest ViroCore, download the new AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_1_0/app-viro_core-release.aar), and use it to replace your existing ViroCore AAR file. If you are using GVR, you will also have to update your GVR SDK. To do this: 1. Download the 1.101 GVR SDK AAR [here](https://s3-us-west-2.amazonaws.com/virocore/1_1_0/sdk-common-1.101.0.aar), and replace your existing GVR SDK AAR (this should be in your project's gvr_common directory). 2. Open your project's GVR gradle file and set it to point to this new AAR file, as follows: ``` configurations.create("default") artifacts.add("default", file('sdk-common-1.101.0.aar')) ```