Differences

This shows you the differences between two versions of the page.

--- public:t-gede-15-1:lab1 [2015/01/10 09:53] – [Preparation] marino
+++ public:t-gede-15-1:lab1 [2024/04/29 13:33] (current) – external edit 127.0.0.1
@@ Line 23: / Line 23: @@
 </box>
   - **Change your build output directory:** Configuration Properties->General->Output Directory\\ Add ''$(ProjectName)\'' at the end of the output directory so it will look like:''$(SolutionDir)$(Configuration)\$(ProjectName)\''\\ This will help with organizing the builds for each lab project.{{ :public:t-gede-14-1:gede_lab1_outputdir.png?nolink |}}
-  - **Add additional include libraries:** C/C++->General->Additional Include Directories =<code>$(OGRE_HOME)\include\OIS;$(OGRE_HOME)\include\OGRE;$(OGRE_HOME)\include;$(OGRE_HOME)\boost;%(AdditionalIncludeDirectories)</code> <box red 100% | Note: >If the C/C++ tab is missing. For some reason, with some versions of Visual Studio you will need to have created a cpp file in order to get the C/C++ tab in the configuration properties, so adding a main.cpp file with a basic "hello world" to the project and building it will suffice. )
+  - **Add additional include libraries:** C/C++->General->Additional Include Directories = **Notice, for all configurations!**<code>$(OGRE_HOME)\include\OIS;$(OGRE_HOME)\include\OGRE;$(OGRE_HOME)\include;$(OGRE_HOME)\boost;%(AdditionalIncludeDirectories)</code> <box red 100% | Note: >If the C/C++ tab is missing. For some reason, with some versions of Visual Studio you will need to have created a cpp file in order to get the C/C++ tab in the configuration properties, so adding a main.cpp file with a basic "hello world" to the project and building it will suffice. )
 </box>{{ :public:t-gede-14-1:gede_lab1_additional_include_directories.png?nolink |}}
   - **Add connections to additional Ogre and input libraries:** Linker->Input->Additional Dependencies  <code>Debug:   OgreMain_d.lib;OIS_d.lib;%(AdditionalDependencies)
@@ Line 32: / Line 32: @@
   - **If you are using a different version of Visual studio than 2010,** make sure to be using the vc100 toolset <code>Project Configuration->General->Platform Toolset = Visual Studio 2010 (v100)
 </code> <box red 100% | Note: >If the v100 toolset is not available, you will need to install VS 2010 express, whether you use it or not, or at least the correct VC++ toolset</box>{{ :public:t-gede-14-1:gede_lab1_toolset_v100.png?nolink |}}
-  - <box green 100% | **2. An early Bonus pt :),** Lets reuse the blasted resources and plugins files. !>
+  - **Set up the engine configuration files.**
-   - **Create a folder** somewhere in your filesystem to hold the ''resources_d.cfg, plugins_d.cfg and Models folder'' and copy the above mentioned files and folders to the folder you create.
+    - Now navigate to your solution folder ''In my case: C:\Code\GEDE2015_Ogre_Labs'' and create a new Folder called ''LabFiles'',
-   - **Change the following lines in your code:** dont forget to make the backslashes forward slashes, and repeating them for the sake of c++ strings escape characters.<code cpp>
+    - In the folder LabFiles, create another folder called ''OgreConfig''
-MyApplication::startUp {
+    - In ''<OGRE SDK folder(same as OGRE_HOME)>/bin/debug/'' you will find two files ''resources_d.cfg'' and ''plugins_d.cfg'', copy those two into the folder ''OgreConfig'' from the previous step.  <box green 100% | Note: >Plugins_d.cfg directs the Ogre application to what modules and plugins it should load (Rendering engine, scene manager etc...). The resources however are what the Ogre application uses (such as 3D models, shaders, particle systems). We put them in a separate directory so that we can reuse the configurations between projects.</box>
-	// Make an absalute path to the folder you created, in my instance it was "C:\OgreCfg\filename"
+    - One final thing before we can start coding, edit the resources_d.cfg file, and replace all instances of ''../..'' with the path to the root of your Ogre SDK(again same as OGRE_HOME).
-	_root = new Ogre::Root("C://OgreCfg//plugins_d.cfg");
+    - We will be adding more files to the ''LabFiles'' Please try to keep file and folder names the same as in the examples so it won't be a nightmare for me to review them :)
-	// ..
-}
-MyApplication::loadResources {
-	Ogre::ConfigFile cf;
-	// Make an absalute path to the folder you created, in my instance it was "C:\OgreCfg\filename"
-	cf.load("C://OgreCfg//resources_d.cfg");
-	// ...
-}
-</code>
 ===== Lab Project =====
 You should now follow the guide from "Ogre3D 1.7 Beginners Guide by Felix Kerger" which you can get {{:public:t-gede-14-1:ogrestartup_ogre3d_1.7_beginners_guide_chapter_9_by_felix_kerger.pdf|Here}}.\\  For this Lab we will only do the sections 1 - 3 of the Ogre 3D beginners Guide. The rest will be covered in the next Lab assignment.\\
 The first 2 labs will be following this guide and getting familiar with the Ogre3D environment.
