core/smn_sorting.cpp
author David Anderson <dvander@alliedmods.net>
Wed Aug 01 02:12:47 2007 +0000 (2007-08-01)
changeset 1231 17badaf66ce4
parent 653 ef60870067ff
child 1330 ab94316bb52b
permissions -rw-r--r--
updated more header files (mostly internal now)
dvander@535
     1
/**
ds@653
     2
 * vim: set ts=4 :
dvander@1231
     3
 * ================================================================
dvander@1231
     4
 * SourceMod
dvander@1231
     5
 * Copyright (C) 2004-2007 AlliedModders LLC.  All rights reserved.
dvander@1231
     6
 * ================================================================
dvander@535
     7
 *
dvander@1231
     8
 * This program is free software; you can redistribute it and/or 
dvander@1231
     9
 * modify it under the terms of the GNU General Public License, 
dvander@1231
    10
 * version 3.0, as published by the Free Software Foundation.
dvander@1231
    11
 * 
dvander@1231
    12
 * This program is distributed in the hope that it will be useful,
dvander@1231
    13
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
dvander@1231
    14
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
dvander@1231
    15
 * GNU General Public License for more details.
dvander@1231
    16
 *
dvander@1231
    17
 * You should have received a copy of the GNU General Public License
dvander@1231
    18
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
dvander@1231
    19
 *
dvander@1231
    20
 * As a special exception, AlliedModders LLC gives you permission to 
dvander@1231
    21
 * link the code of this program (as well as its derivative works) to 
dvander@1231
    22
 * "Half-Life 2," the "Source Engine," the "SourcePawn JIT," and any 
dvander@1231
    23
 * Game MODs that run on software by the Valve Corporation.  You must 
dvander@1231
    24
 * obey the GNU General Public License in all respects for all other 
dvander@1231
    25
 * code used. Additionally, AlliedModders LLC grants this exception 
dvander@1231
    26
 * to all derivative works. AlliedModders LLC defines further 
dvander@1231
    27
 * exceptions, found in LICENSE.txt (as of this writing, version 
dvander@1231
    28
 * JULY-31-2007), or <http://www.sourcemod.net/license.php>.
dvander@535
    29
 *
dvander@535
    30
 * Version: $Id$
dvander@535
    31
 */
dvander@535
    32
dvander@535
    33
#include "sm_globals.h"
dvander@535
    34
#include <IHandleSys.h>
dvander@535
    35
#include <stdlib.h>
dvander@603
    36
#include <string.h>
dvander@535
    37
dvander@535
    38
/***********************************
dvander@535
    39
 *   About the double array hack   *
dvander@535
    40
     ***************************   
dvander@535
    41
dvander@535
    42
 Double arrays in Pawn are vectors offset by the current offset.  For example:
dvander@535
    43
dvander@535
    44
 new array[2][2]
dvander@535
    45
dvander@535
    46
   In this array, index 0 contains the offset from the current offset which
dvander@535
    47
 results in the final vector [2] (at [0][2]).  Meaning, to dereference [1][2], 
dvander@535
    48
 it is equivalent to:
dvander@535
    49
dvander@535
    50
 address = &array[1] + array[1] + 2 * sizeof(cell)
dvander@535
    51
dvander@535
    52
   The fact that each offset is from the _current_ position rather than the _base_
dvander@535
    53
 position is very important.  It means that if you to try to swap vector positions,
dvander@535
    54
 the offsets will no longer match, because their current position has changed.  A 
dvander@535
    55
 simple and ingenious way around this is to back up the positions in a separate array,
dvander@535
    56
 then to overwrite each position in the old array with absolute indices.  Pseudo C++ code:
dvander@535
    57
dvander@535
    58
 cell *array; //assumed to be set to the 2+D array
dvander@535
    59
 cell *old_offsets = new cell[2];
dvander@535
    60
 for (int i=0; i<2; i++)
dvander@535
    61
 {
dvander@535
    62
    old_offsets = array[i];
dvander@535
    63
	array[i] = i;
dvander@535
    64
 }
dvander@535
    65
dvander@535
    66
   Now, you can swap the array indices with no problem, and do a reverse-lookup to find the original addresses.
dvander@535
    67
 After sorting/modification is done, you must relocate the new indices.  For example, if the two vectors in our
dvander@535
    68
 demo array were swapped, array[0] would be 1 and array[1] would be 0.  This is invalid to the virtual machine.
dvander@535
    69
 Luckily, this is also simple -- all the information is there.
dvander@535
    70
dvander@535
    71
 for (int i=0; i<2; i++)
dvander@535
    72
 {
dvander@535
    73
	//get the # of the vector we want to relocate in
dvander@535
    74
	cell vector_index = array[i];			
dvander@535
    75
	//get the real address of this vector
dvander@535
    76
	char *real_address = (char *)array + (vector_index * sizeof(cell)) + old_offsets[vector_index];
dvander@535
    77
	//calc and store the new distance offset
dvander@535
    78
	array[i] = real_address - ( (char *)array + (vector_index + sizeof(cell)) )
dvander@535
    79
 }
dvander@535
    80
dvander@535
    81
 Note that the inner expression can be heavily reduced; it is expanded for readability.
dvander@535
    82
 **********************************/
