roAssetRealizer

this object contains functions for realizing files (i e extracting files from an asset pool and placing them into the standard file directory) realizing a complete asset pool is not recommended because the process can be slow instead, the script should retrieve pool file locations using the roassetpoolfiles object and use them to refer to files directly the roassetrealizer object is still useful for realizing files that must be in the root directory to work (e g autorun and firmware update files) the javascript equivalent is assetrealizer docid\ xnl0us14gwg7euiz2xsdm object creation the roassetrealizer object requires two parameters upon creation an roassetpool object and a destination directory createobject("roassetrealizer", pool as roassetpool, destination directory as string) example pool = createobject("roassetpool", "pool") realizer = createobject ("roassetrealizer", pool, "/") ifuserdata setuserdata(user data as object) sets the user data that will be returned when events are raised getuserdata() as object returns the user data that has previously been set via setuserdata() it will return invalid if no data has been set ifassetrealizer getfailurereason() as string yields additional useful information if a function return indicates an error estimaterealizedsizeinmegabytes(spec as object) as integer returns the estimated amount of space that would be taken up by the specified sync spec realize(spec as rosyncspec/roassetcollection) as roassetrealizerevent places the files into the destination directory specified in the passed rosyncspec or roassetcollection if the pool does not contain the full set of required files, then this method will immediately fail before any files are changed (this method attempts to do as much work as possible before destructively modifying the file system) this method automatically checks the length of the file and any hashes that match the specification if there is a mismatch, then the affected file is deleted and realization fails this method indicates success or failure by returning an roassetrealizerevent object the pool and the destination must be in the same file system validatefiles(spec as object, options as object) as roassociativearray checks the hash of every file in the spec against the corresponding file in the destination path and returns an associative array containing each mismatched file name mapped to the reason the options parameter is an roassociativearray , which can currently support a single option "deletecorrupt" automatically deletes any files that do not match the expected hash by default, these files are not deleted