【Nuke教程】通过Python获取素材Metadata(元数据)

9 九月, 2016
31
0

nukepython-1

作者介绍

jingbo

读取metadata

函数metadata() 返回一个字典,包含了特点指定节点的metadata:

node = nuke.toNode( 'Read1' )
print node.metadata()
# Result:
{'exr/displayWindow': [0, 0, 2047, 1555], 'input/width': 2048, 'exr/nuke/camera/vaperture': '18.672', 'input/bitsperchannel': '16-bit half float', 'input/filereader': 'exr', 'nuke/node_hash': 'c82817f8e9526abe', 'input/mtime': '2011-04-11 16:47:54', 'exr/nuke/camera/haperture': '24.576', 'input/ctime': '2011-04-11 16:47:54', 'exr/nuke/camera/matrix': '[-0.30901703238487244, -0.16514922678470612, 0.93660777807235718, 9.5105648040771484, 0.0, 0.98480772972106934, 0.1736481785774231, 2.0, -0.95105648040771484, 0.05366024374961853, -0.30432236194610596, -3.0901703834533691, 0.0, 0.0, 0.0, 1.0]', 'input/filename': '/Volumes/ohufx/consulting/Foundry/PythonDevGuide/footage/metadata/renderWithMetadata.0003.exr', 'input/filesize': 193828, 'exr/screenWindowCenter': [0.0, 0.0], 'exr/dataWindow': [463, 417, 1518, 1435], 'exr/nuke/camera/focal': '50.0', 'exr/screenWindowWidth': 1.0, 'input/height': 1556, 'exr/pixelAspectRatio': 1.0}

打印出来的结果太长没有可读性,用下面的代码增加可读性:

node = nuke.toNode('Read1')
for k,v in node.metadata().iteritems():
    print k,v

结果

# Result:
exr/displayWindow [0, 0, 2047, 1555]
input/width 2048
exr/nuke/camera/vaperture 18.672
input/bitsperchannel 16-bit half float
input/filereader exr
nuke/node_hash c82817f8e9526abe
input/mtime 2011-04-11 16:47:54
exr/nuke/camera/haperture 24.576
input/ctime 2011-04-11 16:47:54
exr/nuke/camera/matrix [-0.30901703238487244, -0.16514922678470612, 0.93660777807235718, 9.5105648040771484, 0.0, 0.98480772972106934, 0.1736481785774231, 2.0, -0.95105648040771484, 0.05366024374961853, -0.30432236194610596, -3.0901703834533691, 0.0, 0.0, 0.0, 1.0]
input/filename /Volumes/ohufx/consulting/Foundry/PythonDevGuide/footage/metadata/renderWithMetadata.0003.exr
input/filesize 193828
exr/screenWindowCenter [0.0, 0.0]
exr/dataWindow [463, 417, 1518, 1435]
exr/nuke/camera/focal 50.0
exr/screenWindowWidth 1.0
input/height 1556
exr/pixelAspectRatio 1.0

设置metadata

在流中创建自定义metadata,需要使用ModifyMetaData节点。想渲染自定义metadata,就要使用支持它的文件格式( 比如,exr)
setMetaDat_01
ModifyMetaData 节点接收表达式语法,意味着你可以使用TCL,有限扩展,python。在这个例子中,我们想要将camrea的焦距和
光圈和其变换矩阵写入metadata。metaDatCam_02
在此例中,camera的两个光圈范围使用tcl表达式。camera的焦距使用python. 变换矩阵使用python设置,自定义函数叫getTransform。
写成代码就如下:

def getTransform( frame ):
        cam = nuke.toNode( 'masterCam')
        m = []
        for i in range(16):
            m.append( cam['world_matrix'].valueAt( frame, i ))
        return m

将上面的代码加入init.py 或 menu.py ( 或者 import进来 ),你可以让其在knob里面可以用,然后所有自定义部分添加到
ModifyMetaData 节点。

例子:createMetaDatCam

此例中,先看一段代码,其根据exr文件中的metadata创建camera。
metaDatCam_01
开始一个新的函数,检查节点的metadata,如果有足够的信息就创建camera。想在流中的任何地方读取节点的metadata,请使用
metadata方法:

def createMetaDatcam( node ):
        mDat = node.metadata()

接下来,收集我们想要在metadata中找到的项目,冠以group名最为前缀( 在metadata中获取全名):

