doxygen: prevent GPL license block from being parsed as doxygen comment.
[blender.git] / source / blender / makesrna / intern / rna_meta.c
index 7481759..e575eca 100644 (file)
@@ -1,4 +1,4 @@
-/**
+/*
  * $Id$
  *
  * ***** BEGIN GPL LICENSE BLOCK *****
@@ -25,6 +25,7 @@
 #include <stdlib.h>
 
 #include "RNA_define.h"
+#include "RNA_enum_types.h"
 
 #include "rna_internal.h"
 
@@ -35,6 +36,8 @@
 
 #include "BLI_math.h"
 
+#include "MEM_guardedalloc.h"
+
 #include "DNA_scene_types.h"
 #include "DNA_object_types.h"
 
@@ -89,12 +92,56 @@ static void rna_MetaBall_update_data(Main *bmain, Scene *scene, PointerRNA *ptr)
        MetaBall *mb= ptr->id.data;
        Object *ob;
 
-       for(ob=bmain->object.first; ob; ob= ob->id.next)
-               if(ob->data == mb)
-                       copy_mball_properties(scene, ob);
+       /* cheating way for importers to avoid slow updates */
+       if(mb->id.us > 0) {
+               for(ob=bmain->object.first; ob; ob= ob->id.next)
+                       if(ob->data == mb)
+                               copy_mball_properties(scene, ob);
+       
+               DAG_id_tag_update(&mb->id, 0);
+               WM_main_add_notifier(NC_GEOM|ND_DATA, mb);
+       }
+}
+
+static void rna_MetaBall_update_rotation(Main *bmain, Scene *scene, PointerRNA *ptr)
+{
+       MetaElem *ml= ptr->data;
+       normalize_qt(ml->quat);
+       rna_MetaBall_update_data(bmain, scene, ptr);
+}
+
+static MetaElem *rna_MetaBall_elements_new(MetaBall *mb, int type)
+{
+       MetaElem *ml= add_metaball_element(mb, type);
+
+       /* cheating way for importers to avoid slow updates */
+       if(mb->id.us > 0) {
+               DAG_id_tag_update(&mb->id, 0);
+               WM_main_add_notifier(NC_GEOM|ND_DATA, &mb->id);
+       }
 
-       DAG_id_flush_update(&mb->id, OB_RECALC_DATA);
-       WM_main_add_notifier(NC_GEOM|ND_DATA, mb);
+       return ml;
+}
+
+static void rna_MetaBall_elements_remove(MetaBall *mb, ReportList *reports, MetaElem *ml)
+{
+       int found= 0;
+
+       found= BLI_remlink_safe(&mb->elems, ml);
+
+       if(!found) {
+               BKE_reportf(reports, RPT_ERROR, "MetaBall \"%s\" does not contain spline given", mb->id.name+2);
+               return;
+       }
+
+       MEM_freeN(ml);
+       /* invalidate pointer!, no can do */
+
+       /* cheating way for importers to avoid slow updates */
+       if(mb->id.us > 0) {
+               DAG_id_tag_update(&mb->id, 0);
+               WM_main_add_notifier(NC_GEOM|ND_DATA, &mb->id);
+       }
 }
 
 #else
