three.js 源码分析 之 LoadingManager

LoadingManager是一个下载过程中记录、下载完成情况类，当three.js中的一些文件被下载时通过设置LoadingManager可以及时获取当前文件列表中的下载进度
//正在加载的文件管理
     function LoadingManager( onLoad, onProgress, onError ) {
         //设置域
         var scope = this;
         //当前状态为未加载
         var isLoading = false;
 
         var itemsLoaded = 0;
         var itemsTotal = 0;
         var urlModifier = undefined;
        // Refer to #5689 for the reason why we don't set .onStart
         // in the constructor
         //设置回调状态
         this.onStart = undefined;
         this.onLoad = onLoad;
         this.onProgress = onProgress;
         this.onError = onError;
        //单项开始了
         this.itemStart = function ( url ) {
             //下载项总数增加
             itemsTotal ++;
             //如果当前没有下载
             if ( isLoading === false ) {
                 //设置当前开始下载
                 if ( scope.onStart !== undefined ) {
                     //开始下载回调，当前下载的url，当前下载的完的数量，当前下载的总数
                     scope.onStart( url, itemsLoaded, itemsTotal );
                }
            }
             //设置正在下载状态
             isLoading = true;
        };
        //单项结束了
         this.itemEnd = function ( url ) {
             //下载完成，完成数增加
             itemsLoaded ++;
             //设置当前处理完成回调
             if ( scope.onProgress !== undefined ) {
                 //开始下载回调，当前下载的url，当前下载的完的数量，当前下载的总数
                 scope.onProgress( url, itemsLoaded, itemsTotal );
            }
            //总数和下载完成数相同 
             if ( itemsLoaded === itemsTotal ) {
                 //重置下载状态
                 isLoading = false;
                 //回调下载完成回调
                 if ( scope.onLoad !== undefined ) {
 
                     scope.onLoad();
                }
            }
        };
        //单项出现错误了
         this.itemError = function ( url ) {
             //错误回调
             if ( scope.onError !== undefined ) {
                scope.onError( url );
            }
        };
        //设置url解析中间过程
         this.resolveURL = function ( url ) {
            if ( urlModifier ) {
                return urlModifier( url );
            }
            return url;
        };
        //设置url中间转换过程
         this.setURLModifier = function ( transform ) {
            urlModifier = transform;
             return this;
        };
    }