Giter Club home page Giter Club logo

tof-ar-samples-basic's Introduction

Contents

Download the App

Experience immersive AR scenes made with ToF AR.
Download ToF AR Samples Basic now from App Store and Google Play and try it out!

Get it on the App Store      Get it on Google Play

About ToF AR

ToF AR, Time of Flight Augmented Reality, is a toolkit library for Unity providing application developers with tools to start building immersive worlds for iOS and Android devices. ToF AR mainly targets iOS and Android smartphones with a ToF sensor from Sony, but it also works with other depth sensors, such as structured light method sensors.

As well as ToF AR, Unity and compatible devices with ToF sensors are required to build and execute the ToF AR Samples Basic application.

Please see the ToF AR Site on Developer World for ToF AR downloads and development guides, sample applications, and a list of compatible devices.

Overview of ToF AR Samples Basic

ToF AR Samples Basic is a simple sample application that uses the functions of ToF AR and provides the following 17 scenes:

List of scenes

Color ColorDepth BasicStream DepthConfidence
Display Color image Superimpose Color image and Depth image Tile Depth, Confidence and Color images Display Depth image and Confidence image side by side
image of Color scene image of ColorDepth scene image of BasicStream scene image of DepthConfidence scene
PointCloud ColoredPointCloud HumanPointCloud Segmentation
Display a subject as a single color PointCloud Display a subject as a color PointCloud Display a human body as a color PointCloud Display segmentation results for person and sky as masks
image of PointCloud scene image of ColoredPointCloud scene image of HumanPointCloud scene image of Segmentation scene
Hand LiveMeshOcclusion ColorHandOcclusion Body
Display a hand bone model Display a virtual cube occluded by the subject based on distance measurement Display a virtual cube occluded by the hand based on distance measurement, and display hand bone model Display a human bone model on the Depth image
image of Hand scene image of LiveMeshOcclusion scene image of ColorHandOcclusion scene image of Body scene
ColorBody HandMark ColorHandMark SLAM
Display a human bone model on superimposed Depth and Color image Recognize the mark drawn with the index finger and display the mark name Recognize the mark drawn with the index finger and display the mark name. Superimpose Color image and Depth image. Display the coordinates of the SLAM-supported camera
image of ColorBody scene image of HandMark scene image of ColorHandMark scene image of SLAM scene
Face
Overlay a white mask on the face based on face recognition. Also display the recognition result from the shape of the mouth.
image of Face scene

Operation

Using the built application is described below.

image of Top screen

  1. When you start the application, the scene list is displayed on the screen. Select a scene from the list and tap it to start it.

  2. Tap the camera icon at the bottom left of the screen to display a list of available cameras for the selected scene. Select an appropriate camera, and the scene will start working.

  3. Tap the screen with four fingers to return to the top screen.

Component

The table below shows the relationships between the 17 scenes in the sample application and the ToF AR components used by each scene. The scene names are arranged vertically and the component names are arranged horizontally. A check mark indicates that the component is used.

ToF Color Mesh Coordinate Hand MarkRecog Body Segmentation Slam Face Plane Modeling
Color
ColorDepth
BasicStream
DepthConfidence
PointCloud
ColorPointCloud
HumanPointCloud
Segmentation
Hand
LiveMeshOcclusion
ColorHandOcclusion
Body
ColorBody
HandHark
ColorHandMark
SLAM
Face

Assets

ToF AR Samples Basic provides the following assets. Assets include URP (Universal Render Pipeline) and VRM (Virtual Reality Model) for 3D characters and avatars.

TofArSamplesBasic

17 sample scene scripts and resources are stored for each component.

TofArSettings

Prefabs and scripts are stored as the configuration change UI used by each component.

File Description
Settings.Prefab Configuration change UI
XXXController.Prefab Manage configuration changes for each component

URP(Universal Render Pipeline)

URP is the standard lightweight rendering pipeline of Unity for displaying scene content. URP is included in the asset.

Please see Universal Render Pipeline documentation.

VRM (Virtual Reality Model)

VRM is a platform-independent 3D avatar file format for humanoid characters and avatars. VRM is included in the asset.

Please see VRM documentation.

Development environment

Build library

ToF AR is required for build. Download the ToF AR toolkit from the ToF AR Site on Developer World, then import it and use it in a Unity project. Note that both Base and Hand components are required by ToF AR Server.

If the project is opened before ToF AR is set up, a confirmation message to enter safe mode may appear, depending on your settings. If you start Unity in safe mode, exit safe mode and then import the ToF AR package.

Documents

ToF AR Development documents are also available on Developer World.

Verification environment

Operation was verified in the following environment:

  • Unity Version : 2021.3.18f1
  • ToF AR Version : 1.3.0

Notes

Be aware that recognizable hand gestures may have different meaning in countries/areas.
Prior cultural checks are advisable.

Contributing

We cannot accept any Pull Request (PR) at this time. However, you are always welcome to report bugs and request new features by creating issues.

We have released this program as a sample app with a goal of making ToF AR widely available. So please feel free to create issues for reporting bugs and requesting features, and we may update this program or add new features after getting feedback.

tof-ar-samples-basic's People

Contributors

sadayoshishimazaki avatar toshihiko-miyamura avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.