NDK学习笔记(五)Reader机制
针对每一种后缀名Nuke都提供了对应的模块。为了决定用哪个版本的reader或writer模块,Nuke会先解析文件后缀名再以此为依据调用相关模块。
以JPG为例:
该文件格式有两种后缀名:.jpg和.jpeg。实际上两种后缀名用同一个模块来解决即可。Nuke中用tcl脚本来解决这个问题。Nuke文件路径中有这样一个文件:jpegReader.tcl,内容如下:
#jpegReader.tcl
load jpgReader
当Nuke主程序解析后缀名为.jpeg的时候就会调用jpegReader.tcl脚本。该脚本会将调用指向jpgReader模块。通过这种方式就解决了一种图像格式有多种后缀名的问题。
Nuke中提供了对应大部分图像格式的reader和writer模块,例如:dpxWriter,dpxReader,exifReader,exifWriter。
分别针对对应的图像格式。
NDK文档中提供了标准的一个Reader基础模板如下:
class MyReader : DD::Image::Reader
{
static const Description d;
...
}; static Reader* build( Read* r, int fd, const unsigned char* b, int n )
{
return new MyReader( r, fd, b, n );
} static bool test( int fd, const unsigned char* block, int n )
{
return ( block[0] == MY_MAGIC_BYTE );
} const Reader::Description MyReader::d( "myFile\0", "my file format", build, test );
首先定义了一个继承Reader的子类:MyReader,继而定义其中的build及test、Description函数。
Description函数将通过build及test函数来控制和估计是否MyReader类适用于操作当前的图像格式。
一般来说,Reader实例通过后缀名来寻找对应的读取器,一旦找到了特定的图像格式,就是启动test函数去确定读取器与当前格式是否匹配。
在这种情况下,MY_MAGIC_BYTE会被当做内存中第一个元素来识别。为了防止错误的后缀名图像格式(比如dpx格式的文件后缀名却是.jpg),Nuke还会再次测试tester方法,来告诉用户,testing可以决定文件类型是可读的,同时避免了相同的文件后缀冲突。
和使用tcl语言的的方法一样,多种文件后缀也可以在description中被定义。案例如下:
const Reader::Description MyReader::d( "myFile\0someOtherFile", "my file format", build, test );
这样的话Reader就可以适用于.myFile格式和.someOtherFile格式了。
这个Reader结构可以通过DD::Image::Reader::set_info()l来设置IO访问的区域。这会是一个快速的处理过程。复杂的读取,解码,缓存可以通过DD::Image::Reader::open()来解决。
最后一个需要用户自己定义来创造基本的读取机制的方法是DD::Image::Reader::engine()。下面这个案例会显示Nuke自己的图像处理过程:
void MyReader::engine( int y, int x, int r, ChannelMask mask, Row& row )
{
row.range( 0, width() ); for( int z = 0; z < 4; z++ ) {
// A user implemented read function
custom_read_channel( y, z, row.writable( z ) );
}
}
这个实例会在开始时设置画面的宽度,然后读取每一个通道的数据到row中。
row就是一个数据缓冲机制。
还有一些其他的方法:
以下的方法都是可选的,不必每一个都定义。他们提供了一些额外的功能和信息给Reader类。
void DD::Image::Reader::prefetchMetaData()
这个方法可以用来获取特定帧的metadata(元数据)。
const MetaData::Bundle& DD::Image::Reader::fetchMetaData(const char* key)
这个方法可以用来获取metadata(元数据)。
bool DD::Image::Reader::supports_stereo() const
这是一个flag,决定当前类是否支持立体双视角的读取。
bool DD::Image::Reader::fileStereo() const
这是一个flag,表明当前文件是否为立体素材。
bool DD::Image::Reader::videosequence() const
这是一个flag,表示当前文件是否是视频素材,即mov。
关于FileReader基类:
FileReader是一个继承自Reader的类,但它总表现的像是一个基类。它需要实例化的函数方法同Reader一样。然后FileReader这个类之所有有趣,主要还在于它有一些新加的超越Reader的特性。
当用户直接继承Reader类来创建自己的reader类的时候你必须也实例化文件操作函数。FileReader会提供方法直接进入或者操作文件数据,基于此,对于大部分实例,FileReader是一种非常合适的解决方案。
要使用更多的特性,只需要向下面一样自定义一个类继承DD::Image::FileReader即可。
class MyReader : public DD::Image::FileReader
{
...
};
FileReader的扩展特性有以下这些:
int DD::Image::FileReader::lock(FILE_OFFSET offset, int min_length, int length)
int DD::Image::FileReader::lock(FILE_OFFSET offset, int l)
int DD::Image::FileReader::lock(FILE_OFFSET offset, unsigned int l)
以上三个方法用于锁定给定参数上的数据。
const unsigned char& DD::Image::FileReader::byte( FILE_OFFSET n ) const
const unsigned char* DD::Image::FileReader::at( FILE_OFFSET n ) const
以上两个方法用于进入给定offset上的字节。
void DD::Image::FileReader::unlock()
解锁之前锁住的内存。
int DD::Image::FileReader::read(void* p, FILE_OFFSET offset, int min_, int max_)
int DD::Image::FileReader::read(void* p, FILE_OFFSET offset, int l)
int DD::Image::FileReader::read(void* p, File_OFFSET offset, unsigned int l)
直接读取存入内存的文件。
Reader的KNOBS机制:
在reader类中添加knobs需要额外的步骤,因为Reader类并不同于Ops。有特定的对象可以跟Reader一起被初始化和注册来赋予Reader类似常规Op创建Knobs的能力。有两个主要步骤如下:
1.继承一个DD::Image::ReaderFormat类。用这个ReaderFormat类就可以将knobs()及knob_changed()接口实例化了。
2.用你自己的reader类创建一个新的正确类型的对象,确保正确的reader format被初始化了。
代码如下:
class MyFileFormat : public DD::Image::ReaderFormat
{
// implementation of the knobs call
void knobs(Knob_Callback c)
} class MyReader : public DD::Image::FileReader
{
static const Description d;
} static Reader* build( Read* r, int fd, const unsigned char* b, int n )
{
return new MyReader( r, fd, b, n );
} static bool test( int fd, const unsigned char* block, int n )
{
return ( block[] == MY_MAGIC_BYTE );
} static ReaderFormat* buildformat(Read* iop)
{
return new MyFileFormat();
} const Reader::Description MyReader::d( "myFile\0", "my file format", build, test, buildFormat );
第一个MyFileFormat类是一个包装器,用来包含knobs类。第二个类即为MyReader,继承自FileReader,在类中定义了description。第三个代码块是对build函数的定义,第四个代码块是对test函数的定义,第五个是对buildformat函数的定义。最后定义Description函数,该函数是对MyReader类的一个说明,参数与Reader基类比较多了一个buildFormat。这也是FileReader基类的一个特点,有扩展属性,可以很方便的添加新的属性功能。
案例中就通过buildFormat函数新添加了knobs对象。
Reading MetaData:
Metadata可以再解码的时候使用相同的模式去读取。DD::Image::fetchMetaData( const char* key )实例化之后可以返回DD::Image::MetaData::Bundle的对象。代码如下:
class MyReader : public DD::Image::FileReader
{
...
DD::Image::MetaData::Bundle& fetchMetaData( const char* key )
{
return _metaData;
} DD::Image::MetaData::Bundle _metaData;
}
在这个案例中,_metaData信息可以在requested的时候获得。reader对象构建的时候这个metadata已经提前建好了。可以直接调用。
Testing with Tester:
正如之前提到的,当读取一个文件的时候,基于对应于文件格式的已注册的可用扩展名,Nuke会判断用哪一个reader来读取。这下面的代码是一个简单的测试模块来检查第一个字节来确保匹配MY_MAGIC_BYTE宏。这当然是一个简单的例子简单表示一下怎样设置该函数,真实的实例会检查更多更复杂的模式来确保匹配。(这个函数似乎是对指令地址逐一测试用的)test代码块如下:
#define MY_MAGIC_BYTE 0x000000001
static bool test( int fd, const unsigned char* block, int n )
{
return ( block[] == MY_MAGIC_BYTE );
}
第二个用来防止出现错误文件后缀的机制如下:
typedef bool (*Tester)(int fd, const unsigned char* buf, int bufsize);
DD::Image::Reader::(Tester* )( int fd,const unsigned char* block,int n )
Tester函数返回值是指针,执行结果是bool值,当指针非零时,表示一个Unix文件被用来存储图像了。这种情况下,Reader类就会打开这个Unix文件调用该函数。如果函数执行结果是True,那么对应reader就会被调用。当然该机制也允许所有的reader类对一个未知文件类型进行投票来确定谁来读取这个文件。
如果返回值是Null,那么图像就会以空值的形式传递给reader机制。
Working Metadata:
metadata在nuke中是通过DD::Image::Metadata::Bundle对象来解决的。这个抽象的对象提供了了所有需要读写的功能。
在使用metadata的过程中有两件事需要注意,metadata可以被分成两种机制:
1:nuke识别的默认的metadata机制。比如时码(DD::Image::MetaData::TIMECODE)这个关键字是用来存储特定值的。所以nuke读写时码的时候,使用这个关键字的。
2:自定义的metadata机制。如果你想用其他名称来代替timecode这个关键字,Nuke内部也会认可这种key-value值对的方式。
NDK学习笔记(五)Reader机制的更多相关文章
- C#可扩展编程之MEF学习笔记(五):MEF高级进阶
好久没有写博客了,今天抽空继续写MEF系列的文章.有园友提出这种系列的文章要做个目录,看起来方便,所以就抽空做了一个,放到每篇文章的最后. 前面四篇讲了MEF的基础知识,学完了前四篇,MEF中比较常用 ...
- (转)Qt Model/View 学习笔记 (五)——View 类
Qt Model/View 学习笔记 (五) View 类 概念 在model/view架构中,view从model中获得数据项然后显示给用户.数据显示的方式不必与model提供的表示方式相同,可以与 ...
- Java IO学习笔记五:BIO到NIO
作者:Grey 原文地址: Java IO学习笔记五:BIO到NIO 准备环境 准备一个CentOS7的Linux实例: 实例的IP: 192.168.205.138 我们这次实验的目的就是直观感受一 ...
- java之jvm学习笔记五(实践写自己的类装载器)
java之jvm学习笔记五(实践写自己的类装载器) 课程源码:http://download.csdn.net/detail/yfqnihao/4866501 前面第三和第四节我们一直在强调一句话,类 ...
- java学习笔记09--反射机制
java学习笔记09--反射机制 什么是反射: 反射是java语言的一个特性,它允许程序在运行时来进行自我检查并且对内部的成员进行操作.例如它允许一个java的类获取他所有的成员变量和方法并且显示出来 ...
- Learning ROS for Robotics Programming Second Edition学习笔记(五) indigo computer vision
中文译著已经出版,详情请参考:http://blog.csdn.net/ZhangRelay/article/category/6506865 Learning ROS for Robotics Pr ...
- Storm学习笔记 - 消息容错机制
Storm学习笔记 - 消息容错机制 文章来自「随笔」 http://jsynk.cn/blog/articles/153.html 1. Storm消息容错机制概念 一个提供了可靠的处理机制的spo ...
- Typescript 学习笔记五:类
中文网:https://www.tslang.cn/ 官网:http://www.typescriptlang.org/ 目录: Typescript 学习笔记一:介绍.安装.编译 Typescrip ...
- ES6学习笔记<五> Module的操作——import、export、as
import export 这两个家伙对应的就是es6自己的 module功能. 我们之前写的Javascript一直都没有模块化的体系,无法将一个庞大的js工程拆分成一个个功能相对独立但相互依赖的小 ...
随机推荐
- JavaBean转化为Map,List<JavaBean>转化为List<Map>
/** * 将对象转化为map * * @param bean * @param <T> * @return */ private <T> Map<String, Obj ...
- STP实验(指定特定交换机为根桥)
实验要求:将三层交换机设置为根桥交换机,并查看 拓扑如下: 涉及内容有: 1.根桥交换机的选举方式 2.生成树修改优先级成为根桥交换机 3.生成树直接指定根桥交换机 根桥交换机是根据优先级和MAC地址 ...
- [转]谈谈 Bias-Variance Tradeoff
https://liam0205.me/2017/03/25/bias-variance-tradeoff/ 谢谢原作者! 谈谈 Bias-Variance Tradeoff 发表于 2017 年 0 ...
- 2.28 查看webdriver API
2.28 查看webdriver API(带翻译) 前言 前面都是点点滴滴的介绍selenium的一些api使用方法,那么selenium的api到底有多少呢?本篇就教大家如何去查看seleni ...
- webgl,threejs教程、笔记
发现一个不错的博客,学学. webgl和threejs教程
- 使用Git来撤销修改
首先进入一个有Git管理的文件夹下: 当我们在文件编写过程中出现了一个错误怎么办呢?如下: 但是此时你并没有将文件提交缓冲区,你可以去手动打卡文件删除这个错误. 当然你也可以查看一下状态: 发现这个文 ...
- WEBBASE篇: 第一篇, HTML知识1
HTML知识1 1,web概述 WEB就是互联网上的一种应用程序 - 网页程序: 程序结构: (1)C / S: C:Client 客户端:S:Server 服务器: (2)B / S: B:Brow ...
- 牛客HJ浇花。
我也不知道这是什么类型的题,算是简单模拟吧.但是有个方法很赞. 开两个数组,一个模拟花,一个记录不同浇花次数花的数量: 要找浇水的次数,那么记每次浇水的开头和结尾就行了,a—b;那么f[a]++;f[ ...
- lamp 相关
1.LAMP = linux + apache + mysql(mariadb/mongodb) + php 2.mysql 安装:先下载安装包: wget -c http://mirrors.soh ...
- PTA——判断胖瘦
PTA 7-40 到底是不是太胖了 #include<stdio.h> #include<math.h> int main() { ,N; scanf("%d&quo ...