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