DNA_object_types.h

Go to the documentation of this file.

/*
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
 * All rights reserved.
 */
 
#pragma once
 
#include "DNA_object_enums.h"
 
#include "DNA_customdata_types.h"
#include "DNA_defs.h"
#include "DNA_lineart_types.h"
#include "DNA_listBase.h"
 
#include "DNA_ID.h"
#include "DNA_action_types.h" /* bAnimVizSettings */
#include "DNA_customdata_types.h"
#include "DNA_defs.h"
#include "DNA_listBase.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
struct AnimData;
struct BoundBox;
struct Curve;
struct FluidsimSettings;
struct GeometrySet;
struct Ipo;
struct Material;
struct Mesh;
struct Object;
struct PartDeflect;
struct Path;
struct RigidBodyOb;
struct SculptSession;
struct SoftBody;
struct bGPdata;
 
/* Vertex Groups - Name Info */
typedef struct bDeformGroup {
  struct bDeformGroup *next, *prev;
  char name[64];
  /* need this flag for locking weights */
  char flag, _pad0[7];
} bDeformGroup;
 
/* Face Maps*/
typedef struct bFaceMap {
  struct bFaceMap *next, *prev;
  char name[64];
  char flag;
  char _pad0[7];
} bFaceMap;
 
#define MAX_VGROUP_NAME 64
 
/* bDeformGroup->flag */
#define DG_LOCK_WEIGHT 1
 
typedef struct BoundBox {
  float vec[8][3];
  int flag;
  char _pad0[4];
} BoundBox;
 
/* boundbox flag */
enum {
  BOUNDBOX_DISABLED = (1 << 0),
  BOUNDBOX_DIRTY = (1 << 1),
};
 
struct CustomData_MeshMasks;
 
/* Not saved in file! */
typedef struct Object_Runtime {
  CustomData_MeshMasks last_data_mask;
 
  char last_need_mapping;
 
  char _pad0[3];
 
  float parent_display_origin[3];
 
  int select_id;
  char _pad1[3];
 
  char is_data_eval_owned;
 
  struct BoundBox *bb;
 
  struct ID *data_orig;
  struct ID *data_eval;
 
  struct GeometrySet *geometry_set_eval;
 
  void *geometry_set_previews;
 
  struct Mesh *mesh_deform_eval;
 
  struct bGPdata *gpd_orig;
  struct bGPdata *gpd_eval;
 
  struct Mesh *object_as_temp_mesh;
 
  struct Curve *object_as_temp_curve;
 
  struct CurveCache *curve_cache;
 
  unsigned short local_collections_bits;
  short _pad2[3];
  void *_pad3;
} Object_Runtime;
 
typedef struct ObjectLineArt {
  short usage;
  short flags;
 
  float crease_threshold;
} ObjectLineArt;
 
enum eObjectLineArt_Usage {
  OBJECT_LRT_INHERIT = 0,
  OBJECT_LRT_INCLUDE = (1 << 0),
  OBJECT_LRT_OCCLUSION_ONLY = (1 << 1),
  OBJECT_LRT_EXCLUDE = (1 << 2),
  OBJECT_LRT_INTERSECTION_ONLY = (1 << 3),
  OBJECT_LRT_NO_INTERSECTION = (1 << 4),
};
 
enum eObjectLineArt_Flags {
  OBJECT_LRT_OWN_CREASE = (1 << 0),
};
 
