asciimatrix osc interface
-------------------------

/am/print : print to screen (or simply: "/am" is also working)

understands keyword arguments: (defaults in {})

    :cmd print, del, delblock, fill, mark, unmark {print}
    :s string to be printed/filled/deleted {""}
    :l startline {1}
    :c startcolumn {1}
    :ln number of lines {until last}
    :cn number of columns {until last}
    :subst substitute by char, rand (random), space (space) {no subst}
    :wrap currently only no, yes (0, 1) [no, hard, soft (0, 1, 2)] {0}
    :fill start from beginning if :s is done no, yes (0, 1) {0}
    :scroll scroll if outside screen no, yes (0, 1) {0}
    :color text color (0-16) (r, g, b[, a]) {1 = 255 255 255} (white)
    :back background color (0-16) (r, g, b[, a]) {0 = 0 0 0} (black)
    :mark no, yes (0, 1) swap color/back semantics {0}
    :delmode no, lines, allines, block, entblock (0, 1, 3, 4, 12) {no}

convenient commands, which alter default values (if not overridden):

    :cmd del - enables :subst ' ' :wrap hard
    :cmd delblock - enables :subst ' ' :delmode entblock
    :cmd fill - enables :fill yes :wrap hard
    :cmd mark - enables :mark :fill yes
    :cmd unmark - enables :fill yes
    :cmd scroll - enables :scroll, :l = last, :cn = 1


/am/scroll : scroll screen

understands keyword arguments: (defaults in {})

    :ln scroll ln lines {1}
    :cyclic don't delete lines but append to other end no, yes (0, 1) {no}
    :up scroll up instead of down no, yes (0, 1) {no}


/am/config : configure asciimatrix

understands keyword arguments: (defaults in {})

    :server send osc messages to server {leave as is}
    :serverport send to port on :server {leave as is}
   (:listenport listen to port {leave as is}) <- currently not working
    :oscprefix send all osc-commands prepended by /oscprefix/ {don't change}


other commands understood:

/am/getfontsizes		request availabe font sizes list
				(yields strange results at the moment)
/am/setfontsize <points>	set font size in points
/am/getscreenprops		request current screen properties
/am/openconfig			open config dialog in asciimatrix
/am/quit			quit asciimatrix


asciimatrix sends:

/am/screenprops <x> <y> <l> <c>	<xc> <yc>
				x-pixels, y-pixels, lines, columns,
				x-pixels per character, y-pixels per
				character
				sent on startup and after sending
				/am/setfontsize and /am/getscreenprops
/am/fontsizes <points> ...	availabe fixed font sizes in points

/am/mouse/mov <x> <y> <l> <c>	mouse coords (moved)
/am/mouse/prs <x> <y> <l> <c>	mouse coords (pressed)
/am/mouse/rel <x> <y> <l> <c>	mouse coords (released)
/am/mouse/dbc <x> <y> <l> <c>	mouse coords (doubleclicked)

/am/key/prs <keycode> <ascii>	key pressed (keycode, ascii if codable)
/am/key/rel <keycode> <ascii>	key released (keycode, ascii if codable)


TODO
----

- fullscreen
- landscape mode
- listenport via osc: solve threading/stack corruption issues