Libgdx-CardBoard-Extension

KO | EN

gitlite — search

#python #ai #typescript #llm #go #machine-learning #rust #linux #docker #windows #kubernetes #awesome-list #security #mcp

Libgdx-CardBoard-Extension

(★ 68)

Android CardBoard SDK development using Libgdx

File Explorer

Download Latest Version (.zip)

- .classpath
- .gitignore
- .project
- build.gradle
- proguard-project.txt
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- - org.eclipse.jdt.core.prefs
- .classpath
- .gitignore
- .project
- build.gradle
.gitignore
build.gradle
gradlew
gradlew.bat
README.md
settings.gradle
snapshot.png
snapshot2.png

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Libgdx-CardBoard-Extension

#### A libgdx extension for cardboard app deveplopment

[![](https://jitpack.io/v/yangweigbh/Libgdx-CardBoard-Extension.svg)](https://jitpack.io/#yangweigbh/Libgdx-CardBoard-Extension)

## Now support Latest libgdx 1.9.11

the cardboard sdk can only use OpenGL API to development app which is quite low efficiency. Now you can you use libgdx to develop CardBoard App.

![](https://raw.githubusercontent.com/yangweigbh/Libgdx-CardBoard-Extension/master/snapshot.png)

## Setup

add in your project build.gradle

```groovy
allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}
```
add dependency
```groovy
implementation 'com.github.yangweigbh:Libgdx-CardBoard-Extension:0.5.0'
```

> Notice: in order to use this extension, you should also include dependency for 
```groovy
implementation "com.badlogicgames.gdx:gdx-backend-android:1.9.11"
implementation "com.badlogicgames.gdx:gdx:1.9.11"
implementation "com.google.vr:sdk-base:1.190.0"
```
also don't forget put the libgdx natives so into libs folder, **you can get all the file in the Demo project**

>![](https://raw.githubusercontent.com/yangweigbh/Libgdx-CardBoard-Extension/master/snapshot2.png)

## Usage

create your activity inherit from CardBoardAndroidApplication and implement CardBoardApplicationListener interface

```java
   class YourActivity extends CardBoardAndroidApplication implements CardBoardApplicationListener
```

in your activity `onCreate` method, do libgdx initialization like normal libgdx app

```java
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        AndroidApplicationConfiguration config = new AndroidApplicationConfiguration();
        initialize(this, config);
    }
```

the CardBoardApplicationListener interface add 5 cardboard related methods to [ApplicationListener](https://github.com/libgdx/libgdx/wiki/The-life-cycle)

```java
public interface CardBoardApplicationListener extends ApplicationListener{

public void onNewFrame(HeadTransform paramHeadTransform);

public void onDrawEye(Eye paramEye);

public void onFinishFrame(Viewport paramViewport);

public void onRendererShutdown();

public void onCardboardTrigger();
}
```
the method is used as follows:

Method signature | Description
---------------- | -------------
onNewFrame(HeadTransform paramHeadTransform) | Called when a new frame is about to be drawn.
onDrawEye(Eye paramEye) | Requests to draw the contents from the point of view of an eye.
onFinishFrame(Viewport paramViewport) | Called before a frame is finished.
onRendererShutdown () | Called on the renderer thread when the render thread is shutting down.
onCardboardTrigger() | Called when user pull the magnet trigger

the main drawing work is done using CardboardCamera, instead of putting your rendering logic in `render()` method, put it in `onDrawEye()` method:

```java
/* in create callback of ApplicationListener, 
   create CardboardCamera instance.*/
public void create() {
    cam = new CardboardCamera();
    cam.position.set(0f, 0f, CAMERA_Z);
    cam.lookAt(0,0,0);
    cam.near = Z_NEAR;
    cam.far = Z_FAR;

.....your other setup code
}

/* in onDrawEye method, adjust CardboardCamera view 
  and projection matrix according to left or right eye*/
public void onDrawEye(Eye eye) {
	//set view matrix to camera
	cam.setEyeViewAdjustMatrix(new Matrix4(eye.getEyeView()));

//set the projection matrix to camera
    float[] perspective = eye.getPerspective(Z_NEAR, Z_FAR);
    cam.setEyeProjection(new Matrix4(perspective));
    cam.update();

//use the camera to do your rendering
}
```

## Issues

- the added method of CardBoardApplicationListener is always called behind ApplicationListener's callback method, need to implement the correct order

## License

All of the code in this repository is licensed under the Apache Software License 2.0

## Enjoy

Libgdx-CardBoard-Extension

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Libgdx-CardBoard-Extension

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README