-
Notifications
You must be signed in to change notification settings - Fork 1
senbeiwabaka/Computer-Graphics-Project
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
This is a 3D Game Engine for Computer Graphics class Final Project Readme.txt ****************************************** Section 1: System Requirements Section 2: Setting up files Section 3: GUI Overview Section 4: Fuctions 4a. Camera controls 4b. Objects Adding Deleting ReNaming Translating Rotating Scaling Coloring 4c. Meshes Loading 4d. Lights Adding Deleting Translating Direction On/Off 4e. Environment Gravity WireFrame Global Lights On/Off ****************************************** ****************************************** Section 1: System Requirements ****************************************** This project was made using C# .NET Windows Forms using .NET framework 4.0 and 4.5 components. Therefore, .NET framework 4.0 must be installed on the OS. *Note - Will only run on Windows (presumably Vista and higher). ****************************************** Section 2: Setting up files ****************************************** The root folder is called Computer Graphics Term Project. In this folder there are two folders called Graphics Project Runnable-Executable, which has a runnable version of the program, and Graphics Project Source Code, which is the source code. The Program can be executed by clicking on Computer Graphics Term Project.exe in Computer Graphics Term Project/Graphics Project Runnable-Executable. To run or view the source code, open up the project by double clicking Graphics Term Project.sln in Computer Graphics Term Project/Graphics Project Source Code. This will open Visual Studio 2010 or 2012 depending on your version. *Note: If you have issues opening it with the .sln then open the Compiling folder and double click Compiling.csproj. ****************************************** Section 3: GUI Overview ****************************************** The GUI is separated into 4 main sections that will be referenced in the reset of the readme file. Top Menu Bar: This is the Menu bar on the upper-most part of the program. this contains menu items for file operations, adding shapes, and adding lights. Left Control Area: This is the left side of the screen where multiple controls are displayed. Right Control Area: This is the right side of the screen where multiple controls are displayed. Middle Panel Area: Located in the middle of the screen is the main panel where the scene is displayed. ****************************************** Section 4: Functions ****************************************** 4a. Camera controls Reset Camera - Click the "Reset Camera" button to return the Camera to its starting location. (0,0,3.5) Camera Movement - Located in the left control area, six buttons controls Left, Right, Up, Down, Back, Forward, or -x, x, y, -y, z, -z translate respectively. Labels below will update as the Camera eye position is updated. In addition, when mouse hovering over the middle panel, the mouse wheel will "zoom-in and zoom-out" by z axis translation. Also, you can "click and drag" within the panel to move the camera along the x and y axis Rotation Camera Movement - Located in the left control area, six buttons control Left, Right, Up, Down, Back, Forward, or -x, x, y, -y, z, -z rotate respectively. Labels below will update as the cameras rotation is updated. 4b. Objects Adding To add an object, click the "Shapes" menu item in the top menu bar. Select "Square" or "Triangle" and it will be added to the scene at point [0,0,0]. As items are added, they will be added to a count and list located in the right control area under the Objects section. Deleting To delete an object, select an object from the object list drop down list in the right control area in the objects section. The selected object will be indicated when the "Selected Object" label changes to the selected object. Click the Delete button - a message box will prompt with a confirmation. Click yes and continue to delete the object. ReNaming To rename an object, select an object from the object list drop down list in the right control area in the objects section. The current name will load into the "ReName" textbox. Type the new name in this textbox and click the "ReName" button. Use this to keep track of your objects. Translating To translate an object, select an object from the object list drop down list in the right control area in the objects section. At this time, the objects current position will load into the "Translate" X Y and Z textboxes. To translate, click in the desired textbox, update the value, and press the Enter key on your keyboard. Note, the textboxes will only accept integers. Rotating To rotate an object, select an object from the object list drop down list in the right control area in the objects section. At this time, the objects current rotation will load into the "Rotate" X Y and Z textboxes. To rotate, click in the desired textbox, update the value, and press the Enter key on your keyboard. Note, the textboxes will only except integers. Scaling To scale an object, select an object from the object list drop down list in the right control area in the objects section. At this time, the objects current scale will load into the "Scale" X Y and Z textboxes. To scale, click in the desired textbox, update the value, and press the Enter key on your keyboard. Note, the textboxes will only accept integers. Coloring To color an object, select an object from the object list drop down list in the right control area in the objects section. At this time, the objects current RGB color will load into the "Color" label. To change color, click the "Select" button in the Color section. A color picker will display - select your desired color, the color of your object will change. Note, if you don't see the color make sure your light is turned on! 4c. Meshes Loading To load a mesh, click the "File" menu item in the top menu bar. Select "Load Mesh" and an open file dialog will appear. Find a .x mesh file, or use the "tiger.x" file located within the file folders of this project. The mesh will appear on the screen, You can translate, rotate, and scale like you would a square or triangle. 4d. Lights Adding To add a light, click the "Lights" menu item in the top menu bar. Select "Point" or "Directional" and it will be added to the scene at point [0,0,0]. As lights are added, they will be added to a count and list located in the right control area under the Lights section. Deleting To delete a light, select the light from the light list drop down list in the right control area in the lights section. The selected light will be indicated when the "Selected Light" label changes to the selected light. Click the Delete button - a message box will prompt with a confirmation. Click yes and continue to delete the light. Translating To translate a light, select a light from the light list drop down list in the right control area in the light section. At this time, the light current position will load into the "Location (Point Only)" X Y and Z textboxes. To translate, click in the desired textbox, update the value, and press the Enter key on your keyboard. Note, the textboxes will only accept integers. Direction To change a light direction, select a light from the light list drop down list in the right control area in the light section. At this time, the lights current direction will load into the "Point At (Directional Only)" X Y and Z textboxes. To change, click in the desired textbox, update the value, and press the Enter key on your keyboard. Note, the textboxes will only accept integers. On/Off To turn an individual light on and off, select a light from the light list drop down list in the right control area in the light section. At this time, the lights current On/Off status will be updated in the "Light On/Off" checkbox. Check or uncheck this checkbox to switch the light on and off. 4e. Environment Gravity To turn gravity on and off, Check or uncheck the "Gravity On/Off" checkbox located in the "Environment" section in the left control area. WireFrame To turn wireframe on and off, Check or uncheck the "Wireframe On/Off" checkbox located in the "Environment" section in the left control area. Global Lights On/Off To turn Global Lights on and off, Check or uncheck the "Global Lights On/Off" checkbox located in the "Environment" section in the left control area.
About
Computer Graphics Term Project
Resources
Stars
Watchers
Forks
Releases
No releases published
Packages 0
No packages published