Recent changes to load_image

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Thu, 21 Jun 2012 23:55:17 -0000

--- v8
+++ v9
@@ -1,7 +1,8 @@
 **declaration:**
 
 ~~~~
-load_image(resource, startorder) => VID or BADID
+::lua
+function load_image(resource, startorder) => VID or BADID
 ~~~~
 
 Loads a resource as a image (png preferred) and maps to a VID.
@@ -20,4 +21,5 @@
 If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. 
 
 **related functions:**
+
 [load_image_asynch]

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Thu, 21 Jun 2012 23:34:16 -0000

--- v7
+++ v8
@@ -15,8 +15,9 @@
 show_image(vid);
 ~~~~
 
+**caveats:**
+
+If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. 
+
 **related functions:**
 [load_image_asynch]
-
-**caveats:**
-If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded.

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Thu, 21 Jun 2012 21:03:46 -0000

--- v6
+++ v7
@@ -16,7 +16,7 @@
 ~~~~
 
 **related functions:**
-[load_image_async]
+[load_image_asynch]
 
 **caveats:**
 If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded.

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Sat, 16 Jun 2012 10:50:01 -0000

--- v5
+++ v6
@@ -1,4 +1,4 @@
-**definition:**
+**declaration:**
 
 ~~~~
 load_image(resource, startorder) => VID or BADID

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Sat, 16 Jun 2012 09:13:38 -0000

--- v4
+++ v5
@@ -19,6 +19,4 @@
 [load_image_async]
 
 **caveats:**
-If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. Any error that would have forced [load_image]to return BADID, will result in a blank (32x32) texture.
-
-[surface_storage_properties] an [surface_initial_properties] will not return valid data until the callback has been triggered.
+If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded.

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Sat, 16 Jun 2012 09:12:54 -0000

--- v3
+++ v4
@@ -19,4 +19,6 @@
 [load_image_async]
 
 **caveats:**
-If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. If a reload fails, the image is replaced with an error texture. 
+If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. Any error that would have forced [load_image]to return BADID, will result in a blank (32x32) texture.
+
+[surface_storage_properties] an [surface_initial_properties] will not return valid data until the callback has been triggered.

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Sat, 16 Jun 2012 08:56:23 -0000

--- v2
+++ v3
@@ -1,4 +1,5 @@
 **definition:**
+
 ~~~~
 load_image(resource, startorder) => VID or BADID
 ~~~~
@@ -8,6 +9,7 @@
 The routine is synchronous, so it may block.
 
 **example use:**
+
 ~~~~
 vid = load_image(resource, startorder);
 show_image(vid);

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Sat, 16 Jun 2012 08:55:59 -0000

--- v1
+++ v2
@@ -1,3 +1,4 @@
+**definition:**
 ~~~~
 load_image(resource, startorder) => VID or BADID
 ~~~~
@@ -6,14 +7,14 @@
 The VID has zero opacity (invisible) from the beginning.
 The routine is synchronous, so it may block.
 
-*example use:*
+**example use:**
 ~~~~
 vid = load_image(resource, startorder);
 show_image(vid);
 ~~~~
 
-*related functions:*
+**related functions:**
 [load_image_async]
 
-*caveats:*
+**caveats:**
 If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. If a reload fails, the image is replaced with an error texture.

WikiPage load_image modified by Björn Ståhl

Björn Ståhl — Sat, 16 Jun 2012 08:55:35 -0000

~~~~ load_image(resource, startorder) => VID or BADID ~~~~ Loads a resource as a image (png preferred) and maps to a VID. The VID has zero opacity (invisible) from the beginning. The routine is synchronous, so it may block. *example use:* ~~~~ vid = load_image(resource, startorder); show_image(vid); ~~~~ *related functions:* [load_image_async] *caveats:* If Arcan is launched in memory-conservative mode, a local copy will not be kept in memory. Thus, any context switches, external_launch or image statistics functions may force the file to be reloaded. If a reload fails, the image is replaced with an error texture.