MS3D Viewer

MS3D file viewer for S60

Description
Screenshots
Features
Supported hardware
Tips
Known issues
Installation instructions
Download
Release history
Related topics

Description

3D model viewer application for Symbian S60 3rd & 5th edition phones.
MilkShape MS3D Viewer displays MS3D files as you open them from your file browser.

Screenshots

Beast model:

File browser:

Features

Supported model format: MS3D
Supported texture format: TGA, BMP, JPEG, PNG and other format supported by your phone.
Multiple cameras
Camera manipulation: Field Of View, Look at, position, far and near plan.
Basic lightning
Skeletal animation with ranges support

Supported hardware

It should run fine on any S60 3rd and 5th edition phones supporting OpenGL|ES 1.1. It will run much faster if your phone has a Graphics Processing Unit.

Tested on:

Nokia N95
Nokia E90 Communicator
Nokia 5800 XpressMusic - Last tested using v1.04(48)
Nokia N96 - Last tested using v1.03(14)
Nokia 6220 - Last tested using v1.02(82)
Nokia E71 - Last tested using v1.02(74)
Samsung I8910 - Last tested using v1.05(8)
Nokia N97 - Last tested using v1.04(48)
Sony Ericsson Satio - Last tested using v1.04(57)

Tips

With the default camera use the keys 8 and 2 to obtain zoom in and zoom out effects.
You can change the camera settings by using the numeric keypad.
You can change the camera settings you control by using the key 5.
* toggles model rotation around Y axis.
# key toggles camera info display.
Joystick verticals let you change the camera.
Joystick horizontals let you change the animation move if any.
You can further customise your viewer by editing the file milkshapeviewer.ini from the directory \Slion\Data\E9760001\.
You can edit that configuration file directly from your phone by using a text editor such as LightNotepad.
To improve your frame rate on animated model make sure you select the 'Compute frames' option from the menu.
- Computing your frames will improve runtime performance but use up large amount of memory.
Touch screen support:
- Quick gestures will send your model spinning.
- Simply tap the screen to immobilize your model.
- Tap and hold for one second will give you control of the camera position.
You can define animation moves by formatting the built-in model comment as follow. Take a look at the provided Ninja example:

[Moves]
walk = 0;32
run = 33;64
go_left = 65;96
go_right = 97;128

Known issues

Viewer file associations won't work unless you install DataTypeRegistry.
Viewer file associations might not be working properly until you reboot your device.
Rare "Unable to delete file!" error message upon reinstallation/uninstallation. Close any running file explorer application and retry until it works.
Some BMP (4bbp uncompressed, 16bpp, 24bpp RLE) are not supported.
Color mapped TGA are not supported.
Some JPEGs are not supported by our libjpeg port, however at a couple of seconds cost the Symbian ICL loads them just fine.
Screen switch not working on Samsung I8910.

Installation instructions

Simply download and install the SIS file on your phone. If you have not done it yet you will also need to install DataTypeRegistry to be able to open MS3D files from your file explorer. You could also use Y-Browser to set-up application/ms3d file association with MS3D Viewer but that would only work from Y-Browser itself.

If you are upgrading from v1.00(0) or older to a newer version you first need to uninstall the software before installing the newer version. Failing to do so will give you an 'Update error!' failure upon installation.

Download

MS3D Viewer 1.05(17).

Release history

Version	Date	Notes
v1.05(17)	08 Feb 2010	Supports a lot more texture formats through Symbian Image Conversion Library. Fixing minor defects.
v1.05(8)	05 Feb 2010	Adding support for animation ranges or moves. Adding animation menu providing control for speed, sense and mode: cycle or loop back. Adding 'Reset cameras' option. Providing ninja model from Psionic as animation moves example.
v1.04(57)	21 Sep 2009	Upgrading to libjpeg v7.0. JPEG texture loader won't print to stdio anymore. Failing to load JPEG texture won't close the application anymore.
v1.04(48)	11 Aug 2009	FPS more stable. Improved start-up time. Improved progress bar for loading. Added progress bar for frames computing. Added menus fade in effect. Fixed touch screen sensibility regression.
v1.04(7)	04 Aug 2009	Shows progress bar during loading. Provides seven cameras focused on your model. `*` key toggles model rotation around Y axis. `#` key toggles camera info display. Failing to load a texture is no longer critical. Various stability and responsiveness improvements.
v1.03(24)	18 Jul 2009	Minor jpeg support improvement. Camera far plan and light position adjusted by auto focus. Blending enabled by default. Can now load model with upper case texture file extension.
v1.03(14)	09 Jul 2009	Adding support for BMP RLE4 and RLE8 texture formats. Fixing issue with relative texture path prefixed with ".\".
v1.03(2)	06 Jul 2009	Support for PNG textures.
v1.02(82)	05 Jun 2009	Fixing regression crash when trying to load a model without material.
v1.02(74)	03 Jun 2009	Fixed N96 crashes. Info displayed at the top by default. Options menus improvements.
v1.02(32)	01 Jun 2009	Much better touch screen usability. Support on-screen soft keys.
v1.02(2)	27 May 2009	Support phones without GPU out of the box. Support for touch screen.
v1.01(19)	22 May 2009	Better camera auto focus.
v1.01(14)	20 May 2009	No need for Symbian Signed Online anymore. Camera auto focus. Fixed panic on Reload. Support multiple application instances.
v1.00(0)	30 Jan 2009	Removing dependency on OpenC PIPS.
v0.09(0)	28 Jan 2009	Support for JPEG textures.
v0.08(0)	02 Jan 2009	Support materials without texture file. Support relative file path for textures. Enable model loading from any directory.
v0.07(0)	22 Nov 2008	Improved performance on animated model with multiple groups. Support for triangle count. Support for precomputed frames. Provided beast model now only has 22 frames.
v0.06(0)	10 Oct 2008	First release.