User:Michelinux/3DGlasses
| This is an old revision of this page, as edited by Ciccio (talk | contribs) at 16:54, 24 January 2010. It may differ significantly from the current revision. |
| 3DGlasses | |
| General | |
|---|---|
| Author(s) | Michelinux |
| Type | Library |
Description
3DGlasses is a C++ library to develop applications that can be seen wearing 3D glasses.
This is not a full featured 3D library: it's your responsability to draw objects in correct z-order.
Development status
- Reading/writing configuration file works
- Geometry init works
- Simple shapes are drawn correctly
Supported glasses
Different kind of 3D glasses exists, this library supports the old ones with each lens of a different color; these glasses are called anaglyphs. Most common anaglyphs have a red lens for left eye, and a cyan lens for the right one, also exists glasses with green - magenta and very rare ones with yellow - blue lenses; 3DGlasses library supports all of them.
Geometry
Origin of the axis is set at the center of the screen, with x incresing towards right, y increasing towards botton and z increasing towards "internal" of screen. For negative values of z the object appears outside the tv, inside the screen for positive values.
For z = 0, x goes from -320 to 320; perspective makes the range narrower for z < 0 and wider for z > 0. Y scale may change because the library tryes to keep 1:1 aspect ratio between axis.
Configuration file
The configuration file 3DGlasses.cfg, inside the main directory of your SD, is shared among all applications using this library. This file contains geometry info about your screen and the kind of anaglyphs you wear.
Probably this file is created the first time you run an application using 3DGlasses. If you change tv or glasses just delete this file (it will be recreated) or edit it by hand (instructions are inside the file itself).
Use of colors
Since the two eyes see different colors of the image you must avoid pure colors in your applications: if you draw a monochromatic red object it will be seen only by left eye with no 3D effect at all.
Classes
3DGlasses library defines its own namespace: l3dg with the following classes
l3dg::Glasses
It's the main class of the library; you need to instanziate one (probably no more than one) object of this class.
This class incapsulates a GRRLIB_texImg where the drawing of the 3D scene happens. startDrawing() method clears internal image while doneDrawing() puts it on the screen.
You can provide a callback function to the constructor of this class; if configuration file is not found, che callback is called to ask user some parameters (look at the following example for details about callback function signature). If configuration file is found, callback is not called.
Sample code
#include <wiiuse/wpad.h>
#include <3DGlasses.h>
#include "BMfont4.h"
#define GRAY 0x808080FF
#define WHITE 0xFFFFFFFF
GRRLIB_texImg *tex_BMfont4;
void callback(l3dg::glassesTypes &glassesType, unsigned int &screenSize, bool &isWidescreen, float &xYRatioCorrection, unsigned int &distanceEyesScreen) {
guVector v[5];
v[0].x= 280; v[0].y= 320; v[0].z= 0;
v[1].x= 370; v[1].y= 320; v[1].z= 0;
v[2].x= 370; v[2].y= 320 + 100 * xYRatioCorrection; v[2].z= 0;
v[3].x= 280; v[3].y= v[2].y; v[3].z= 0;
v[4].x= 280; v[4].y= 320; v[4].z= 0;
u32 textColors[4];
u32 quadColors[5];
u32 pressed;
int type= glassesType;
int i;
int hilighted= 0;
do {
for (i= 0; i < 4; i++) {
if (i == hilighted) {
textColors[i]= WHITE;
} else {
textColors[i]= GRAY;
}
}
for (i= 0; i < 5; i++) {
if (hilighted == 4) {
quadColors[i]= WHITE;
} else {
quadColors[i]= GRAY;
}
}
WPAD_ScanPads();
pressed= WPAD_ButtonsDown(0);
switch (hilighted) {
case 0:
if (pressed & WPAD_BUTTON_RIGHT) type++;
else if (pressed & WPAD_BUTTON_LEFT) type--;
if (type < 0) type= l3dg::glassesTypesNumber - 1;
else if (type >= l3dg::glassesTypesNumber) type= 0;
break;
case 1:
if (pressed & WPAD_BUTTON_RIGHT) screenSize++;
else if (pressed & WPAD_BUTTON_LEFT) screenSize--;
break;
case 2:
if (pressed & (WPAD_BUTTON_LEFT | WPAD_BUTTON_RIGHT)) isWidescreen= !isWidescreen;
break;
case 3:
if (pressed & WPAD_BUTTON_RIGHT) distanceEyesScreen++;
else if (pressed & WPAD_BUTTON_LEFT) distanceEyesScreen--;
break;
case 4:
if (pressed & WPAD_BUTTON_RIGHT) xYRatioCorrection+= 0.05;
else if (pressed & WPAD_BUTTON_LEFT) xYRatioCorrection-= 0.05;
v[2].y= 320 + 100 * xYRatioCorrection;
v[3].y= v[2].y;
break;
}
if (pressed & (WPAD_BUTTON_LEFT | WPAD_BUTTON_RIGHT)) {
}
if (pressed & WPAD_BUTTON_DOWN) {
hilighted++;
if (hilighted > 4) hilighted= 0;
}
if (pressed & WPAD_BUTTON_UP) {
hilighted--;
if (hilighted < 0) hilighted= 4;
}
GRRLIB_FillScreen(0x00000000);
GRRLIB_Printf(64, 64, tex_BMfont4, textColors[0], 1, "GLASSES TYPE: %s", l3dg::glassesTypesStrings[type]);
GRRLIB_Printf(64, 128, tex_BMfont4, textColors[1], 1, "SCREEN SIZE: %d\"", screenSize);
if (isWidescreen) {
GRRLIB_Printf(64, 192, tex_BMfont4, textColors[2], 1, "16:9 WIDESCREEN");
} else {
GRRLIB_Printf(64, 192, tex_BMfont4, textColors[2], 1, "4:3");
}
GRRLIB_Printf(64, 256, tex_BMfont4, textColors[3], 1, "DISTANCE EYES-SCREEN: %d CM", distanceEyesScreen);
GRRLIB_NGone(v, quadColors, 5);
GRRLIB_Render();
} while (!(pressed & WPAD_BUTTON_A));
glassesType= (l3dg::glassesTypes) type;
}
int main(int argc, char *argv[]) {
GRRLIB_Init();
tex_BMfont4= GRRLIB_LoadTexture(BMfont4);
GRRLIB_InitTileSet(tex_BMfont4, 16, 16, 32);
WPAD_Init();
l3dg::Glasses glasses= l3dg::Glasses(callback);
u32 pressed= WPAD_ButtonsDown(0);
while (!(pressed & WPAD_BUTTON_HOME)) {
GRRLIB_FillScreen(0x00000000);
// draw your own 2D background here using GRRLIB
glasses.startDrawing();
// draw 3D scene here using 3DGlasses library
glasses.doneDrawing();
// draw your own 2D foreground here using GRRLIB
GRRLIB_Render();
WPAD_ScanPads();
pressed= WPAD_ButtonsDown(0);
}
GRRLIB_Exit();
}
Contacts
michelinux AT gmail DOT com