/usr/share/doc/python-soya-doc/examples/basic-1.py is in python-soya-doc 0.14-2.
This file is owned by root:root, with mode 0o755.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 | #!/usr/bin/env python
# -*- coding: utf-8 -*-
# -*- indent-tabs-mode: t -*-
# Soya 3D tutorial
# Copyright (C) 2001-2004 Jean-Baptiste LAMY
#
# 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
# basic-1: Setting up : displaying a 3D model
# This is the first lesson of the Soya tutorial.
# This lesson just sets up everything and display a 3D model. In order to do that,
# we need :
# - a model,
# - a light,
# - a camera,
# - a scene, to group the three other 3D objects.
# Imports sys, os modules and the Soya module.
import sys, os, os.path, soya
# 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.
soya.set_root_widget(camera)
# 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()
|