@@ -103,27 +150,20 @@ static void rna_def_metaelement(BlenderRNA *brna)
 {
        StructRNA *srna;
        PropertyRNA *prop;
-       static EnumPropertyItem prop_type_items[] = {
-               {MB_BALL, "BALL", ICON_META_BALL, "Ball", ""},
-               {MB_TUBE, "TUBE", ICON_META_TUBE, "Tube", ""},
-               {MB_PLANE, "PLANE", ICON_META_PLANE, "Plane", ""},
-               {MB_ELIPSOID, "ELLIPSOID", ICON_META_ELLIPSOID, "Ellipsoid", ""}, // NOTE: typo at original definition!
-               {MB_CUBE, "CUBE", ICON_META_CUBE, "Cube", ""},
-               {0, NULL, 0, NULL, NULL}};
-       
+
        srna= RNA_def_struct(brna, "MetaElement", NULL);
        RNA_def_struct_sdna(srna, "MetaElem");
        RNA_def_struct_ui_text(srna, "Meta Element", "Blobby element in a MetaBall datablock");
        RNA_def_struct_ui_icon(srna, ICON_OUTLINER_DATA_META);
-       
+
        /* enums */
        prop= RNA_def_property(srna, "type", PROP_ENUM, PROP_NONE);
-       RNA_def_property_enum_items(prop, prop_type_items);
+       RNA_def_property_enum_items(prop, metaelem_type_items);
        RNA_def_property_ui_text(prop, "Type", "Metaball types");
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
        
        /* number values */
-       prop= RNA_def_property(srna, "location", PROP_FLOAT, PROP_TRANSLATION);
+       prop= RNA_def_property(srna, "co", PROP_FLOAT, PROP_TRANSLATION);
        RNA_def_property_float_sdna(prop, NULL, "x");
        RNA_def_property_array(prop, 3);
        RNA_def_property_ui_text(prop, "Location", "");
@@ -131,8 +171,8 @@ static void rna_def_metaelement(BlenderRNA *brna)
 
        prop= RNA_def_property(srna, "rotation", PROP_FLOAT, PROP_QUATERNION);
        RNA_def_property_float_sdna(prop, NULL, "quat");
-       RNA_def_property_ui_text(prop, "Rotation", "");
-       RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
+       RNA_def_property_ui_text(prop, "Rotation", "Normalized quaternion rotation");
+       RNA_def_property_update(prop, 0, "rna_MetaBall_update_rotation");
 
        prop= RNA_def_property(srna, "radius", PROP_FLOAT, PROP_UNSIGNED|PROP_UNIT_LENGTH);
        RNA_def_property_float_sdna(prop, NULL, "rad");
@@ -165,7 +205,7 @@ static void rna_def_metaelement(BlenderRNA *brna)
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
        
        /* flags */
-       prop= RNA_def_property(srna, "negative", PROP_BOOLEAN, PROP_NONE);
+       prop= RNA_def_property(srna, "use_negative", PROP_BOOLEAN, PROP_NONE);
        RNA_def_property_boolean_sdna(prop, NULL, "flag", MB_NEGATIVE);
        RNA_def_property_ui_text(prop, "Negative", "Set metaball as negative one");
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
@@ -176,6 +216,37 @@ static void rna_def_metaelement(BlenderRNA *brna)
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
 }
 
