Panda3D
Classes | Public Member Functions | Static Public Member Functions | Public Attributes | Friends | List of all members
FINAL Class Reference

This describes the structure of a single array within a Geom data. More...

#include "geomVertexArrayFormat.h"

Inheritance diagram for FINAL:
NodeCachedReferenceCount TypedWritableReferenceCount TypedWritableReferenceCount GeomEnums TypedWritableReferenceCount GeomEnums CachedTypedWritableReferenceCount TypedWritable ReferenceCount TypedWritable ReferenceCount TypedWritable ReferenceCount TypedWritableReferenceCount TypedObject MemoryBase TypedObject MemoryBase TypedObject MemoryBase TypedWritable ReferenceCount MemoryBase MemoryBase MemoryBase TypedObject MemoryBase MemoryBase

Public Member Functions

int add_array (const GeomVertexArrayFormat *array_format)
 
int add_column (CPT_InternalName name, int num_components, NumericType numeric_type, Contents contents, int start=-1, int column_alignment=0)
 
int add_column (const GeomVertexColumn &column)
 
void align_columns_for_animation ()
 
void align_columns_for_animation ()
 
void cache_ref () const
 
bool cache_unref () const
 
void clear_arrays ()
 
void clear_columns ()
 
int compare_to (const TransformState &other) const
 
int compare_to (const TransformState &other, bool uniquify_matrix) const
 
int compare_to (const GeomVertexArrayFormat &other) const
 
int compare_to (const GeomVertexFormat &other) const
 
virtual int complete_pointers (TypedWritable **plist, BamReader *manager)
 Receives an array of pointers, one for each time manager->read_pointer() was called in fillin(). More...
 
virtual int complete_pointers (TypedWritable **plist, BamReader *manager)
 Receives an array of pointers, one for each time manager->read_pointer() was called in fillin(). More...
 
bool components_given () const
 
int count_unused_space () const
 
 CPT (GeomVertexFormat) get_post_animated_format() const
 
 CPT (GeomVertexFormat) get_union_format(const GeomVertexFormat *other) const
 
 CPT (TransformState) set_pos(const LVecBase3 &pos) const
 
 CPT (TransformState) set_hpr(const LVecBase3 &hpr) const
 
 CPT (TransformState) set_quat(const LQuaternion &quat) const
 
 CPT (TransformState) set_scale(const LVecBase3 &scale) const
 
 CPT (TransformState) set_shear(const LVecBase3 &shear) const
 
 CPT (TransformState) set_pos2d(const LVecBase2 &pos) const
 
 CPT (TransformState) set_rotate2d(PN_stdfloat rotate) const
 
 CPT (TransformState) set_scale2d(const LVecBase2 &scale) const
 
 CPT (TransformState) set_shear2d(PN_stdfloat shear) const
 
 CPT (TransformState) compose(const TransformState *other) const
 
 CPT (TransformState) invert_compose(const TransformState *other) const
 
 CPT (TransformState) get_inverse() const
 
 CPT (TransformState) get_unique() const
 
virtual void finalize (BamReader *manager)
 Called by the BamReader to perform any final actions needed for setting up the object after all objects have been read and all pointers have been completed. More...
 
virtual void finalize (BamReader *manager)
 Called by the BamReader to perform any final actions needed for setting up the object after all objects have been read and all pointers have been completed. More...
 
int find_ancestor (const string &basename) const
 
virtual TypeHandle force_init_type ()
 
virtual TypeHandle force_init_type ()
 
virtual TypeHandle force_init_type ()
 
virtual TypeHandle force_init_type ()
 
 GeomVertexArrayFormat ()
 
 GeomVertexArrayFormat (const GeomVertexArrayFormat &copy)
 
 GeomVertexArrayFormat (CPT_InternalName name0, int num_components0, NumericType numeric_type0, Contents contents0)
 
 GeomVertexArrayFormat (CPT_InternalName name0, int num_components0, NumericType numeric_type0, Contents contents0, CPT_InternalName name1, int num_components1, NumericType numeric_type1, Contents contents1)
 
 GeomVertexArrayFormat (CPT_InternalName name0, int num_components0, NumericType numeric_type0, Contents contents0, CPT_InternalName name1, int num_components1, NumericType numeric_type1, Contents contents1, CPT_InternalName name2, int num_components2, NumericType numeric_type2, Contents contents2)
 
 GeomVertexArrayFormat (CPT_InternalName name0, int num_components0, NumericType numeric_type0, Contents contents0, CPT_InternalName name1, int num_components1, NumericType numeric_type1, Contents contents1, CPT_InternalName name2, int num_components2, NumericType numeric_type2, Contents contents2, CPT_InternalName name3, int num_components3, NumericType numeric_type3, Contents contents3)
 
 GeomVertexFormat ()
 
 GeomVertexFormat (const GeomVertexArrayFormat *array_format)
 
 GeomVertexFormat (const GeomVertexFormat &copy)
 
