Changes

Team Guardian Cube Mapping

47,426 bytes added, 04:45, 14 April 2011

no edit summary

~~Theory behind the Material Class~~<html xmlns:v="urn:schemas- The material class was originally supposed to encapsulate all material related data, such as textures, colors, reflectivity etc. The intention was to replace a lot of the functionality of graphic, so that an object encapsulates an in world object, graphic encapsulated a static mesh and material described the appearance of a mesh. This way you could have a material attached to many different meshes, so a similar appearance can be applied amongst many objects. This is similar to the approach taken by 3DS Max.microsoft- ~~This approach proved too invasive for others to implement, so now I have made Material a category, which will shift responsibility of drawing the object away from graphic and into Material.~~com:vml"~~How to implement Environmental Cube Mapping1) Download and include the iMaterial.h, Material.h and Material.cpp into your project.~~2) Add the cube map code from the provided FX file into your own FX file. If you will be adding there manually, copy the code between //REF_CUBE_MAP_A# and //END REF_CUBE_MAP_A#, there should be 4 sections to copy in total~~3) Edit the Configuration.h file and add “MATERIAL” to the Category enumeration4) Object is now going to need some adjustments. I’ll break this down into a few components~~xmlns:o="urn:~~• iObject.hI. Add ‘class iMaterial’ to the top of the file with the rest of the declarationsII. Add a virtual getting and setter for the Object’s materialIII. Add two more virtual functions, one called getID, receives an int and returns an int, and second one called resetID which receives an int and returns nothing.• Object.hI. Add a private iMaterial pointer to the object named rMaterial (you could change it to w/e you want, but it won’t be as easy to copy/paste code if you don’t)II. Implement the getter and setter in the in the Object header, in the setter, change the category of the object to MATERIAL.III. Remove the braces after Object’s preDraw() function, we are going to need to implement this function in the cpp.IV. Add a private int array called get cubeMapID, which for this implementation, it can be an array of 2 items, since reflection depth will not be implemented.V. Implement getID and resetID, get id returns the int at level in the cubeMapID array (return cubeMapID[level];) and resetID sets the int at level in the cubeMapID to~~ schemas-1.~~• Object.cppI. Add ‘#include iMaterial.h’ at the top.II. In the object constructor add ‘rMaterial = NULL’, just to be safe, also set cubeMapID [0] and [1] to~~ microsoft-1.com:office:office"~~III. In the object’s~~ xmlns:w= ~~operator, set CubeMapID[0] and [1] to -1.~~IV. In the Object’s attach function, check if the category is set to MATERIAL and that rMaterial isn’t NULL, if true, use Material’s setStage, if category is not set to MATERIALS then use the code already there (Remember, if reading this is confusing, you can always copy the code, this is just trying to explain what to do)V. Above the draw function, add the implementation of the preDraw, which is simple. Check if the category is set to MATERIAL and rMaterial isn’t NULL, if true, set the cubeMapID (at index of rMaterial->getDepth()) to dthe result of rMaterial->getCubeID(this). Finally call the preDraw function on rMaterial and pass it a reference to the object (this), vertexlist pointer, and scene pointer.VI. Mod the Object’s draw function to test if the category is set to MATERIAL, if it is and rMaterial isn’t NULL, call the draw function on the material (passing in the object and scene) in place of using the attach and draw code in the function, the report should occur regardless.~~VII. In the suspend code, check if rMaterial is NULL, if not, call suspend on it. Do the same for release.~~5) Open Display.cpp, #include Material.h and call the static function connectDevice from Material, this will give material access to the device and below, call the static function connectEffect, giving Material access to the effect file.6) The system requires a knowledge of the vertices of the in a mesh, so you have to go to iVertex list and add two virtual functions, ‘int getNumOfVerts()’ and ‘Vertex* getVertitices()’. Now you have to go into the VertexList class, implement these functions to return nVertices and Vertex. You also need to make an implementation for stock mesh, simply give return NULL for both stock mesh implementations. ~~NOTE~~"urn: If you already have your object’s center and radius calculated or easily accessible, you can skip this step and alter the code in the Material class to use that data instead of calculating the center from the vertex list.~~7) Open Design.cpp and #include iMaterial.h. Add scene~~schemas-~~>draw(MATERIAL); to Design’s draw function and scene~~microsoft-~~>draw(MATERIAL); to Design’s preDraw.This will give you the ability to use the Material class with your object to give them a nice reflective or refracting effect.How to use Material~~com:~~To use a material, follow these few steps~~office:word"~~1) Create a Material~~xmlns:~~iMaterial* mat~~ m= ~~CreateMaterial(contextPointer, numberOfStages, numberOfSubsets);NOTES~~"http: ~~if the material only have one stage and subset, only pass in context~~//schemas.microsoft.com/office/2004/12/omml"~~2) Setup the material~~xmlns="http:mat->setup(arrayOfBasicColors, twoDimensionalTextureArray, arrayOfColorsRepresentingReflection, arrayOfRefractionPowers, twoDimensionalArrayOfColorsRepresentingRefraction, ObjectShine, ObjectFlags, ObjectBorderColor);~~NOTE: If you specify only one subset~~/stage, you can simply put in a pointers to this data, but if you specify more than one subset or stage, you must implement the data in an array OR pass in NULL. The alpha channel determines how strong the effect of the reflection or refraction will be, and they are both over-riding effects, reflection being the most over-riding of the two/www. ~~So if refraction’s alpha channel is 1~~w3.~~0, the object’s color and texture will be completely gone, the object will only have the refracted texture on it. If the alpha channel is 0.5, then it will be half refracted texture, half color~~org/TR/diffuse texture. The same works with reflection except that reflection will over-ride refraction, so if an object is 100% refractive and 100% reflective, you will only see the reflection. Where as if the reflection is 50% and refraction is 50%, the distribution of the texture will be 50% reflective, 25% refractive, 25% diffuse. The refractive power float array dictates how much the light bends, so if it is equal to 1.0, the light will not bend at all, where as if it is set to 0.9, it will bend about 10% of the angle of the normal of the fragment.~~3) Set the material onto the object:object~~REC-html40">~~setMaterial(mat);NOTE: this will convert the object to a material object and attach the material.~~