+/* mball.elements */
+static void rna_def_metaball_elements(BlenderRNA *brna, PropertyRNA *cprop)
+{
+       StructRNA *srna;
+       PropertyRNA *prop;
+
+       FunctionRNA *func;
+       PropertyRNA *parm;
+
+       RNA_def_property_srna(cprop, "MetaBallElements");
+       srna= RNA_def_struct(brna, "MetaBallElements", NULL);
+       RNA_def_struct_sdna(srna, "MetaBall");
+       RNA_def_struct_ui_text(srna, "Meta Elements", "Collection of metaball elements");
+
+       func= RNA_def_function(srna, "new", "rna_MetaBall_elements_new");
+       RNA_def_function_ui_description(func, "Add a new spline to the curve.");
+       RNA_def_enum(func, "type", metaelem_type_items, MB_BALL, "", "type for the new meta element.");
+       parm= RNA_def_pointer(func, "element", "MetaElement", "", "The newly created metaelement.");
+       RNA_def_function_return(func, parm);
+
+       func= RNA_def_function(srna, "remove", "rna_MetaBall_elements_remove");
+       RNA_def_function_ui_description(func, "Remove a spline from a curve.");
+       RNA_def_function_flag(func, FUNC_USE_REPORTS);
+       parm= RNA_def_pointer(func, "element", "MetaElement", "", "The element to remove.");
+       RNA_def_property_flag(parm, PROP_REQUIRED|PROP_NEVER_NULL);
+
+       prop= RNA_def_property(srna, "active", PROP_POINTER, PROP_NONE);
+       RNA_def_property_pointer_sdna(prop, NULL, "lastelem");
+       RNA_def_property_ui_text(prop, "Active Element", "Last selected element");
+}
+
 static void rna_def_metaball(BlenderRNA *brna)
 {
        StructRNA *srna;
@@ -195,25 +266,23 @@ static void rna_def_metaball(BlenderRNA *brna)
        RNA_def_property_collection_sdna(prop, NULL, "elems", NULL);
        RNA_def_property_struct_type(prop, "MetaElement");
        RNA_def_property_ui_text(prop, "Elements", "Meta elements");
+       rna_def_metaball_elements(brna, prop);
 
-       prop= RNA_def_property(srna, "active_element", PROP_POINTER, PROP_NONE);
-       RNA_def_property_pointer_sdna(prop, NULL, "lastelem");
-       RNA_def_property_ui_text(prop, "Last selected element.", "Last selected element");
-       
        /* enums */
-       prop= RNA_def_property(srna, "flag", PROP_ENUM, PROP_NONE);
+       prop= RNA_def_property(srna, "update_method", PROP_ENUM, PROP_NONE);
+       RNA_def_property_enum_sdna(prop, NULL, "flag");
        RNA_def_property_enum_items(prop, prop_update_items);
        RNA_def_property_ui_text(prop, "Update", "Metaball edit update behavior");
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
        
        /* number values */
-       prop= RNA_def_property(srna, "wire_size", PROP_FLOAT, PROP_DISTANCE);
+       prop= RNA_def_property(srna, "resolution", PROP_FLOAT, PROP_DISTANCE);
        RNA_def_property_float_sdna(prop, NULL, "wiresize");
        RNA_def_property_range(prop, 0.050f, 1.0f);
        RNA_def_property_ui_text(prop, "Wire Size", "Polygonization resolution in the 3D viewport");
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
        
-       prop= RNA_def_property(srna, "render_size", PROP_FLOAT, PROP_DISTANCE);
+       prop= RNA_def_property(srna, "render_resolution", PROP_FLOAT, PROP_DISTANCE);
        RNA_def_property_float_sdna(prop, NULL, "rendersize");
        RNA_def_property_range(prop, 0.050f, 1.0f);
        RNA_def_property_ui_text(prop, "Render Size", "Polygonization resolution in rendering");
@@ -226,11 +295,11 @@ static void rna_def_metaball(BlenderRNA *brna)
        RNA_def_property_update(prop, 0, "rna_MetaBall_update_data");
 
        /* texture space */
-       prop= RNA_def_property(srna, "auto_texspace", PROP_BOOLEAN, PROP_NONE);
+       prop= RNA_def_property(srna, "use_auto_texspace", PROP_BOOLEAN, PROP_NONE);
        RNA_def_property_boolean_sdna(prop, NULL, "texflag", MB_AUTOSPACE);
        RNA_def_property_ui_text(prop, "Auto Texture Space", "Adjusts active object's texture space automatically when transforming object");
        
-       prop= RNA_def_property(srna, "texspace_loc", PROP_FLOAT, PROP_TRANSLATION);
+       prop= RNA_def_property(srna, "texspace_location", PROP_FLOAT, PROP_TRANSLATION);
        RNA_def_property_array(prop, 3);
        RNA_def_property_ui_text(prop, "Texture Space Location", "Texture space location");
        RNA_def_property_editable_func(prop, "rna_Meta_texspace_editable");
@@ -256,6 +325,7 @@ static void rna_def_metaball(BlenderRNA *brna)
        RNA_def_property_collection_sdna(prop, NULL, "mat", "totcol");
        RNA_def_property_struct_type(prop, "Material");
        RNA_def_property_ui_text(prop, "Materials", "");
+       RNA_def_property_srna(prop, "IDMaterials"); /* see rna_ID.c */  
        
        /* anim */
        rna_def_animdata_common(srna);