const InternalName * get_ancestor (int n) const
 
const GeomVertexAnimationSpecget_animation () const
 
const GeomVertexArrayFormat * get_array (int array) const
 
bool get_array_info (const InternalName *name, int &array_index, const GeomVertexColumn *&column) const
 
int get_array_with (int i) const
 
int get_array_with (const InternalName *name) const
 
const string & get_basename () const
 
int get_color_array_index () const
 
const GeomVertexColumnget_color_column () const
 
const GeomVertexColumnget_column (int i) const
 
const GeomVertexColumnget_column (const InternalName *name) const
 
const GeomVertexColumnget_column (int i) const
 
const GeomVertexColumnget_column (const InternalName *name) const
 
const GeomVertexColumnget_column (int start_byte, int num_bytes) const
 
int get_composition_cache_num_entries () const
 
const TransformState * get_composition_cache_result (int n) const
 
int get_composition_cache_size () const
 
const TransformState * get_composition_cache_source (int n) const
 
int get_divisor () const
 
string get_format_string (bool pad=true) const
 
int get_geom_rendering (int geom_rendering) const
 
size_t get_hash () const
 
const LVecBase3get_hpr () const
 
int get_invert_composition_cache_num_entries () const
 
const TransformState * get_invert_composition_cache_result (int n) const
 
int get_invert_composition_cache_size () const
 
const TransformState * get_invert_composition_cache_source (int n) const
 
const LMatrix4get_mat () const
 
LMatrix3 get_mat3 () const
 
const InternalName * get_morph_base (int n) const
 
const InternalName * get_morph_delta (int n) const
 
const InternalName * get_morph_slider (int n) const
 
string get_name () const
 
string get_net_basename (int n) const
 
const LQuaternionget_norm_quat () const
 
int get_normal_array_index () const
 
const GeomVertexColumnget_normal_column () const
 
int get_num_arrays () const
 
int get_num_columns () const
 
int get_num_columns () const
 
int get_num_morphs () const
 
int get_num_points () const
 
int get_num_texcoords () const
 
int get_num_vectors () const
 
int get_pad_to () const
 
InternalName * get_parent () const
 
const InternalName * get_point (int n) const
 
const LPoint3get_pos () const
 
LVecBase2 get_pos2d () const
 
const LQuaternionget_quat () const
 
PN_stdfloat get_rotate2d () const
 
const LVecBase3get_scale () const
 
LVecBase2 get_scale2d () const
 
const LVecBase3get_shear () const
 
PN_stdfloat get_shear2d () const
 
int get_stride () const
 
const InternalName * get_texcoord (int n) const
 
const InternalName * get_top () const
 
int get_total_bytes () const
 
virtual TypeHandle get_type () const
 
virtual TypeHandle get_type () const
 
virtual TypeHandle get_type () const
 
virtual TypeHandle get_type () const
 
PN_stdfloat get_uniform_scale () const
 
const InternalName * get_vector (int n) const
 
int get_vertex_array_index () const
 
const GeomVertexColumnget_vertex_column () const
 
bool has_column (const InternalName *name) const
 
bool has_column (const InternalName *name) const
 
bool has_components () const
 
bool has_hpr () const
 
bool has_identity_scale () const
 
bool has_mat () const
 
bool has_nonzero_shear () const
 
bool has_pos () const
 
bool has_quat () const
 
bool has_scale () const
 
bool has_shear () const
 
bool has_uniform_scale () const
 
bool hpr_given () const
 
void insert_array (int array, const GeomVertexArrayFormat *array_format)
 
bool is_2d () const
 
bool is_data_subset_of (const GeomVertexArrayFormat &other) const
 
bool is_identity () const
 
bool is_invalid () const
 
bool is_registered () const
 
bool is_registered () const
 
bool is_singular () const
 
