BRL-CAD
Loading...
Searching...
No Matches
Data Structures | Macros | Enumerations | Functions | Variables
db_attr.h File Reference
#include "common.h"
#include "bu/avs.h"
#include "rt/defines.h"
Include dependency graph for db_attr.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  db5_attr_ctype
 
struct  db5_registry
 

Macros

#define ATTR_STD(attr)   db5_standard_attribute(db5_standardize_attribute(attr))
 

Enumerations

enum  {
  ATTR_REGION = 0 , ATTR_REGION_ID , ATTR_MATERIAL_ID , ATTR_MATERIAL_NAME ,
  ATTR_AIR , ATTR_LOS , ATTR_COLOR , ATTR_SHADER ,
  ATTR_INHERIT , ATTR_TIMESTAMP , ATTR_NULL
}
 
enum  { ATTR_STANDARD = 0 , ATTR_USER_DEFINED , ATTR_UNKNOWN_ORIGIN }
 

Functions

void db5_attr_registry_init (struct db5_registry *registry)
 
void db5_attr_registry_free (struct db5_registry *registry)
 
int db5_attr_create (struct db5_registry *registry, int attr_type, int is_binary, int attr_subtype, const char *name, const char *description, const char *examples, const char *aliases, const char *property, const char *long_description)
 
int db5_attr_register (struct db5_registry *registry, struct db5_attr_ctype *attribute)
 
int db5_attr_deregister (struct db5_registry *registry, const char *name)
 
struct db5_attr_ctype * db5_attr_get (struct db5_registry *registry, const char *name)
 
struct db5_attr_ctype ** db5_attr_dump (struct db5_registry *registry)
 
const char * db5_standard_attribute (int idx)
 
const char * db5_standard_attribute_def (int idx)
 
int db5_is_standard_attribute (const char *attrname)
 
size_t db5_standardize_avs (struct bu_attribute_value_set *avs)
 
int db5_standardize_attribute (const char *attr)
 
void db5_sync_attr_to_comb (struct rt_comb_internal *comb, const struct bu_attribute_value_set *avs, struct directory *dp)
 
void db5_sync_comb_to_attr (struct bu_attribute_value_set *avs, const struct rt_comb_internal *comb)
 
int db5_import_attributes (struct bu_attribute_value_set *avs, const struct bu_external *ap)
 
void db5_export_attributes (struct bu_external *ap, const struct bu_attribute_value_set *avs)
 
struct bu_ptbl * db_lookup_by_attr (struct db_i *dbip, int dir_flags, struct bu_attribute_value_set *avs, int op)
 
int db5_put_color_table (struct db_i *dbip)
 
int db5_update_ident (struct db_i *dbip, const char *title, double local2mm)
 
int db5_update_attributes (struct directory *dp, struct bu_attribute_value_set *avsp, struct db_i *dbip)
 
int db5_update_attribute (const char *obj_name, const char *aname, const char *value, struct db_i *dbip)
 
int db5_replace_attributes (struct directory *dp, struct bu_attribute_value_set *avsp, struct db_i *dbip)
 
int db5_get_attributes (const struct db_i *dbip, struct bu_attribute_value_set *avs, const struct directory *dp)
 

Variables

const struct db5_attr_ctype db5_attr_std []
 

Macro Definition Documentation

◆ ATTR_STD

#define ATTR_STD (   attr)    db5_standard_attribute(db5_standardize_attribute(attr))

Definition at line 229 of file db_attr.h.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Define standard attribute types in BRL-CAD geometry. (See the attributes manual page.) These should be a collective enumeration starting from 0 and increasing without any gaps in the numbers so db5_standard_attribute() can be used as an index-based iterator.

Enumerator
ATTR_REGION 
ATTR_REGION_ID 
ATTR_MATERIAL_ID 
ATTR_MATERIAL_NAME 
ATTR_AIR 
ATTR_LOS 
ATTR_COLOR 
ATTR_SHADER 
ATTR_INHERIT 
ATTR_TIMESTAMP 
ATTR_NULL 

Definition at line 44 of file db_attr.h.

◆ anonymous enum

anonymous enum
Enumerator
ATTR_STANDARD 
ATTR_USER_DEFINED 
ATTR_UNKNOWN_ORIGIN 

Definition at line 59 of file db_attr.h.

Function Documentation

◆ db5_attr_registry_init()

void db5_attr_registry_init ( struct db5_registry *  registry)
extern

Initialize a user attribute registry

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_attr_registry_free()

void db5_attr_registry_free ( struct db5_registry *  registry)
extern

Free a user attribute registry

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_attr_create()

int db5_attr_create ( struct db5_registry *  registry,
int  attr_type,
int  is_binary,
int  attr_subtype,
const char *  name,
const char *  description,
const char *  examples,
const char *  aliases,
const char *  property,
const char *  long_description 
)
extern

Register a user attribute

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_attr_register()

int db5_attr_register ( struct db5_registry *  registry,
struct db5_attr_ctype *  attribute 
)
extern

Register a user attribute

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_attr_deregister()

int db5_attr_deregister ( struct db5_registry *  registry,
const char *  name 
)
extern

De-register a user attribute

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_attr_get()

struct db5_attr_ctype * db5_attr_get ( struct db5_registry *  registry,
const char *  name 
)
extern

Look to see if a specific attribute is registered

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_attr_dump()

struct db5_attr_ctype ** db5_attr_dump ( struct db5_registry *  registry)
extern

Get an array of pointers to all registered attributes

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_standard_attribute()

