open_toontown_panda3d/panda/src/gobj/vertexDataBuffer.h

110 lines
3.6 KiB
C++

// Filename: vertexDataBuffer.h
// Created by: drose (14May07)
//
////////////////////////////////////////////////////////////////////
//
// 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 VERTEXDATABUFFER_H
#define VERTEXDATABUFFER_H
#include "pandabase.h"
#include "vertexDataBook.h"
#include "vertexDataBlock.h"
#include "pointerTo.h"
#include "virtualFile.h"
#include "pStatCollector.h"
#include "pmutex.h"
#include "mutexHolder.h"
////////////////////////////////////////////////////////////////////
// Class : VertexDataBuffer
// Description : A block of bytes that stores the actual raw vertex
// data referenced by a GeomVertexArrayData object.
//
// At any point, a buffer may be in any of two states:
//
// independent - the buffer's memory is resident, and
// owned by the VertexDataBuffer object itself (in
// _resident_data).
//
// paged - the buffer's memory is owned by a
// VertexDataBlock. That block might itself be
// resident, compressed, or paged to disk. If it is
// resident, the memory may still be accessed directly
// from the block. However, this memory is considered
// read-only.
//
// VertexDataBuffers start out in independent state.
// They get moved to paged state when their owning
// GeomVertexArrayData objects get evicted from the
// _independent_lru. They can get moved back to
// independent state if they are modified
// (e.g. get_write_pointer() or realloc() is called).
//
// The idea is to keep the highly dynamic and
// frequently-modified VertexDataBuffers resident in
// easy-to-access memory, while collecting the static
// and rarely accessed VertexDataBuffers together onto
// pages, where they may be written to disk as a block
// when necessary.
////////////////////////////////////////////////////////////////////
class EXPCL_PANDA_GOBJ VertexDataBuffer {
public:
INLINE VertexDataBuffer();
INLINE VertexDataBuffer(size_t size);
INLINE VertexDataBuffer(const VertexDataBuffer &copy);
void operator = (const VertexDataBuffer &copy);
INLINE ~VertexDataBuffer();
INLINE const unsigned char *get_read_pointer(bool force) const;
INLINE unsigned char *get_write_pointer();
INLINE size_t get_size() const;
INLINE void clean_realloc(size_t size);
INLINE void unclean_realloc(size_t size);
INLINE void clear();
INLINE void page_out(VertexDataBook &book);
INLINE void swap(VertexDataBuffer &other);
private:
void do_clean_realloc(size_t size);
void do_unclean_realloc(size_t size);
void do_page_out(VertexDataBook &book);
void do_page_in();
unsigned char *_resident_data;
size_t _size;
PT(VertexDataBlock) _block;
Mutex _lock;
public:
static TypeHandle get_class_type() {
return _type_handle;
}
static void init_type() {
register_type(_type_handle, "VertexDataBuffer");
}
private:
static TypeHandle _type_handle;
};
#include "vertexDataBuffer.I"
#endif