string join (const string &sep) const
 
 MAKE_SEQ (get_arrays, get_num_arrays, get_array)
 
 MAKE_SEQ (get_columns, get_num_columns, get_column)
 
 MAKE_SEQ (get_columns, get_num_columns, get_column)
 
 MAKE_SEQ (get_points, get_num_points, get_point)
 
 MAKE_SEQ (get_vectors, get_num_vectors, get_vector)
 
 MAKE_SEQ (get_texcoords, get_num_texcoords, get_texcoord)
 
 MAKE_SEQ (get_morph_sliders, get_num_morphs, get_morph_slider)
 
 MAKE_SEQ (get_morph_bases, get_num_morphs, get_morph_base)
 
 MAKE_SEQ (get_morph_deltas, get_num_morphs, get_morph_delta)
 
void maybe_align_columns_for_animation ()
 
GeomVertexArrayFormat * modify_array (int array)
 
void node_ref () const
 
bool node_unref () const
 
bool operator!= (const TransformState &other) const
 
void operator= (const GeomVertexFormat &copy)
 
void operator= (const GeomVertexArrayFormat &copy)
 
bool operator== (const TransformState &other) const
 
void output (ostream &out) const
 
void output (ostream &out) const
 
void output (ostream &out) const
 
void output (ostream &out) const
 
void pack_columns ()
 
void pack_columns ()
 
 PT (InternalName) append(const string &basename)
 
bool quat_given () const
 
void remove_array (int array)
 
void remove_column (const InternalName *name)
 
void remove_column (const InternalName *name, bool keep_empty_array=false)
 
void remove_empty_arrays ()
 
void set_animation (const GeomVertexAnimationSpec &animation)
 
void set_array (int array, const GeomVertexArrayFormat *format)
 
void set_divisor (int divisor)
 
void set_pad_to (int pad_to)
 
void set_stride (int stride)
 
virtual bool unref () const
 Explicitly decrements the reference count. More...
 
virtual bool unref () const
 Explicitly decrements the reference count. More...
 
virtual bool unref () const
 Explicitly decrements the reference count. More...
 
virtual bool unref () const
 Explicitly decrements the reference count. More...
 
bool validate_composition_cache () const
 
void write (ostream &out, int indent_level=0) const
 
void write (ostream &out, int indent_level=0) const
 
void write (ostream &out, int indent_level) const
 
void write_composition_cache (ostream &out, int indent_level) const
 
virtual void write_datagram (BamWriter *manager, Datagram &me)
 Writes the contents of this object to the datagram for shipping out to a Bam file. More...
 
virtual void write_datagram (BamWriter *manager, Datagram &dg)
 Writes the contents of this object to the datagram for shipping out to a Bam file. More...
 
virtual void write_datagram (BamWriter *manager, Datagram &dg)
 Writes the contents of this object to the datagram for shipping out to a Bam file. More...
 
virtual void write_datagram (BamWriter *manager, Datagram &dg)
 Writes the contents of this object to the datagram for shipping out to a Bam file. More...
 
void write_with_data (ostream &out, int indent_level, const GeomVertexArrayData *array_data) const
 
void write_with_data (ostream &out, int indent_level, const GeomVertexData *data) const
 
- Public Member Functions inherited from NodeCachedReferenceCount
int get_node_ref_count () const
 Returns the current reference count. More...
 
int get_referenced_bits () const
 Returns the union of the values defined in the Referenced enum that represents the various things that appear to be holding a pointer to this object. More...
 
void node_ref () const
 Explicitly increments the reference count. More...
 
bool node_unref () const
 Explicitly decrements the node reference count and the normal reference count simultaneously. More...
 
bool test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
- Public Member Functions inherited from CachedTypedWritableReferenceCount
void cache_ref () const
 Explicitly increments the cache reference count and the normal reference count simultaneously. More...
 
bool cache_unref () const
 Explicitly decrements the cache reference count and the normal reference count simultaneously. More...
 
int get_cache_ref_count () const
 Returns the current reference count. More...
 
bool test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
- Public Member Functions inherited from TypedWritableReferenceCount
 TypedWritableReferenceCount (const TypedWritableReferenceCount &copy)
 
virtual ReferenceCountas_reference_count ()
 Returns the pointer cast to a ReferenceCount pointer, if it is in fact of that type. More...
 
void operator= (const TypedWritableReferenceCount &copy)
 
- Public Member Functions inherited from TypedWritable
 TypedWritable (const TypedWritable &copy)
 
