summaryrefslogtreecommitdiffstats
path: root/src/controller/README_controller.txt (plain)
blob: c9e7f83717ecbaca9b548eaab016769162af6f44
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
The controller is split into two sections.  The callbacks subdirectory
contains the functions that are used as callbacks from the GLUT event
loop.  The actions subdirectory contains functions that operate on the
data and state.  To the extent possible callbacks should be empty
shells that transform information from hardware and the event loop to
the calling parameters of actions.  This design has the advantage of
facilitating the scripting of user actions in the future.  A script
should be able to call action functions and generate equivalent
behaviors as if the user had initiated the sequences of actions using
the user interface.  Another advantage is that multiple user interface
callbacks can share the same actions.  A common example of this is the
execution of the same function through either a menu selection
callback or a toolbar callback.  As per the "GNU Coding Standards"
section "5.4 Naming Variables, Functions, and Files
[http://www.gnu.org/prep/standards/html_node/Names.html#Names]"
underscores should be used to separate words in a name.

 LocalWords:  callbacks callback

Valid XHTML 1.0 Strict

Copyright © 2009 Don Pellegrino All Rights Reserved.