~~A quick example of how to make a glass like cube would be~~<head><meta http-equiv=Content-Type content="text/html; charset=windows-1252"><meta name=ProgId content=Word.Document><meta name=Generator content="Microsoft Word 12"><meta name=Originator content="Microsoft Word 12"><link rel=File-Listhref="How%20to%20implement%20Environmental%20Cube%20Mapping_files/filelist.xml"><link rel=themeDatahref="How%20to%20implement%20Environmental%20Cube%20Mapping_files/themedata.thmx"><link rel=colorSchemeMappinghref="How%20to%20implement%20Environmental%20Cube%20Mapping_files/colorschememapping.xml"><style></style></head>

<body lang=EN-CA style='tab-interval:36.0pt'> <div class=WordSection1> Theory behind the Material Class: <![if !supportLists]><spanstyle='mso-ascii-font-family:Calibri;mso-fareast-font-family:Calibri;mso-hansi-font-family:Calibri;mso-bidi-font-family:Calibri'><spanstyle='mso-list:Ignore'>-         <![endif]>The material class was originally supposed to encapsulateall material related data, such as textures, colors, reflectivity etc. Theintention was to replace a lot of the functionality of graphic, so that anobject encapsulates an in world object, graphic encapsulated a static mesh and materialdescribed the appearance of a mesh. Thisway you could have a material attached to many different meshes, so a similarappearance can be applied amongst many objects. This is similar to the approachtaken by 3DS Max. <![if !supportLists]><spanstyle='mso-ascii-font-family:Calibri;mso-fareast-font-family:Calibri;mso-hansi-font-family:Calibri;mso-bidi-font-family:Calibri'><spanstyle='mso-list:Ignore'>-         <![endif]>This approach proved too invasive for others toimplement, so now I have made Material a category, which will shiftresponsibility of drawing the object away from graphic and into Material. How to implement Environmental Cube Mapping <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>1)     <![endif]>Download and include the iMaterial.h,Material.h and Material.cpp into your project. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>2)     <![endif]>Add the cube map code from the provided FX fileinto your own FX file. If you will be adding there manually, copy the codebetween //REF_CUBE_MAP_A# and //END REF_CUBE_MAP_A#, there should be 4 sectionsto copy in total <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>3)     <![endif]>Edit the Configuration.hfile and add “MATERIAL” to the Categoryenumeration <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>4)     <![endif]>Object is now going to need someadjustments. I’ll break this down into afew components: <![if !supportLists]><spanstyle='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol'>·        <![endif]>iObject.h <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                             I.     <![endif]>Add ‘class iMaterial’to the top of the file with the rest of the declarations <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                           II.     <![endif]>Add a virtual getting and setter for theObject’s material <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                         III.     <![endif]>Add two more virtual functions, one called <spanclass=SpellE>getID, receives an int andreturns an int, and second one called <spanclass=SpellE>resetID which receives an int andreturns nothing. <![if !supportLists]><spanstyle='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol'>·        <![endif]>Object.h <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                             I.     <![endif]>Add a private iMaterialpointer to the object named rMaterial (you couldchange it to w/e you want, but it won’t be as easy to copy/paste code if youdon’t) <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                           II.     <![endif]>Implement the getter and setter in the in theObject header, in the setter, change the category of the object to MATERIAL. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                         III.     <![endif]>Remove the braces after Object’s <spanclass=SpellE>preDraw()function, we are going to need to implement this function in the <spanclass=SpellE>cpp. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                         IV.     <![endif]>Add a private intarray called get cubeMapID, which for thisimplementation, itcan be an array of 2 items, since reflection depth will not be implemented. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                           V.     <![endif]>Implement getID and <spanclass=SpellE>resetID, get id returns the intat level in the cubeMapID array (return <spanclass=SpellE>cubeMapID[level];)and resetID sets the int atlevel in the cubeMapID to -1. <![if !supportLists]><spanstyle='font-family:Symbol;mso-fareast-font-family:Symbol;mso-bidi-font-family:Symbol'>·        <![endif]>Object.cpp <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                             I.     <![endif]>Add ‘#include <spanclass=SpellE>iMaterial.h’ at the top. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                           II.     <![endif]>In the object constructor add ‘<spanclass=SpellE>rMaterial = NULL’, just to be safe, also set <spanclass=SpellE>cubeMapID [0] and [1] to -1. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                         III.     <![endif]>In the object’s = operator, set <spanclass=SpellE>CubeMapID[0]and [1] to -1. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                         IV.     <![endif]>In the Object’s attach function,<spanstyle='mso-spacerun:yes'> check if the category is set to MATERIAL andthat rMaterial isn’t NULL, if true, use Material’s <spanclass=SpellE>setStage, if category is not set to MATERIALS then use thecode already there (Remember, if reading this is confusing, you can always copythe code, this is just trying to explain what to do) <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                           V.     <![endif]>Above the draw function, add the implementationof the preDraw, which is simple. Check if thecategory is set to MATERIAL and rMaterial isn’t NULL,if true, set the cubeMapID (at index of <spanclass=SpellE>rMaterial->getDepth<spanclass=GramE>()) to dthe result of <spanclass=SpellE>rMaterial->getCubeID(this).Finally call the preDraw function on <spanclass=SpellE>rMaterial and pass it a reference to the object (this), <spanclass=SpellE>vertexlist pointer, and scene pointer. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                         VI.     <![endif]>Mod the Object’s draw function to test if thecategory is set to MATERIAL, if it is and rMaterial isn’t NULL, call the draw functionon the material (passing in the object and scene) in place of using the attachand draw code in the function, the report should occur regardless. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>                                                       VII.     <![endif]>In the suspend code, check if <spanclass=SpellE>rMaterial is NULL, if not, call suspend on it. Do the samefor release. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>5)     <![endif]>Open Display.cpp,<spanstyle='mso-spacerun:yes'> #include Material.hand call the static function connectDevice fromMaterial, this will give material access to the device and below, call thestatic function connectEffect, giving Material accessto the effect file. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>6)     <![endif]>The system requires a knowledge of the verticesof the in a mesh, so you have to go to iVertex listand add two virtual functions,<spanstyle='mso-spacerun:yes'> ‘int <spanclass=SpellE>getNumOfVerts()’ and ‘Vertex* getVertitices()’.Now you have to go into the VertexList class,implement these functions to return nVertices andVertex. You also need to make animplementation for stock mesh, simply give return NULL for both stock meshimplementations. NOTE: If you already have your object’s center and radius calculated or easilyaccessible, you can skip this step and alter the code in the Material class touse that data instead of calculating the center from the vertex list. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>7)     <![endif]>Open Design.cpp and #include iMaterial.h.<spanstyle='mso-spacerun:yes'> Add scene->draw(MATERIAL);to Design’s draw function and scene->draw(MATERIAL); to Design’s <spanclass=SpellE>preDraw. This will give you the ability to use the Material classwith your object to give them a nice reflective or refracting effect. How to use Material: To use a material, follow these few steps: <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>1)     <![endif]>Create a Material: iMaterial<istyle='mso-bidi-font-style:normal'>* mat = CreateMaterial(<spanclass=SpellE>contextPointer, numberOfStages, <spanclass=SpellE>numberOfSubsets); NOTES: if the material only have one stage and subset, only pass incontext. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>2)     <![endif]>Setup the material: mat->setup(arrayOfBasicColors,twoDimensionalTextureArray, arrayOfColorsRepresentingReflection,arrayOfRefractionPowers, twoDimensionalArrayOfColorsRepresentingRefraction,ObjectShine, ObjectFlags, <spanclass=SpellE>ObjectBorderColor); NOTE: If you specify only one subset/stage, you can simply put in a pointers tothis data, but if you specify more than one subset or stage, you <spanstyle='mso-spacerun:yes'> must implement the data in an array OR pass inNULL. The alpha channel determines how strong the effect of the reflection orrefraction will be, and they are both over-riding effects, reflection being themost over-riding of the two. So ifrefraction’s alpha channel is 1.0, the object’s color and texture will becompletely gone, the object will only have the refracted texture on it. If thealpha channel is 0.5, then it will be half refracted texture, halfcolor/diffuse texture. The same works with reflection except that reflectionwill over-ride refraction, so if an object is 100% refractive and 100%reflective, you will only see the reflection. Where as if the reflection is 50%and refraction is 50%, the distribution of the texture will be 50% reflective,25% refractive, 25% diffuse. The refractive power float array dictates how muchthe light bends, so if it is equal to 1.0, the light will not bend at all,where as if it is set to 0.9, it will bend about 10% of the angle of the normalof the fragment. <![if !supportLists]><spanstyle='mso-bidi-font-family:Calibri;mso-bidi-theme-font:minor-latin'><spanstyle='mso-list:Ignore'>3)     <![endif]>Set the material onto the object<spanclass=GramE>: object->setMaterial(mat); NOTE: this will convert the object to a material object and attach thematerial. <o:p> </o:p> A quick example of how to make a glass like cube would be: iObject<istyle='mso-bidi-font-style:normal'>* boxy = CreateBox(-10,-10, -10, 10, 10, 10, “opaque”, Colour(1.0f, 1.0f, 1.0f,1.0f); iMaterial* mat = CreateMaterial(context); float power = 0.9f; //this is just to sidestep the need for an array mat->>setup(&Colour(0.7f, 0.7f, 0.7f, 0.7f), NULL, &Colour(1.0f, 1.0f, 1.0f, 0.25), &power, &Colour(1.0f, 1.0f, 1.0f, 1.0f)); boxy->setMaterial(mat);<o:p></o:p> I didn’t test the above code so there could be a typo. </div> </body> </html>

CloudScorpion

4

edits

CDOT Wiki β

Changes

Team Guardian Cube Mapping

CDOT Wiki ^β