misc.h

Go to the documentation of this file.

/*                      M I S C . H
 * BRL-CAD
 *
 * Copyright (c) 1993-2026 United States Government as represented by
 * the U.S. Army Research Laboratory.
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * version 2.1 as published by the Free Software Foundation.
 *
 * This library 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
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this file; see the file named COPYING for more
 * information.
 */
/** @file rt/misc.h
 *
 * Catch all for functions that don't have a clear sub-header yet.
 */
 
#ifndef RT_MISC_H
#define RT_MISC_H
 
#include "common.h"
#include "vmath.h"
#include "bu/ptbl.h"
#include "rt/defines.h"
#include "rt/resource.h"
 
__BEGIN_DECLS
 
/**
 * Append every database path from @p start to @p end to an initialized
 * @p paths table.  Combination trees, including region combinations, are
 * traversed.  The caller owns the returned db_full_path objects.
 */
RT_EXPORT extern int rt_find_paths(struct db_i *dbip,
                                   struct directory *start,
                                   struct directory *end,
                                   struct bu_ptbl *paths);
 
RT_EXPORT extern struct bu_bitv *rt_get_solidbitv(size_t nbits, struct resource *resp);
 
/* table.c */
RT_EXPORT extern int rt_id_solid(struct bu_external *ep);
 
/**
 * Used by MGED for labeling vertices of a solid.
 *
 * TODO - eventually this should fade into a general annotation
 * framework
 */
struct rt_point_labels {
    char str[8];
    point_t pt;
};
 
#define RT_POINT_LABELS_INIT { {'\0', '\0', '\0', '\0', '\0', '\0', '\0', '\0'}, VINIT_ZERO }
 
/**
 * reduce an object into some form of simpler representation
 */
RT_EXPORT extern void rt_reduce_obj(struct rt_db_internal *dest, const struct rt_db_internal *ip, fastf_t reduction_level, unsigned flags);
 
#define RT_REDUCE_OBJ_PRESERVE_VOLUME 0x1
 
/**
 * reduce the database hierarchy
 */
RT_EXPORT extern void rt_reduce_db(struct db_i *db, size_t num_preserved_attributes, const char * const * preserved_attributes, const struct bu_ptbl *preserved_combs_dirs);
 
/* below are librt table implementation detail */
 
RT_EXPORT extern int rt_generic_xform(struct rt_db_internal     *op,
                                      const mat_t               mat,
                                      struct rt_db_internal     *ip,
                                      int                       avail,
                                      struct db_i               *dbip);
RT_EXPORT extern void rt_generic_make(const struct rt_functab *ftp, struct rt_db_internal *intern);
 
 
__END_DECLS
 
#endif /* RT_MISC_H */
 
/*
 * Local Variables:
 * tab-width: 8
 * mode: C
 * indent-tabs-mode: t
 * c-file-style: "stroustrup"
 * End:
 * ex: shiftwidth=4 tabstop=8
 */