sandey/blender
1
0
Fork 0
forked from bartvdbraak/blender
Code Pull Requests Activity

===Python API===

Browse Source 
Taking a hint from Hos, started adding some (hopefully) better examples into
the documentation for creating and manipulating meshes.
This commit is contained in:
Ken Hughes 2006-03-04 00:04:45 +00:00
parent 932717da38
commit ae32a538dd
1 changed files with 31 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

45
source/blender/python/api2_2x/doc/Mesh.py
View File

@ -12,32 +12,49 @@ This module provides access to B{Mesh Data} objects in Blender. It differs
from the NMesh module by allowing direct access to the actual Blender data, from the NMesh module by allowing direct access to the actual Blender data,
so that changes are done immediately without need to update or put the data so that changes are done immediately without need to update or put the data
back into the original mesh. The result is faster operations with less memory back into the original mesh. The result is faster operations with less memory
usage. usage. The example below creates a simple pyramid, and sets some of the
face's attributes (the vertex color):
Example:: Example::
import Blender from Blender import *
from Blender import Mesh, Material, Window
editmode = Window.EditMode() # are we in edit mode? If so ... editmode = Window.EditMode() # are we in edit mode? If so ...
if editmode: Window.EditMode(0) # leave edit mode before getting the mesh if editmode: Window.EditMode(0) # leave edit mode before getting the mesh
me = Mesh.Get("Plane") # get the mesh data called "Plane" # define vertices and faces for a pyramid
coords=[ [-1,-1,-1], [1,-1,-1], [1,1,-1], [-1,1,-1], [0,0,1] ]
faces= [ [3,2,1,0], [0,1,4], [1,2,4], [2,3,4], [3,0,4] ]
if not me.materials: # if there are no materials ... me = Mesh.New('myMesh') # create a new mesh
newmat = Material.New() # create one ...
me.materials=[newmat] # and set the mesh's list of mats
print me.materials # print the list of materials me.verts.extend(coords) # add vertices to mesh
mat = me.materials[0] # grab the first material in the list
mat.R = 1.0 # redefine its red component for f in faces: # replace face indices to MVerts
for v in me.verts: # loop the list of vertices for i in xrange(len(f)):
v.co[0] *= 2.5 # multiply the coordinates f[i] = me.verts[f[i]]
v.co[1] *= 5.0
v.co[2] *= 2.5 me.faces.extend(faces) # add faces to the mesh (also adds edges)
me.vertexColors = 1 # enable vertex colors
me.faces[1].col[0].r = 255 # make each vertex a different color
me.faces[1].col[1].g = 255
me.faces[1].col[2].b = 255
ob = Object.New('Mesh','myObj') # link mesh to an object
ob.link(me)
sc = Scene.GetCurrent() # link object to current scene
sc.link(ob)
if editmode: Window.EditMode(1) # optional, just being nice if editmode: Window.EditMode(1) # optional, just being nice
Vertices, edges and faces are added to a mesh using the .extend() methods.
For best speed and efficiency, gather all vertices, edges or faces into a
list and call .extend() once as in the above example. Similarly, deleting
from the mesh is done with the .delete() methods and are most efficient when
done once.
@type Modes: readonly dictionary @type Modes: readonly dictionary
@type FaceFlags: readonly dictionary @type FaceFlags: readonly dictionary
@type FaceModes: readonly dictionary @type FaceModes: readonly dictionary