# -*- indent-tabs-mode: t -*- # Soya 3D tutorial # Copyright (C) 2001-2004 Jean-Baptiste LAMY # Copyright (C) 2008 Thibaut GIRKA # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by # the Free Software Foundation; either version 2 of the License, or # (at your option) any later version. # # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA # background-2: Adding a background (using soya.gui) # This lesson is the same as basic-1.py, except that we have added a background. # Imports sys, os modules and the Soya module. import sys, os, os.path, soya, soya.gui # Initializes Soya (creates and displays the 3D window). soya.init() # Add the path "tutorial/data" to the list of soya data path. When soya loads some data, # like a model or a texture, it always searches the data in soya.path. # soya.path behaves like Python's sys.path. # Soya's data directory should be organized as following : # ./images : the image file # ./materials : the materials (including textures, optimized forms of images) # ./worlds : the model # ./models : the optimized model # Notice the use of sys.argv to get the directory where this script lives. soya.path.append(os.path.join(os.path.dirname(sys.argv[0]), "data")) # Creates a scene. The scene is a World, which contains all the 3D elements we are # about to render. A World is a 3D object that can contain other 3D objects (including # other worlds) ; think to World as a group of 3D objects. scene = soya.World() # Loads the sword model (from file "tutorial/data/models/sword.data"). # A model is an optimized model ; the sword model we use here was designed in Blender. # Model.get is a static method that returns the object of the corresponding filename, # and loads it if needed, i.e. if you call get a second time, it will return the same # object instead of loading it again. # Any dependancy of the model (e.g. materials) are loaded too. sword_model = soya.Model.get("sword") # Create the model. # A Body displays a model. The first argument of the Body constructor is the # parent of the new body ; here we put the body in the scene. The parent must be # a World or a World derivative (or None). # (this is a convention, similarly to Tkinter, where the first argument of a # widget's constructor is the master). # The second argument of the Body constructor is the model : our sword model. sword = soya.Body(scene, sword_model) # The default position is 0.0, 0.0, 0.0 # To view it better, we moves the sword to the right. sword.x = 1.0 # Rotates the sword on the Y axis, of 60.0 degrees. # (in Soya, all angles are in degrees). sword.rotate_y(90.0) # Creates a light in the scene (same convention: the first argument of the # constructor is the parent) and moves it to (1.5, 2.0, 0.2). light = soya.Light(scene) light.set_xyz(0.5, 0.0, 2.0) # Creates a camera in the scene and moves it to z = 5.0. The camera looks in the # -Z direction, so, in this case, towards the cube. # # When relevant, Soya always considers the X direction to be on the right, # the Y direction to be on the top and the -Z to be the front. # (Using -Z for front seems odd, but using Z for front makes all coordinate systems # indirect, which is a mathematical nightmare !) camera = soya.Camera(scene) camera.z = 2.0 # Say to Soya that the camera is what we want to be rendered. # Make a widget group root = soya.gui.RootLayer(None) # Create the background material, and the background widget background_material = soya.Material(soya.Image.get('block2.png')) background = soya.gui.Image(root, background_material) # Make the scene transparent so we can see the background scene.atmosphere = soya.NoBackgroundAtmosphere() # Add the the camera and set the root widget soya.gui.CameraViewport(root, camera) soya.set_root_widget(root) # Uncomment this line to save a 320x240 screenshot in the results directory. #soya.render(); soya.screenshot().resize((320, 240)).save(os.path.join(os.path.dirname(sys.argv[0]), "results", os.path.basename(sys.argv[0])[:-3] + ".jpeg")) # Creates an 'MainLoop' for the scene, and launch it. # The MainLoop is the object that manages the Soya's mainloop. It take care of : # - looping # - regulating the frame rate to 40 FPS # - smoothing the animation # - computing FPS # - rendering the screen soya.MainLoop(scene).main_loop()