typedef struct Object {
  ID id;
  struct AnimData *adt;
  struct DrawDataList drawdata;
 
  struct SculptSession *sculpt;
 
  short type, partype;
  int par1, par2, par3;
  char parsubstr[64];
  struct Object *parent, *track;
  /* if ob->proxy (or proxy_group), this object is proxy for object ob->proxy */
  /* proxy_from is set in target back to the proxy. */
  struct Object *proxy, *proxy_group, *proxy_from;
  struct Ipo *ipo DNA_DEPRECATED;
  /* struct Path *path; */
  struct bAction *action DNA_DEPRECATED; /* XXX deprecated... old animation system */
  struct bAction *poselib;
  struct bPose *pose;
  void *data;
 
  struct bGPdata *gpd
      DNA_DEPRECATED; /* XXX deprecated... replaced by gpencil object, keep for readfile */
 
  bAnimVizSettings avs;
  bMotionPath *mpath;
  void *_pad0;
 
  ListBase constraintChannels DNA_DEPRECATED; /* XXX deprecated... old animation system */
  ListBase effect DNA_DEPRECATED;             /* XXX deprecated... keep for readfile */
  ListBase defbase;
  ListBase modifiers;
  ListBase greasepencil_modifiers;
  ListBase fmaps;
  ListBase shader_fx;
 
  int mode;
  int restore_mode;
 
  /* materials */
  struct Material **mat;
  char *matbits;
  int totcol;
  int actcol;
 
  /* rot en drot have to be together! (transform('r' en 's')) */
  float loc[3], dloc[3];
  float scale[3];
  float dsize[3] DNA_DEPRECATED;
  float dscale[3];
  float rot[3], drot[3];
  float quat[4], dquat[4];
  float rotAxis[3], drotAxis[3];
  float rotAngle, drotAngle;
  float obmat[4][4];
  float parentinv[4][4];
  float constinv[4][4];
  float imat[4][4];
 
  /* Previously 'imat' was used at render time, but as other places use it too
   * the interactive ui of 2.5 creates problems. So now only 'imat_ren' should
   * be used when ever the inverse of ob->obmat * re->viewmat is needed! - jahka
   */
  float imat_ren[4][4];
 
  unsigned int lay DNA_DEPRECATED;
 
  short flag;
  short colbits DNA_DEPRECATED;
 
  short transflag, protectflag;
  short trackflag, upflag;
  short nlaflag;
 
  char _pad1;
  char duplicator_visibility_flag;
 
  /* Depsgraph */
  short base_flag;
  unsigned short base_local_view_bits;
 
  unsigned short col_group, col_mask;
 
  short rotmode;
 
  char boundtype;
  char collision_boundtype;
 
  short dtx;
  char dt;
  char empty_drawtype;
  float empty_drawsize;
  float instance_faces_scale;
 
  short index;
  unsigned short actdef;
  unsigned short actfmap;
  char _pad2[2];
  float color[4];
 
  short softflag;
 
  char restrictflag;
 
  char shapeflag;
  short shapenr;
 
  char _pad3[2];
 
  ListBase constraints;
  ListBase nlastrips DNA_DEPRECATED; /* XXX deprecated... old animation system */
  ListBase hooks DNA_DEPRECATED;     /* XXX deprecated... old animation system */
  ListBase particlesystem;
 
  struct PartDeflect *pd;
  struct SoftBody *soft;
  struct Collection *instance_collection;
 
  struct FluidsimSettings *fluidsimSettings
      DNA_DEPRECATED; /* XXX deprecated... replaced by mantaflow, keep for readfile */
 
  ListBase pc_ids;
 
  struct RigidBodyOb *rigidbody_object;
  struct RigidBodyCon *rigidbody_constraint;
 
  float ima_ofs[2];
  ImageUser *iuser;
  char empty_image_visibility_flag;
  char empty_image_depth;
  char empty_image_flag;
  char _pad8[5];
 
  struct PreviewImage *preview;
 
  ObjectLineArt lineart;
 
  void *_pad9;
  Object_Runtime runtime;
} Object;
 
/* Warning, this is not used anymore because hooks are now modifiers */
typedef struct ObHook {
  struct ObHook *next, *prev;
 
  struct Object *parent;
  float parentinv[4][4];
  float mat[4][4];
  float cent[3];
  float falloff;
 
  char name[64];
 
  int *indexar;
  int totindex, curindex;
  short type, active;
  float force;
} ObHook;
 
