|--=]QQQQQQQQQQQQQQQQQQQVTQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQQQQQQQQQQQQQQQQQQ. mQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQQQQV??9QQQ@T??9QT` ?TQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQQQ( jw "Q@`_gg,dw  awQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQQF .QQ; ]k +$QgmQ. mQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQQ[ :QQ; ]m   -?QQ. mQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQW[ :QQ; ]Wgs.  3Q. mQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
Q. ]QQQ:h  QQ` jE4WQ; jQ. m@$WQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
!  -""":QL.?! jQk ??`_QQc ?'dQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
QmQQQQmQQQQwwmQWQmgygQQQQgwmQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQQ!.aa,-4QB  dQQQQQc )WQQQQQQQQWQQQWQQQWQQQWQQ
QQQQQQQQQQQQQQQQQF jWWQ/jQQa<QQQQQQf )WQQQQQQQQQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQf )WQQmmQ???$QW!-"t )WQ@?"!4QQQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQL   "Y$QQm; dQ[ <g, )W@`.mc ]QQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQQ,     4QQ; dW  jQL )W[ =Qk -QQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQQQma,  =QQ; dW  3Qk )W[ -""  WWQQQQQQWQQQWQQQ
QQQQQQQQQQQQQQQQQ@4QQQm .QQ; dQ  3Qf )W[ =QQQWWQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQWk-QWQW <QQ; dQc ]Q[ )Wk -QWE:QQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQm,-!!`_mQc__|QQ,_=c__]Qa "!=yQQQQQQQQQQQQQQQQ
QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQW""!QQQQQQQQQQQQQQQQQQQQW"""Q
QQQQQQQQQQQQQQQQQWQQQQQQQQQQQQQQQQE .QQQQQQQQQQQQQQQQQQQQQm  Q
QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQE :QQQQQQQQQQQQQQQQQQQWQW  Q
QQQQQQQQQQQQQQQQQQQQQQQQWQQQQQW"  ! :QQ@!^^?QW@"++"4QQQ!  ?  Q
QQQQQQQQQQQQQQQQWQQQQQQQQQQQQQ[ =Qc .QW' mk )WE<QQ; $Qf _QL  Q
QQQQQQQQQQQQQQQQQQQQQQQWQQQQQQ` ]Qk :QF .Qm  $WWBH[ ]Q' ]Wm  Q
QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ. jQE :Qf  |+..dD`.a, ]Q; ]WW  Q
QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ; ]QE .QL  QQQQQ[ jW[ ]Q( ]WB  Q
QQQQQQQQQQQQQQQQQQQQQWQQQQQQQQL +W[ :QQ. $Q@.Q[ ]B' ]Qk -Wf  Q
QQQQQQQQQQQQQQQQWQQQQQQQQQQQQQQa,_w_a<Qg,-"<yQm, _c_=jQw,_w_a_
[                                                            ]
[                                                            ]
[                                                            ]
[   MAsterX-ovDM and components (code name haze)             ]
[                                                            ]
[   svn co svn://lostsidedead.com/haze                       ]
[                                                            ]
[   http://lostsidedead.com/project.php  (offical page)      ]
[____________________________________________________________]



MAsterX-ovDM - Prototype 4 README 0.1

--------------------------------------------------------------

Supported Platforms:

Mac OS X Leopard ( Intel )
Linux 
FreeBSD 

soon more



This time I put a lot of thought and effort into
creating this application. I spent  quite a few months
tweaking the graphics engine. Also writing the markup language ( MXL )
as well as the lexical analyzer.  libmxui which is the  
component which takes care of the interface  features of the application
is build on top of the graphics engine, all controls, windows, dimensions
are all written by hand with rectangles, lines, and pixels.
I have had to scrap the project 3 times  due to internal problems with
the lay out of the code. So this time , I spent some time and drew out
some diagrams of where each component  would fit with each other component
and now things are working better than ever before


Current Project State:

I instead decided too use a embedded python interpreter intstead of 
the underdeveloped MasC language I came up with, ( will eventuly be added anyway )
It is accessible to you at the console as a interactive session. Most of the software
for MasterX will be written in Python.

How to compile:

Read this tutorial here: http://lostsidedead.com/masterx_build.php
or if your using debian or Ubuntu download this build script:

svn co svn://lostsidedead.com/haze/build_scripts


Recently added boost-thread, for multithreading which will be nessicary for implementing  the
networking aspect of the application.




Info for demo:


THe user name and password for the MasterX demo are:

username: Jared
password: masterx

it is case sesnitive


Depdencys (main ones)



if your using Ubuntu to install all the dependcys except for the ones I wrote:

sudo apt-get install subversion  automake autoconf libtool pkg-config  gcc g++ libstdc++6 python2.5-dev libboost-dev libboost-python-dev libboost-thread-dev  libsdl1.2-dev libsdl-stretch-dev libpng12-dev zlib1g-dev


SDL-1.2.13

SDL_stretch <- is required to be compiled into libmx if 
you want to compile MasterX so that means no ppc unless you can
implement a fast stretch  routine in ppc asm and mail me: jared@lostsidedead.biz


Ones I wrote:

libmasc
mxl
libmx
libmxui


Build Configure Arugments:

libmx 
-----

--enable-tests              ( enables libmx test programs not nessicary for compiling MasterX)
--enable-subtext            ( enables subtext in test program not nessicary for compiling Masterx)

libmxui
------

--enable-debug_mode         ( enables debug mode )
--disable-assert            ( disables assertions (removes them completly) only use this for release builds)

-------------------------------------------------------------------------------------------------------------

Program  Controls

Controls:

Shift + Escape                    (Quick Quit)
LEFT ALT  + CTRL + UP             (Restore all Window)
LEFTALT + CTRL+ DOWN              (minimize all Windows)
LEFT SHIFT + LEFT                 (shift left one dimension)
LEFTSHIFT + RIGHT                 (shift right  one dimension)
Left Alt  + Left ShiftB           (shift focus order of widgets)
F1                                ( jump to Console Dimension )
F2                                (take a screen shot)
CTRL+SHHIFT+UP                    (Restore all Windows )
CTRL+SHIFT+DOWN                   (Minimize all windows) 


Click near the top of the screen to show the system menu

import masterx

in interactive session ( Dimensions -> Console ) to gain access to versions of libmxui classes 
exported in python. ( Still in progress ).

program arguments:

--width=W
--width=H

W is width in pixels
H is height in pixels

example

./masterx --width=1280 --height=1024

when no arguments are given, defaults to 1024x768

--log=true

will send stdout log information to a file called system.log
versus printing to the standard output stream.


Python Feature Log:
in the shell:

masterx moudle classes

first:

import masterx

masterx classes so far as of Wed Oct  1 17:42:50 PDT 2008

masterx window classes:

creating a window:
win =   masterx.mxWin("Title", x_cord, y_cord, width, height)
setting a skin:
win.useskin("img/skins/mx/black")
set window title:
win.settitle(" title ")
set position:
win.setpos(x,y)
set size:
win.setsize(width,height)



callbacks:

drawing

first set the objects name 

win.setcallback("win")

second assign it a render callback

def render_callback():
	# whatever you want here
	win.fillrect(0,0,640,480,255,255,255)

assign input processing callbacks

def keydown(key):
	print "key pressed: " + str(key) + " !"

win.keydown = keydown

other input processing callbacks

win.keyup
win.mousemove
win.mousedown
win.mouseup

soon child control callbacks will be added


filling a rectangle:
win.fillrect(x,y,width,height, red,green,blue)
setting a pixel:
first you must lock the surface:
win.lock()
then set  the pixels:
win.setpixel(x,y,red,green,blue)
then when finished unlock the surface:
win.unlock()
exiting the program safeely (releasing all resources)
win.bail()

adding graphics to your window:
surf = masterx.mxSurf()
loading images from disk:
surf.loadpng("surf.png")
surf.load("surf.bmp")
freeing resources:
surf.release()

copying to a window:

win.copysurf(surf, 0, 0, 1024, 768)

resize copy

win.copyresizesurf(surf, 0, 0, 1280, 1024)

creating a dimension for your window:
dim = masterx.mxDim()
adding the dimension to list of dimensions:
dim.add()
adding your window to the dimension:
dim.add(win)
other dimension functions:
set background color:
dim.setbgcolor(r,g,b)
set background image:
dim.setbackground("image.png")


system  output classes (stdout, stderr):

setting the font:
sys.stdout.setfont("font")
setting the font color:
sys.stdout.setcolor(red,green,blue)

IN PROGRESS MAY CHANGE OR UPDATE

CALLING SCRIPTS FROM THE SHELL:

PYTHONPATH

PYTHONPATH must point  to the scripts directory
I have included a handy shell script called RunMasterX
which you can use to start the program and it will set the varaibles for you

so instead of running

./masterx

run

./RunMasterX


Write your pytthon script and place it in the scripts directory
in the shell type

if you script is called myscript:

from  myscript import *

then it should execute without  namspace errors

I am still working on getting all  the controls
and call backs working it will take some time so be patient

Good Luck and thank you for taking interest in this project

- { Jared, Bruni };