dvander@535
    83
dvander@535
    84
enum SortOrder
dvander@535
    85
{
dvander@535
    86
	Sort_Ascending = 0,
dvander@535
    87
	Sort_Descending = 1,
dvander@535
    88
};
dvander@535
    89
dvander@535
    90
int sort_ints_asc(const void *int1, const void *int2)
dvander@535
    91
{
dvander@535
    92
	return (*(int *)int1) - (*(int *)int2);
dvander@535
    93
}
dvander@535
    94
dvander@535
    95
int sort_ints_desc(const void *int1, const void *int2)
dvander@535
    96
{
dvander@535
    97
	return (*(int *)int2) - (*(int *)int1);
dvander@535
    98
}
dvander@535
    99
dvander@535
   100
static cell_t sm_SortIntegers(IPluginContext *pContext, const cell_t *params)
dvander@535
   101
{
dvander@535
   102
	cell_t *array;
dvander@535
   103
	cell_t array_size = params[2];
dvander@535
   104
	cell_t type = params[3];
dvander@535
   105
dvander@535
   106
	pContext->LocalToPhysAddr(params[1], &array);
dvander@535
   107
dvander@535
   108
	if (type == Sort_Ascending)
dvander@535
   109
	{
dvander@535
   110
		qsort(array, array_size, sizeof(cell_t), sort_ints_asc);
dvander@535
   111
	} else {
dvander@535
   112
		qsort(array, array_size, sizeof(cell_t), sort_ints_desc);
dvander@535
   113
	}
dvander@535
   114
dvander@535
   115
	return 1;
dvander@535
   116
}
dvander@535
   117
dvander@535
   118
int sort_floats_asc(const void *float1, const void *float2)
dvander@535
   119
{
dvander@535
   120
	float r1 = *(float *)float1;
dvander@535
   121
	float r2 = *(float *)float2;
dvander@535
   122
	
dvander@535
   123
	if (r1 < r2)
dvander@535
   124
	{
dvander@535
   125
		return -1;
dvander@535
   126
	} else if (r2 < r1) {
dvander@535
   127
		return 1;
dvander@535
   128
	} else {
dvander@535
   129
		return 0;
dvander@535
   130
	}
dvander@535
   131
}
dvander@535
   132
dvander@535
   133
int sort_floats_desc(const void *float1, const void *float2)
dvander@535
   134
{
dvander@535
   135
	float r1 = *(float *)float1;
dvander@535
   136
	float r2 = *(float *)float2;
dvander@535
   137
dvander@535
   138
	if (r1 < r2)
dvander@535
   139
	{
dvander@535
   140
		return 1;
dvander@535
   141
	} else if (r2 < r1) {
dvander@535
   142
		return -1;
dvander@535
   143
	} else {
dvander@535
   144
		return 0;
dvander@535
   145
	}
dvander@535
   146
}
dvander@535
   147
dvander@535
   148
static cell_t sm_SortFloats(IPluginContext *pContext, const cell_t *params)
dvander@535
   149
{
dvander@535
   150
	cell_t *array;
dvander@535
   151
	cell_t array_size = params[2];
dvander@535
   152
	cell_t type = params[3];
dvander@535
   153
dvander@535
   154
	pContext->LocalToPhysAddr(params[1], &array);
dvander@535
   155
dvander@535
   156
	if (type == Sort_Ascending)
dvander@535
   157
	{
dvander@535
   158
		qsort(array, array_size, sizeof(cell_t), sort_floats_asc);
dvander@535
   159
	} else {
dvander@535
   160
		qsort(array, array_size, sizeof(cell_t), sort_floats_desc);
dvander@535
   161
	}
dvander@535
   162
dvander@535
   163
	return 1;
dvander@535
   164
}
dvander@535
   165
