Interface administrators, moderator
2,711
edits
OnResourceReady: Difference between revisions
no edit summary
No edit summary |
No edit summary |
||
| Line 9: | Line 9: | ||
|cancel = false | |cancel = false | ||
|notes = This function is only called when extra files (using the <file> tag in meta.xml) are done downloading. The script files (added with <script> tag) are handled differently, so resource might've already started and running before the extra files are downloaded. You can check this in any script file with [[resource.isStarted]].<br> | |notes = This function is only called when extra files (using the <file> tag in meta.xml) are done downloading. The script files (added with <script> tag) are handled differently, so resource might've already started and running before the extra files are downloaded. You can check this in any script file with [[resource.isStarted]].<br> | ||
This is related to the [[resource.isReady|resource.isReady]] property, which indicates if all a resource's files are finished downloading.<br> | |||
A good example of this is a resource that shows an image on screen. Such a resource would likely load the image with [[openFile]] and [[graphics.loadPNG]] so these functions should be called in an OnResourceReady event handler. If they're called in an [[OnResourceStart|OnResourceStart]] event handler, it might throw an error since the resource has started, but the image file hasn't been downloaded to the client yet. | A good example of this is a resource that shows an image on screen. Such a resource would likely load the image with [[openFile]] and [[graphics.loadPNG]] so these functions should be called in an OnResourceReady event handler. If they're called in an [[OnResourceStart|OnResourceStart]] event handler, it might throw an error since the resource has started, but the image file hasn't been downloaded to the client yet. | ||
|exampleLuaCS = // This example will fade the camera in to show the game world, when the resource is ready. | |exampleLuaCS = // This example will fade the camera in to show the game world, when the resource is ready. | ||