api_find_annotations
List of: Functions
Subjects: Feature Naming
Contents: Kernel

Action: Finds all annotation entities of a given type.

Prototype: outcome api_find_annotations (


ENTITY_LIST&, // list of annotation




// entities


is_fun // test for specific



= is_ANNOTATION, // type of annotation


BULLETIN_BOARD* bb // obsolete, ignored



= NULL,


AcisOptions* = NULL // acis options


);

Includes: #include "kernel/acis.hxx"

#include "kernel/kernapi/api/api.hxx"

#include "kernel/kernapi/api/kernapi.hxx"

#include "kernel/kerndata/bulletin/bulletin.hxx"

#include "kernel/kerndata/lists/lists.hxx"

#include "kernel/kernapi/api/acis_options.hxx"

Description: When the annotations option is turned on, certain modeling operations like blending or sweeping produce ANNOTATION class instances in internal ENTITY_LIST. The api_find_annotations function can be used to acquire a list of those annotations for user-defined processing. Generally, annotations are cleared manually from the list by using api_clear_annotations before the next modeling operation.


The flag for is_fun defaults to is_ANNOTATION. However, any is_ function for a class can be used. So, for example, to get the top vertex annotations from a sweep operation, this function can be passed is_SWEEP_ANNO_VERTEX_TOP as an argument.

Library: kernel

Filename: kern/kernel/kernapi/api/kernapi.hxx

Effect: Read-only
PDF/KERN/16FNA.PDF
HTM/DATA/KERN/KERN/16FNA/0042.HTM