/* **************** OBJECT ********************* */
 
/* used many places... should be specialized  */
#define SELECT 1
 
#define OBJECT_ACTIVE_MODIFIER_NONE -1
 
/* type */
enum {
  OB_EMPTY = 0,
  OB_MESH = 1,
  OB_CURVE = 2,
  OB_SURF = 3,
  OB_FONT = 4,
  OB_MBALL = 5,
 
  OB_LAMP = 10,
  OB_CAMERA = 11,
 
  OB_SPEAKER = 12,
  OB_LIGHTPROBE = 13,
 
  OB_LATTICE = 22,
 
  OB_ARMATURE = 25,
 
  OB_GPENCIL = 26,
 
  OB_HAIR = 27,
 
  OB_POINTCLOUD = 28,
 
  OB_VOLUME = 29,
 
  /* Keep last. */
  OB_TYPE_MAX,
};
 
/* check if the object type supports materials */
#define OB_TYPE_SUPPORT_MATERIAL(_type) \
  (((_type) >= OB_MESH && (_type) <= OB_MBALL) || ((_type) >= OB_GPENCIL && (_type) <= OB_VOLUME))
#define OB_TYPE_SUPPORT_VGROUP(_type) (ELEM(_type, OB_MESH, OB_LATTICE, OB_GPENCIL))
#define OB_TYPE_SUPPORT_EDITMODE(_type) \
  (ELEM(_type, OB_MESH, OB_FONT, OB_CURVE, OB_SURF, OB_MBALL, OB_LATTICE, OB_ARMATURE))
#define OB_TYPE_SUPPORT_PARVERT(_type) (ELEM(_type, OB_MESH, OB_SURF, OB_CURVE, OB_LATTICE))
 
#define OB_DATA_SUPPORT_EDITMODE(_type) (ELEM(_type, ID_ME, ID_CU, ID_MB, ID_LT, ID_AR))
 
/* is this ID type used as object data */
#define OB_DATA_SUPPORT_ID(_id_type) \
  (ELEM(_id_type, \
        ID_ME, \
        ID_CU, \
        ID_MB, \
        ID_LA, \
        ID_SPK, \
        ID_LP, \
        ID_CA, \
        ID_LT, \
        ID_GD, \
        ID_AR, \
        ID_HA, \
        ID_PT, \
        ID_VO))
 
#define OB_DATA_SUPPORT_ID_CASE \
  ID_ME: \
  case ID_CU: \
  case ID_MB: \
  case ID_LA: \
  case ID_SPK: \
  case ID_LP: \
  case ID_CA: \
  case ID_LT: \
  case ID_GD: \
  case ID_AR: \
  case ID_HA: \
  case ID_PT: \
  case ID_VO
 
/* partype: first 4 bits: type */
enum {
  PARTYPE = (1 << 4) - 1,
  PAROBJECT = 0,
  PARSKEL = 4,
  PARVERT1 = 5,
  PARVERT3 = 6,
  PARBONE = 7,
 
};
 
/* (short) transflag */
enum {
  OB_TRANSFORM_ADJUST_ROOT_PARENT_FOR_VIEW_LOCK = 1 << 0,
  OB_TRANSFLAG_UNUSED_1 = 1 << 1, /* cleared */
  OB_NEG_SCALE = 1 << 2,
  OB_TRANSFLAG_UNUSED_3 = 1 << 3, /* cleared */
  OB_DUPLIVERTS = 1 << 4,
  OB_DUPLIROT = 1 << 5,
  OB_TRANSFLAG_UNUSED_6 = 1 << 6, /* cleared */
  /* runtime, calculate derivedmesh for dupli before it's used */
  OB_TRANSFLAG_UNUSED_7 = 1 << 7, /* dirty */
  OB_DUPLICOLLECTION = 1 << 8,
  OB_DUPLIFACES = 1 << 9,
  OB_DUPLIFACES_SCALE = 1 << 10,
  OB_DUPLIPARTS = 1 << 11,
  OB_TRANSFLAG_UNUSED_12 = 1 << 12, /* cleared */
  /* runtime constraints disable */
  OB_NO_CONSTRAINTS = 1 << 13,
 
