README.TXT

(4 KB) Pobierz
dosbox s60 port (very-very-beta-sneak-peek-release)
===================================================

by kolijoco

version 0.1


disclaimer:
===========

this release is porovided as is, use at your own risk, i take responsibilty to damage this might cause to you or your phone... you get the idea.

this is a work in progress development build, so don't expect too much...


license:
========

all this (exepct for nokia plugin, see below) should go under GPL (methinks), so while there's no source included, there will be in the future. you should not even contemplate selling or otherwise commercializing the contents of this release.


contents of this release:
=========================

README.TXT		- you're reading it! :-)

dosbox.sisx		- the dosbox installer

dosbox.conf		- sample configuration file

mapper.txt		- sample key mapping file

[dependencies]		- folder containing the dependency installers: 1) the SDL s60 binary, as available at http://koti.mbnet.fi/mertama/sdl.html, and 2) Nokia OpenC plugin installers, you must read, and agree to the terms in "Symbian Redistribution and Use Licence v1.0 12.03.07 final.doc" before you install them !!! (dosbox doesn't depend an ALL of these, but i didn't care to single out the ones actually needed.)


installation instructions:
==========================

(you will probably have to set phone security to accept untrusted packages)

1) install all dependencies

2) install dosbox

3) edit dosbox.conf: be sure to set your preferred orientation, the location you will install mapper.txt to, and the autoexec.bat section with special respect to the mount command, and whatever you want to launch. (type into the shell is no joy on s60.) (c: drive is the phone's memory, for my e51 the microsd is drive e:)

4) copy dosbox.conf to the /Data directory on you phone's memory (tested), or your storage's (not tested, but should work)

5) copy a dos tree to the appropriate location (as specified for the mount command in the autoexec section of dosbox.conf)

6) edit maper.txt to suit your needs (note the provided example substitutes 'y' for '9', so i can answer the y/n question when "eye of the beholder" starts up)

7) copy mapper.txt to wherever you've specified it in dosbox.conf

notes: you probably need to place your dos dir under /Data. i'm keeping the conf and mapper file and my /dos tree in 'C:/Data' (my phone's memory), and have not tested any other setups. the provided config and mapper file reflect my personal preference for playing eye of the beholder on my e51.


virtual mouse:
==============

use "accept call" button to toggle virtual mouse mode on/off. 
use the thumb thingy (i know it has an official name, but i jsut can't remember) to move the mouse.
buttons:
left   - the thumb thingy push or [#]
right  - [*]
middle - [0]


cpu cores:
==========

simple and normal cores should work, no dynaimc for now...


audio:
======

its a bit slow on my e51, to get audio playback without stuttering i had to reduce cycles to 500, but that slowed everything else to a crawl. so for now, don't force it...


source code:
============

be patient, i want to clean it up before i release it (less you find out what a sloppy coder i am :-)


feedback and contact:
=====================

for the time being please don't email or pm me with "installation problems", "bug reports" or even "pats on the back".

feel free to contact me with "more official" enquiries (hosting, publishing, insanly high slalry job offers, and the like :-) 

tell your friends about the project.


contribute:
===========

contact me if:

if you're a symbian guru and wish to participate (profiling and optimizing mainly),

if you're on the dosbox team and think this is worth integrating,

if you just inherited a fortune, and would like to provide me with test equipment (hey, i never know, do i?), an e71 (for the keyboard), or an n95 would look really good on me :-)

NOTE:

i'm very new to symbian. so if you want to discuss symbianish, be prepared to explain things :-)


Zgłoś jeśli naruszono regulamin