Yamyam: 1版をインポートしました

2018-06-28T18:37:24Z

1版をインポートしました

2010年4月1日 (木) 08:22にwiki>Terrywallworkによる

2010-04-01T08:22:32Z

新規ページ

== Python RNA API ==
* Matches the C/RNA api structure
* Thin wrapper ~(3000 lines)
* No functions specific to any blender object type.
* Defines 2 types, BPy_StructRNA and BPy_PropertyRNA.
* Python 3.1 target
* Write access to data
* Subclasses are used for adding extra functionality through python.
* Collection iterators
* Call RNA functions

=== Collections ===
Collections may have their own functions and attributes, here is a list which should be used as a bases when extending collections for the RNA api.

* '''seq.active''' --> item or None active member of the collection.
* '''data = seq.new(name, type)''' / '''seq.remove(item)'''<br>''Type optional when it can be changed after adding.''
* '''seq.link(data)''' / '''seq.unlink(data)'''<br>''Exception if already linked or not linked when unlinking.

=== Todo ===
* Solve the "Python keeping invalid blender pointers" problem.<br>''This cant just be solved in the py api - we need blender to notify when ID's are removed''

=== Examples ===
Here are some examples that work with the current implementation of the api.
Examples:
<source lang="python">
bpy.lamps["Lamp.006"].energy -> (1.0)
</source>
<source lang="python">
bpy.lamps["Lamp.007"].shadow -> ("NOSHADOW")
</source>
<source lang="python">
bpy.meshes["MyObject"]
</source>
<source lang="python">
bpy.materials.keys() -> ['flyingsquirrel_eye', 'frankie_skin', 'frankie_theeth']
</source>
<source lang="python">
bpy.meshes["mymesh"].uv_layers.keys() -> ['UVTex', 'UVTex']
</source>
<source lang="python">
bpy.scenes["hud"].objects["num_text_p2_4"].data.novnormalflip -> False
</source>

=== Notes ===
* "bpy" is as an arbitrary pytype, we can change it to anything.
* At the moment enum types are converted into python strings (as seen above with the lamps "NOSHADOW")

=== Dumping a blendfile with PyRNA ===
Here's a script that prints out all RNA data

<source lang="python">
PRINT_DATA = True
VERBOSE = False
VERBOSE_TYPE = False
VERBOSE_DOCS = True
SKIP_RECURSIVE = False

def seek(r, txt):
print(txt)
newtxt = ''

if len(txt) > 200:
print ("Something is wrong")
print (txt)
return

# basic types
if type(r) in (float, int, bool, type(None)):
if PRINT_DATA:
print(txt + ' -> ' + str(r))
return
if type(r) == str:
if PRINT_DATA:
print(txt + ' -> "' + str(r) + '"')
return

if VERBOSE_DOCS and PRINT_DATA:
try: print(r.__doc__)
except: pass

try: keys = r.keys()
except: keys = None

if keys != None:
if PRINT_DATA:
print(txt + '.keys() - ' + str(r.keys()))

try: __members__ = r.__members__
except: __members__ = []

for item in __members__:
if PRINT_DATA: newtxt = txt + '.' + item

if item == 'rna_type' and not VERBOSE_TYPE: # just avoid because it spits out loads of data
continue

if SKIP_RECURSIVE:
if item in txt:
if PRINT_DATA:
print(newtxt + ' - (skipping to avoid recursive search)')
continue

seek( getattr(r, item), newtxt)

if keys:
for k in keys:
if PRINT_DATA: newtxt = txt + '["' + k + '"]'
seek(r[k], newtxt)

else:
try: length = len( r )
except: length = 0

if not VERBOSE and length >= 4:
for i in (0, length-1):
if i>0:
if PRINT_DATA:
print((' '*len(txt)) + ' ... skipping '+str(length-2)+' items ...')

if PRINT_DATA: newtxt = txt + '[' + str(i) + ']'
seek(r[i], newtxt)
else:
for i in range(length):
if PRINT_DATA: newtxt = txt + '[' + str(i) + ']'
seek(r[i], newtxt)

seek(bpy, 'bpy')