-<box red 100% | Note:>
+<box red 100% | Important:>
+In step 1.2 change the path from ''plugins_d.cfg'' to ''../LabFiles/OgreConfig/plugins_d.cfg''
+<code cpp>
+Ogre::Root* root = new Ogre::Root("../LabFiles/OgreConfig/plugins_d.cfg");
+</code>
+Additionally in step 3.1 change the path from ''resourcfes_d.cfg'' to ''../LabFiles/OgreConfig/resourcfes_d.cfg''
+<code cpp>
+cf.load("../LabFiles/OgreConfig/resources_d.cfg");
+</code>
 After line 2 in section 2 of the Guide, please add this line to the code. Since the Ogre 1.9 default Scene Manager does not set the ambient light by default like back in 1.7, we have to that our selves.
 <code cpp>
-	sceneManager->setAmbientLight(Ogre::ColourValue(0.3f, 0.3f, 0.3f));
+sceneManager->setAmbientLight(Ogre::ColourValue(0.3f, 0.3f, 0.3f));
 </code>
+A friendly note: In the guide #include ''"OGRE/Ogre.h"'' makes compiler go through a lot of jargon you are not using making compilation times horrible. Try to include only what you need, like so for Ogre::Root* ''#include "OGRE/OgreRoot.h"''.
+When you manage to run your first application and get the configuration dialog after section 1 of the guide, **Do not run it in fullscreen! Especially if you run it through the VS environment :)**
+Finally after you successfully render your first window, black or with Sinbad, do the following.
+  - Navigate to <your solution directory>/(Debug or Release depending what you built). There should be a directory for your first Lab project.
+  - In the first lab directory you should find ''ogre.cfg'', move it to the folder ''<solution dir>/LabFiles/OgreConfig/''
+  - Change the line <code cpp>
+Ogre::Root* root = new Ogre::Root("../LabFiles/OgreConfig/plugins_d.cfg");
+to
+Ogre::Root* root = new Ogre::Root("../LabFiles/OgreConfig/plugins_d.cfg","../LabFiles/OgreConfig/ogre.cfg");
+</code>
+  - This will guarantee that you will always be using the same configuration for all runs independent of the project you are working on.
 </box>
 Your final results should look something like this:
 {{ :public:t-gede-14-1:gede_lab1_final_example.png?nolink |}}
 ===== CODE =====
 <code cpp>
- #include "OGRE/Ogre.h"
+#include "OGRE/OgreRoot.h"
+#include "OGRE/OgreSceneManager.h"
- int main()
+#include "OGRE/OgreSceneNode.h"
+#include "OGRE/OgreRenderWindow.h"
+#include "OGRE/OgreConfigFile.h"
+#include "OGRE/OgreEntity.h"
+int main()
  {
- 	Ogre::Root* root = new Ogre::Root("plugins_d.cfg");
+ 	Ogre::Root* root = new Ogre::Root("../LabFiles/OgreConfig/plugins_d.cfg","../LabFiles/OgreConfig/ogre.cfg");
 	if(!root->showConfigDialog()) {
 		return -1;
 	}
 	Ogre::RenderWindow* window = root->initialise(true, "Ogre3D Beginners Guide");
 	Ogre::SceneManager* sceneManager = root->createSceneManager(Ogre::ST_GENERIC);
 	Ogre::Camera* camera = sceneManager->createCamera("Camera");
 	camera->setPosition(Ogre::Vector3(0,0,30));
 	camera->lookAt(Ogre::Vector3(0,0,0));
 	camera->setNearClipDistance(5);
 	Ogre::Viewport* viewport = window->addViewport(camera);
 	viewport->setBackgroundColour(Ogre::ColourValue(0.0,0.0,0.0));
 	camera->setAspectRatio(Ogre::Real(viewport->getActualWidth())/Ogre::Real(viewport->getActualHeight()));
-	//Ogre::ResourceGroupManager::getSingleton().addResourceLocation("/Ogre SDK/OgreSDK_vc10_v1-8-1/media/packs/Sinbad.zip","Zip");
 	Ogre::String sectionName, typeName, dataName;
 	Ogre::ConfigFile cf;
-	cf.load("resources_d.cfg");
+	cf.load("../LabFiles/OgreConfig/resources_d.cfg");
 	Ogre::ConfigFile::SectionIterator sectionIter = cf.getSectionIterator();
 	while(sectionIter.hasMoreElements()) {
 		sectionName = sectionIter.peekNextKey();
@@ Line 108: / Line 124: @@
 		}
 	}
 	Ogre::ResourceGroupManager::getSingleton().initialiseAllResourceGroups();
 	Ogre::Entity* ent = sceneManager->createEntity("Sinbad.mesh");
 	sceneManager->getRootSceneNode()->attachObject(ent);
 	sceneManager->setAmbientLight(Ogre::ColourValue(.3f,.3f,.3f));
 	root->startRendering();
 	return 0;
- }
+}
 </code>
 ===== When You Are Finished =====
-Upload your source files into Lab1 in MySchool (zip them up if more than one). The lab projects will not be graded, but their completion counts towards your labs grade.
+This lab projects will not be graded, but their completion counts towards your labs grade.
-And check out the next [[public:t-gede-15-1:lab2|Lab]] :)