dvander@535
   166
static cell_t *g_CurStringArray = NULL;
dvander@535
   167
static cell_t *g_CurRebaseMap = NULL;
dvander@535
   168
dvander@535
   169
int sort_strings_asc(const void *blk1, const void *blk2)
dvander@535
   170
{
dvander@535
   171
	cell_t reloc1 = *(cell_t *)blk1;
dvander@535
   172
	cell_t reloc2 = *(cell_t *)blk2;
dvander@535
   173
	
dvander@535
   174
	char *str1 = ((char *)(&g_CurStringArray[reloc1]) + g_CurRebaseMap[reloc1]);
dvander@535
   175
	char *str2 = ((char *)(&g_CurStringArray[reloc2]) + g_CurRebaseMap[reloc2]);
dvander@535
   176
dvander@535
   177
	return strcmp(str1, str2);
dvander@535
   178
}
dvander@535
   179
dvander@535
   180
int sort_strings_desc(const void *blk1, const void *blk2)
dvander@535
   181
{
dvander@535
   182
	cell_t reloc1 = *(cell_t *)blk1;
dvander@535
   183
	cell_t reloc2 = *(cell_t *)blk2;
dvander@535
   184
dvander@535
   185
	char *str1 = ((char *)(&g_CurStringArray[reloc1]) + g_CurRebaseMap[reloc1]);
dvander@535
   186
	char *str2 = ((char *)(&g_CurStringArray[reloc2]) + g_CurRebaseMap[reloc2]);
dvander@535
   187
dvander@535
   188
	return strcmp(str2, str1);
dvander@535
   189
}
dvander@535
   190
dvander@535
   191
static cell_t sm_SortStrings(IPluginContext *pContext, const cell_t *params)
dvander@535
   192
{
dvander@535
   193
	cell_t *array;
dvander@535
   194
	cell_t array_size = params[2];
dvander@535
   195
	cell_t type = params[3];
dvander@535
   196
dvander@535
   197
	pContext->LocalToPhysAddr(params[1], &array);
dvander@535
   198
dvander@535
   199
	/** HACKHACK - back up the old indices, replace the indices with something easier */
dvander@535
   200
	cell_t amx_addr, *phys_addr;
dvander@535
   201
	int err;
dvander@535
   202
	if ((err=pContext->HeapAlloc(array_size, &amx_addr, &phys_addr)) != SP_ERROR_NONE)
dvander@535
   203
	{
dvander@535
   204
		pContext->ThrowNativeErrorEx(err, "Ran out of memory to sort");
dvander@535
   205
	}
dvander@535
   206
dvander@535
   207
	g_CurStringArray = array;
dvander@535
   208
	g_CurRebaseMap = phys_addr;
dvander@535
   209
dvander@535
   210
	for (int i=0; i<array_size; i++)
dvander@535
   211
	{
dvander@535
   212
		phys_addr[i] = array[i];
dvander@535
   213
		array[i] = i;
dvander@535
   214
	}
dvander@535
   215
dvander@535
   216
	if (type == Sort_Ascending)
dvander@535
   217
	{
dvander@535
   218
		qsort(array, array_size, sizeof(cell_t), sort_strings_asc);
dvander@535
   219
	} else {
dvander@535
   220
		qsort(array, array_size, sizeof(cell_t), sort_strings_desc);
dvander@535
   221
	}
dvander@535
   222
dvander@535
   223
	/* END HACKHACK - restore what we damaged so Pawn doesn't throw up.
dvander@535
   224
	 * We'll browse through each index of the array and patch up the distance.
dvander@535
   225
	 */
dvander@535
   226
	for (int i=0; i<array_size; i++)
dvander@535
   227
	{
dvander@535
   228
		/* Compute the final address of the old array and subtract the new location.
dvander@535
   229
		 * This is the fixed up distance.
dvander@535
   230
		 */
dvander@535
   231
		array[i] = ((char *)&array[array[i]] + phys_addr[array[i]]) - (char *)&array[i];
dvander@535
   232
	}
dvander@535
   233
dvander@535
   234
	pContext->HeapPop(amx_addr);
dvander@535
   235
dvander@535
   236
	g_CurStringArray = NULL;
dvander@535
   237
	g_CurRebaseMap = NULL;
dvander@535
   238
dvander@535
   239
	return 1;
dvander@535
   240
}
dvander@535
   241
