EQL5/examples/M-modules/quick/Tic-Tac-Toe
2017-10-10 10:59:03 +02:00
..
pics add example "quick/Tic-Tac-Toe"; lots of minor revisions; 2017-01-19 02:02:30 +01:00
qml fix QML examples to work with Qt 5.9 2017-06-21 21:13:29 +02:00
COPYING.txt add example "quick/Tic-Tac-Toe"; lots of minor revisions; 2017-01-19 02:02:30 +01:00
game-logic.lisp small revisions of QML examples 2017-03-07 00:23:14 +01:00
properties.lisp unix: add "make install" option for exe, lib, modules (refactor file locations) 2017-04-28 12:05:59 +02:00
qml-lisp.lisp fix 'qml-set' to work with enum values 2017-10-10 10:59:03 +02:00
README.txt small revisions of QML examples 2017-03-07 00:23:14 +01:00
tic-tac-toe.lisp build wrapper functions by default (no more optionally) 2017-09-14 13:17:44 +02:00

INFO
====

This is a port of a QtQuick1/Qt4 example.
Please note that this is _old_ QML code (QtQuick 1).

The JS game logic has (obviously) been ported to Lisp, see "game-logic.lisp".


RUN
===

Please run it from this directory.

For Emacs/Slime, this would be:

    eql5 ~/slime/eql-start-swank.lisp tic-tac-toe


CALL LISP
=========

Examples:

    Lisp.call("cl:foo", x, y)
    Lisp.call(this, "cl:foo", x, y)    ; optionally pass 'this'

    Lisp.apply("cl:foo", [x, y])
    Lisp.apply(this, "cl:foo", [x, y]) ; see above

'this' can be accessed in Lisp through qml:*caller*


QML FILES
=========

The only "import" needed is:

    import EQL5 1.0

which provides all of:

    Lisp.call()
    Lisp.apply()
    PaintedItem

To reload the QML source file after changes, do:

    (qml:reload)


NOTES
=====

Try the following:

    (qml-set "game" "difficulty" 8) ; one of: 2, 8, 10

Since the logic of the buttons is defined in the QML file, changes to
properties will be reflected immediately by the UI.

Anywhere an 'objectName' is expected, you can optionally pass a QQuickItem
directly, or NIL if you want to use the root item.

Please see also "../qml-lisp/qml/example.lisp" for documentation on calling
Lisp functions from QML.


HELP
====

To display the output of QPROPERTIES*, run

    (show-properties-dialog) ; see "properties.lisp"

and use [Select] to explore the single QML items;
hint: click exactly inside a button text, and do

    (qml-set qsel:*q* "text" "<b>ciao</b>")


TIP
===

In order to have uniform access to QQuickItems from both QML and Lisp
functions, it is convenient to set both 'id:' and 'objectName:' to the
same name.

QML Example:

    Item {
        id: my_item
        objectName: "my_item"
    }