275 lines
9.4 KiB
C++
275 lines
9.4 KiB
C++
// Filename: geomVertexFormat.h
|
|
// Created by: drose (07Mar05)
|
|
//
|
|
////////////////////////////////////////////////////////////////////
|
|
//
|
|
// PANDA 3D SOFTWARE
|
|
// Copyright (c) 2001 - 2004, Disney Enterprises, Inc. All rights reserved
|
|
//
|
|
// All use of this software is subject to the terms of the Panda 3d
|
|
// Software license. You should have received a copy of this license
|
|
// along with this source code; you will also find a current copy of
|
|
// the license at http://etc.cmu.edu/panda3d/docs/license/ .
|
|
//
|
|
// To contact the maintainers of this program write to
|
|
// panda3d-general@lists.sourceforge.net .
|
|
//
|
|
////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef GEOMVERTEXFORMAT_H
|
|
#define GEOMVERTEXFORMAT_H
|
|
|
|
#include "pandabase.h"
|
|
#include "typedWritableReferenceCount.h"
|
|
#include "geomVertexAnimationSpec.h"
|
|
#include "geomVertexArrayFormat.h"
|
|
#include "geomEnums.h"
|
|
#include "internalName.h"
|
|
#include "luse.h"
|
|
#include "pointerTo.h"
|
|
#include "pmap.h"
|
|
#include "pset.h"
|
|
#include "pvector.h"
|
|
#include "indirectCompareTo.h"
|
|
#include "pmutex.h"
|
|
|
|
class FactoryParams;
|
|
class GeomVertexData;
|
|
class GeomMunger;
|
|
|
|
////////////////////////////////////////////////////////////////////
|
|
// Class : GeomVertexFormat
|
|
// Description : This class defines the physical layout of the vertex
|
|
// data stored within a Geom. 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.
|
|
////////////////////////////////////////////////////////////////////
|
|
class EXPCL_PANDA GeomVertexFormat : public TypedWritableReferenceCount, public GeomEnums {
|
|
PUBLISHED:
|
|
GeomVertexFormat();
|
|
GeomVertexFormat(const GeomVertexArrayFormat *array_format);
|
|
GeomVertexFormat(const GeomVertexFormat ©);
|
|
void operator = (const GeomVertexFormat ©);
|
|
virtual ~GeomVertexFormat();
|
|
|
|
INLINE bool is_registered() const;
|
|
INLINE static CPT(GeomVertexFormat) register_format(const GeomVertexFormat *format);
|
|
INLINE static CPT(GeomVertexFormat) register_format(const GeomVertexArrayFormat *format);
|
|
|
|
INLINE const GeomVertexAnimationSpec &get_animation() const;
|
|
INLINE void set_animation(const GeomVertexAnimationSpec &animation);
|
|
|
|
CPT(GeomVertexFormat) get_post_animated_format() const;
|
|
CPT(GeomVertexFormat) get_union_format(const GeomVertexFormat *other) const;
|
|
|
|
INLINE int get_num_arrays() const;
|
|
INLINE const GeomVertexArrayFormat *get_array(int array) const;
|
|
GeomVertexArrayFormat *modify_array(int array);
|
|
void set_array(int array, const GeomVertexArrayFormat *format);
|
|
void remove_array(int array);
|
|
int add_array(const GeomVertexArrayFormat *array_format);
|
|
void insert_array(int array, const GeomVertexArrayFormat *array_format);
|
|
void clear_arrays();
|
|
|
|
int get_num_columns() const;
|
|
int get_array_with(int i) const;
|
|
const GeomVertexColumn *get_column(int i) const;
|
|
|
|
int get_array_with(const InternalName *name) const;
|
|
const GeomVertexColumn *get_column(const InternalName *name) const;
|
|
INLINE bool has_column(const InternalName *name) const;
|
|
|
|
void remove_column(const InternalName *name);
|
|
|
|
INLINE int get_num_points() const;
|
|
INLINE const InternalName *get_point(int n) const;
|
|
|
|
INLINE int get_num_vectors() const;
|
|
INLINE const InternalName *get_vector(int n) const;
|
|
|
|
INLINE int get_num_texcoords() const;
|
|
INLINE const InternalName *get_texcoord(int n) const;
|
|
|
|
INLINE int get_num_morphs() const;
|
|
INLINE const InternalName *get_morph_slider(int n) const;
|
|
INLINE const InternalName *get_morph_base(int n) const;
|
|
INLINE const InternalName *get_morph_delta(int n) const;
|
|
|
|
void output(ostream &out) const;
|
|
void write(ostream &out, int indent_level = 0) const;
|
|
void write_with_data(ostream &out, int indent_level,
|
|
const GeomVertexData *data) const;
|
|
|
|
// Some standard vertex formats. No particular requirement to use
|
|
// one of these, but the DirectX renderers can use these formats
|
|
// directly, whereas any other format will have to be converted
|
|
// first.
|
|
INLINE static const GeomVertexFormat *get_v3();
|
|
INLINE static const GeomVertexFormat *get_v3n3();
|
|
INLINE static const GeomVertexFormat *get_v3t2();
|
|
INLINE static const GeomVertexFormat *get_v3n3t2();
|
|
|
|
// These formats, with the DirectX-style packed color, are not
|
|
// supported directly by OpenGL. If you use them, the
|
|
// GLGraphicsStateGuardian will automatically convert to OpenGL
|
|
// form (with a small runtime overhead).
|
|
INLINE static const GeomVertexFormat *get_v3cp();
|
|
INLINE static const GeomVertexFormat *get_v3cpt2();
|
|
INLINE static const GeomVertexFormat *get_v3n3cp();
|
|
INLINE static const GeomVertexFormat *get_v3n3cpt2();
|
|
|
|
// These formats, with an OpenGL-style four-byte color, are not
|
|
// supported directly by DirectX. If you use them, the
|
|
// DXGraphicsStateGuardian will automatically convert to DirectX
|
|
// form (with a larger runtime overhead, since DirectX8, and old
|
|
// DirectX9 drivers, require everything to be interleaved together).
|
|
INLINE static const GeomVertexFormat *get_v3c4();
|
|
INLINE static const GeomVertexFormat *get_v3c4t2();
|
|
INLINE static const GeomVertexFormat *get_v3n3c4();
|
|
INLINE static const GeomVertexFormat *get_v3n3c4t2();
|
|
|
|
public:
|
|
bool get_array_info(const InternalName *name,
|
|
int &array_index,
|
|
const GeomVertexColumn *&column) const;
|
|
|
|
INLINE int get_vertex_array_index() const;
|
|
INLINE const GeomVertexColumn *get_vertex_column() const;
|
|
INLINE int get_normal_array_index() const;
|
|
INLINE const GeomVertexColumn *get_normal_column() const;
|
|
INLINE int get_color_array_index() const;
|
|
INLINE const GeomVertexColumn *get_color_column() const;
|
|
|
|
int compare_to(const GeomVertexFormat &other) const;
|
|
|
|
private:
|
|
class Registry;
|
|
INLINE static Registry *get_registry();
|
|
static void make_registry();
|
|
|
|
void do_register();
|
|
void do_unregister();
|
|
|
|
bool _is_registered;
|
|
|
|
GeomVertexAnimationSpec _animation;
|
|
|
|
typedef pvector< PT(GeomVertexArrayFormat) > Arrays;
|
|
Arrays _arrays;
|
|
|
|
class DataTypeRecord {
|
|
public:
|
|
int _array_index;
|
|
int _column_index;
|
|
};
|
|
|
|
typedef pmap<const InternalName *, DataTypeRecord> DataTypesByName;
|
|
DataTypesByName _columns_by_name;
|
|
|
|
int _vertex_array_index;
|
|
const GeomVertexColumn *_vertex_column;
|
|
int _normal_array_index;
|
|
const GeomVertexColumn *_normal_column;
|
|
int _color_array_index;
|
|
const GeomVertexColumn *_color_column;
|
|
|
|
typedef pvector< CPT(InternalName) > Columns;
|
|
Columns _points;
|
|
Columns _vectors;
|
|
Columns _texcoords;
|
|
|
|
class MorphRecord {
|
|
public:
|
|
CPT(InternalName) _slider;
|
|
CPT(InternalName) _base;
|
|
CPT(InternalName) _delta;
|
|
};
|
|
typedef pvector<MorphRecord> Morphs;
|
|
Morphs _morphs;
|
|
|
|
const GeomVertexFormat *_post_animated_format;
|
|
|
|
// This is the global registry of all currently-in-use formats.
|
|
typedef pset<GeomVertexFormat *, IndirectCompareTo<GeomVertexFormat> > Formats;
|
|
class EXPCL_PANDA Registry {
|
|
public:
|
|
Registry();
|
|
CPT(GeomVertexFormat) register_format(GeomVertexFormat *format);
|
|
INLINE CPT(GeomVertexFormat) register_format(GeomVertexArrayFormat *format);
|
|
void unregister_format(GeomVertexFormat *format);
|
|
|
|
Formats _formats;
|
|
|
|
CPT(GeomVertexFormat) _v3;
|
|
CPT(GeomVertexFormat) _v3n3;
|
|
CPT(GeomVertexFormat) _v3t2;
|
|
CPT(GeomVertexFormat) _v3n3t2;
|
|
|
|
CPT(GeomVertexFormat) _v3cp;
|
|
CPT(GeomVertexFormat) _v3n3cp;
|
|
CPT(GeomVertexFormat) _v3cpt2;
|
|
CPT(GeomVertexFormat) _v3n3cpt2;
|
|
|
|
CPT(GeomVertexFormat) _v3c4;
|
|
CPT(GeomVertexFormat) _v3n3c4;
|
|
CPT(GeomVertexFormat) _v3c4t2;
|
|
CPT(GeomVertexFormat) _v3n3c4t2;
|
|
};
|
|
|
|
static Registry *_registry;
|
|
|
|
|
|
public:
|
|
static void register_with_read_factory();
|
|
virtual void write_datagram(BamWriter *manager, Datagram &dg);
|
|
virtual int complete_pointers(TypedWritable **plist, BamReader *manager);
|
|
|
|
protected:
|
|
static TypedWritable *make_from_bam(const FactoryParams ¶ms);
|
|
void fillin(DatagramIterator &scan, BamReader *manager);
|
|
|
|
public:
|
|
static TypeHandle get_class_type() {
|
|
return _type_handle;
|
|
}
|
|
static void init_type() {
|
|
TypedWritableReferenceCount::init_type();
|
|
register_type(_type_handle, "GeomVertexFormat",
|
|
TypedWritableReferenceCount::get_class_type());
|
|
}
|
|
virtual TypeHandle get_type() const {
|
|
return get_class_type();
|
|
}
|
|
virtual TypeHandle force_init_type() {init_type(); return get_class_type();}
|
|
|
|
private:
|
|
static TypeHandle _type_handle;
|
|
|
|
friend class GeomVertexFormat::Registry;
|
|
friend class GeomMunger;
|
|
};
|
|
|
|
INLINE ostream &operator << (ostream &out, const GeomVertexFormat &obj);
|
|
|
|
#include "geomVertexFormat.I"
|
|
|
|
#endif
|