import sys
sys.exit()
</source>

Extract of a file dump, see yo-frankie level dump here [http://pasteall.org/3294/python]

<source lang="python">
bpy.lamps["Lamp.004"].name -> "Lamp.004"
bpy.lamps["Lamp.004"].color[0] -> 1.0
bpy.lamps["Lamp.004"].color[1] -> 1.0
bpy.lamps["Lamp.004"].color[2] -> 1.0
bpy.lamps["Lamp.004"].dist -> 20.0
bpy.lamps["Lamp.004"].energy -> 1.0
bpy.lamps["Lamp.004"].shadow -> "NOSHADOW"
bpy.lamps["Lamp.004"].type -> "LOCAL"
bpy.lamps["Lamp.006"].rna_type.rna_type - (skipping to avoid recursive search)
bpy.lamps["Lamp.006"].rna_type.name -> "Lamp"
bpy.lamps["Lamp.006"].rna_type.identifier -> "Lamp"
bpy.lamps["Lamp.006"].rna_type.name_property.rna_type - (skipping to avoid recursive search)
bpy.lamps["Lamp.006"].rna_type.name_property.name - (skipping to avoid recursive search)
bpy.lamps["Lamp.006"].rna_type.name_property.description -> "Object ID name."
bpy.lamps["Lamp.006"].rna_type.name_property.identifier -> "name"
bpy.lamps["Lamp.006"].rna_type.name_property.max_length -> 22
bpy.lamps["Lamp.006"].rna_type.name_property.subtype -> "NONE"
bpy.lamps["Lamp.006"].rna_type.name_property.type - (skipping to avoid recursive search)
bpy.lamps["Lamp.006"].rna_type.properties.keys() - ['RNA', 'Name', 'Color', 'Distance', 'Energy', 'Shadow', 'Type']
bpy.lamps["Lamp.006"].rna_type.properties["RNA"].rna_type - (skipping to avoid recursive search)
bpy.lamps["Lamp.006"].rna_type.properties["RNA"].name -> "RNA"
</source>

==== rna2xml.py ====
<source lang="python">
VERBOSE = True
VERBOSE_TYPE = False
VERBOSE_DOCS = False
SKIP_RECURSIVE = False
common_types = float, int, bool, type(None), str

def seek(r, txt, end = '\n'):
newtxt = ''

if type(r) in (float, int, type(None)): # basic types
print('%s%s' % (txt, r), end=end)
return
if type(r) in (str, bool):
print('%s"%s"' % (txt, r), end=end)
return

try: keys = r.keys()
except: keys = None

try: __members__ = r.__members__
except: __members__ = []

for item in __members__:
newtxt = txt + '\t'

if item == 'rna_type' and not VERBOSE_TYPE: # just avoid because it spits out loads of data
continue

if SKIP_RECURSIVE:
if item in txt:
continue

attr = getattr(r, item)

if type(attr) in common_types:
print('%s<%s>' % (txt, item), end='')
seek( attr, '', ''),
print('</%s>' % (item))
else:
print('%s<%s>' % (txt, item))
seek( attr, txt, '')
print('%s</%s>' % (txt, item))

if keys:
for k in keys:
newtxt = txt + '\t'
print('%s<item key="%s">' % (txt, k))
seek(r[k], newtxt)
print('%s</item>' % (txt))

else:
try: length = len( r )
except: length = 0

for i in range(length):
newtxt = txt + '\t'

attr = r[i]
if type(attr) in common_types:
print('%s<item index="%d">' % (newtxt, i), end = '')
seek(attr, '', '')
print('</item>')
else:
print('%s<item index=%d>' % (newtxt, i))
seek(attr, newtxt+'\t')
print('%s</item>' % (newtxt))

print('<root>')
seek(bpy, '\t')
print('</root>')

</source>

[[Category:Script]]

← 古い版	2018年6月28日 (木) 18:37時点における版
(相違点なし)

Dev:2.5/Source/Python/PyRNA - 版の履歴

Yamyam: 1版 をインポートしました

2010年4月1日 (木) 08:22にwiki>Terrywallworkによる

Yamyam: 1版をインポートしました