string encode_to_bam_stream () const
 Converts the TypedWritable object into a single stream of data using a BamWriter, and returns that data as a string string. More...
 
bool encode_to_bam_stream (string &data, BamWriter *writer=NULL) const
 Converts the TypedWritable object into a single stream of data using a BamWriter, and stores that data in the indicated string. More...
 
UpdateSeq get_bam_modified () const
 Returns the current bam_modified counter. More...
 
void mark_bam_modified ()
 Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams. More...
 
void operator= (const TypedWritable &copy)
 
virtual bool require_fully_complete () const
 Some objects require all of their nested pointers to have been completed before the objects themselves can be completed. More...
 
virtual void update_bam_nested (BamWriter *manager)
 Called by the BamWriter when this object has not itself been modified recently, but it should check its nested objects for updates. More...
 
- Public Member Functions inherited from TypedObject
 TypedObject (const TypedObject &copy)
 
TypedObjectas_typed_object ()
 Returns the object, upcast (if necessary) to a TypedObject pointer. More...
 
const TypedObjectas_typed_object () const
 Returns the object, upcast (if necessary) to a TypedObject pointer. More...
 
int get_best_parent_from_Set (const std::set< int > &) const
 
int get_type_index () const
 Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. More...
 
bool is_exact_type (TypeHandle handle) const
 Returns true if the current object is the indicated type exactly. More...
 
bool is_of_type (TypeHandle handle) const
 Returns true if the current object is or derives from the indicated type. More...
 
void operator= (const TypedObject &copy)
 
- Public Member Functions inherited from ReferenceCount
int get_ref_count () const
 Returns the current reference count. More...
 
WeakReferenceListget_weak_list () const
 Returns the WeakReferenceList associated with this ReferenceCount object. More...
 
bool has_weak_list () const
 Returns true if this particular ReferenceCount object has a WeakReferenceList created, false otherwise. More...
 
void local_object ()
 This function should be called, once, immediately after creating a new instance of some ReferenceCount-derived object on the stack. More...
 
void ref () const
 Explicitly increments the reference count. More...
 
bool test_ref_count_integrity () const
 Does some easy checks to make sure that the reference count isn't completely bogus. More...
 
bool test_ref_count_nonzero () const
 Does some easy checks to make sure that the reference count isn't zero, or completely bogus. More...
 
void weak_ref (WeakPointerToVoid *ptv)
 Adds the indicated PointerToVoid as a weak reference to this object. More...
 
void weak_unref (WeakPointerToVoid *ptv)
 Removes the indicated PointerToVoid as a weak reference to this object. More...
 

Static Public Member Functions

static int clear_cache ()
 
static CPT (GeomVertexFormat) register_format(const GeomVertexFormat *format)
 
static CPT (GeomVertexFormat) register_format(const GeomVertexArrayFormat *format)
 
static CPT (TransformState) make_identity()
 
static CPT (TransformState) make_invalid()
 
static CPT (GeomVertexArrayFormat) register_format(const GeomVertexArrayFormat *format)
 
static CPT (TransformState) make_pos(const LVecBase3 &pos)
 
static CPT (TransformState) make_hpr(const LVecBase3 &hpr)
 
static CPT (TransformState) make_quat(const LQuaternion &quat)
 
