{"id":383,"date":"2021-11-30T21:09:35","date_gmt":"2021-11-30T21:09:35","guid":{"rendered":"https:\/\/writingagame.com\/?p=383"},"modified":"2021-12-04T18:57:03","modified_gmt":"2021-12-04T18:57:03","slug":"chapter-7-external-data-files-windows","status":"publish","type":"post","link":"https:\/\/writingagame.com\/index.php\/2021\/11\/30\/chapter-7-external-data-files-windows\/","title":{"rendered":"Chapter 7. External data files, Windows"},"content":{"rendered":"\n

Now we are ready to start writing real (practically usable) shaders. Right now we have 2 sample (1 vertex and 1 fragment) shaders, that are hard-coded in TheGame.cpp. Obviously, not the best solution, but for simplicity’s sake was quite reasonable. In our turn, we want to keep our shaders outside of the executable.<\/p>\n\n\n\n

1. In Windows File Explorer<\/strong> (not in VS), in C:\\CPP\\engine\\<\/em> folder add sub-folder \u201cdt\u201d (for “data”). Here we will keep all engine-related data files, particularly shaders. Inside of \u201cdt\u201d add sub-folder \u201cshaders\u201d.<\/p>\n\n\n\n

In a Text Editor<\/strong> create a simple txt file for testing, just couple lines, such as<\/p>\n\n\n

\ntest 1\ntest 2\n<\/pre><\/div>\n\n\n

Save it as C:\\CPP\\engine\\dt\\shaders\\test0.txt<\/em><\/p>\n\n\n\n
\n\n\n\n
<\/p>\n\n\n\n
2. Now we need to pass this file to the executable. There are couple options such as including files into “resources” or directly into the project. However, we don’t want data files “inside” of the project. Instead, we will instruct Visual Studio to copy data folder to the same folder as executable.<\/p>\n\n\n\n
Start Visual Studio, open C:\\CPP\\a999hello\\p_windows\\p_windows.sln<\/em> solution.<\/p>\n\n\n\n
\n\n\n\n
<\/p>\n\n\n\n
3. Open  p_windows<\/em> project Properties, All Configurations \/ Win32, Configuration Properties -> Build events -> Post-Build Event<\/em>, open Command Line -> Edit<\/em>.<\/p>\n\n\n\n
Add (copy-paste) following command:<\/p>\n\n\n\n
xcopy \"..\\..\\engine\\dt\\*.*\" \"$(TargetDir)dt\\\" \/E \/R \/D \/y<\/code><\/pre>\n\n\n\n
<\/p>\n\n\n\n
Then – Ok, Apply, Ok<\/strong>.<\/p>\n\n\n\n
Clarification:<\/p>\n\n\n\n
  • xcopy <\/strong>– doesn’t really need an explanation (I guess)<\/li>
  • “..\\..\\engine\\dt\\*.*”<\/strong> \u2013 copy what and from. Refers to C:\\CPP\\engine\\dt<\/em>, just in relative form from  p_windows<\/em>  project root folder<\/li>
  • “$(TargetDir)dt\\”<\/strong> – copy to where. We want a copy of \u201cdt\u201d folder in the same place as executable<\/li><\/ul>\n\n\n\n
    Keys:<\/p>\n\n\n\n
    • \/E<\/strong> – Copy directories and subdirectories, including empty ones<\/li>
    • \/R<\/strong> – Overwrite read-only files<\/li>
    • \/D<\/strong> \u2013 Copy files only if newer<\/li>
    • \/y<\/strong> – Don’t ask if exists\/overwrite<\/li><\/ul>\n\n\n\n
      \n\n\n\n
      <\/p>\n\n\n\n
      4. Now run the program (green arrow). Runs. Now – close the program OR: VS top menu -> Debug -> Stop Debugging<\/em>.<\/p>\n\n\n\n
      Go to Windows File Explorer<\/strong>, open C:\\CPP\\a999hello\\p_windows\\Debug<\/em>. Perfect, the copy of the “dt” folder with all it’s content is there, in the same folder as OurProject.exe<\/em>:<\/p>\n\n\n\n
      <\/p>\n\n\n\n
      <\/p>\n\n\n\n
      \n\n\n\n
      5. Now let’s try to read our test file (test0.txt). For that we need to specify the file’s full<\/strong> path. However, it can vary depending on where program was installed. So, will need to find it out, to detect application’s root folder.<\/p>\n\n\n\n
      The code:<\/p>\n\n\n
      \n    \/\/find application root folder\n    char path[256];\n    GetModuleFileNameA(NULL, path, 256);\n    filesRoot.assign(path);\n    int lastSlashPos = filesRoot.find_last_of('\\\\');\n    if (lastSlashPos < 0)\n        lastSlashPos = filesRoot.find_last_of('\/');\n    filesRoot = filesRoot.substr(0, lastSlashPos);\n    mylog("App path = %s\\n", filesRoot.c_str());\n\n<\/pre><\/div>\n\n\n
      <\/p>\n\n\n\n
      Insert it in main.cpp<\/em> right before theGame.run()<\/em>.<\/p>\n\n\n\n
      Also, add after include section:<\/p>\n\n\n
      \n#include <windows.h>\n#include <string>\n#include <fstream>      \/\/ std::ifstream\n\nstd::string filesRoot;\n\n<\/pre><\/div>\n\n\n
      <\/p>\n\n\n\n
      Run. Result:<\/p>\n\n\n\n
      App path = C:\\CPP\\a999hello\\p_windows\\Debug<\/strong><\/p>\n\n\n\n
      Just what we need. <\/p>\n\n\n\n
      \n\n\n\n
      6. Now let’s open our test file and read it.<\/p>\n\n\n\n
      After mylog(\u2026)<\/em> add following code:<\/p>\n\n\n
      \n    \/\/reading test file\n    std::ifstream myFile(filesRoot + "\/dt\/shaders\/test0.txt");\n    std::string line;\n    if (myFile.is_open())\n    {\n        while (getline(myFile, line))\n            mylog("%s\\n", line.c_str());\n    }\n    else mylog("Unable to open file\\n");\n\n<\/pre><\/div>\n\n\n
      <\/p>\n\n\n\n
      Run. Result:<\/p>\n\n\n\n
      App path = C:\\CPP\\a999hello\\p_windows\\Debug<\/strong>
      test 1
      test 2<\/strong><\/p>\n\n\n\n
      \n\n\n\n
      7. After removing testing code, main.cpp<\/em> (with new filesRoot <\/em>variable and with corresponding code) is:<\/p>\n\n\n
      \n#include <glad\/glad.h>\n#define GLFW_INCLUDE_NONE\n#include <GLFW\/glfw3.h>\n\n#include <stdlib.h>\n\n#include "TheGame.h"\n#include "platform.h"\n\n#include <windows.h>\n#include <string>\n\nstd::string filesRoot;\n\nstatic void error_callback(int error, const char* description)\n{\n    mylog("Error: %s\\n", description);\n}\n\nstatic void key_callback(GLFWwindow* window, int key, int scancode, int action, int mods)\n{\n    if (key == GLFW_KEY_ESCAPE && action == GLFW_PRESS)\n        glfwSetWindowShouldClose(window, GLFW_TRUE);\n}\n\nTheGame theGame;\nGLFWwindow* myMainWindow;\n\nint main(void)\n{\n    glfwSetErrorCallback(error_callback);\n\n    if (!glfwInit())\n        exit(EXIT_FAILURE);\n\n    glfwWindowHint(GLFW_CONTEXT_VERSION_MAJOR, 3);\n    glfwWindowHint(GLFW_CONTEXT_VERSION_MINOR, 2);\n\n    myMainWindow = glfwCreateWindow(640, 480, "OurProject", NULL, NULL);\n    if (!myMainWindow)\n    {\n        glfwTerminate();\n        exit(EXIT_FAILURE);\n    }\n\n    glfwSetKeyCallback(myMainWindow, key_callback);\n\n    glfwMakeContextCurrent(myMainWindow);\n    gladLoadGLES2Loader((GLADloadproc)glfwGetProcAddress); \/\/gladLoadGL(glfwGetProcAddress);\n    glfwSwapInterval(1);\n\n    \/\/find application root folder\n    char path[256];\n    GetModuleFileNameA(NULL, path, 256);\n    filesRoot.assign(path);\n    int lastSlashPos = filesRoot.find_last_of('\\\\');\n    if (lastSlashPos < 0)\n        lastSlashPos = filesRoot.find_last_of('\/');\n    filesRoot = filesRoot.substr(0, lastSlashPos);\n    mylog("App path = %s\\n", filesRoot.c_str());\n    \n    theGame.run();\n\n    glfwDestroyWindow(myMainWindow);\n    glfwTerminate();\n    exit(EXIT_SUCCESS);\n}\n\n<\/pre><\/div>\n\n\n
      <\/p>\n\n\n\n
      Replace  main.cpp<\/em> code by this one.<\/p>\n\n\n\n
      Save All.<\/p>\n\n\n\n
      What’s next? Finally, shaders?? No. First – external data files on Android.<\/p>\n\n\n\n
      \n\n\n\n
      <\/p>\n","protected":false},"excerpt":{"rendered":"
      Now we are ready to start writing real (practically usable) shaders. Right now we have 2 sample (1 vertex and 1 fragment) shaders, that are hard-coded in TheGame.cpp. Obviously, not the best solution, but for simplicity’s sake was quite reasonable. In our turn, we want to keep our shaders outside of the executable. 1. In […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4],"tags":[],"class_list":["post-383","post","type-post","status-publish","format-standard","hentry","category-cross-platform-3d"],"_links":{"self":[{"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/posts\/383","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/comments?post=383"}],"version-history":[{"count":10,"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/posts\/383\/revisions"}],"predecessor-version":[{"id":472,"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/posts\/383\/revisions\/472"}],"wp:attachment":[{"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/media?parent=383"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/categories?post=383"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/writingagame.com\/index.php\/wp-json\/wp\/v2\/tags?post=383"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}