f73. preliminary description

git-svn-id: svn://kolibrios.org@2989 a494cfbc-eb01-0410-851d-a64ba20cac60

kernel/branches/Kolibri-acpi/docs/sysfuncs.txt

@@ -203,13 +203,13 @@ Parameters:
     * B=1 - fill background with the color edi
     * Y = Cnnn
       * C=1 redirect the output to the user area, specified in edi
-      * nnn - not used in the current, must be 0 (zero) 
+      * nnn - not used in the current, must be 0 (zero)
   * edx = pointer to the beginning of the string
   * esi = for A=0 length of the string, must not exceed 255;
           for A=1 is ignored
   * edi = color to fill background, if B=1
   * edi = pointer to user area, for redirect, if C=1
-  
+
 Returned value:
   * function does not return value
 Remarks:
@@ -1788,7 +1788,7 @@ Returned value:
   * eax = 0x000000XX - owner of pixel the slot window N
     If incorrect values ebx and ecx then function returns 0
   * The function takes the value from the area [_WinMapAddress]
-  
+
 ======================================================================
 ======= Function 35 - read the color of a pixel on the screen. =======
 ======================================================================
@@ -4135,8 +4135,8 @@ Examples:
   * '/hd0/2/menuet/pics/tanzania.bmp',0
   * '/hd0/1/Program files/NameOfProgram/SomeFile.SomeExtension',0
   * '/sys/MySuperApp.ini',0
-Also function supports relative names.  If the path begins not 
+Also function supports relative names.  If the path begins not
-with '/', it is considered relative to a current folder. To get or 
+with '/', it is considered relative to a current folder. To get or
 set a current folder, use the function 30.
 
 Available subfunctions:
@@ -4539,6 +4539,44 @@ Returned value:
   * eax = 0 - success
   * eax = 1 - buffer is full
 
+======================================================================
+===================== Function 73 - blit bitmap  =====================
+======================================================================
+
+Parameters:
+  * eax = 73 - function number
+
+  * ebx = ROP and optional flags
+     31           6 5  4 3   0
+     [  reserved  ][T][B][ROP]
+     ROP - raster operation code
+        0: Copy
+     1-15: reserved
+     B   - blit into the background surface
+     T   - transparent blit
+
+  * ecx = pointer to the function parametrs
+        destination offset and clipping
+     +0 signed dword: destination rectangle X offset from the window
+                      top-left corner
+     +4 signed dword: destination rectangle Y offset from the window
+                      top-left corner
+     +8 dword:        destination rectangle width
+    +12 dword:        destination rectangle height
+
+        source offset and clipping
+    +16 signed dword: source rectangle X offset from the bitmap top-left corner
+    +20 signed dword: source rectangle Y offset from the bitmap top-left corner
+    +24 dword:        source rectangle width
+    +28 dword:        source rectangle height
+
+    +32: dword: size of the bitmap row in bytes
+    +36: dword: bitmap data - must be 32bpp
+
+Returned value:
+  * function does not return value
+
+
 ======================================================================
 =============== Function -1 - terminate thread/process ===============
 ======================================================================
@@ -4554,6 +4592,7 @@ Remarks:
   * This function terminates the current thread. Other thread can be
     killed by call to subfunction 2 of function 18.
 
+
 ======================================================================
 =========================== List of events ===========================
 ======================================================================