Getting started with Rajawali VR library

First step to getting started with Rajawali VR library is to extend your main Activity to VrActivity. VrActivity internally extends the google’s CardboardActivity providing a surface to render the 3D scene.

import org.rajawali3d.vr.VRActivity;

public class MainActivity extends VRActivity {

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
}

There might be a warning if onCreate access is protected, if so change it public

Setting up a sample scene with Rajawali

First, we need to extend the Rajawali Renderer class. Let’s create a new class where our MainActivity is:

Name the class say Renderer and select the superclass as VrRenderer

Implement methods and create a constructor matching super.

import org.rajawali3d.vr.renderer.VRRenderer;

public class Renderer extends VRRenderer {
    public Renderer(Context context) {
        super(context);
    }

    @Override
    protected void initScene() {

    }

    @Override
    public void onOffsetsChanged(float xOffset, float yOffset, float xOffsetStep, float yOffsetStep, int xPixelOffset, int yPixelOffset) {

    }

    @Override
    public void onTouchEvent(MotionEvent event) {

    }
}

initScene is where you initialize the scene. Lets render a simple cube with a blue colored material:

@Override
protected void initScene() {
    Material material = new Material();
    material.setColor(Color.BLUE);
    Cube cube = new Cube(2);
    cube.setMaterial(material);
    cube.setPosition(0, 0, -6);
    cube.rotate(Vector3.Axis.Y, 45);
    getCurrentScene().addChild(cube);
}

Setting up the Activity

Now we need to set this renderer to our activity. Just create a new Renderer object and call the setRenderer method

@Override
public void onCreate(Bundle savedInstanceState) {
    requestWindowFeature(Window.FEATURE_NO_TITLE);
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
    super.onCreate(savedInstanceState);
    setRenderer(new Renderer(this));
}

You may also lock the orientation to landscape for the activity in the AndroidManifest.xml

android:screenOrientation="landscape"

The output will look like this:

Setting up the Manifest

To ensure the app can be launched from the cardboard app and the traditional launcher, add the following intent filter for the acitvity in the AndroidManifest.xml:

<intent-filter>
    <action android:name="android.intent.action.MAIN" />

    <category android:name="android.intent.category.LAUNCHER" />
    <category android:name="com.google.intent.category.CARDBOARD" />
</intent-filter>

Your final manifest entry should look something like this:

<activity
    android:name=".MainActivity"
    android:screenOrientation="landscape">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />

        <category android:name="android.intent.category.LAUNCHER" />
        <category android:name="com.google.intent.category.CARDBOARD" />
    </intent-filter>
</activity>