https://wiki.virtualparadise.org/index.php?action=history&feed=atom&title=Vp_query_cell
Vp query cell - Revision history
2026-05-04T21:12:42Z
Revision history for this page on the wiki
MediaWiki 1.42.1
https://wiki.virtualparadise.org/index.php?title=Vp_query_cell&diff=4236&oldid=prev
Sleepy E: Basic layout
2016-12-12T21:06:06Z
<p>Basic layout</p>
<p><b>New page</b></p><div>{{sdk method page|query_cell|Query the objects in a cell.<br />
|paramex=x, z<br />
|parameters=<br />
{{sdk parameter row|int |x |X cell coordinate}}<br />
{{sdk parameter row|int |z |Z cell coordinate}}<br />
|returncodes=<br />
{{sdk return code row|NOT_IN_WORLD |Bot is not currently in a world}}<br />
|behavior=<br />
|caveats=<i>x</i> and <i>z</i> are not the same as object or avatar coordinates. See the example.<br />
|examples=<br />
<syntaxhighlight lang="c"><br />
int cell_from_coordinate(double val)<br />
{<br />
return val < 0 ? static_cast<int>(val) - 1 : static_cast<int>(val);<br />
}<br />
<br />
int query_at(VPInstance sdk, double x, double z)<br />
{<br />
int cell_x, cell_z;<br />
<br />
cell_x = cell_from_coordinate(x);<br />
cell_z = cell_from_coordinate(z);<br />
<br />
return vp_query_cell(sdk, cell_x, cell_z);<br />
}<br />
<br />
void handle_object(VPInstance sdk)<br />
{<br />
const char *model;<br />
<br />
model = vp_string(sdk, VP_OBJECT_MODEL);<br />
<br />
printf("Found a %s in the cell\n", model);<br />
}<br />
<br />
void handle_cell_end(VPInstance sdk)<br />
{<br />
vp_say(sdk, "Query finished!");<br />
}<br />
<br />
int g_owner_session;<br />
double g_owner_x;<br />
double g_owner_z;<br />
<br />
void handle_chat(VPInstance sdk)<br />
{<br />
int session;<br />
<br />
session = vp_int(sdk, VP_AVATAR_SESSION);<br />
<br />
if (session == g_owner_session) // Ignore chat from other people than owner<br />
{<br />
char *str;<br />
<br />
str = vp_string(sdk, VP_CHAT_MESSAGE);<br />
<br />
if (stricmp(str, "query") == 0) // Check if owner wants to query the cell at his/her position<br />
query_at(sdk, g_owner_x, g_owner_z);<br />
}<br />
}<br />
<br />
void handle_avatar_add(VPInstance sdk)<br />
{<br />
int user_id;<br />
<br />
user_id = vp_int(sdk, VP_USER_ID);<br />
if (user_id == vp_int(sdk, VP_MY_USER_ID))<br />
{<br />
g_owner_session = vp_int(sdk, VP_AVATAR_SESSION);<br />
}<br />
}<br />
<br />
void handle_avatar_change(VPInstance sdk) // Keep track of where the owner of the bot is at in the world<br />
{<br />
int session;<br />
<br />
session = vp_int(sdk, VP_AVATAR_SESSION);<br />
<br />
if (session == g_owner_session)<br />
{<br />
g_owner_x = vp_double(sdk, VP_AVATAR_X);<br />
g_owner_z = vp_double(sdk, VP_AVATAR_Z);<br />
}<br />
}<br />
<br />
int main(int argc, const char* argv[])<br />
{<br />
<br />
//...<br />
<br />
vp_event_set(sdk, VP_EVENT_OBJECT, handle_object);<br />
vp_event_set(sdk, VP_EVENT_CELL_END, handle_cell_end);<br />
vp_event_set(sdk, VP_EVENT_CHAT, handle_chat);<br />
vp_event_set(sdk, VP_EVENT_AVATAR_ADD, handle_avatar_add);<br />
vp_event_set(sdk, VP_EVENT_AVATAR_CHANGE, handle_avatar_change);<br />
<br />
//...<br />
}<br />
</syntaxhighlight><br />
|seealso=<br />
* {{sdk method|query_cell_revision}}<br />
* {{sdk event|OBJECT}}<br />
* {{sdk event|CELL_END}}<br />
}}</div>
Sleepy E