reqFields = ['exr/nuke/camera/%s' % i for i in ('focal', 'haperture', 'vaperture', 'matrix') ]

检查所需数据是否为metadata的子集,如果不是,停止脚本:

if not set(reqFiedls).issubset(mDat):
    print 'no metadata for camera found'
    return

询问需要给camera的帧区间,将节点的帧区间作为默认值放入对话框:

first = node.firstFrame()
last = node.lastFrame()
ret = nuke.getFramesAndViews(' Create Camera from Metadata', '%s-%s' %(first, last))

metaDatCam_02
nuke.getFramesAndViews返回一个列表,第一项为帧区间,第二项为所要求的视图。分离帧区间,并将其转换成帧区间对象。
现在可以忽略视图:

fRange = nuke.FrameRange( ret[0] )

创建一个camera节点,将其useMatrix knob设置为True:

cam = nuke.createNode( 'Camera2')
cam['useMatrix'].setValue( True)

遍历你所需的knob,并设置为动画:

for k in ('force', 'haperture', 'vaperture', 'matrix'):
    cam[k].setAnimated()

在遍历frame range设置keyframes前,创建一个进度条,用户可以在UI中取消操作。

task = nuke.ProcessTask('Baking camera from meta data in %s' % node.name() )

用enumerate来循环。其返回当前迭代器的索引,用来更新进度条(这个例子中,名为curTask)。在使用进度条时,要检测用户使用
点击“取消”来停止循环:

for curTask, frame in enumerate( fRange ):
    if task.isCancelled():
        break

更新任务信息,告知我们进行到何处:

task.setMessage('process frame %s' % frame)

现在从metadata中抓取camera的当前帧的焦距和光圈值,转换成浮点值,就可以赋给knob了:

for k in ('focal', 'haperture', 'vaperture'):
    val = float( node.metadata('exr/nuke/camera/%s', %k, frame))

给knob赋值:

cam[k].setValueAt( float(val), frame)

这会处理投影参数,现在需要处理camera的变换。这种情况下,metadata保存的字符串仅是python的list,可以使用evaluate转变成list。

matrixList = eval( node.metadata('exr/nuke/camera/matrix' ))

迭代整个list并给当前帧的摄像机matrix赋值:

for i,v in enumerate( matrixList ):
        cam['matrix'].setValueAt( v, frame, i)

最后更新进度条,因此,我们就知道进行到哪了。

task.setProgress( int(float(curTask)/fRange.frames()*100))

全部代码如下:

import nuke
def createMetaDatCam( node ):
    '''
    create a camera node from meta data.
    This assumes the following keys in the given nodes meta data stream: 'focal', 'haperture', 'vaperture' and 'matrix',
    where 'matrix' carries the result of "[python nuke.toNode( 'Camera1' ).knob('world_matrix').valueAt( nuke.frame() )]"
    args:
       node  -  node to check for meta data
       ask   -  prompt before creating camera
    '''
    mDat = node.metadata()
    reqFields = ['exr/nuke/camera/%s' % i for i in ('focal', 'haperture', 'vaperture', 'matrix')]
    if not set( reqFields ).issubset( mDat ):
        print 'no metdata for camera found'
        return
    first = node.firstFrame()
    last = node.lastFrame()
    ret = nuke.getFramesAndViews( 'Create Camera from Metadata', '%s-%s' %( first, last )  )
    fRange = nuke.FrameRange( ret[0] )
    cam = nuke.createNode( 'Camera2' )
    cam['useMatrix'].setValue( True )
    for k in ( 'focal', 'haperture', 'vaperture', 'matrix'):
        cam[k].setAnimated()
    task = nuke.ProgressTask( 'Baking camera from meta data in %s' % node.name() )
    for curTask, frame in enumerate( fRange ):
        if task.isCancelled():
            break
        task.setMessage( 'processing frame %s' % frame )
        # GET ALL FRAMES
        for k in ( 'focal', 'haperture', 'vaperture' ):
            val = float( node.metadata( 'exr/nuke/camera/%s' % k, frame ) )
            cam[ k ].setValueAt(  float( val ), frame )
        # CONVERT STRING BACK TO LIST OBJECT AND ASSIGN
        matrixList = eval( node.metadata('exr/nuke/camera/matrix') )
        for i, v in enumerate( matrixList ):
            cam[ 'matrix' ].setValueAt( v, frame, i)
        # UPDATE PROGRESS BAR
        task.setProgress( int( float(curTask) / fRange.frames() *100) )