const char * db5_standard_attribute ( int  idx)
extern

Function returns the string name for a given standard attribute index. Index values returned from db5_standardize_attribute() correspond to the names returned from this function, returning the "standard" name. Callers may also iterate over all names starting with an index of zero until a NULL is returned.

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_standard_attribute_def()

const char * db5_standard_attribute_def ( int  idx)
extern

Function returns the string definition for a given standard attribute index. Index values returned from db5_standardize_attribute_def() correspond to the definition returned from this function, returning the "standard" definition. Callers may also iterate over all names starting with an index of zero until a NULL is returned.

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_is_standard_attribute()

int db5_is_standard_attribute ( const char *  attrname)
extern

Function for recognizing various versions of the DB5 standard attribute names that have been used - returns the attribute type of the supplied attribute name, or -1 if it is not a recognized variation of the standard attributes.

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_standardize_avs()

size_t db5_standardize_avs ( struct bu_attribute_value_set *  avs)
extern

Ensures that an attribute set containing standard attributes with non-standard/old/deprecated names gets the standard name added. It will update the first non-standard name encountered, but will leave any subsequent matching attributes found unmodified if they have different values. Such "conflict" attributes must be resolved manually.

Returns the number of conflicting attributes.

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_standardize_attribute()

int db5_standardize_attribute ( const char *  attr)
extern

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_sync_attr_to_comb()

void db5_sync_attr_to_comb ( struct rt_comb_internal *  comb,
const struct bu_attribute_value_set *  avs,
struct directory *  dp 
)
extern

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_sync_comb_to_attr()

void db5_sync_comb_to_attr ( struct bu_attribute_value_set *  avs,
const struct rt_comb_internal *  comb 
)
extern

PRIVATE: this is new API and should be considered private for the time being.

◆ db5_import_attributes()

int db5_import_attributes ( struct bu_attribute_value_set *  avs,
const struct bu_external *  ap 
)
extern

Convert the on-disk encoding into a handy easy-to-use bu_attribute_value_set structure.

Take advantage of the readonly_min/readonly_max capability so that we don't have to bu_strdup() each string, but can simply point to it in the provided buffer *ap. Important implication: don't free *ap until you're done with this avs.

The upshot of this is that bu_avs_add() and bu_avs_remove() can be safely used with this *avs.

Returns - >0 count of attributes successfully imported -1 Error, mal-formed input

◆ db5_export_attributes()

void db5_export_attributes ( struct bu_external *  ap,
const struct bu_attribute_value_set *  avs 
)
extern

Encode the attribute-value pair information into the external on-disk format.

The on-disk encoding is:

name1 NULL value1 NULL ... nameN NULL valueN NULL NULL

For binary attributes the on-disk encoding is:

bname1 NULL uchar valuelen1 comment1 NULL bvalue1 NULL ... bnameN NULL uchar valuelenN commentN NULL bvalueN NULL NULL

'ext' is initialized on behalf of the caller.

◆ db_lookup_by_attr()

struct bu_ptbl * db_lookup_by_attr ( struct db_i *  dbip,
int  dir_flags,
struct bu_attribute_value_set *  avs,
int  op 
)
extern

lookup directory entries based on directory flags (dp->d_flags) and attributes the "dir_flags" arg is a mask for the directory flags the *"avs" is an attribute value set used to select from the objects that *pass the flags mask. if "op" is 1, then the object must have all the *attributes and values that appear in "avs" in order to be *selected. If "op" is 2, then the object must have at least one of *the attribute/value pairs from "avs".

dir_flags are in the form used in struct directory (d_flags)

for op: 1 -> all attribute name/value pairs must be present and match 2 -> at least one of the name/value pairs must be present and match

returns a ptbl list of selected directory pointers. An empty list means nothing met the requirements and a NULL return means something went wrong.

◆ db5_put_color_table()

int db5_put_color_table ( struct db_i *  dbip)
extern

Put the old region-id-color-table into the global object. A null attribute is set if the material table is empty.

Returns - <0 error 0 OK

◆ db5_update_ident()

int db5_update_ident ( struct db_i *  dbip,
const char *  title,
double  local2mm 
)
extern

◆ db5_update_attributes()

int db5_update_attributes ( struct directory *  dp,
struct bu_attribute_value_set *  avsp,
struct db_i *  dbip 
)
extern

Update an arbitrary number of attributes on a given database object. For efficiency, this is done without looking at the object body at all.

Contents of the bu_attribute_value_set are freed, but not the struct itself.

Returns - 0 on success <0 on error

◆ db5_update_attribute()

int db5_update_attribute ( const char *  obj_name,
const char *  aname,
const char *  value,
struct db_i *  dbip 
)
extern

A convenience routine to update the value of a single attribute.

Returns - 0 on success <0 on error

◆ db5_replace_attributes()

int db5_replace_attributes ( struct directory *  dp,
struct bu_attribute_value_set *  avsp,
struct db_i *  dbip 
)
extern

Replace the attributes of a given database object.

For efficiency, this is done without looking at the object body at all. Contents of the bu_attribute_value_set are freed, but not the struct itself.

Returns - 0 on success <0 on error

◆ db5_get_attributes()

int db5_get_attributes ( const struct db_i *  dbip,
struct bu_attribute_value_set *  avs,
const struct directory *  dp 
)
extern

Get attributes for an object pointed to by *dp

returns: 0 - all is well <0 - error

Variable Documentation

◆ db5_attr_std

const struct db5_attr_ctype db5_attr_std[]
extern