//========= Copyright © 1996-2005, Valve Corporation, All rights reserved. ============// // // Purpose: Implements an interface to the map editor for the execution of // editor shell commands from another application. Commands allow the // creation and deletion of entities, AI nodes, and AI node connections. // // $NoKeywords: $ //=============================================================================// #if !defined(_STATIC_LINKED) || defined(_SHARED_LIB) #if !defined(_X360) && defined(_WIN32) #include #endif #include #include "editor_sendcommand.h" #include "tier1/strtools.h" #include "mathlib/vector.h" #if defined( _X360 ) #include "xbox/xbox_win32stubs.h" #endif // memdbgon must be the last include file in a .cpp file!!! #include "tier0/memdbgon.h" const int MAX_COMMAND_BUFFER = 2048; //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to begin an editing session // of a given map. // Input : pszMapName - Name of the bsp, without the path or extension: "c1a3a_port" // nMapVersion - Map version number, from the BSP file. // Output : Returns Editor_OK on success, an error code if the session was rejected. //----------------------------------------------------------------------------- EditorSendResult_t Editor_BeginSession(const char *pszMapName, int nMapVersion, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "session_begin %s %d", pszMapName, nMapVersion); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to verify the version and // map name being edited. // Input : pszMapName - Name of the bsp, without the path or extension: "c1a3a_port" // nMapVersion - Map version number, from the BSP file. // Output : Returns Editor_OK on success, an error code if the session was rejected. //----------------------------------------------------------------------------- EditorSendResult_t Editor_CheckVersion(const char *pszMapName, int nMapVersion, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "map_check_version %s %d", pszMapName, nMapVersion); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to create an entity at // a given (x, y, z) coordinate. // Input : pszEntity - Class name of entity to create, ie "info_player_start". // x, y, z - World coordinates at which to create entity. // Output : Returns Editor_OK on success, an error code on failure. //----------------------------------------------------------------------------- EditorSendResult_t Editor_CreateEntity(const char *pszEntity, float x, float y, float z, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "entity_create %s %g %g %g", pszEntity, x, y, z); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to create an entity at // a given (x, y, z) coordinate. // Input : pszNodeClass - Class name of node to create, ie "info_node". // nID - Unique ID to assign the node. // x, y, z - World coordinates at which to create node. // Output : Returns Editor_OK on success, an error code on failure. //----------------------------------------------------------------------------- EditorSendResult_t Editor_CreateNode(const char *pszNodeClass, int nID, float x, float y, float z, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "node_create %s %d %g %g %g", pszNodeClass, nID, x, y, z); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to create an entity at // a given (x, y, z) coordinate. // Input : pszNodeClass - Class name of node to create, ie "info_node". // nID - Unique ID to assign the node. // x, y, z - World coordinates at which to create node. // Output : Returns Editor_OK on success, an error code on failure. //----------------------------------------------------------------------------- EditorSendResult_t Editor_CreateNodeLink(int nStartID, int nEndID, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "nodelink_create %d %d", nStartID, nEndID); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to delete an entity at // a given (x, y, z) coordinate. // Input : pszEntity - Class name of entity to delete, ie "info_player_start". // x, y, z - World coordinates of entity to delete. // Output : Returns Editor_OK on success, an error code on failure. //----------------------------------------------------------------------------- EditorSendResult_t Editor_DeleteEntity(const char *pszEntity, float x, float y, float z, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "entity_delete %s %g %g %g", pszEntity, x, y, z); return(Editor_SendCommand(szCommand, bShowUI)); } // sets an arbitrary key/value pair in the entity EditorSendResult_t Editor_SetKeyValue(const char *pszEntity, float x, float y, float z, const char *pKey, const char *pValue, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "entity_set_keyvalue %s %f %f %f \"%s\" \"%s\"", pszEntity, x, y, z, pKey, pValue); return(Editor_SendCommand(szCommand, bShowUI)); } // applies an incremental rotation to an entity EditorSendResult_t Editor_RotateEntity(const char *pszEntity, float x, float y, float z, const QAngle &incrementalRotation, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "entity_rotate_incremental %s %f %f %f %f %f %f", pszEntity, x, y, z, incrementalRotation.x, incrementalRotation.y, incrementalRotation.z ); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to delete an entity at // a given (x, y, z) coordinate. // Input : nID - unique ID of node to delete. // Output : Returns Editor_OK on success, an error code on failure. //----------------------------------------------------------------------------- EditorSendResult_t Editor_DeleteNode(int nID, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "node_delete %d", nID); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to delete an entity at // a given (x, y, z) coordinate. // Input : nStartID - unique ID of one node that the link is connected to. // nEndID - unique ID of the other node that the link is connected to. // Output : Returns Editor_OK on success, an error code on failure. //----------------------------------------------------------------------------- EditorSendResult_t Editor_DeleteNodeLink(int nStartID, int nEndID, bool bShowUI) { char szCommand[MAX_COMMAND_BUFFER]; Q_snprintf(szCommand,sizeof(szCommand), "nodelink_delete %d %d", nStartID, nEndID); return(Editor_SendCommand(szCommand, bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Sends a command to the editor (if running) to end the current remote // editing session. // Output : Returns Editor_OK on success, an error code if the session was rejected. //----------------------------------------------------------------------------- EditorSendResult_t Editor_EndSession(bool bShowUI) { return(Editor_SendCommand("session_end", bShowUI)); } //----------------------------------------------------------------------------- // Purpose: Attempts to sends a shell command to the editor. // Input : pszCommand - Shell command to send. // bShowUI - Whether to display mesage boxes on failure. // Output : Returns one of the following values: // Editor_OK - The command was executed successfully. // Editor_NotRunning - Unable to establish a communications channel with the editor. // Editor_BadCommand - The editor did not accept the command. //----------------------------------------------------------------------------- EditorSendResult_t Editor_SendCommand(const char *pszCommand, bool bShowUI) { #ifdef _WIN32 HWND hwnd = FindWindow("Worldcraft_ShellMessageWnd", "Worldcraft_ShellMessageWnd"); if (hwnd != NULL) { // // Fill out the data structure to send to the editor. // COPYDATASTRUCT CopyData; CopyData.cbData = strlen(pszCommand) + 1; CopyData.dwData = 0; CopyData.lpData = (void *)pszCommand; if (!SendMessage(hwnd, WM_COPYDATA, 0, (LPARAM)&CopyData)) { if (bShowUI) { char szError[1024]; Q_snprintf(szError,sizeof(szError), "Worldcraft did not accept the command: \n\n\"%s\"\n\n Make sure the command is valid and that Worldcraft is still running properly.", pszCommand); MessageBox(NULL, szError, "Editor_SendCommand Error", MB_OK); } return(Editor_BadCommand); } } else { if (bShowUI) { char szError[1024]; Q_snprintf(szError,sizeof(szError), "Could not contact Worldcraft to send the command: \n\n\"%s\"\n\n Worldcraft does not appear to be running.", pszCommand); MessageBox(NULL, szError, "Editor_SendCommand Error", MB_OK); } return(Editor_NotRunning); } #endif return(Editor_OK); } #endif // !_STATIC_LINKED || _SHARED_LIB