dvander@535
   242
struct sort_info
dvander@535
   243
{
dvander@535
   244
	IPluginFunction *pFunc;
dvander@535
   245
	Handle_t hndl;
dvander@535
   246
	cell_t array_addr;
dvander@535
   247
	cell_t *array_base;
dvander@535
   248
	cell_t *array_remap;
dvander@535
   249
};
dvander@535
   250
dvander@535
   251
sort_info g_SortInfo;
dvander@535
   252
dvander@535
   253
int sort1d_amx_custom(const void *elem1, const void *elem2)
dvander@535
   254
{
dvander@535
   255
	cell_t c1 = *(cell_t *)elem1;
dvander@535
   256
	cell_t c2 = *(cell_t *)elem2;
dvander@535
   257
dvander@535
   258
	cell_t result = 0;
dvander@535
   259
	IPluginFunction *pf = g_SortInfo.pFunc;
dvander@535
   260
	pf->PushCell(c1);
dvander@535
   261
	pf->PushCell(c2);
dvander@535
   262
	pf->PushCell(g_SortInfo.array_addr);
dvander@535
   263
	pf->PushCell(g_SortInfo.hndl);
dvander@535
   264
	pf->Execute(&result);
dvander@535
   265
dvander@535
   266
	return result;
dvander@535
   267
}
dvander@535
   268
dvander@535
   269
static cell_t sm_SortCustom1D(IPluginContext *pContext, const cell_t *params)
dvander@535
   270
{
dvander@535
   271
	cell_t *array;
dvander@535
   272
	cell_t array_size = params[2];
dvander@535
   273
dvander@535
   274
	IPluginFunction *pFunction = pContext->GetFunctionById(params[3]);
dvander@535
   275
	if (!pFunction)
dvander@535
   276
	{
dvander@535
   277
		return pContext->ThrowNativeError("Function %x is not a valid function", params[3]);
dvander@535
   278
	}
dvander@535
   279
dvander@535
   280
	pContext->LocalToPhysAddr(params[1], &array);
dvander@535
   281
dvander@535
   282
	sort_info oldinfo = g_SortInfo;
dvander@535
   283
dvander@535
   284
	
dvander@535
   285
	g_SortInfo.hndl = params[4];
dvander@535
   286
	g_SortInfo.array_addr = params[1];
dvander@535
   287
	g_SortInfo.array_remap = NULL;
dvander@535
   288
	g_SortInfo.array_base = NULL;
dvander@535
   289
	g_SortInfo.pFunc = pFunction;
dvander@535
   290
dvander@535
   291
	qsort(array, array_size, sizeof(cell_t), sort1d_amx_custom);
dvander@535
   292
dvander@535
   293
	g_SortInfo = oldinfo;
dvander@535
   294
dvander@535
   295
	return 1;
dvander@535
   296
}
dvander@535
   297
dvander@535
   298
int sort2d_amx_custom(const void *elem1, const void *elem2)
dvander@535
   299
{
dvander@535
   300
	cell_t c1 = *(cell_t *)elem1;
dvander@535
   301
	cell_t c2 = *(cell_t *)elem2;
dvander@535
   302
dvander@535
   303
	cell_t c1_addr = g_SortInfo.array_addr + (c1 * sizeof(cell_t)) + g_SortInfo.array_remap[c1];
dvander@535
   304
	cell_t c2_addr = g_SortInfo.array_addr + (c2 * sizeof(cell_t)) + g_SortInfo.array_remap[c2];
dvander@535
   305
dvander@535
   306
	IPluginContext *pContext = g_SortInfo.pFunc->GetParentContext();
dvander@535
   307
	cell_t *c1_r, *c2_r;
dvander@535
   308
	pContext->LocalToPhysAddr(c1_addr, &c1_r);
dvander@535
   309
	pContext->LocalToPhysAddr(c2_addr, &c2_r);
dvander@535
   310
dvander@535
   311
	cell_t result = 0;
dvander@535
   312
	g_SortInfo.pFunc->PushCell(c1_addr);
dvander@535
   313
	g_SortInfo.pFunc->PushCell(c2_addr);
dvander@535
   314
	g_SortInfo.pFunc->PushCell(g_SortInfo.array_addr);
dvander@535
   315
	g_SortInfo.pFunc->PushCell(g_SortInfo.hndl);
dvander@535
   316
	g_SortInfo.pFunc->Execute(&result);
dvander@535
   317
dvander@535
   318
	return result;
dvander@535
   319
}
dvander@535
   320