static CPT (TransformState) make_pos_hpr(const LVecBase3 &pos
 
static CPT (TransformState) make_scale(PN_stdfloat scale)
 
static CPT (TransformState) make_scale(const LVecBase3 &scale)
 
static CPT (TransformState) make_shear(const LVecBase3 &shear)
 
static CPT (TransformState) make_pos_hpr_scale(const LVecBase3 &pos
 
static CPT (TransformState) make_pos_quat_scale(const LVecBase3 &pos
 
static CPT (TransformState) make_pos_hpr_scale_shear(const LVecBase3 &pos
 
static CPT (TransformState) make_pos_quat_scale_shear(const LVecBase3 &pos
 
static CPT (TransformState) make_mat(const LMatrix4 &mat)
 
static CPT (TransformState) make_pos2d(const LVecBase2 &pos)
 
static CPT (TransformState) make_rotate2d(PN_stdfloat rotate)
 
static CPT (TransformState) make_pos_rotate2d(const LVecBase2 &pos
 
static CPT (TransformState) make_scale2d(PN_stdfloat scale)
 
static CPT (TransformState) make_scale2d(const LVecBase2 &scale)
 
static CPT (TransformState) make_shear2d(PN_stdfloat shear)
 
static CPT (TransformState) make_pos_rotate_scale2d(const LVecBase2 &pos
 
static CPT (TransformState) make_pos_rotate_scale_shear2d(const LVecBase2 &pos
 
static CPT (TransformState) make_mat3(const LMatrix3 &mat)
 
static void flush_level ()
 
static int garbage_collect ()
 
static TypeHandle get_class_type ()
 
static TypeHandle get_class_type ()
 
static TypeHandle get_class_type ()
 
static TypeHandle get_class_type ()
 
static int get_num_states ()
 
static int get_num_unused_states ()
 
static const GeomVertexFormat * get_v3 ()
 
static const GeomVertexFormat * get_v3c4 ()
 
static const GeomVertexFormat * get_v3c4t2 ()
 
static const GeomVertexFormat * get_v3cp ()
 
static const GeomVertexFormat * get_v3cpt2 ()
 
static const GeomVertexFormat * get_v3n3 ()
 
static const GeomVertexFormat * get_v3n3c4 ()
 
static const GeomVertexFormat * get_v3n3c4t2 ()
 
static const GeomVertexFormat * get_v3n3cp ()
 
static const GeomVertexFormat * get_v3n3cpt2 ()
 
static const GeomVertexFormat * get_v3n3t2 ()
 
static const GeomVertexFormat * get_v3t2 ()
 
static void init_states ()
 
static void init_type ()
 
static void init_type ()
 
static void init_type ()
 
static void init_type ()
 
static void list_cycles (ostream &out)
 
static void list_states (ostream &out)
 
static PT (InternalName) make(const string &name)
 
template<int N>
static PT (InternalName) make(const char(&literal)[N])
 
static PT (InternalName) make(const string &name
 
static PT (InternalName) get_root()
 
static PT (InternalName) get_error()
 
static PT (InternalName) get_vertex()
 
static PT (InternalName) get_normal()
 
static PT (InternalName) get_tangent()
 
static PT (InternalName) get_tangent_name(const string &name)
 
static PT (InternalName) get_binormal()
 
static PT (InternalName) get_binormal_name(const string &name)
 
static PT (InternalName) get_texcoord()
 
static PT (InternalName) get_texcoord_name(const string &name)
 
static PT (InternalName) get_color()
 
static PT (InternalName) get_rotate()
 
static PT (InternalName) get_size()
 
static PT (InternalName) get_aspect_ratio()
 
static PT (InternalName) get_transform_blend()
 
static PT (InternalName) get_transform_weight()
 
static PT (InternalName) get_transform_index()
 
static PT (InternalName) get_morph(InternalName *column
 
static PT (InternalName) get_index()
 
static PT (InternalName) get_world()
 
static PT (InternalName) get_camera()
 
static PT (InternalName) get_model()
 
static PT (InternalName) get_view()
 
static PT (TypedWritableReferenceCount) change_this(TypedWritableReferenceCount *old_ptr
 
static void register_with_read_factory ()
 
static void register_with_read_factory ()
 
static void register_with_read_factory ()
 
static void register_with_read_factory ()
 
static bool validate_states ()
 
- Static Public Member Functions inherited from NodeCachedReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from CachedTypedWritableReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from TypedWritableReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 
static PT (TypedWritableReferenceCount) decode_from_bam_stream(const string &data
 
- Static Public Member Functions inherited from TypedWritable
static bool decode_raw_from_bam_stream (TypedWritable *&ptr, ReferenceCount *&ref_ptr, const string &data, BamReader *reader=NULL)
 Reads the string created by a previous call to encode_to_bam_stream(), and extracts the single object on that string. More...
 
static TypeHandle get_class_type ()
 
static void init_type ()
 
- Static Public Member Functions inherited from TypedObject
static TypeHandle get_class_type ()
 
static void init_type ()
 This function is declared non-inline to work around a compiler bug in g++ 2.96. More...
 
- Static Public Member Functions inherited from ReferenceCount
static TypeHandle get_class_type ()
 
static void init_type ()
 

Public Attributes

static const LVecBase3hpr
 
static int index
 
static BamReadermanager
 
static const LQuaternionquat
 
static PN_stdfloat rotate
 
static const LVecBase3 const LVecBase3scale
 
static const LQuaternion const LVecBase3scale
 
static PN_stdfloat const LVecBase2scale
 
static const LVecBase3 const LVecBase3 const LVecBase3shear
 
static const LQuaternion const LVecBase3 const LVecBase3shear
 
static PN_stdfloat const LVecBase2 PN_stdfloat shear
 
static const string & slider
 
- Public Attributes inherited from TypedWritableReferenceCount
static BamReaderreader = NULL)
 

Friends

class Extension< TransformState >
 
class GeomMunger
 
class GeomVertexFormat
 
class GeomVertexFormat::Registry
 

Additional Inherited Members

- Public Types inherited from NodeCachedReferenceCount
enum  Referenced { R_node = 0x001, R_cache = 0x002 }
 
- Public Types inherited from GeomEnums
enum  AnimationType { AT_none, AT_panda, AT_hardware }
 
enum  Contents {
  C_other, C_point, C_clip_point, C_vector,
  C_texcoord, C_color, C_index, C_morph_delta,
  C_matrix, C_normal
}
 
enum  GeomRendering {
  GR_indexed_point = 0x00001, GR_indexed_other = 0x10000, GR_indexed_bits = 0x10001, GR_point = 0x00002,
  GR_point_uniform_size = 0x00004, GR_per_point_size = 0x00008, GR_point_perspective = 0x00010, GR_point_aspect_ratio = 0x00020,
  GR_point_scale = 0x00040, GR_point_rotate = 0x00080, GR_point_sprite = 0x00100, GR_point_sprite_tex_matrix = 0x00200,
  GR_point_bits = 0x003fe, GR_triangle_strip = 0x00400, GR_triangle_fan = 0x00800, GR_line_strip = 0x01000,
  GR_composite_bits = 0x01c00, GR_strip_cut_index = 0x20000, GR_flat_first_vertex = 0x02000, GR_flat_last_vertex = 0x04000,
  GR_shade_model_bits = 0x06000
}
 
enum  NumericType {
  NT_uint8, NT_uint16, NT_uint32, NT_packed_dcba,
  NT_packed_dabc, NT_float32, NT_float64, NT_stdfloat
}
 
enum  PrimitiveType {
  PT_none, PT_polygons, PT_lines, PT_points,
  PT_patches
}
 
enum  ShadeModel { SM_uniform, SM_smooth, SM_flat_first_vertex, SM_flat_last_vertex }
 
enum  UsageHint {
  UH_client, UH_stream, UH_dynamic, UH_static,
  UH_unspecified
}
 
- Static Public Attributes inherited from TypedWritable
static TypedWritable *const Null = (TypedWritable*)0L
 

Detailed Description

This describes the structure of a single array within a Geom data.

Indicates a coordinate-system transform on vertices.

Encodes a string name in a hash table, mapping it to a pointer.

This class defines the physical layout of the vertex data stored within a Geom.

See GeomVertexFormat for the parent class which collects together all of the individual GeomVertexArrayFormat objects.

A particular array may include any number of standard or user-defined columns. All columns consist of a sequence of one or more numeric values, packed in any of a variety of formats; the semantic meaning of each column is defined in general with its contents member, and in particular by its name. The standard array types used most often are named "vertex", "normal", "texcoord", and "color"; other kinds of data may be piggybacked into the data record simply by choosing a unique name.

The layout consists of a list of named columns, each of which has a numeric type and a size.

The columns are typically interleaved within a single array, but they may also be distributed among multiple different arrays; at the extreme, each column may be alone within its own array (which amounts to a parallel-array definition).

Thus, a GeomVertexFormat is really a list of GeomVertexArrayFormats, each of which contains a list of columns. However, a particular column name should not appear more than once in the format, even between different arrays.

There are a handful of standard pre-defined GeomVertexFormat objects, or you may define your own as needed. You may record any combination of standard and/or user-defined columns in your custom GeomVertexFormat constructions.

This is used to tokenify names so they may be used efficiently in low-level Panda structures, for instance to differentiate the multiple sets of texture coordinates that might be stored on a Geom.

InternalNames are hierarchical, with the '.' used by convention as a separator character. You can construct a single InternalName as a composition of one or more other names, or by giving it a source string directly.

TransformStates are the primary means for storing transformations on the scene graph.

Transforms may be specified in one of two ways: componentwise, with a pos-hpr-scale, or with an arbitrary transform matrix. If you specify a transform componentwise, it will remember its original components.

TransformState objects are managed very much like RenderState objects. They are immutable and reference-counted automatically.

You should not attempt to create or modify a TransformState object directly. Instead, call one of the make() functions to create one for you. And instead of modifying a TransformState object, create a new one.

Definition at line 53 of file geomVertexArrayFormat.h.

Member Function Documentation

◆ complete_pointers() [1/2]

virtual int FINAL::complete_pointers ( TypedWritable **  p_list,
BamReader manager 
)
virtual

Receives an array of pointers, one for each time manager->read_pointer() was called in fillin().

Returns the number of pointers processed.

This is the callback function that is made by the BamReader at some later point, after all of the required pointers have been filled in. It is necessary because there might be forward references in a bam file; when we call read_pointer() in fillin(), the object may not have been read from the file yet, so we do not have a pointer available at that time. Thus, instead of returning a pointer, read_pointer() simply reserves a later callback. This function provides that callback. The calling object is responsible for keeping track of the number of times it called read_pointer() and extracting the same number of pointers out of the supplied vector, and storing them appropriately within the object.

Reimplemented from TypedWritable.

◆ complete_pointers() [2/2]

virtual int FINAL::complete_pointers ( TypedWritable **  p_list,
BamReader manager 
)
virtual

Receives an array of pointers, one for each time manager->read_pointer() was called in fillin().

Returns the number of pointers processed.

This is the callback function that is made by the BamReader at some later point, after all of the required pointers have been filled in. It is necessary because there might be forward references in a bam file; when we call read_pointer() in fillin(), the object may not have been read from the file yet, so we do not have a pointer available at that time. Thus, instead of returning a pointer, read_pointer() simply reserves a later callback. This function provides that callback. The calling object is responsible for keeping track of the number of times it called read_pointer() and extracting the same number of pointers out of the supplied vector, and storing them appropriately within the object.

Reimplemented from TypedWritable.

◆ finalize() [1/2]

virtual void FINAL::finalize ( BamReader manager)
virtual

Called by the BamReader to perform any final actions needed for setting up the object after all objects have been read and all pointers have been completed.

Reimplemented from TypedWritable.

◆ finalize() [2/2]

virtual void FINAL::finalize ( BamReader manager)
virtual

Called by the BamReader to perform any final actions needed for setting up the object after all objects have been read and all pointers have been completed.

Reimplemented from TypedWritable.

◆ unref() [1/4]

virtual bool FINAL::unref ( ) const
virtual

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented from ReferenceCount.

◆ unref() [2/4]

virtual bool FINAL::unref ( ) const
virtual

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented from ReferenceCount.

◆ unref() [3/4]

virtual bool FINAL::unref ( ) const
virtual

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented from ReferenceCount.

◆ unref() [4/4]

virtual bool FINAL::unref ( ) const
virtual

Explicitly decrements the reference count.

Note that the object will not be implicitly deleted by unref() simply because the reference count drops to zero. (Having a member function delete itself is problematic.) However, see the helper function unref_delete().

User code should avoid using ref() and unref() directly, which can result in missed reference counts. Instead, let a PointerTo object manage the reference counting automatically.

This function is const, even though it changes the object, because generally fiddling with an object's reference count isn't considered part of fiddling with the object. An object might be const in other ways, but we still need to accurately count the number of references to it.

The return value is true if the new reference count is nonzero, false if it is zero.

Reimplemented from ReferenceCount.

◆ write_datagram() [1/4]

virtual void FINAL::write_datagram ( BamWriter manager,
Datagram dg 
)
virtual

Writes the contents of this object to the datagram for shipping out to a Bam file.

Reimplemented from TypedWritable.

◆ write_datagram() [2/4]

virtual void FINAL::write_datagram ( BamWriter manager,
Datagram dg 
)
virtual

Writes the contents of this object to the datagram for shipping out to a Bam file.

Reimplemented from TypedWritable.

◆ write_datagram() [3/4]

virtual void FINAL::write_datagram ( BamWriter manager,
Datagram dg 
)
virtual

Writes the contents of this object to the datagram for shipping out to a Bam file.

Reimplemented from TypedWritable.

◆ write_datagram() [4/4]

virtual void FINAL::write_datagram ( BamWriter manager,
Datagram dg 
)
virtual

Writes the contents of this object to the datagram for shipping out to a Bam file.

Reimplemented from TypedWritable.


The documentation for this class was generated from the following files: