Subversion Repositories Kolibri OS

Rev

Go to most recent revision | Blame | Last modification | View Log | Download | RSS feed

  1. AClock 1.1
  2. Copyright (c) 2002,2003 Thomas Mathys
  3. killer@vantage.ch
  4.  
  5.  
  6. what the hell is this ?
  7. -----------------------
  8.  
  9. this is aclock, a silly analog clock application
  10. for menuetos (http://www.menuetos.org).
  11.  
  12.  
  13. why do i need it ?
  14. ------------------
  15.  
  16. well, this is certainly one of the last programs on
  17. earth you'd ever need. anyway, it demonstrates how
  18. how to do certain things:
  19.  
  20. - writing menuet apps that parse the command line.
  21.   includes a strtok-like function that you might
  22.   want to use in own projects. or maybe rather not.
  23. - writing menuet apps that are aware of the current
  24.   window size and that have no problems with different
  25.   skin heights.
  26. - how to write menuet apps with nasm instead of fasm
  27.   (there should be a gas version aswell, don't you think ?)
  28.   and how to write kick-ass code with nasm in general =)
  29.  
  30.  
  31. compiling instructions
  32. ----------------------
  33.  
  34. yes, it's still written for nasm.
  35. i really can't be bothered to work with fasm.
  36.  
  37. oh yes, you wanted to know how to compile aclock:
  38.  
  39.         nasm -t -f bin -o aclock aclock.asm
  40.        
  41. if you get error messages like
  42.  
  43.         nasm: unrecognised option `-t
  44.         type `nasm -h' for help
  45.  
  46. then you've got an old version of nasm.
  47. get a newer version (0.98.36 or later) from
  48. http://nasm.sourceforge.net
  49.  
  50.  
  51. configuration
  52. -------------
  53.  
  54. you might want to change some of the constants defined
  55. somewhere at the top of aclock.asm. the following might
  56. be useful:
  57.  
  58.         -       DEFAULT_XPOS
  59.         -       DEFAULT_YPOS
  60.         -       DEFAULT_WIDTH
  61.         -       DEFAULT_HEIGHT
  62.         -       MIN_WIDTH
  63.         -       MIN_HEIGHT
  64.        
  65. for more info about DEFAULT_XPOS/DEFAULT_YPOS see next
  66. section.
  67.  
  68.  
  69. usage
  70. -----
  71.  
  72. this version of AClock introduces command line parameters.
  73. here's an example command line:
  74.  
  75.         aclock w128 h128 x20 y-20
  76.        
  77. this creates a window that is 128 pixels wide and 128 pixels
  78. high (that's for the work area, without border/title bar).
  79. the window is placed at x=20, y=screen resolution-20
  80. (because of the minus sign after the y).
  81.  
  82. all parameters are optional and may appear in any order.
  83. you can't have any whitespaces in a parameter, e.g.
  84. "w 128" is an invalid parameter (which will simply be ignored).
  85. the command line parser is case sensitive.
  86.