  OB_DUPLI = OB_DUPLIVERTS | OB_DUPLICOLLECTION | OB_DUPLIFACES | OB_DUPLIPARTS,
};
 
/* (short) trackflag / upflag */
enum {
  OB_POSX = 0,
  OB_POSY = 1,
  OB_POSZ = 2,
  OB_NEGX = 3,
  OB_NEGY = 4,
  OB_NEGZ = 5,
};
 
/* dtx: flags (short) */
enum {
  OB_DRAWBOUNDOX = 1 << 0,
  OB_AXIS = 1 << 1,
  OB_TEXSPACE = 1 << 2,
  OB_DRAWNAME = 1 << 3,
  /* OB_DRAWIMAGE = 1 << 4, */ /* UNUSED */
  /* for solid+wire display */
  OB_DRAWWIRE = 1 << 5,
  /* for overdraw s*/
  OB_DRAW_IN_FRONT = 1 << 6,
  /* enable transparent draw */
  OB_DRAWTRANSP = 1 << 7,
  OB_DRAW_ALL_EDGES = 1 << 8, /* only for meshes currently */
  OB_DRAW_NO_SHADOW_CAST = 1 << 9,
  /* Enable lights for grease pencil. */
  OB_USE_GPENCIL_LIGHTS = 1 << 10,
};
 
/* empty_drawtype: no flags */
enum {
  OB_ARROWS = 1,
  OB_PLAINAXES = 2,
  OB_CIRCLE = 3,
  OB_SINGLE_ARROW = 4,
  OB_CUBE = 5,
  OB_EMPTY_SPHERE = 6,
  OB_EMPTY_CONE = 7,
  OB_EMPTY_IMAGE = 8,
};
 
/* gpencil add types */
enum {
  GP_EMPTY = 0,
  GP_STROKE = 1,
  GP_MONKEY = 2,
  GP_LRT_SCENE = 3,
  GP_LRT_OBJECT = 4,
  GP_LRT_COLLECTION = 5,
};
 
/* boundtype */
enum {
  OB_BOUND_BOX = 0,
  OB_BOUND_SPHERE = 1,
  OB_BOUND_CYLINDER = 2,
  OB_BOUND_CONE = 3,
  /* OB_BOUND_TRIANGLE_MESH = 4, */  /* UNUSED */
  /* OB_BOUND_CONVEX_HULL = 5, */    /* UNUSED */
  /*  OB_BOUND_DYN_MESH      = 6, */ /*UNUSED*/
  OB_BOUND_CAPSULE = 7,
};
 
/* **************** BASE ********************* */
 
/* base->flag_legacy */
enum {
  BA_WAS_SEL = (1 << 1),
  /* NOTE: BA_HAS_RECALC_DATA can be re-used later if freed in readfile.c. */
  // BA_HAS_RECALC_OB = (1 << 2),  /* DEPRECATED */
  // BA_HAS_RECALC_DATA =  (1 << 3),  /* DEPRECATED */
  BA_SNAP_FIX_DEPS_FIASCO = (1 << 2),
};
 
/* NOTE: this was used as a proper setting in past, so nullify before using */
#define BA_TEMP_TAG (1 << 5)
 
#define BA_TRANSFORM_LOCKED_IN_PLACE (1 << 7)
 
#define BA_TRANSFORM_CHILD (1 << 8)   /* child of a transformed object */
#define BA_TRANSFORM_PARENT (1 << 13) /* parent of a transformed object */
 
