Browse Source

neko.vm.Ui.hx documentation

http://nekovm.org/doc/view/ui
Mark Knol 10 years ago
parent
commit
e05f8d99a3
1 changed files with 23 additions and 1 deletions
  1. 23 1
      std/neko/vm/Ui.hx

+ 23 - 1
std/neko/vm/Ui.hx

@@ -21,20 +21,42 @@
  */
  */
 package neko.vm;
 package neko.vm;
 
 
+/**
+	Core native User Interface support. This API uses native WIN32 API 
+	on Windows, Carbon API on OSX, and GTK2 on Linux.
+*/
 class Ui {
 class Ui {
 
 
+	/**
+		Tells if the current thread is the main loop thread or not. 
+		The main loop thread is the one in which the first "ui" 
+		library primitive has been loaded.
+	*/
 	public static function isMainThread() {
 	public static function isMainThread() {
 		return _is_main_thread();
 		return _is_main_thread();
 	}
 	}
 
 
+	/**
+		Starts the native UI event loop. This method can only be called 
+		from the main thread.
+	*/
 	public static function loop() {
 	public static function loop() {
 		_loop();
 		_loop();
 	}
 	}
 
 
+	/**
+		Stop the native UI event loop. This method can only be called 
+		from the main thread.
+	*/
 	public static function stopLoop() {
 	public static function stopLoop() {
 		_sync(_stop_loop);
 		_sync(_stop_loop);
 	}
 	}
 
 
+	/**
+		Queue a method call callb to be executed by the main thread while 
+		running the UI event loop. This can be used to perform UI updates 
+		in the UI thread using results processed by another thread.
+	*/
 	public static function sync( f : Void -> Void ) {
 	public static function sync( f : Void -> Void ) {
 		_sync(f);
 		_sync(f);
 	}
 	}
@@ -64,4 +86,4 @@ class Ui {
 	static var _stop_loop = neko.Lib.load("ui","ui_stop_loop",0);
 	static var _stop_loop = neko.Lib.load("ui","ui_stop_loop",0);
 	static var _sync = neko.Lib.load("ui","ui_sync",1);
 	static var _sync = neko.Lib.load("ui","ui_sync",1);
 
 
-}
+}