dvander@535
   321
static cell_t sm_SortCustom2D(IPluginContext *pContext, const cell_t *params)
dvander@535
   322
{
dvander@535
   323
	cell_t *array;
dvander@535
   324
	cell_t array_size = params[2];
dvander@535
   325
	IPluginFunction *pFunction;
dvander@535
   326
dvander@535
   327
	pContext->LocalToPhysAddr(params[1], &array);
dvander@535
   328
dvander@535
   329
	if ((pFunction=pContext->GetFunctionById(params[3])) == NULL)
dvander@535
   330
	{
dvander@535
   331
		return pContext->ThrowNativeError("Function %x is not a valid function", params[3]);
dvander@535
   332
	}
dvander@535
   333
dvander@535
   334
	/** back up the old indices, replace the indices with something easier */
dvander@535
   335
	cell_t amx_addr, *phys_addr;
dvander@535
   336
	int err;
dvander@535
   337
	if ((err=pContext->HeapAlloc(array_size, &amx_addr, &phys_addr)) != SP_ERROR_NONE)
dvander@535
   338
	{
dvander@535
   339
		pContext->ThrowNativeErrorEx(err, "Ran out of memory to sort");
dvander@535
   340
		return 0;
dvander@535
   341
	}
dvander@535
   342
dvander@535
   343
	sort_info oldinfo = g_SortInfo;
dvander@535
   344
dvander@535
   345
	g_SortInfo.pFunc = pFunction;
dvander@535
   346
	g_SortInfo.hndl = params[4];
dvander@535
   347
	g_SortInfo.array_addr = params[1];
dvander@535
   348
	
dvander@535
   349
	/** Same process as in strings, back up the old indices for later fixup */
dvander@535
   350
	g_SortInfo.array_base = array;
dvander@535
   351
	g_SortInfo.array_remap = phys_addr;
dvander@535
   352
	
dvander@535
   353
	for (int i=0; i<array_size; i++)
dvander@535
   354
	{
dvander@535
   355
		phys_addr[i] = array[i];
dvander@535
   356
		array[i] = i;
dvander@535
   357
	}
dvander@535
   358
dvander@535
   359
	qsort(array, array_size, sizeof(cell_t), sort2d_amx_custom);
dvander@535
   360
dvander@535
   361
	/** Fixup process! */
dvander@535
   362
	for (int i=0; i<array_size; i++)
dvander@535
   363
	{
dvander@535
   364
		/* Compute the final address of the old array and subtract the new location.
dvander@535
   365
		 * This is the fixed up distance.
dvander@535
   366
		 */
dvander@535
   367
		array[i] = ((char *)&array[array[i]] + phys_addr[array[i]]) - (char *)&array[i];
dvander@535
   368
	}
dvander@535
   369
dvander@535
   370
	pContext->HeapPop(amx_addr);
dvander@535
   371
dvander@535
   372
	g_SortInfo = oldinfo;
dvander@535
   373
	
dvander@535
   374
	return 1;
dvander@535
   375
}
dvander@535
   376
dvander@535
   377
REGISTER_NATIVES(sortNatives)
dvander@535
   378
{
dvander@535
   379
	{"SortIntegers",			sm_SortIntegers},
dvander@535
   380
	{"SortFloats",				sm_SortFloats},
dvander@535
   381
	{"SortStrings",				sm_SortStrings},
dvander@535
   382
	{"SortCustom1D",			sm_SortCustom1D},
dvander@535
   383
	{"SortCustom2D",			sm_SortCustom2D},
dvander@535
   384
	{NULL,						NULL},
dvander@535
   385
};