Specifications

Developers guidelines | 3D graphics with Java ME
37 June 2010
A: Create a new project in Ktoolbar. Select Project->Settings menu, on API Selection
tab choose "Custom" platform. Check the appropriate checkbox "Mascot Capsule
Ver.3 API". Now you will be able to build your project with support of Mascot Capsule
V3 API.
Q: What tools are available to create models?
A: All Micro3D conversion tools are available at Mascot Capsule website
http://www.mascotcapsule.com/toolkit/sony_ericsson
.
Q: What texture sizes can be used ?
A: Unlike Mascot Capsule Version 4, arbitrary sizes can be used for example, 64 x 192.
The texture image file needs to be less than 256x256 pixels and use 8 bits (256
colours).
Q: I cannot position a model on the phone using the Z axis ?
A: Be sure to define the Z-axis position. See the method setPerspective() in the
FigureLayout class. Perhaps parallel projection is being set instead of perspective
projection?
Q: There appears to be no support on for defining and rendering your own geometric
model to the screen.
A: Refer to Graphics3D::renderPrimitives.
Q: Can I render a scene to an off-screen object ?
A: Yes. Use the bind() method in Graphics3D() to direct the 3D drawing to the
graphics object javax.microedition.lcdui.Image::getGraphics().
Q: Which graphics format is supported by Mascot Capsule v3?
A: Mascot Capsule v3 only supports uncompressed 256 colours indexed BMP. BMP
RLE compression is not supported for creating textures.
Q: When using the AffineTrans setRotation method, what is does the integer
parameter indicate ?
A: The rotation angle is specified as an integer assuming 360 degrees = 4096. The
rotation is a clockwise rotation looking in the positive axis direction.
Q: What are the .bac and .mbac files and what is their relation?
A: The .bac file is generated by the 3D modeling tooling using the Mascot Capule
version 3 plugin. This file represents your model in the propriety Mascot Capsule
format. The .bac file is intended to be used with the Micro3D Converter tool provided
by Mascot Capsule which in turn generates a .mbac file that is optimised for a small
foot print and usage on a phone.
Note that the binary (bac) file format cannot be used to gain access to triangles (for
advanced collision detection and direct triangle transformation). For this, use the ascii
format. It is important to know which models can be represented by ascii files and
which cannot.