Action:
|
Creates a spherical pattern.
|
|
Prototype:
|
outcome api_spherical_pattern (
|
|
|
pattern*& pat,
|
// created pattern
|
|
|
const SPAposition& center,// pattern center
|
|
|
int num_latitudes,
|
// # of latitudinal rings
|
|
|
|
|
// in the pattern
|
|
|
const SPAposition& root,
|
// position mapped to
|
|
|
|
|
// pattern sites
|
|
|
double spacing
|
// desired spacing for
|
|
|
|
= 0.0,
|
// pattern elements
|
|
|
AcisOptions* ao = NULL
|
// acis options
|
|
|
);
|
|
Includes:
|
#include "kernel/acis.hxx"
|
|
#include "baseutil/vector/position.hxx"
|
|
#include "kernel/kernapi/api/api.hxx"
|
|
#include "kernel/kernutil/law/pattern.hxx"
|
|
#include "kernel/kernutil/law/pattern_api.hxx"
|
|
#include "kernel/kernapi/api/acis_options.hxx"
|
|
Description:
|
Creates a two-dimensional spherical pattern about the
center position, with the pattern seed entity at one pole of the associated sphere. The pattern elements are approximately equally spaced, with the parameter
num_latitudes specifying by default the number of latitudinal rings in the pattern. If
num_latitudes is set to zero, this number is instead determined by the optional
spacing parameter. (This number must be specified if
num_latitudes is zero.) The root position of the pattern is given by root. The pattern coordinates for spacing are specified in the order (longitude, latitude).
|
|
Errors:
|
Both the spacing and the number of latitudes is zero.
|
|
Library:
|
kernel
|
|
Filename:
|
kern/kernel/kernutil/law/pattern_api.hxx
|
|
Effect:
|
Changes model
|