Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revisionBoth sides next revision | ||
op2_sdk:textdialogbox [2016/03/28 02:28] – vagabond | op2_sdk:textdialogbox [2016/03/28 13:35] – vagabond | ||
---|---|---|---|
Line 14: | Line 14: | ||
Rich Text Format documents include metadata such as font and text color which are not available in text (.txt) format. Depending on the program used to open an RTF, the metadata may be hidden. Microsoft Word and Wordpad will default to showing just the text and the effect of the metadata on the text. Notepad or Notepad++ will show all of the metadata. | Rich Text Format documents include metadata such as font and text color which are not available in text (.txt) format. Depending on the program used to open an RTF, the metadata may be hidden. Microsoft Word and Wordpad will default to showing just the text and the effect of the metadata on the text. Notepad or Notepad++ will show all of the metadata. | ||
- | Outpost 2 uses Arial font size 10 for Campaign Mission Briefing Screens. | + | For campaign mission briefing screens, |
- | **Note:** //Although Microsoft Word can create and save RTF documents, it is not recommended. Microsoft Word adds large amounts of metadata to the document that is not necessary for Outpost 2, typically increasing a small amount of text from about 3 kb to about 50 kb.// | + | Typically, the RTF file is saved as briefing.rtf and added to the root directory of the scenario' |
+ | |||
+ | **Note:** //Although Microsoft Word can create and save RTF documents, it is not recommended. Microsoft Word adds large amounts of metadata to the document that is not necessary for Outpost 2, typically increasing a small amount of text from about 3 kb to about 50 kb. This file size increase will carry into the compiled DLL.// | ||
**Example RTF file** | **Example RTF file** | ||
Line 43: | Line 45: | ||
===== Adding a Resource Script (.rc) File ===== | ===== Adding a Resource Script (.rc) File ===== | ||
- | Microsoft Visual Studio will autogenerate | + | Resource script files are text documents describing resources associated with an executable or DLL. These include among other things Version Information, |
+ | |||
+ | To add a resource script file and associated resource header: | ||
+ | |||
+ | right click on your project in the solution explorer. | ||
+ | |||
+ | Resource Scripts by default is placed in the Resource Files filter in the Solution Explorer. Use the Solution Explorer (or your favorite text editor) to open the file file in text view. You can also access the Resource Script from the Visual Studio Resource View, which defaults to opening on the left side of Visual Studio. The Resource View allows graphical depiction of Dialog Boxes defined in the resource script file. Alternative programs like Resource Hacker can also load Resource Scripts. | ||
- | #ifdef // | + | Below is a sample resource script file that provides a dialog box before a scenario is initialized. The dialog box will include |
For more information on TEXTINCLUDE, | For more information on TEXTINCLUDE, | ||
+ | |||
+ | #ifdef // | ||
+ | |||
+ | #ifndef // | ||
+ | |||
+ | #undef // | ||
<code cpp> | <code cpp> | ||
Line 59: | Line 73: | ||
// Generated from the TEXTINCLUDE 2 resource. | // Generated from the TEXTINCLUDE 2 resource. | ||
// | // | ||
- | #include "afxres.h" | + | #include "winres.h" |
///////////////////////////////////////////////////////////////////////////// | ///////////////////////////////////////////////////////////////////////////// | ||
Line 120: | Line 134: | ||
2 TEXTINCLUDE | 2 TEXTINCLUDE | ||
BEGIN | BEGIN | ||
- | "# | + | "# |
" | " | ||
END | END | ||
Line 243: | Line 257: | ||
#endif | #endif | ||
+ | </ | ||
+ | |||
+ | ===== Creating the Dialog Box in Code ===== | ||
+ | |||
+ | Once the resource script and resource header have been well formed, the briefing screen should be called from the beginning of '' | ||
+ | |||
+ | First, you will require a handle to the DLL instance from DllMain. | ||
+ | |||
+ | **DllMain.cpp** | ||
+ | <code cpp> | ||
+ | #define WIN32_LEAN_AND_MEAN | ||
+ | #include < | ||
+ | |||
+ | // Used by the scenario briefing screen. | ||
+ | HINSTANCE hInst; | ||
+ | |||
+ | BOOL APIENTRY DllMain(HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved) | ||
+ | { | ||
+ | if (fdwReason == DLL_PROCESS_ATTACH) | ||
+ | { | ||
+ | DisableThreadLibraryCalls(hinstDLL); | ||
+ | hInst = hinstDLL; | ||
+ | } | ||
+ | |||
+ | return TRUE; | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | **briefigin.h** | ||
+ | <code cpp> | ||
+ | #pragma once | ||
+ | |||
+ | #define WIN32_LEAN_AND_MEAN | ||
+ | #include < | ||
+ | |||
+ | #include < | ||
+ | #include " | ||
+ | #include " | ||
+ | |||
+ | void ShowBriefing(); | ||
+ | LRESULT CALLBACK DialogProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam); | ||
+ | </ | ||
+ | |||
+ | **briefing.cpp** | ||
+ | <code cpp> | ||
+ | #include " | ||
+ | |||
+ | extern HINSTANCE hInst; | ||
+ | |||
+ | // Briefing source code is pulled from Plymouth Cold War Scenario and was written by BlackBox. | ||
+ | void ShowBriefing() | ||
+ | { | ||
+ | // OP2 turns off the skinning before the game loads. | ||
+ | // We have to re-enable it (otherwise the briefing box will look ugly). | ||
+ | wplEnable(); | ||
+ | // Show the dialog box, using the shell window as the parent | ||
+ | HWND shellWnd = FindWindow(" | ||
+ | DialogBoxParam(hInst, | ||
+ | // Turn off the skinning again (probably not needed but a good idea to do it anyway) | ||
+ | wplDisable(); | ||
+ | } | ||
+ | |||
+ | LRESULT CALLBACK DialogProc(HWND hWnd, UINT msg, WPARAM wParam, LPARAM lParam) | ||
+ | { | ||
+ | HRSRC txtRes = NULL; | ||
+ | HWND richEdit = NULL; | ||
+ | switch (msg) | ||
+ | { | ||
+ | case WM_INITDIALOG: | ||
+ | // Make the BG black in the rich edit box | ||
+ | richEdit = GetDlgItem(hWnd, | ||
+ | SendMessage(richEdit, | ||
+ | |||
+ | // Find the text resource | ||
+ | txtRes = FindResource(hInst, | ||
+ | if (txtRes) | ||
+ | { | ||
+ | // Load it | ||
+ | HGLOBAL resHdl = LoadResource(hInst, | ||
+ | if (resHdl) | ||
+ | { | ||
+ | // Lock it and set the text | ||
+ | char *briefing = (char*)LockResource(resHdl); | ||
+ | if (briefing) | ||
+ | { | ||
+ | SetDlgItemText(hWnd, | ||
+ | return TRUE; | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | SetDlgItemText(hWnd, | ||
+ | return TRUE; | ||
+ | case WM_COMMAND: | ||
+ | if (wParam == IDOK) | ||
+ | { | ||
+ | EndDialog(hWnd, | ||
+ | return TRUE; | ||
+ | } | ||
+ | return FALSE; | ||
+ | } | ||
+ | return FALSE; | ||
+ | } | ||
</ | </ | ||