Blender文档翻译:ID Datablocks(ID数据块)

   ID数据块

源文为Blender官方文档:ID Datablocks

      对象,网格,材质,场景,这些都是ID数据块的例子。 它们通常在DNA_{某种类型}_types.h头文件中定义。
ID数据块是以一组公共属性开始的内存块。 在C中,这被建模为一个结构,它嵌入ID类型的结构作为第一个字段。 如果它有动画数据的形式的动画数据结构,这必须是第二个字段。 

typedef struct Mesh {
  ID id;
  struct AnimData *adt;
  …
};

       datablock的名称(pointer->id.name)对数据块的类型进行编码。 例如,在Blender用户界面中呈现的带有名称“Suzanne”的网格实际上在数据块中被命名为“MESuzanne”。 这可以用于将ID*id转换为正确的类型。 函数GS(name)可从这样的名称中获取并返回一个常量,该常量表明ID数据类型:if(GS(id->name)==ID_SC)...可以用来测试ID数据块是否是场景。

 ID类型的运行时注册

       在2020年初之前,ID数据块的类型在Blender中被硬编码。 作为代码清理日工作的一部分,这些被转换为运行时数据结构(参见T73719)。 本节描述ID类型注册的新方法。
       运行时类型信息存储在IDTypeInfo结构中。 这包含结构的元数据,以及指向一般操作(创建、复制、删除、make local等)的函数的指针。 这是此类结构的一个例子,本例是Objects:

IDTypeInfo IDType_ID_OB = {
    .id_code = ID_OB,
    .id_filter = FILTER_ID_OB,
    .main_listbase_index = INDEX_ID_OB,
    .struct_size = sizeof(Object),
    .name = "Object",
    .name_plural = "objects",
    .translation_context = BLT_I18NCONTEXT_ID_OBJECT,
    .flags = 0,

    .init_data = object_init_data,
    .copy_data = object_copy_data,
    .free_data = object_free_data,
    .make_local = object_make_local,
};

添加新ID类型

     要添加新的IDTypeInfo需要:

  1、在相关的BKE实现文件(如:mesh.c定义ID_ME,等等)定义IDTypeInfo.

    • 将static callbacks(回调函数)和IDTypeInfo结构放在这些文件的开头。
    • 如果您需要额外的帮助器,那么只需要将它们的forward声明放在那里,并在IDTypeInfo定义之后实现它们。 这使得每个ID类型实现文件的公共信息和特定API之间能够保持一致的清晰分离。
    • IDTypeInfo应该从其idcode命名开始(例如:object的IDType_ID_OB)。

  2、在BKE_IDType.h中添加新IDType的 extern声明

  3、在idtype.c的id_type_init()中注册新的IDTypeInfo。

处理ID类型的函数

     有许多函数可以用来帮助处理ID数据块。把它们列在这里肯定会过时的,你只要通读BKE_idtype.h。

 

posted @ 2020-10-24 13:34  平凡人  阅读(561)  评论(1编辑  收藏  举报