/**************************************************************************** Copyright (c) 2008-2010 Ricardo Quesada Copyright (c) 2011-2012 cocos2d-x.org Copyright (c) 2013-2014 Chukong Technologies Inc. Copyright (c) 2010 Sangwoo Im http://www.cocos2d-x.org Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ****************************************************************************/ /** * The sortable object interface * @class * @extends cc._Class */ cc.SortableObject = cc._Class.extend(/** @lends cc.SortableObject */{ setObjectID:function (objectId) { }, getObjectID:function () { return 0; } }); /** * The SortedObject class * @class * @extends cc.SortableObject */ cc.SortedObject = cc.SortableObject.extend(/** @lends cc.SortedObject */{ _objectID:0, ctor:function () { this._objectID = 0; }, setObjectID:function (objectID) { this._objectID = objectID; }, getObjectID:function () { return this._objectID; } }); var _compareObject = function (val1, val2) { return (val1.getObjectID() - val2.getObjectID()); }; /** * Array for object sorting utils * @class * @extend cc._Class */ cc.ArrayForObjectSorting = cc._Class.extend(/** @lends cc.ArrayForObjectSorting# */{ _saveObjectArr:null, ctor:function () { this._saveObjectArr = []; }, /** * Inserts a given object into array. * * Inserts a given object into array with key and value that are used in * sorting. "value" must respond to message, compare:, which returns * (NSComparisonResult). If it does not respond to the message, it is appended. * If the compare message does not result NSComparisonResult, sorting behavior * is not defined. It ignores duplicate entries and inserts next to it. * * @function * @param {Object} addObject Object to insert */ insertSortedObject:function (addObject) { if(!addObject) throw new Error("cc.ArrayForObjectSorting.insertSortedObject(): addObject should be non-null."); var idx = this.indexOfSortedObject(addObject); this.insertObject(addObject, idx); }, /*! * Removes an object in array. * * Removes an object with given key and value. If no object is found in array * with the key and value, no action is taken. * * @function * @param {Object} delObject Object to remove */ removeSortedObject:function (delObject) { if (this.count() === 0) { return; } var idx = this.indexOfSortedObject(delObject); if (idx < this.count() && idx !== cc.macro.INVALID_INDEX) { var foundObj = this.objectAtIndex(idx); if (foundObj.getObjectID() === delObject.getObjectID()) { this.removeObjectAtIndex(idx); } } }, /*! * Sets a new value of the key for the given object. * * In case where sorting value must be changed, this message must be sent to * keep consistency of being sorted. If it is changed externally, it must be * sorted completely again. * * @function * @param {Number} tag Tag to set * @param {Object} setObject The object which would be set */ setObjectID_ofSortedObject:function (tag, setObject) { var idx = this.indexOfSortedObject(setObject); if (idx < this.count() && idx !== cc.macro.INVALID_INDEX) { var foundObj = this.objectAtIndex(idx); if (foundObj.getObjectID() === setObject.getObjectID()) { this.removeObjectAtIndex(idx); foundObj.setObjectID(tag); this.insertSortedObject(foundObj); } } }, objectWithObjectID:function (tag) { if (this.count() === 0) { return null; } var foundObj = new cc.SortedObject(); foundObj.setObjectID(tag); var idx = this.indexOfSortedObject(foundObj); if (idx < this.count() && idx !== cc.macro.INVALID_INDEX) { foundObj = this.objectAtIndex(idx); if (foundObj.getObjectID() !== tag) foundObj = null; } return foundObj; }, /*! * Returns an object with given key and value. * * Returns an object with given key and value. If no object is found, * it returns nil. * * @function * @param {Number} tag Tag to locate object * @return {Object|null} */ getObjectWithObjectID:function (tag) { return null; }, /*! * Returns an index of the object with given key and value. * * Returns the index of an object with given key and value. * If no object is found, it returns an index at which the given object value * would have been located. If object must be located at the end of array, * it returns the length of the array, which is out of bound. * * @function * @param {Number} idxObj Id to locate object * @return {Number} index of an object found */ indexOfSortedObject:function (idxObj) { var idx = 0; if (idxObj) { // CCObject* pObj = (CCObject*)bsearch((CCObject*)&object, data.arr, data.num, sizeof(CCObject*), _compareObject); // FIXME: need to use binary search to improve performance var uPrevObjectID = 0; var uOfSortObjectID = idxObj.getObjectID(); var locObjectArr = this._saveObjectArr; for (var i = 0; i < locObjectArr.length; i++) { var pSortableObj = locObjectArr[i]; var curObjectID = pSortableObj.getObjectID(); if ((uOfSortObjectID === curObjectID) || (uOfSortObjectID >= uPrevObjectID && uOfSortObjectID < curObjectID)) { break; } uPrevObjectID = curObjectID; idx++; } } else { idx = cc.macro.INVALID_INDEX; } return idx; }, //implement array method count:function () { return this._saveObjectArr.length; }, lastObject:function () { var locObjectArr = this._saveObjectArr; if (locObjectArr.length === 0) return null; return locObjectArr[locObjectArr.length - 1]; }, objectAtIndex:function (idx) { return this._saveObjectArr[idx]; }, addObject:function (addObj) { this._saveObjectArr.push(addObj); this._saveObjectArr.sort(_compareObject); }, removeObjectAtIndex:function (idx) { this._saveObjectArr.splice(idx, 1); this._saveObjectArr.sort(_compareObject); }, insertObject:function (addObj, idx) { this._saveObjectArr.splice(idx, 0, addObj); this._saveObjectArr.sort(_compareObject); } });