#define OB_FROMDUPLI (1 << 9)
#define OB_DONE (1 << 10) /* unknown state, clear before use */
#ifdef DNA_DEPRECATED_ALLOW
#  define OB_FLAG_UNUSED_11 (1 << 11) /* cleared */
#  define OB_FLAG_UNUSED_12 (1 << 12) /* cleared */
#endif
 
/* ob->restrictflag */
enum {
  OB_RESTRICT_VIEWPORT = 1 << 0,
  OB_RESTRICT_SELECT = 1 << 1,
  OB_RESTRICT_RENDER = 1 << 2,
};
 
/* ob->shapeflag */
enum {
  OB_SHAPE_LOCK = 1 << 0,
#ifdef DNA_DEPRECATED_ALLOW
  OB_SHAPE_FLAG_UNUSED_1 = 1 << 1, /* cleared */
#endif
  OB_SHAPE_EDIT_MODE = 1 << 2,
};
 
/* ob->nlaflag */
enum {
  OB_ADS_UNUSED_1 = 1 << 0, /* cleared */
  OB_ADS_UNUSED_2 = 1 << 1, /* cleared */
  /* object-channel expanded status */
  OB_ADS_COLLAPSED = 1 << 10,
  /* object's ipo-block */
  /* OB_ADS_SHOWIPO = 1 << 11, */ /* UNUSED */
  /* object's constraint channels */
  /* OB_ADS_SHOWCONS = 1 << 12, */ /* UNUSED */
  /* object's material channels */
  /* OB_ADS_SHOWMATS = 1 << 13, */ /* UNUSED */
  /* object's marticle channels */
  /* OB_ADS_SHOWPARTS = 1 << 14, */ /* UNUSED */
};
 
/* ob->protectflag */
enum {
  OB_LOCK_LOCX = 1 << 0,
  OB_LOCK_LOCY = 1 << 1,
  OB_LOCK_LOCZ = 1 << 2,
  OB_LOCK_LOC = OB_LOCK_LOCX | OB_LOCK_LOCY | OB_LOCK_LOCZ,
  OB_LOCK_ROTX = 1 << 3,
  OB_LOCK_ROTY = 1 << 4,
  OB_LOCK_ROTZ = 1 << 5,
  OB_LOCK_ROT = OB_LOCK_ROTX | OB_LOCK_ROTY | OB_LOCK_ROTZ,
  OB_LOCK_SCALEX = 1 << 6,
  OB_LOCK_SCALEY = 1 << 7,
  OB_LOCK_SCALEZ = 1 << 8,
  OB_LOCK_SCALE = OB_LOCK_SCALEX | OB_LOCK_SCALEY | OB_LOCK_SCALEZ,
  OB_LOCK_ROTW = 1 << 9,
  OB_LOCK_ROT4D = 1 << 10,
};
 
/* ob->duplicator_visibility_flag */
enum {
  OB_DUPLI_FLAG_VIEWPORT = 1 << 0,
  OB_DUPLI_FLAG_RENDER = 1 << 1,
};
 
/* ob->empty_image_depth */
#define OB_EMPTY_IMAGE_DEPTH_DEFAULT 0
#define OB_EMPTY_IMAGE_DEPTH_FRONT 1
#define OB_EMPTY_IMAGE_DEPTH_BACK 2
 
enum {
  OB_EMPTY_IMAGE_HIDE_PERSPECTIVE = 1 << 0,
  OB_EMPTY_IMAGE_HIDE_ORTHOGRAPHIC = 1 << 1,
  OB_EMPTY_IMAGE_HIDE_BACK = 1 << 2,
  OB_EMPTY_IMAGE_HIDE_FRONT = 1 << 3,
  OB_EMPTY_IMAGE_HIDE_NON_AXIS_ALIGNED = 1 << 4,
};
 
enum {
  OB_EMPTY_IMAGE_USE_ALPHA_BLEND = 1 << 0,
};
 
#define MAX_DUPLI_RECUR 8
 
#ifdef __cplusplus
}
#endif