historical/toontown-classic.git/panda/include/projectionScreen.h
2024-01-16 11:20:27 -06:00

162 lines
5.5 KiB
C++

/**
* PANDA 3D SOFTWARE
* Copyright (c) Carnegie Mellon University. All rights reserved.
*
* All use of this software is subject to the terms of the revised BSD
* license. You should have received a copy of this license along
* with this source code in a file named "LICENSE."
*
* @file projectionScreen.h
* @author drose
* @date 2001-12-11
*/
#ifndef PROJECTIONSCREEN_H
#define PROJECTIONSCREEN_H
#include "pandabase.h"
#include "pandaNode.h"
#include "lensNode.h"
#include "geomNode.h"
#include "nodePath.h"
#include "internalName.h"
#include "pointerTo.h"
#include "pfmFile.h"
class Geom;
class WorkingNodePath;
/**
* A ProjectionScreen implements a simple system for projective texturing.
* The ProjectionScreen node is the parent of a hierarchy of geometry that is
* considered a "screen"; the ProjectionScreen will automatically recompute
* all the UV's (for a particular texture stage) on its subordinate geometry
* according to the relative position and lens parameters of the indicated
* LensNode.
*
* All this does is recompute UV's; the caller is responsible for applying the
* appropriate texture(s) to the geometry.
*
* This does not take advantage of any hardware-assisted projective texturing;
* all of the UV's are computed in the CPU. (Use NodePath::project_texture()
* to enable hardware-assisted projective texturing.) However, the
* ProjectionScreen interface does support any kind of lens, linear or
* nonlinear, that might be defined using the Lens interface, including
* fisheye and cylindrical lenses.
*/
class EXPCL_PANDAFX ProjectionScreen : public PandaNode {
PUBLISHED:
explicit ProjectionScreen(const std::string &name = "");
virtual ~ProjectionScreen();
protected:
ProjectionScreen(const ProjectionScreen &copy);
public:
virtual PandaNode *make_copy() const;
virtual bool cull_callback(CullTraverser *trav, CullTraverserData &data);
PUBLISHED:
void set_projector(const NodePath &projector);
INLINE const NodePath &get_projector() const;
INLINE void clear_undist_lut();
INLINE void set_undist_lut(const PfmFile &undist_lut);
INLINE bool has_undist_lut() const;
INLINE const PfmFile &get_undist_lut() const;
PT(GeomNode) generate_screen(const NodePath &projector,
const std::string &screen_name,
int num_x_verts, int num_y_verts,
PN_stdfloat distance, PN_stdfloat fill_ratio);
void regenerate_screen(const NodePath &projector, const std::string &screen_name,
int num_x_verts, int num_y_verts, PN_stdfloat distance,
PN_stdfloat fill_ratio);
PT(PandaNode) make_flat_mesh(const NodePath &this_np, const NodePath &camera);
INLINE void set_texcoord_name(const std::string &texcoord_name);
INLINE std::string get_texcoord_name() const;
INLINE void set_invert_uvs(bool invert_uvs);
INLINE bool get_invert_uvs() const;
INLINE void set_texcoord_3d(bool texcoord_3d);
INLINE bool get_texcoord_3d() const;
INLINE void set_vignette_on(bool vignette_on);
INLINE bool get_vignette_on() const;
INLINE void set_vignette_color(const LColor &vignette_color);
INLINE const LColor &get_vignette_color() const;
INLINE void set_frame_color(const LColor &frame_color);
INLINE const LColor &get_frame_color() const;
INLINE void set_auto_recompute(bool auto_recompute);
INLINE bool get_auto_recompute() const;
void recompute();
INLINE const UpdateSeq &get_last_screen() const;
bool recompute_if_stale();
bool recompute_if_stale(const NodePath &this_np);
private:
void do_recompute(const NodePath &this_np);
void recompute_node(const WorkingNodePath &np, LMatrix4 &rel_mat, bool &computed_rel_mat);
void recompute_child(const WorkingNodePath &np, LMatrix4 &rel_mat, bool &computed_rel_mat);
void recompute_geom_node(const WorkingNodePath &np, LMatrix4 &rel_mat, bool &computed_rel_mat);
void recompute_geom(Geom *geom, const LMatrix4 &rel_mat);
PandaNode *
make_mesh_node(PandaNode *result_parent, const WorkingNodePath &np,
const NodePath &camera,
LMatrix4 &rel_mat, bool &computed_rel_mat);
void make_mesh_children(PandaNode *new_node, const WorkingNodePath &np,
const NodePath &camera,
LMatrix4 &rel_mat, bool &computed_rel_mat);
PT(GeomNode) make_mesh_geom_node(const WorkingNodePath &np,
const NodePath &camera,
LMatrix4 &rel_mat,
bool &computed_rel_mat);
PT(Geom) make_mesh_geom(const Geom *geom, Lens *lens, LMatrix4 &rel_mat);
NodePath _projector;
PT(LensNode) _projector_node;
bool _has_undist_lut;
PfmFile _undist_lut;
PT(InternalName) _texcoord_name;
bool _invert_uvs;
bool _texcoord_3d;
bool _vignette_on;
LColor _vignette_color;
LColor _frame_color;
LMatrix4 _rel_top_mat;
bool _computed_rel_top_mat;
bool _stale;
UpdateSeq _projector_lens_change;
UpdateSeq _last_screen;
bool _auto_recompute;
public:
static TypeHandle get_class_type() {
return _type_handle;
}
static void init_type() {
PandaNode::init_type();
register_type(_type_handle, "ProjectionScreen",
PandaNode::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;
};
#include "projectionScreen.I"
#endif