Panda3D
|
NodePath is the fundamental system for disambiguating instances, and also provides a higher-level interface for manipulating the scene graph. More...
#include "nodePath.h"
Public Types | |
enum | ErrorType { ET_ok = 0, ET_not_found, ET_removed, ET_fail } |
Public Member Functions | |
NodePath () | |
This constructs an empty NodePath with no nodes. | |
NodePath (const string &top_node_name, Thread *current_thread=Thread::get_current_thread()) | |
This constructs a new NodePath with a single node. | |
NodePath (const NodePath &parent, PandaNode *child_node, Thread *current_thread=Thread::get_current_thread()) | |
Constructs a NodePath with the indicated parent NodePath and child node; the child node must be a stashed or unstashed child of the parent. | |
NodePath (const NodePath ©) | |
NodePath (PandaNode *node, Thread *current_thread=Thread::get_current_thread()) | |
This constructs a NodePath for the indicated node. | |
size_t | add_hash (size_t hash) const |
Adds the NodePath into the running hash. | |
void | adjust_all_priorities (int adjustment) |
Adds the indicated adjustment amount (which may be negative) to the priority for all transitions on the referenced node, and for all nodes in the subgraph below. | |
void | apply_texture_colors () |
Removes textures from Geoms at this node and below by applying the texture colors to the vertices. | |
NodePath | attach_new_node (PandaNode *node, int sort=0, Thread *current_thread=Thread::get_current_thread()) const |
Attaches a new node, with or without existing parents, to the scene graph below the referenced node of this NodePath. | |
NodePath | attach_new_node (const string &name, int sort=0, Thread *current_thread=Thread::get_current_thread()) const |
Creates an ordinary PandaNode and attaches it below the current NodePath, returning a new NodePath that references it. | |
bool | calc_tight_bounds (LPoint3 &min_point, LPoint3 &max_point, Thread *current_thread=Thread::get_current_thread()) const |
Calculates the minimum and maximum vertices of all Geoms at this NodePath's bottom node and below. | |
void | clear_antialias () |
Completely removes any antialias setting that may have been set on this node via set_antialias(). | |
void | clear_attrib (TypeHandle type) |
Removes the render attribute of the given type from this node. | |
void | clear_audio_volume () |
Completely removes any audio volume from the referenced node. | |
void | clear_billboard () |
Removes any billboard effect from the node. | |
void | clear_bin () |
Completely removes any bin adjustment that may have been set via set_bin() from this particular node. | |
void | clear_clip_plane () |
Completely removes any clip planes that may have been set via set_clip_plane() or set_clip_plane_off() from this particular node. | |
void | clear_clip_plane (const NodePath &clip_plane) |
Removes any reference to the indicated clipping plane from the NodePath. | |
void | clear_color () |
Completely removes any color adjustment from the node. | |
void | clear_color_scale () |
Completely removes any color scale from the referenced node. | |
void | clear_compass () |
Removes any compass effect from the node. | |
void | clear_depth_offset () |
Completely removes any depth-offset adjustment that may have been set on this node via set_depth_offset(). | |
void | clear_depth_test () |
Completely removes any depth-test adjustment that may have been set on this node via set_depth_test(). | |
void | clear_depth_write () |
Completely removes any depth-write adjustment that may have been set on this node via set_depth_write(). | |
void | clear_effect (TypeHandle type) |
Removes the render effect of the given type from this node. | |
void | clear_effects () |
Resets this node to have no render effects. | |
void | clear_fog () |
Completely removes any fog adjustment that may have been set via set_fog() or set_fog_off() from this particular node. | |
void | clear_light () |
Completely removes any lighting operations that may have been set via set_light() or set_light_off() from this particular node. | |
void | clear_light (const NodePath &light) |
Removes any reference to the indicated Light or PolylightNode from the NodePath. | |
void | clear_mat () |
Completely removes any transform from the referenced node. | |
void | clear_material () |
Completely removes any material adjustment that may have been set via set_material() from this particular node. | |
int | clear_model_nodes () |
Recursively walks through the scene graph at this level and below, looking for ModelNodes, and calls model_node->set_preserve_transform(PT_drop_node) on each one. | |
void | clear_normal_map () |
Undoes the effect of a previous call to set_normal_map(). | |
void | clear_occluder () |
Completely removes any occluders that may have been set via set_occluder() from this particular node. | |
void | clear_occluder (const NodePath &occluder) |
Removes any reference to the indicated occluder from the NodePath. | |
void | clear_project_texture (TextureStage *stage) |
Undoes the effect of project_texture(). | |
void | clear_render_mode () |
Completely removes any render mode adjustment that may have been set on this node via set_render_mode_wireframe() or set_render_mode_filled(). | |
void | clear_scissor () |
Removes the scissor region that was defined at this node level by a previous call to set_scissor(). | |
void | clear_shader () |
void | clear_shader_input (const InternalName *id) |
void | clear_shader_input (const string &id) |
void | clear_tag (const string &key) |
Removes the value defined for this key on this particular node. | |
void | clear_tex_gen (TextureStage *stage) |
Disables automatic texture coordinate generation for the indicated texture stage. | |
void | clear_tex_gen () |
Removes the texture coordinate generation mode from all texture stages on this node. | |
void | clear_tex_projector () |
Removes the TexProjectorEffect for all stages from this node. | |
void | clear_tex_projector (TextureStage *stage) |
Removes the TexProjectorEffect for the indicated stage from this node. | |
void | clear_tex_transform () |
Removes all texture matrices from the current node. | |
void | clear_tex_transform (TextureStage *stage) |
Removes the texture matrix on the current node for the given stage. | |
void | clear_texture () |
Completely removes any texture adjustment that may have been set via set_texture() or set_texture_off() from this particular node. | |
void | clear_texture (TextureStage *stage) |
Removes any reference to the indicated texture stage from the NodePath. | |
void | clear_transform (Thread *current_thread=Thread::get_current_thread()) |
Sets the transform object on this node to identity. | |
void | clear_transform (const NodePath &other, Thread *current_thread=Thread::get_current_thread()) |
Sets the transform object on this node to identity, relative to the other node. | |
void | clear_transparency () |
Completely removes any transparency adjustment that may have been set on this node via set_transparency(). | |
void | clear_two_sided () |
Completely removes any two-sided adjustment that may have been set on this node via set_two_sided(). | |
int | compare_to (const NodePath &other) const |
Returns a number less than zero if this NodePath sorts before the other one, greater than zero if it sorts after, or zero if they are equivalent. | |
void | compose_color_scale (const LVecBase4 &scale, int priority=0) |
multiplies the color scale component of the transform, with previous color scale leaving translation and rotation untouched. | |
void | compose_color_scale (PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz, PN_stdfloat sa, int priority=0) |
Sets the color scale component of the transform. | |
NodePath | copy_to (const NodePath &other, int sort=0, Thread *current_thread=Thread::get_current_thread()) const |
Functions like instance_to(), except a deep copy is made of the referenced node and all of its descendents, which is then parented to the indicated node. | |
int | count_num_descendants () const |
Returns the number of nodes at and below this level. | |
CPT (TransformState) get_transform(const NodePath &other | |
CPT (TransformState) get_net_transform(Thread *current_thread | |
CPT (TransformState) get_prev_transform(const NodePath &other | |
CPT (TransformState) get_net_prev_transform(Thread *current_thread | |
CPT (TransformState) get_tex_transform(TextureStage *stage) const | |
CPT (TransformState) get_tex_transform(const NodePath &other | |
CPT (RenderState) get_state(const NodePath &other | |
CPT (RenderState) get_net_state(Thread *current_thread | |
void | detach_node (Thread *current_thread=Thread::get_current_thread()) |
Disconnects the referenced node from its parent, but does not immediately delete it. | |
void | do_billboard_axis (const NodePath &camera, PN_stdfloat offset) |
Performs a billboard-type rotate to the indicated camera node, one time only, and leaves the object rotated. | |
void | do_billboard_point_eye (const NodePath &camera, PN_stdfloat offset) |
Performs a billboard-type rotate to the indicated camera node, one time only, and leaves the object rotated. | |
void | do_billboard_point_world (const NodePath &camera, PN_stdfloat offset) |
Performs a billboard-type rotate to the indicated camera node, one time only, and leaves the object rotated. | |
string | encode_to_bam_stream () const |
Converts the NodePath object into a single stream of data using a BamWriter, and returns that data as a string string. | |
bool | encode_to_bam_stream (string &data, BamWriter *writer=NULL) const |
Converts the NodePath object into a single stream of data using a BamWriter, and stores that data in the indicated string. | |
NodePath | find (const string &path) const |
Searches for a node below the referenced node that matches the indicated string. | |
NodePathCollection | find_all_matches (const string &path) const |
Returns the complete set of all NodePaths that begin with this NodePath and can be extended by path. | |
MaterialCollection | find_all_materials (const string &name) const |
Returns a list of a materials applied to geometry at this node and below that match the indicated name (which may contain wildcard characters). | |
MaterialCollection | find_all_materials () const |
Returns a list of a materials applied to geometry at this node and below. | |
NodePathCollection | find_all_paths_to (PandaNode *node) const |
Returns the set of all NodePaths that extend from this NodePath down to the indicated node. | |
InternalNameCollection | find_all_texcoords () const |
Returns a list of all texture coordinate sets used by any geometry at this node level and below. | |
InternalNameCollection | find_all_texcoords (const string &name) const |
Returns a list of all texture coordinate sets used by any geometry at this node level and below that match the indicated name (which may contain wildcard characters). | |
TextureStageCollection | find_all_texture_stages (const string &name) const |
Returns a list of a TextureStages applied to geometry at this node and below that match the indicated name (which may contain wildcard characters). | |
TextureStageCollection | find_all_texture_stages () const |
Returns a list of a TextureStages applied to geometry at this node and below. | |
TextureCollection | find_all_textures () const |
Returns a list of a textures applied to geometry at this node and below. | |
TextureCollection | find_all_textures (const string &name) const |
Returns a list of a textures applied to geometry at this node and below that match the indicated name (which may contain wildcard characters). | |
TextureCollection | find_all_textures (TextureStage *stage) const |
Returns a list of a textures on geometry at this node and below that are assigned to the indicated texture stage. | |
InternalNameCollection | find_all_vertex_columns () const |
Returns a list of all vertex array columns stored on some geometry found at this node level and below. | |
InternalNameCollection | find_all_vertex_columns (const string &name) const |
Returns a list of all vertex array columns stored on some geometry found at this node level and below that match the indicated name (which may contain wildcard characters). | |
Material * | find_material (const string &name) const |
Returns the first material found applied to geometry at this node or below that matches the indicated name (which may contain wildcards). | |
NodePath | find_net_tag (const string &key) const |
Returns the lowest ancestor of this node that contains a tag definition with the indicated key, if any, or an empty NodePath if no ancestor of this node contains this tag definition. | |
NodePath | find_path_to (PandaNode *node) const |
Searches for the indicated node below this node and returns the shortest NodePath that connects them. | |
Texture * | find_texture (TextureStage *stage) const |
Returns the first texture found applied to geometry at this node or below that is assigned to the indicated texture stage. | |
Texture * | find_texture (const string &name) const |
Returns the first texture found applied to geometry at this node or below that matches the indicated name (which may contain wildcards). | |
TextureStage * | find_texture_stage (const string &name) const |
Returns the first TextureStage found applied to geometry at this node or below that matches the indicated name (which may contain wildcards). | |
int | flatten_light () |
Lightly flattens out the hierarchy below this node by applying transforms, colors, and texture matrices from the nodes onto the vertices, but does not remove any nodes. | |
int | flatten_medium () |
A more thorough flattening than flatten_light(), this first applies all the transforms, colors, and texture matrices from the nodes onto the vertices, and then removes unneeded grouping nodes--nodes that have exactly one child, for instance, but have no special properties in themselves. | |
int | flatten_strong () |
The strongest possible flattening. | |
void | force_recompute_bounds () |
Forces the recomputing of all the bounding volumes at every node in the subgraph beginning at this node and below. | |
NodePath | get_ancestor (int index, Thread *current_thread=Thread::get_current_thread()) const |
Returns the nth ancestor of the path, where 0 is the NodePath itself and get_num_nodes() - 1 is get_top(). | |
unsigned short | get_antialias () const |
Returns the antialias setting that has been specifically set on this node via set_antialias(), or M_none if no setting has been made. | |
const RenderAttrib * | get_attrib (TypeHandle type) const |
Returns the render attribute of the indicated type, if it is defined on the node, or NULL if it is not. | |
PN_stdfloat | get_audio_volume () const |
Returns the complete audio volume that has been applied to this node via a previous call to set_audio_volume(), or 1. | |
int | get_bin_draw_order () const |
Returns the drawing order associated with the bin that this particular node was assigned to via set_bin(), or 0 if no bin was assigned. | |
string | get_bin_name () const |
Returns the name of the bin that this particular node was assigned to via set_bin(), or the empty string if no bin was assigned. | |
NodePath | get_child (int n, Thread *current_thread=Thread::get_current_thread()) const |
Returns a NodePath representing the nth child of the referenced node. | |
NodePathCollection | get_children (Thread *current_thread=Thread::get_current_thread()) const |
Returns the set of all child nodes of the referenced node. | |
CollideMask | get_collide_mask () const |
Returns the union of all of the into_collide_masks for nodes at this level and below. | |
LColor | get_color () const |
Returns the color that has been assigned to the node, or black if no color has been assigned. | |
const LVecBase4 & | get_color_scale () const |
Returns the complete color scale vector that has been applied to this node via a previous call to set_color_scale() and/or set_alpha_scale(), or all 1's (identity) if no scale has been applied to this particular node. | |
NodePath | get_common_ancestor (const NodePath &other, Thread *current_thread=Thread::get_current_thread()) const |
Returns the lowest NodePath that both of these two NodePaths have in common: the first ancestor that both of them share. | |
int | get_depth_offset () const |
Returns the depth offset value if it has been specified using set_depth_offset, or 0 if not. | |
bool | get_depth_test () const |
Returns true if depth-test rendering has been specifically set on this node via set_depth_test(), or false if depth-test rendering has been specifically disabled. | |
bool | get_depth_write () const |
Returns true if depth-write rendering has been specifically set on this node via set_depth_write(), or false if depth-write rendering has been specifically disabled. | |
PN_stdfloat | get_distance (const NodePath &other) const |
Returns the straight-line distance between this referenced node's coordinate frame's origin, and that of the other node's origin. | |
const RenderEffect * | get_effect (TypeHandle type) const |
Returns the render effect of the indicated type, if it is defined on the node, or NULL if it is not. | |
const RenderEffects * | get_effects () const |
Returns the complete RenderEffects that will be applied to this node. | |
ErrorType | get_error_type () const |
If is_empty() is true, this returns a code that represents the reason why the NodePath is empty. | |
Fog * | get_fog () const |
Returns the fog that has been set on this particular node, or NULL if no fog has been set. | |
PN_stdfloat | get_h (const NodePath &other) const |
PN_stdfloat | get_h () const |
NodePath | get_hidden_ancestor (DrawMask camera_mask=PandaNode::get_overall_bit(), Thread *current_thread=Thread::get_current_thread()) const |
Returns the NodePath at or above the referenced node that is hidden to the indicated camera(s), or an empty NodePath if no ancestor of the referenced node is hidden (and the node should be visible). | |
LVecBase3 | get_hpr (const NodePath &other) const |
Returns the relative orientation of the bottom node as seen from the other node. | |
LVecBase3 | get_hpr () const |
Retrieves the rotation component of the transform. | |
const int | get_instance_count () const |
Returns the geometry instance count, or 0 if disabled. | |
int | get_key () const |
Returns an integer that is guaranteed to be the same for all NodePaths that represent the same node instance, and different for all NodePaths that represent a different node instance. | |
const LMatrix4 & | get_mat () const |
Returns the transform matrix that has been applied to the referenced node, or the identity matrix if no matrix has been applied. | |
LMatrix4 | get_mat (const NodePath &other) const |
Returns the matrix that describes the coordinate space of the bottom node, relative to the other path's bottom node's coordinate space. | |
string | get_name () const |
Returns the name of the referenced node. | |
PN_stdfloat | get_net_audio_volume () const |
Returns the complete audio volume for this node taking highers nodes in the graph into account. | |
string | get_net_tag (const string &key) const |
Returns the tag value that has been defined on this node, or the nearest ancestor node, for the indicated key. | |
PandaNode * | get_node (int index, Thread *current_thread=Thread::get_current_thread()) const |
Returns the nth node of the path, where 0 is the referenced (bottom) node and get_num_nodes() - 1 is the top node. | |
int | get_num_children (Thread *current_thread=Thread::get_current_thread()) const |
Returns the number of children of the referenced node. | |
int | get_num_nodes (Thread *current_thread=Thread::get_current_thread()) const |
Returns the number of nodes in the path. | |
PN_stdfloat | get_p (const NodePath &other) const |
PN_stdfloat | get_p () const |
NodePath | get_parent (Thread *current_thread=Thread::get_current_thread()) const |
Returns the NodePath to the parent of the referenced node: that is, this NodePath, shortened by one node. | |
LPoint3 | get_pos (const NodePath &other) const |
Returns the relative position of the referenced node as seen from the other node. | |
LPoint3 | get_pos () const |
Retrieves the translation component of the transform. | |
LVector3 | get_pos_delta (const NodePath &other) const |
Returns the delta vector from this node's position in the previous frame (according to set_prev_transform(), typically set via the use of set_fluid_pos()) and its position in the current frame, as seen in the indicated node's coordinate space. | |
LVector3 | get_pos_delta () const |
Returns the delta vector from this node's position in the previous frame (according to set_prev_transform(), typically set via the use of set_fluid_pos()) and its position in the current frame. | |
const TransformState * | get_prev_transform (Thread *current_thread=Thread::get_current_thread()) const |
Returns the transform that has been set as this node's "previous" position. | |
LQuaternion | get_quat (const NodePath &other) const |
Returns the relative orientation of the bottom node as seen from the other node. | |
LQuaternion | get_quat () const |
Retrieves the rotation component of the transform. | |
PN_stdfloat | get_r (const NodePath &other) const |
PN_stdfloat | get_r () const |
LPoint3 | get_relative_point (const NodePath &other, const LVecBase3 &point) const |
Given that the indicated point is in the coordinate system of the other node, returns the same point in this node's coordinate system. | |
LVector3 | get_relative_vector (const NodePath &other, const LVecBase3 &vec) const |
Given that the indicated vector is in the coordinate system of the other node, returns the same vector in this node's coordinate system. | |
RenderModeAttrib::Mode | get_render_mode () const |
Returns the render mode that has been specifically set on this node via set_render_mode(), or M_unchanged if nothing has been set. | |
bool | get_render_mode_perspective () const |
Returns the flag that has been set on this node via set_render_mode_perspective(), or false if no flag has been set. | |
PN_stdfloat | get_render_mode_thickness () const |
Returns the render mode thickness that has been specifically set on this node via set_render_mode(), or 1.0 if nothing has been set. | |
PN_stdfloat | get_sa () const |
Gets the alpha scale component of the transform. | |
PN_stdfloat | get_sb () const |
Gets the blue scale component of the transform. | |
LVecBase3 | get_scale (const NodePath &other) const |
Returns the relative scale of the bottom node as seen from the other node. | |
LVecBase3 | get_scale () const |
Retrieves the scale component of the transform. | |
PN_stdfloat | get_sg () const |
Gets the green scale component of the transform. | |
const Shader * | get_shader () const |
const ShaderInput * | get_shader_input (const string &id) const |
const ShaderInput * | get_shader_input (const InternalName *id) const |
LVecBase3 | get_shear (const NodePath &other) const |
Returns the relative shear of the bottom node as seen from the other node. | |
LVecBase3 | get_shear () const |
Retrieves the shear component of the transform. | |
PN_stdfloat | get_shxy (const NodePath &other) const |
Returns the relative shear of the referenced node as seen from the other node. | |
PN_stdfloat | get_shxy () const |
PN_stdfloat | get_shxz (const NodePath &other) const |
PN_stdfloat | get_shxz () const |
PN_stdfloat | get_shyz (const NodePath &other) const |
PN_stdfloat | get_shyz () const |
int | get_sort (Thread *current_thread=Thread::get_current_thread()) const |
Returns the sort value of the referenced node within its parent; that is, the sort number passed on the last reparenting operation for this node. | |
PN_stdfloat | get_sr () const |
Gets the red scale component of the transform. | |
NodePath | get_stashed_ancestor (Thread *current_thread=Thread::get_current_thread()) const |
Returns the NodePath at or above the referenced node that is stashed, or an empty NodePath if no ancestor of the referenced node is stashed (and the node should be visible). | |
NodePathCollection | get_stashed_children (Thread *current_thread=Thread::get_current_thread()) const |
Returns the set of all child nodes of the referenced node that have been stashed. | |
const RenderState * | get_state (Thread *current_thread=Thread::get_current_thread()) const |
Returns the complete state object set on this node. | |
PN_stdfloat | get_sx (const NodePath &other) const |
Returns the relative scale of the referenced node as seen from the other node. | |
PN_stdfloat | get_sx () const |
PN_stdfloat | get_sy (const NodePath &other) const |
PN_stdfloat | get_sy () const |
PN_stdfloat | get_sz (const NodePath &other) const |
PN_stdfloat | get_sz () const |
string | get_tag (const string &key) const |
Retrieves the user-defined value that was previously set on this node for the particular key, if any. | |
RenderAttrib::TexGenMode | get_tex_gen (TextureStage *stage) const |
Returns the texture coordinate generation mode for the given stage, or M_off if there is no explicit mode set for the given stage. | |
NodePath | get_tex_gen_light (TextureStage *stage) const |
Returns the particular Light set for the indicated texgen mode's texture stage, or empty NodePath if no light is set. | |
LVecBase3 | get_tex_hpr (TextureStage *stage) const |
Returns the 3-D HPR set for the UVW's for the given stage on the current node. | |
LVecBase3 | get_tex_hpr (const NodePath &other, TextureStage *stage) const |
Returns the 3-D HPR set for the UVW's for the given stage on the current node. | |
LVecBase2 | get_tex_offset (TextureStage *stage) const |
Returns the offset set for the UV's for the given stage on the current node. | |
LVecBase2 | get_tex_offset (const NodePath &other, TextureStage *stage) const |
Returns the offset set for the UV's for the given stage on the current node. | |
LVecBase3 | get_tex_pos (TextureStage *stage) const |
Returns the offset set for the UVW's for the given stage on the current node. | |
LVecBase3 | get_tex_pos (const NodePath &other, TextureStage *stage) const |
Returns the offset set for the UVW's for the given stage on the current node. | |
NodePath | get_tex_projector_from (TextureStage *stage) const |
Returns the "from" node associated with the TexProjectorEffect on the indicated stage. | |
NodePath | get_tex_projector_to (TextureStage *stage) const |
Returns the "to" node associated with the TexProjectorEffect on the indicated stage. | |
PN_stdfloat | get_tex_rotate (TextureStage *stage) const |
Returns the rotation set for the UV's for the given stage on the current node. | |
PN_stdfloat | get_tex_rotate (const NodePath &other, TextureStage *stage) const |
Returns the rotation set for the UV's for the given stage on the current node. | |
LVecBase2 | get_tex_scale (TextureStage *stage) const |
Returns the scale set for the UV's for the given stage on the current node. | |
LVecBase2 | get_tex_scale (const NodePath &other, TextureStage *stage) const |
Returns the scale set for the UV's for the given stage on the current node. | |
LVecBase3 | get_tex_scale_3d (TextureStage *stage) const |
Returns the scale set for the UVW's for the given stage on the current node. | |
LVecBase3 | get_tex_scale_3d (const NodePath &other, TextureStage *stage) const |
Returns the scale set for the UVW's for the given stage on the current node. | |
Texture * | get_texture () const |
Returns the base-level texture that has been set on this particular node, or NULL if no texture has been set. | |
Texture * | get_texture (TextureStage *stage) const |
Returns the texture that has been set on the indicated stage for this particular node, or NULL if no texture has been set for this stage. | |
NodePath | get_top (Thread *current_thread=Thread::get_current_thread()) const |
Returns a singleton NodePath that represents the top of the path, or empty NodePath if this path is empty. | |
PandaNode * | get_top_node (Thread *current_thread=Thread::get_current_thread()) const |
Returns the top node of the path, or NULL if the path is empty. | |
const TransformState * | get_transform (Thread *current_thread=Thread::get_current_thread()) const |
Returns the complete transform object set on this node. | |
TransparencyAttrib::Mode | get_transparency () const |
Returns the transparent rendering that has been specifically set on this node via set_transparency(), or M_none if nontransparent rendering has been specifically set, or if nothing has been specifically set. | |
bool | get_two_sided () const |
Returns true if two-sided rendering has been specifically set on this node via set_two_sided(), or false if one-sided rendering has been specifically set, or if nothing has been specifically set. | |
PN_stdfloat | get_x (const NodePath &other) const |
PN_stdfloat | get_x () const |
PN_stdfloat | get_y (const NodePath &other) const |
PN_stdfloat | get_y () const |
PN_stdfloat | get_z (const NodePath &other) const |
PN_stdfloat | get_z () const |
bool | has_antialias () const |
Returns true if an antialias setting has been explicitly mode on this particular node via set_antialias(). | |
bool | has_attrib (TypeHandle type) const |
Returns true if there is a render attribute of the indicated type defined on this node, or false if there is not. | |
bool | has_audio_volume () const |
Returns true if an audio volume has been applied to the referenced node, false otherwise. | |
bool | has_billboard () const |
Returns true if there is any billboard effect on the node. | |
bool | has_bin () const |
Returns true if the node has been assigned to the a particular rendering bin via set_bin(), false otherwise. | |
bool | has_clip_plane (const NodePath &clip_plane) const |
Returns true if the indicated clipping plane has been specifically applied to this particular node. | |
bool | has_clip_plane_off () const |
Returns true if all clipping planes have been specifically disabled on this particular node. | |
bool | has_clip_plane_off (const NodePath &clip_plane) const |
Returns true if the indicated clipping plane has been specifically disabled on this particular node. | |
bool | has_color () const |
Returns true if a color has been applied to the given node, false otherwise. | |
bool | has_color_scale () const |
Returns true if a color scale has been applied to the referenced node, false otherwise. | |
bool | has_compass () const |
Returns true if there is any compass effect on the node. | |
bool | has_depth_offset () const |
Returns true if a depth-offset adjustment has been explicitly set on this particular node via set_depth_offset(). | |
bool | has_depth_test () const |
Returns true if a depth-test adjustment has been explicitly set on this particular node via set_depth_test(). | |
bool | has_depth_write () const |
Returns true if a depth-write adjustment has been explicitly set on this particular node via set_depth_write(). | |
bool | has_effect (TypeHandle type) const |
Returns true if there is a render effect of the indicated type defined on this node, or false if there is not. | |
bool | has_fog () const |
Returns true if a fog has been applied to this particular node via set_fog(), false otherwise. | |
bool | has_fog_off () const |
Returns true if a fog has been specifically disabled on this particular node via set_fog_off(), false otherwise. | |
bool | has_light (const NodePath &light) const |
Returns true if the indicated Light or PolylightNode has been specifically enabled on this particular node. | |
bool | has_light_off () const |
Returns true if all Lights have been specifically disabled on this particular node. | |
bool | has_light_off (const NodePath &light) const |
Returns true if the indicated Light has been specifically disabled on this particular node. | |
bool | has_mat () const |
Returns true if a non-identity transform matrix has been applied to the referenced node, false otherwise. | |
bool | has_material () const |
Returns true if a material has been applied to this particular node via set_material(), false otherwise. | |
bool | has_net_tag (const string &key) const |
Returns true if the indicated tag value has been defined on this node or on any ancestor node, or false otherwise. | |
bool | has_occluder (const NodePath &occluder) const |
Returns true if the indicated occluder has been specifically applied to this particular node. | |
bool | has_parent (Thread *current_thread=Thread::get_current_thread()) const |
Returns true if the referenced node has a parent; i.e. | |
bool | has_render_mode () const |
Returns true if a render mode has been explicitly set on this particular node via set_render_mode() (or set_render_mode_wireframe() or set_render_mode_filled()), false otherwise. | |
bool | has_scissor () const |
Returns true if a scissor region was defined at this node by a previous call to set_scissor(). | |
bool | has_tag (const string &key) const |
Returns true if a value has been defined on this node for the particular key (even if that value is the empty string), or false if no value has been set. | |
bool | has_tex_gen (TextureStage *stage) const |
Returns true if there is a mode for automatic texture coordinate generation on the current node for the given stage. | |
bool | has_tex_projector (TextureStage *stage) const |
Returns true if this node has a TexProjectorEffect for the indicated stage, false otherwise. | |
bool | has_tex_transform (TextureStage *stage) const |
Returns true if there is an explicit texture matrix on the current node for the given stage. | |
bool | has_texcoord (const string &texcoord_name) const |
Returns true if there are at least some vertices at this node and below that use the named texture coordinate set, false otherwise. | |
bool | has_texture () const |
Returns true if a texture has been applied to this particular node via set_texture(), false otherwise. | |
bool | has_texture (TextureStage *stage) const |
Returns true if texturing has been specifically enabled on this particular node for the indicated stage. | |
bool | has_texture_off () const |
Returns true if texturing has been specifically disabled on this particular node via set_texture_off(), false otherwise. | |
bool | has_texture_off (TextureStage *stage) const |
Returns true if texturing has been specifically disabled on this particular node for the indicated stage. | |
bool | has_transparency () const |
Returns true if a transparent-rendering adjustment has been explicitly set on this particular node via set_transparency(). | |
bool | has_two_sided () const |
Returns true if a two-sided adjustment has been explicitly set on this particular node via set_two_sided(). | |
bool | has_vertex_column (const InternalName *name) const |
Returns true if there are at least some vertices at this node and below that contain a reference to the indicated vertex data column name, false otherwise. | |
void | heads_up (PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction. | |
void | heads_up (const LPoint3 &point, const LVector3 &up=LVector3::up()) |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction. | |
void | heads_up (const NodePath &other, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction. | |
void | heads_up (const NodePath &other, const LPoint3 &point=LPoint3(0.0, 0.0, 0.0), const LVector3 &up=LVector3::up()) |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction. | |
void | hide (DrawMask camera_mask) |
Makes the referenced node invisible just to the cameras whose camera_mask shares the indicated bits. | |
void | hide () |
Makes the referenced node (and the entire subgraph below this node) invisible to all cameras. | |
void | hide_bounds () |
Stops the rendering of the bounding volume begun with show_bounds(). | |
NodePath | instance_to (const NodePath &other, int sort=0, Thread *current_thread=Thread::get_current_thread()) const |
Adds the referenced node of the NodePath as a child of the referenced node of the indicated other NodePath. | |
NodePath | instance_under_node (const NodePath &other, const string &name, int sort=0, Thread *current_thread=Thread::get_current_thread()) const |
Behaves like instance_to(), but implicitly creates a new node to instance the geometry under, and returns a NodePath to that new node. | |
bool | is_ancestor_of (const NodePath &other, Thread *current_thread=Thread::get_current_thread()) const |
Returns true if the node represented by this NodePath is a parent or other ancestor of the other NodePath, or false if it is not. | |
bool | is_empty () const |
Returns true if the NodePath contains no nodes. | |
bool | is_hidden (DrawMask camera_mask=PandaNode::get_overall_bit()) const |
Returns true if the referenced node is hidden from the indicated camera(s) either directly, or because some ancestor is hidden. | |
bool | is_same_graph (const NodePath &other, Thread *current_thread=Thread::get_current_thread()) const |
Returns true if the node represented by this NodePath is parented within the same graph as that of the other NodePath. | |
bool | is_singleton (Thread *current_thread=Thread::get_current_thread()) const |
Returns true if the NodePath contains exactly one node. | |
bool | is_stashed () const |
Returns true if the referenced node is stashed either directly, or because some ancestor is stashed. | |
void | list_tags () const |
Lists the tags to the nout stream, one per line. | |
void | look_at (PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Sets the transform on this NodePath so that it rotates to face the indicated point in space. | |
void | look_at (const LPoint3 &point, const LVector3 &up=LVector3::up()) |
Sets the hpr on this NodePath so that it rotates to face the indicated point in space. | |
void | look_at (const NodePath &other, const LPoint3 &point=LPoint3(0.0, 0.0, 0.0), const LVector3 &up=LVector3::up()) |
Sets the transform on this NodePath so that it rotates to face the indicated point in space, which is relative to the other NodePath. | |
void | look_at (const NodePath &other, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Sets the hpr on this NodePath so that it rotates to face the indicated point in space, which is relative to the other NodePath. | |
void | ls () const |
Lists the hierarchy at and below the referenced node. | |
void | ls (ostream &out, int indent_level=0) const |
Lists the hierarchy at and below the referenced node. | |
MAKE_SEQ (get_nodes, get_num_nodes, get_node) | |
MAKE_SEQ (get_ancestors, get_num_nodes, get_ancestor) | |
PandaNode * | node () const |
Returns the referenced node of the path. | |
operator bool () const | |
Returns true if the NodePath is valid (not empty), or false if it contains no nodes. | |
bool | operator!= (const NodePath &other) const |
Returns true if the two paths are not equivalent. | |
bool | operator< (const NodePath &other) const |
Returns true if this NodePath sorts before the other one, false otherwise. | |
void | operator= (const NodePath ©) |
bool | operator== (const NodePath &other) const |
Returns true if the two paths are equivalent; that is, if they contain the same list of nodes in the same order. | |
void | output (ostream &out) const |
Writes a sensible description of the NodePath to the indicated output stream. | |
void | premunge_scene (GraphicsStateGuardianBase *gsg=NULL) |
Walks through the scene graph beginning at the bottom node, and internally adjusts any GeomVertexFormats for optimal rendering on the indicated GSG. | |
void | prepare_scene (GraphicsStateGuardianBase *gsg) |
Walks through the scene graph beginning at the bottom node, and does whatever initialization is required to render the scene properly with the indicated GSG. | |
void | project_texture (TextureStage *stage, Texture *tex, const NodePath &projector) |
A convenience function to enable projective texturing at this node level and below, using the indicated NodePath (which should contain a LensNode) as the projector. | |
PT (BoundingVolume) get_bounds(Thread *current_thread | |
PT (Material) get_material() const | |
void | remove_node (Thread *current_thread=Thread::get_current_thread()) |
Disconnects the referenced node from the scene graph. | |
void | reparent_to (const NodePath &other, int sort=0, Thread *current_thread=Thread::get_current_thread()) |
Removes the referenced node of the NodePath from its current parent and attaches it to the referenced node of the indicated NodePath. | |
void | reverse_ls () const |
Lists the hierarchy at and above the referenced node. | |
int | reverse_ls (ostream &out, int indent_level=0) const |
Lists the hierarchy at and above the referenced node. | |
void | set_all_color_scale (PN_stdfloat scale, int priority=0) |
Scales all the color components of the object by the same amount, darkening the object, without (much) affecting alpha. | |
void | set_alpha_scale (PN_stdfloat scale, int priority=0) |
Sets the alpha scale component of the transform without (much) affecting the color scale. | |
void | set_antialias (unsigned short mode, int priority=0) |
Specifies the antialiasing type that should be applied at this node and below. | |
void | set_attrib (const RenderAttrib *attrib, int priority=0) |
Adds the indicated render attribute to the scene graph on this node. | |
void | set_audio_volume (PN_stdfloat volume, int priority=0) |
Sets the audio volume component of the transform. | |
void | set_audio_volume_off (int priority=0) |
Disables any audio volume attribute inherited from above. | |
void | set_billboard_axis (PN_stdfloat offset=0.0) |
Puts a billboard transition on the node such that it will rotate in two dimensions around the up axis. | |
void | set_billboard_axis (const NodePath &camera, PN_stdfloat offset) |
Puts a billboard transition on the node such that it will rotate in two dimensions around the up axis, towards a specified "camera" instead of to the viewing camera. | |
void | set_billboard_point_eye (PN_stdfloat offset=0.0) |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the top of the camera. | |
void | set_billboard_point_eye (const NodePath &camera, PN_stdfloat offset) |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the top of the camera, towards a specified "camera" instead of to the viewing camera. | |
void | set_billboard_point_world (const NodePath &camera, PN_stdfloat offset) |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the sky, towards a specified "camera" instead of to the viewing camera. | |
void | set_billboard_point_world (PN_stdfloat offset=0.0) |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the sky. | |
void | set_bin (const string &bin_name, int draw_order, int priority=0) |
Assigns the geometry at this level and below to the named rendering bin. | |
void | set_clip_plane (const NodePath &clip_plane, int priority=0) |
Adds the indicated clipping plane to the list of planes that apply to geometry at this node and below. | |
void | set_clip_plane_off (const NodePath &clip_plane, int priority=0) |
Sets the geometry at this level and below to render without being clipped by the indicated PlaneNode. | |
void | set_clip_plane_off (int priority=0) |
Sets the geometry at this level and below to render using no clip_planes at all. | |
void | set_collide_mask (CollideMask new_mask, CollideMask bits_to_change=CollideMask::all_on(), TypeHandle node_type=TypeHandle::none()) |
Recursively applies the indicated CollideMask to the into_collide_masks for all nodes at this level and below. | |
void | set_color (PN_stdfloat r, PN_stdfloat g, PN_stdfloat b, PN_stdfloat a=1.0, int priority=0) |
Applies a scene-graph color to the referenced node. | |
void | set_color (const LColor &color, int priority=0) |
Applies a scene-graph color to the referenced node. | |
void | set_color_off (int priority=0) |
Sets the geometry at this level and below to render using the geometry color. | |
void | set_color_scale (const LVecBase4 &scale, int priority=0) |
Sets the color scale component of the transform, leaving translation and rotation untouched. | |
void | set_color_scale (PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz, PN_stdfloat sa, int priority=0) |
Sets the color scale component of the transform. | |
void | set_color_scale_off (int priority=0) |
Disables any color scale attribute inherited from above. | |
void | set_compass (const NodePath &reference=NodePath()) |
Puts a compass effect on the node, so that it will retain a fixed rotation relative to the reference node (or render if the reference node is empty) regardless of the transforms above it. | |
void | set_depth_offset (int bias, int priority=0) |
This instructs the graphics driver to apply an offset or bias to the generated depth values for rendered polygons, before they are written to the depth buffer. | |
void | set_depth_test (bool depth_test, int priority=0) |
Specifically sets or disables the testing of the depth buffer on this particular node. | |
void | set_depth_write (bool depth_write, int priority=0) |
Specifically sets or disables the writing to the depth buffer on this particular node. | |
void | set_effect (const RenderEffect *effect) |
Adds the indicated render effect to the scene graph on this node. | |
void | set_effects (const RenderEffects *effects) |
Sets the complete RenderEffects that will be applied this node. | |
void | set_fluid_pos (const NodePath &other, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Sets the translation component, without changing the "previous" position, so that the collision system will see the node as moving fluidly from its previous position to its new position. | |
void | set_fluid_pos (const NodePath &other, const LVecBase3 &pos) |
Sets the translation component of the transform, relative to the other node. | |
void | set_fluid_pos (PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Sets the translation component, without changing the "previous" position, so that the collision system will see the node as moving fluidly from its previous position to its new position. | |
void | set_fluid_pos (const LVecBase3 &pos) |
Sets the translation component, without changing the "previous" position, so that the collision system will see the node as moving fluidly from its previous position to its new position. | |
void | set_fluid_x (const NodePath &other, PN_stdfloat x) |
void | set_fluid_x (PN_stdfloat x) |
void | set_fluid_y (const NodePath &other, PN_stdfloat y) |
void | set_fluid_y (PN_stdfloat y) |
void | set_fluid_z (const NodePath &other, PN_stdfloat z) |
void | set_fluid_z (PN_stdfloat z) |
void | set_fog (Fog *fog, int priority=0) |
Sets the geometry at this level and below to render using the indicated fog. | |
void | set_fog_off (int priority=0) |
Sets the geometry at this level and below to render using no fog. | |
void | set_h (const NodePath &other, PN_stdfloat h) |
void | set_h (PN_stdfloat h) |
void | set_hpr (PN_stdfloat h, PN_stdfloat p, PN_stdfloat r) |
Sets the rotation component of the transform, leaving translation and scale untouched. | |
void | set_hpr (const NodePath &other, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r) |
Sets the rotation component of the transform, relative to the other node. | |
void | set_hpr (const NodePath &other, const LVecBase3 &hpr) |
Sets the rotation component of the transform, relative to the other node. | |
void | set_hpr (const LVecBase3 &hpr) |
Sets the rotation component of the transform, leaving translation and scale untouched. | |
void | set_hpr_scale (const NodePath &other, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r, PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz) |
Sets the rotation and scale components of the transform, leaving translation untouched. | |
void | set_hpr_scale (const NodePath &other, const LVecBase3 &hpr, const LVecBase3 &scale) |
Sets the rotation and scale components of the transform, leaving translation untouched. | |
void | set_hpr_scale (const LVecBase3 &hpr, const LVecBase3 &scale) |
Sets the rotation and scale components of the transform, leaving translation untouched. | |
void | set_hpr_scale (PN_stdfloat h, PN_stdfloat p, PN_stdfloat r, PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz) |
Sets the rotation and scale components of the transform, leaving translation untouched. | |
void | set_instance_count (int instance_count) |
Sets the geometry instance count, or 0 if geometry instancing should be disabled. | |
void | set_light (const NodePath &light, int priority=0) |
Adds the indicated Light or PolylightNode to the list of lights that illuminate geometry at this node and below. | |
void | set_light_off (const NodePath &light, int priority=0) |
Sets the geometry at this level and below to render without using the indicated Light. | |
void | set_light_off (int priority=0) |
Sets the geometry at this level and below to render using no lights at all. | |
void | set_mat (const LMatrix4 &mat) |
Directly sets an arbitrary 4x4 transform matrix. | |
void | set_mat (const NodePath &other, const LMatrix4 &mat) |
Converts the indicated matrix from the other's coordinate space to the local coordinate space, and applies it to the node. | |
void | set_material (Material *tex, int priority=0) |
Sets the geometry at this level and below to render using the indicated material. | |
void | set_material_off (int priority=0) |
Sets the geometry at this level and below to render using no material. | |
void | set_name (const string &name) |
Changes the name of the referenced node. | |
void | set_normal_map (Texture *normal_map, const string &texcoord_name=string(), bool preserve_color=false) |
A convenience function to set up a normal map on this geometry. | |
void | set_occluder (const NodePath &occluder) |
Adds the indicated occluder to the list of occluders that apply to geometry at this node and below. | |
void | set_p (const NodePath &other, PN_stdfloat p) |
void | set_p (PN_stdfloat p) |
void | set_pos (const NodePath &other, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Sets the translation component of the transform, relative to the other node. | |
void | set_pos (const NodePath &other, const LVecBase3 &pos) |
Sets the translation component of the transform, relative to the other node. | |
void | set_pos (PN_stdfloat x, PN_stdfloat y, PN_stdfloat z) |
Sets the translation component of the transform, leaving rotation and scale untouched. | |
void | set_pos (const LVecBase3 &pos) |
Sets the translation component of the transform, leaving rotation and scale untouched. | |
void | set_pos_hpr (PN_stdfloat x, PN_stdfloat y, PN_stdfloat z, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r) |
Sets the translation and rotation component of the transform, leaving scale untouched. | |
void | set_pos_hpr (const NodePath &other, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r) |
Sets the translation and rotation component of the transform, relative to the other node. | |
void | set_pos_hpr (const NodePath &other, const LVecBase3 &pos, const LVecBase3 &hpr) |
Sets the translation and rotation component of the transform, relative to the other node. | |
void | set_pos_hpr (const LVecBase3 &pos, const LVecBase3 &hpr) |
Sets the translation and rotation component of the transform, leaving scale untouched. | |
void | set_pos_hpr_scale (PN_stdfloat x, PN_stdfloat y, PN_stdfloat z, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r, PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz) |
Completely replaces the transform with new translation, rotation, and scale components. | |
void | set_pos_hpr_scale (const LVecBase3 &pos, const LVecBase3 &hpr, const LVecBase3 &scale) |
Replaces the translation, rotation, and scale components, implicitly setting shear to 0. | |
void | set_pos_hpr_scale (const NodePath &other, PN_stdfloat x, PN_stdfloat y, PN_stdfloat z, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r, PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz) |
Completely replaces the transform with new translation, rotation, and scale components, relative to the other node. | |
void | set_pos_hpr_scale (const NodePath &other, const LVecBase3 &pos, const LVecBase3 &hpr, const LVecBase3 &scale) |
Completely replaces the transform with new translation, rotation, and scale components, relative to the other node, implicitly setting shear to 0. | |
void | set_pos_hpr_scale_shear (const LVecBase3 &pos, const LVecBase3 &hpr, const LVecBase3 &scale, const LVecBase3 &shear) |
Completely replaces the transform with new translation, rotation, scale, and shear components. | |
void | set_pos_hpr_scale_shear (const NodePath &other, const LVecBase3 &pos, const LVecBase3 &hpr, const LVecBase3 &scale, const LVecBase3 &shear) |
Completely replaces the transform with new translation, rotation, scale, and shear components, relative to the other node. | |
void | set_pos_quat (const LVecBase3 &pos, const LQuaternion &quat) |
Sets the translation and rotation component of the transform, leaving scale untouched. | |
void | set_pos_quat (const NodePath &other, const LVecBase3 &pos, const LQuaternion &quat) |
Sets the translation and rotation component of the transform, relative to the other node. | |
void | set_pos_quat_scale (const LVecBase3 &pos, const LQuaternion &quat, const LVecBase3 &scale) |
Replaces the translation, rotation, and scale components, implicitly setting shear to 0. | |
void | set_pos_quat_scale (const NodePath &other, const LVecBase3 &pos, const LQuaternion &quat, const LVecBase3 &scale) |
Completely replaces the transform with new translation, rotation, and scale components, relative to the other node, implicitly setting shear to 0. | |
void | set_pos_quat_scale_shear (const LVecBase3 &pos, const LQuaternion &quat, const LVecBase3 &scale, const LVecBase3 &shear) |
Completely replaces the transform with new translation, rotation, scale, and shear components. | |
void | set_pos_quat_scale_shear (const NodePath &other, const LVecBase3 &pos, const LQuaternion &quat, const LVecBase3 &scale, const LVecBase3 &shear) |
Completely replaces the transform with new translation, rotation, scale, and shear components, relative to the other node. | |
void | set_prev_transform (const TransformState *transform, Thread *current_thread=Thread::get_current_thread()) |
Sets the transform that represents this node's "previous" position, one frame ago, for the purposes of detecting motion for accurate collision calculations. | |
void | set_prev_transform (const NodePath &other, const TransformState *transform, Thread *current_thread=Thread::get_current_thread()) |
Sets the "previous" transform object on this node, relative to the other node. | |
void | set_quat (const NodePath &other, const LQuaternion &quat) |
Sets the rotation component of the transform, relative to the other node. | |
void | set_quat (const LQuaternion &quat) |
Sets the rotation component of the transform, leaving translation and scale untouched. | |
void | set_quat_scale (const LQuaternion &quat, const LVecBase3 &scale) |
Sets the rotation and scale components of the transform, leaving translation untouched. | |
void | set_quat_scale (const NodePath &other, const LQuaternion &quat, const LVecBase3 &scale) |
Sets the rotation and scale components of the transform, leaving translation untouched. | |
void | set_r (const NodePath &other, PN_stdfloat r) |
void | set_r (PN_stdfloat r) |
void | set_render_mode (RenderModeAttrib::Mode mode, PN_stdfloat thickness, int priority=0) |
Sets up the geometry at this level and below (unless overridden) to render in the specified mode and with the indicated line and/or point thickness. | |
void | set_render_mode_filled (int priority=0) |
Sets up the geometry at this level and below (unless overridden) to render in filled (i.e. | |
void | set_render_mode_perspective (bool perspective, int priority=0) |
Sets up the point geometry at this level and below to render as perspective sprites (that is, billboarded quads). | |
void | set_render_mode_thickness (PN_stdfloat thickness, int priority=0) |
Sets up the point geometry at this level and below to render as thick points (that is, billboarded quads). | |
void | set_render_mode_wireframe (int priority=0) |
Sets up the geometry at this level and below (unless overridden) to render in wireframe mode. | |
void | set_sa (PN_stdfloat sa) |
Sets the alpha scale component of the transform. | |
void | set_sb (PN_stdfloat sb) |
Sets the blue scale component of the transform. | |
void | set_scale (const NodePath &other, const LVecBase3 &scale) |
Sets the scale component of the transform, relative to the other node. | |
void | set_scale (const NodePath &other, PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz) |
Sets the scale component of the transform, relative to the other node. | |
void | set_scale (PN_stdfloat sx, PN_stdfloat sy, PN_stdfloat sz) |
void | set_scale (const LVecBase3 &scale) |
Sets the scale component of the transform, leaving translation and rotation untouched. | |
void | set_scale (PN_stdfloat scale) |
Sets the scale component of the transform, leaving translation and rotation untouched. | |
void | set_scale (const NodePath &other, PN_stdfloat scale) |
Sets the scale component of the transform, relative to the other node. | |
void | set_scissor (const LPoint3 &a, const LPoint3 &b, const LPoint3 &c, const LPoint3 &d) |
Sets up a scissor region on the nodes rendered at this level and below. | |
void | set_scissor (const NodePath &other, const LPoint3 &a, const LPoint3 &b) |
Sets up a scissor region on the nodes rendered at this level and below. | |
void | set_scissor (const NodePath &other, const LPoint3 &a, const LPoint3 &b, const LPoint3 &c, const LPoint3 &d) |
Sets up a scissor region on the nodes rendered at this level and below. | |
void | set_scissor (const LPoint3 &a, const LPoint3 &b) |
Sets up a scissor region on the nodes rendered at this level and below. | |
void | set_scissor (PN_stdfloat left, PN_stdfloat right, PN_stdfloat bottom, PN_stdfloat top) |
Sets up a scissor region on the nodes rendered at this level and below. | |
void | set_sg (PN_stdfloat sg) |
Sets the alpha scale component of the transform. | |
void | set_shader (const Shader *sha, int priority=0) |
void | set_shader_auto (int priority=0) |
void | set_shader_auto (BitMask32 shader_switch, int priority=0) |
overloaded for auto shader customization | |
void | set_shader_input (const string &id, Texture *tex, int priority=0) |
void | set_shader_input (const InternalName *id, const PTA_LVecBase4 &v, int priority=0) |
void | set_shader_input (const string &id, const LVecBase3 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const PTA_float &v, int priority=0) |
void | set_shader_input (const InternalName *id, const PTA_LVecBase2 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const PTA_LMatrix3 &v, int priority=0) |
void | set_shader_input (const string &id, const PTA_LVecBase4 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const LVecBase3 &v, int priority=0) |
void | set_shader_input (const string &id, const LVecBase4 &v, int priority=0) |
void | set_shader_input (const InternalName *id, double n1=0, double n2=0, double n3=0, double n4=1, int priority=0) |
void | set_shader_input (const InternalName *id, const LMatrix3 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const LMatrix4 &v, int priority=0) |
void | set_shader_input (const string &id, const LMatrix4 &v, int priority=0) |
void | set_shader_input (const string &id, double n1=0, double n2=0, double n3=0, double n4=1, int priority=0) |
void | set_shader_input (const string &id, const PTA_LMatrix3 &v, int priority=0) |
void | set_shader_input (const ShaderInput *inp) |
void | set_shader_input (const InternalName *id, const PTA_LMatrix4 &v, int priority=0) |
void | set_shader_input (const string &id, const PTA_LVecBase3 &v, int priority=0) |
void | set_shader_input (const string &id, const LMatrix3 &v, int priority=0) |
void | set_shader_input (const string &id, const LVecBase2 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const LVecBase2 &v, int priority=0) |
void | set_shader_input (const string &id, const PTA_LMatrix4 &v, int priority=0) |
void | set_shader_input (const string &id, const PTA_float &v, int priority=0) |
void | set_shader_input (const InternalName *id, const PTA_LVecBase3 &v, int priority=0) |
void | set_shader_input (const string &id, const NodePath &np, int priority=0) |
void | set_shader_input (const string &id, const PTA_double &v, int priority=0) |
void | set_shader_input (const string &id, const PTA_LVecBase2 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const NodePath &np, int priority=0) |
void | set_shader_input (const InternalName *id, const LVecBase4 &v, int priority=0) |
void | set_shader_input (const InternalName *id, const PTA_double &v, int priority=0) |
void | set_shader_input (const InternalName *id, Texture *tex, int priority=0) |
void | set_shader_off (int priority=0) |
void | set_shear (const NodePath &other, const LVecBase3 &shear) |
Sets the shear component of the transform, relative to the other node. | |
void | set_shear (PN_stdfloat shxy, PN_stdfloat shxz, PN_stdfloat shyz) |
Sets the shear component of the transform, leaving translation, rotation, and scale untouched. | |
void | set_shear (const NodePath &other, PN_stdfloat shxy, PN_stdfloat shxz, PN_stdfloat shyz) |
Sets the shear component of the transform, relative to the other node. | |
void | set_shear (const LVecBase3 &shear) |
Sets the shear component of the transform, leaving translation and rotation untouched. | |
void | set_shxy (const NodePath &other, PN_stdfloat shxy) |
void | set_shxy (PN_stdfloat shxy) |
void | set_shxz (const NodePath &other, PN_stdfloat shxz) |
void | set_shxz (PN_stdfloat shxz) |
void | set_shyz (const NodePath &other, PN_stdfloat shyz) |
void | set_shyz (PN_stdfloat shyz) |
void | set_sr (PN_stdfloat sr) |
Sets the red scale component of the transform. | |
void | set_state (const RenderState *state, Thread *current_thread=Thread::get_current_thread()) |
Changes the complete state object on this node. | |
void | set_state (const NodePath &other, const RenderState *state, Thread *current_thread=Thread::get_current_thread()) |
Sets the state object on this node, relative to the other node. | |
void | set_sx (PN_stdfloat sx) |
void | set_sx (const NodePath &other, PN_stdfloat sx) |
void | set_sy (PN_stdfloat sy) |
void | set_sy (const NodePath &other, PN_stdfloat sy) |
void | set_sz (PN_stdfloat sz) |
void | set_sz (const NodePath &other, PN_stdfloat sz) |
void | set_tag (const string &key, const string &value) |
Associates a user-defined value with a user-defined key which is stored on the node. | |
void | set_tex_gen (TextureStage *stage, RenderAttrib::TexGenMode mode, const LTexCoord3 &constant_value, int priority=0) |
Enables automatic texture coordinate generation for the indicated texture stage. | |
void | set_tex_gen (TextureStage *stage, RenderAttrib::TexGenMode mode, int priority=0) |
Enables automatic texture coordinate generation for the indicated texture stage. | |
void | set_tex_gen (TextureStage *stage, RenderAttrib::TexGenMode mode, const string &source_name, const NodePath &light, int priority=0) |
Enables automatic texture coordinate generation for the indicated texture stage. | |
void | set_tex_hpr (TextureStage *stage, const LVecBase3 &hpr) |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage. | |
void | set_tex_hpr (const NodePath &other, TextureStage *stage, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r) |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage. | |
void | set_tex_hpr (TextureStage *stage, PN_stdfloat h, PN_stdfloat p, PN_stdfloat r) |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage. | |
void | set_tex_hpr (const NodePath &other, TextureStage *stage, const LVecBase3 &hpr) |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage. | |
void | set_tex_offset (const NodePath &other, TextureStage *stage, const LVecBase2 &uv) |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage. | |
void | set_tex_offset (TextureStage *stage, PN_stdfloat u, PN_stdfloat v) |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage. | |
void | set_tex_offset (TextureStage *stage, const LVecBase2 &uv) |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage. | |
void | set_tex_offset (const NodePath &other, TextureStage *stage, PN_stdfloat u, PN_stdfloat v) |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage. | |
void | set_tex_pos (const NodePath &other, TextureStage *stage, const LVecBase3 &uvw) |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage. | |
void | set_tex_pos (TextureStage *stage, PN_stdfloat u, PN_stdfloat v, PN_stdfloat w) |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage. | |
void | set_tex_pos (TextureStage *stage, const LVecBase3 &uvw) |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage. | |
void | set_tex_pos (const NodePath &other, TextureStage *stage, PN_stdfloat u, PN_stdfloat v, PN_stdfloat w) |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage. | |
void | set_tex_projector (TextureStage *stage, const NodePath &from, const NodePath &to) |
Establishes a TexProjectorEffect on this node, which can be used to establish projective texturing (but see also the NodePath::project_texture() convenience function), or it can be used to bind this node's texture transform to particular node's position in space, allowing a LerpInterval (for instance) to adjust this node's texture coordinates. | |
void | set_tex_rotate (const NodePath &other, TextureStage *stage, PN_stdfloat r) |
Sets a texture matrix on the current node to apply the indicated rotation, clockwise in degrees, to UV's for the given stage. | |
void | set_tex_rotate (TextureStage *stage, PN_stdfloat r) |
Sets a texture matrix on the current node to apply the indicated rotation, clockwise in degrees, to UV's for the given stage. | |
void | set_tex_scale (TextureStage *stage, const LVecBase2 &scale) |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage. | |
void | set_tex_scale (const NodePath &other, TextureStage *stage, const LVecBase3 &scale) |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage. | |
void | set_tex_scale (const NodePath &other, TextureStage *stage, const LVecBase2 &scale) |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage. | |
void | set_tex_scale (TextureStage *stage, PN_stdfloat su, PN_stdfloat sv, PN_stdfloat sw) |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage. | |
void | set_tex_scale (TextureStage *stage, const LVecBase3 &scale) |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage. | |
void | set_tex_scale (TextureStage *stage, PN_stdfloat scale) |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage. | |
void | set_tex_scale (const NodePath &other, TextureStage *stage, PN_stdfloat scale) |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage. | |
void | set_tex_scale (TextureStage *stage, PN_stdfloat su, PN_stdfloat sv) |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage. | |
void | set_tex_scale (const NodePath &other, TextureStage *stage, PN_stdfloat su, PN_stdfloat sv, PN_stdfloat sw) |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage. | |
void | set_tex_scale (const NodePath &other, TextureStage *stage, PN_stdfloat su, PN_stdfloat sv) |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage. | |
void | set_tex_transform (const NodePath &other, TextureStage *stage, const TransformState *transform) |
Sets the texture matrix on the current node to the indicated transform for the given stage. | |
void | set_tex_transform (TextureStage *stage, const TransformState *transform) |
Sets the texture matrix on the current node to the indicated transform for the given stage. | |
void | set_texture (Texture *tex, int priority=0) |
Adds the indicated texture to the list of textures that will be rendered on the default texture stage. | |
void | set_texture (TextureStage *stage, Texture *tex, int priority=0) |
Adds the indicated texture to the list of textures that will be rendered on the indicated multitexture stage. | |
void | set_texture_off (int priority=0) |
Sets the geometry at this level and below to render using no texture, on any stage. | |
void | set_texture_off (TextureStage *stage, int priority=0) |
Sets the geometry at this level and below to render using no texture, on the indicated stage. | |
void | set_transform (const TransformState *transform, Thread *current_thread=Thread::get_current_thread()) |
Changes the complete transform object on this node. | |
void | set_transform (const NodePath &other, const TransformState *transform, Thread *current_thread=Thread::get_current_thread()) |
Sets the transform object on this node, relative to the other node. | |
void | set_transparency (TransparencyAttrib::Mode mode, int priority=0) |
Specifically sets or disables transparent rendering mode on this particular node. | |
void | set_two_sided (bool two_sided, int priority=0) |
Specifically sets or disables two-sided rendering mode on this particular node. | |
void | set_x (const NodePath &other, PN_stdfloat x) |
void | set_x (PN_stdfloat x) |
void | set_y (PN_stdfloat y) |
void | set_y (const NodePath &other, PN_stdfloat y) |
void | set_z (const NodePath &other, PN_stdfloat z) |
void | set_z (PN_stdfloat z) |
void | show () |
Undoes the effect of a previous hide() on this node: makes the referenced node (and the entire subgraph below this node) visible to all cameras. | |
void | show (DrawMask camera_mask) |
Makes the referenced node visible just to the cameras whose camera_mask shares the indicated bits. | |
void | show_bounds () |
Causes the bounding volume of the bottom node and all of its descendants (that is, the bounding volume associated with the the bottom arc) to be rendered, if possible. | |
void | show_through (DrawMask camera_mask) |
Makes the referenced node visible just to the cameras whose camera_mask shares the indicated bits. | |
void | show_through () |
Makes the referenced node visible just to the cameras whose camera_mask shares the indicated bits. | |
void | show_tight_bounds () |
Similar to show_bounds(), this draws a bounding box representing the "tight" bounds of this node and all of its descendants. | |
void | stash (int sort=0, Thread *current_thread=Thread::get_current_thread()) |
Removes the referenced node (and the entire subgraph below this node) from the scene graph in any normal sense. | |
void | stash_to (const NodePath &other, int sort=0, Thread *current_thread=Thread::get_current_thread()) |
Similar to reparent_to(), but the node is added to its new parent's stashed list, so that the result is equivalent to calling reparent_to() immediately followed by stash(). | |
void | unify_texture_stages (TextureStage *stage) |
Searches through all TextureStages at this node and below. | |
void | unstash (int sort=0, Thread *current_thread=Thread::get_current_thread()) |
Undoes the effect of a previous stash() on this node: makes the referenced node (and the entire subgraph below this node) once again part of the scene graph. | |
void | unstash_all (Thread *current_thread=Thread::get_current_thread()) |
Unstashes this node and all stashed child nodes. | |
bool | verify_complete (Thread *current_thread=Thread::get_current_thread()) const |
Returns true if all of the nodes described in the NodePath are connected, or false otherwise. | |
bool | write_bam_file (const Filename &filename) const |
Writes the contents of this node and below out to a bam file with the indicated filename. | |
bool | write_bam_stream (ostream &out) const |
Writes the contents of this node and below out to the indicated stream. | |
void | write_bounds (ostream &out) const |
Writes a description of the bounding volume containing the bottom node and all of its descendants to the indicated output stream. | |
void | wrt_reparent_to (const NodePath &other, int sort=0, Thread *current_thread=Thread::get_current_thread()) |
This functions identically to reparent_to(), except the transform on this node is also adjusted so that the node remains in the same place in world coordinates, even if it is reparented into a different coordinate system. | |
Static Public Member Functions | |
static NodePath | any_path (PandaNode *node, Thread *current_thread=Thread::get_current_thread()) |
Returns a new NodePath that represents any arbitrary path from the root to the indicated node. | |
static NodePath | decode_from_bam_stream (const string &data, BamReader *reader=NULL) |
Reads the string created by a previous call to encode_to_bam_stream(), and extracts and returns the NodePath on that string. | |
static NodePath | fail () |
Creates a NodePath with the ET_fail error type set. | |
static TypeHandle | get_class_type () |
static int | get_max_search_depth () |
Returns the current setting of the search depth limit. | |
static void | init_type () |
static NodePath | not_found () |
Creates a NodePath with the ET_not_found error type set. | |
static NodePath | removed () |
Creates a NodePath with the ET_removed error type set. | |
static void | set_max_search_depth (int max_search_depth) |
Certain operations, such as find() or find_all_matches(), require a traversal of the scene graph to search for the target node or nodes. | |
Public Attributes | |
TextureStage *stage | const |
Thread * | current_thread = Thread::get_current_thread()) const |
Friends | |
class | NodePathCollection |
class | WeakNodePath |
class | WorkingNodePath |
NodePath is the fundamental system for disambiguating instances, and also provides a higher-level interface for manipulating the scene graph.
A NodePath is a list of connected nodes from the root of the graph to any sub-node. Each NodePath therefore uniquely describes one instance of a node.
NodePaths themselves are lightweight objects that may easily be copied and passed by value. Their data is stored as a series of NodePathComponents that are stored on the nodes. Holding a NodePath will keep a reference count to all the nodes in the path. However, if any node in the path is removed or reparented (perhaps through a different NodePath), the NodePath will automatically be updated to reflect the changes.
Definition at line 161 of file nodePath.h.
NodePath::NodePath | ( | ) | [inline] |
This constructs an empty NodePath with no nodes.
Definition at line 22 of file nodePath.I.
Referenced by decode_from_bam_stream(), get_child(), get_parent(), get_tex_gen_light(), project_texture(), set_billboard_axis(), set_billboard_point_eye(), set_billboard_point_world(), set_normal_map(), set_tex_transform(), and set_transform().
NodePath::NodePath | ( | const string & | top_node_name, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline] |
This constructs a new NodePath with a single node.
An ordinary, unattached PandaNode is created with the indicated name.
Definition at line 36 of file nodePath.I.
References Thread::get_pipeline_stage().
NodePath::NodePath | ( | PandaNode * | node, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline] |
This constructs a NodePath for the indicated node.
If the node does not have any parents, this creates a singleton NodePath; otherwise, it automatically finds the path from the node to the root. If the node has multiple paths to the root, one path is chosen arbitrarily and a warning message is printed (but see also NodePath::any_path(), below).
Definition at line 57 of file nodePath.I.
References Thread::get_pipeline_stage().
NodePath::NodePath | ( | const NodePath & | parent, |
PandaNode * | child_node, | ||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Constructs a NodePath with the indicated parent NodePath and child node; the child node must be a stashed or unstashed child of the parent.
Definition at line 156 of file nodePath.cxx.
References Thread::get_pipeline_stage(), and is_empty().
size_t NodePath::add_hash | ( | size_t | hash | ) | const [inline] |
Adds the NodePath into the running hash.
This is intended to be used by lower-level code that computes a hash for each NodePath. It modifies the hash value passed in by a unique adjustment for each NodePath, and returns the modified hash.
This is similar to the unique integer returned by get_key(), but it is not guaranteed to remain unique beyond the lifetime of this particular NodePath. Once this NodePath destructs, a different NodePath may be created which shares the same hash value.
Definition at line 290 of file nodePath.I.
Referenced by LightAttrib::get_hash_impl(), and ClipPlaneAttrib::get_hash_impl().
void NodePath::adjust_all_priorities | ( | int | adjustment | ) | [inline] |
Adds the indicated adjustment amount (which may be negative) to the priority for all transitions on the referenced node, and for all nodes in the subgraph below.
This can be used to force these nodes not to be overridden by a high-level state change above. If the priority would drop below zero, it is set to zero.
Definition at line 1894 of file nodePath.I.
References is_empty(), and node().
NodePath NodePath::any_path | ( | PandaNode * | node, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline, static] |
Returns a new NodePath that represents any arbitrary path from the root to the indicated node.
This is the same thing that would be returned by NodePath(node), except that no warning is issued if the path is ambiguous.
Definition at line 77 of file nodePath.I.
References Thread::get_pipeline_stage().
Referenced by Character::cull_callback(), CharacterJoint::get_local_transforms(), CharacterJoint::get_net_transforms(), PGItem::get_relative_frame(), ProjectionScreen::recompute(), ProjectionScreen::recompute_if_stale(), BulletSoftBodyNode::transform_changed(), BulletRigidBodyNode::transform_changed(), BulletGhostNode::transform_changed(), BulletCharacterControllerNode::transform_changed(), and Character::update().
void NodePath::apply_texture_colors | ( | ) |
Removes textures from Geoms at this node and below by applying the texture colors to the vertices.
This is primarily useful to simplify a low-LOD model. The texture colors are replaced by flat colors that approximate the original textures.
Only the bottommost texture on each Geom is used (if there is more than one), and it is applied as if it were M_modulate, and WM_repeat, regardless of its actual settings. If the texture has a simple_ram_image, this may be used if the main image isn't resident.
After this call, there will be no texturing specified at this level and below. Of course, there might still be texturing inherited from above.
Definition at line 6881 of file nodePath.cxx.
References SceneGraphReducer::apply_attribs(), is_empty(), and node().
NodePath NodePath::attach_new_node | ( | PandaNode * | node, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Attaches a new node, with or without existing parents, to the scene graph below the referenced node of this NodePath.
This is the preferred way to add nodes to the graph.
If the node was already a child of the parent, this returns a NodePath to the existing child.
This does *not* automatically extend the current NodePath to reflect the attachment; however, a NodePath that does reflect this extension is returned.
Definition at line 883 of file nodePath.cxx.
References fail(), Thread::get_pipeline_stage(), and verify_complete().
Referenced by NonlinearImager::add_viewer(), attach_new_node(), PGEntry::clear_cursor_def(), copy_to(), MouseWatcherGroup::do_show_regions(), ModelFlattenRequest::do_task(), MayaPview::doIt(), PortalNode::enable_clipping_planes(), MultitexReducer::flatten(), GeoMipTerrain::generate(), PGFrameStyle::generate_into(), PandaFramework::get_mouse(), SmoothMover::handle_wrt_reparent(), instance_under_node(), GraphicsOutput::make_cube_map(), PGButton::setup(), PGEntry::setup_minimal(), SceneGraphAnalyzerMeter::setup_window(), FrameRateMeter::setup_window(), and PathFollow::start().
NodePath NodePath::attach_new_node | ( | const string & | name, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) | const [inline] |
Creates an ordinary PandaNode and attaches it below the current NodePath, returning a new NodePath that references it.
Definition at line 440 of file nodePath.I.
References attach_new_node(), fail(), and verify_complete().
bool NodePath::calc_tight_bounds | ( | LPoint3 & | min_point, |
LPoint3 & | max_point, | ||
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Calculates the minimum and maximum vertices of all Geoms at this NodePath's bottom node and below.
This is a tight bounding box; it will generally be tighter than the bounding volume returned by get_bounds() (but it is more expensive to compute).
The return value is true if any points are within the bounding volume, or false if none are.
Definition at line 6706 of file nodePath.cxx.
References is_empty(), and node().
Referenced by TextPropertiesManager::set_graphic(), and PGButton::setup().
void NodePath::clear_antialias | ( | ) |
Completely removes any antialias setting that may have been set on this node via set_antialias().
Definition at line 6216 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_attrib | ( | TypeHandle | type | ) | [inline] |
Removes the render attribute of the given type from this node.
This node, and the subgraph below, will now inherit the indicated render attribute from the nodes above this one.
Definition at line 570 of file nodePath.I.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_audio_volume | ( | ) |
Completely removes any audio volume from the referenced node.
This is preferable to simply setting the audio volume to identity, as it also removes the overhead associated with having an audio volume at all.
Definition at line 6280 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_billboard | ( | ) |
Removes any billboard effect from the node.
Definition at line 6071 of file nodePath.cxx.
References PandaNode::clear_effect(), is_empty(), and node().
void NodePath::clear_bin | ( | ) |
Completely removes any bin adjustment that may have been set via set_bin() from this particular node.
Definition at line 3435 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_clip_plane | ( | ) |
Completely removes any clip planes that may have been set via set_clip_plane() or set_clip_plane_off() from this particular node.
Definition at line 3086 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_clip_plane | ( | const NodePath & | clip_plane | ) |
Removes any reference to the indicated clipping plane from the NodePath.
Definition at line 3098 of file nodePath.cxx.
References PandaNode::clear_attrib(), PandaNode::get_attrib(), RenderState::get_override(), PandaNode::get_state(), is_empty(), TypedObject::is_of_type(), node(), and PandaNode::set_attrib().
void NodePath::clear_color | ( | ) |
Completely removes any color adjustment from the node.
This allows the natural color of the geometry, or whatever color transitions might be otherwise affecting the geometry, to show instead.
Definition at line 2474 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_color_scale | ( | ) |
Completely removes any color scale from the referenced node.
This is preferable to simply setting the color scale to identity, as it also removes the overhead associated with having a color scale at all.
Definition at line 2539 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_compass | ( | ) |
Removes any compass effect from the node.
Definition at line 6108 of file nodePath.cxx.
References PandaNode::clear_effect(), is_empty(), and node().
void NodePath::clear_depth_offset | ( | ) |
Completely removes any depth-offset adjustment that may have been set on this node via set_depth_offset().
Definition at line 5879 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_depth_test | ( | ) |
Completely removes any depth-test adjustment that may have been set on this node via set_depth_test().
Definition at line 5738 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_depth_write | ( | ) |
Completely removes any depth-write adjustment that may have been set on this node via set_depth_write().
Definition at line 5808 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_effect | ( | TypeHandle | type | ) | [inline] |
Removes the render effect of the given type from this node.
Definition at line 620 of file nodePath.I.
References PandaNode::clear_effect(), is_empty(), and node().
Referenced by clear_scissor().
void NodePath::clear_effects | ( | ) | [inline] |
Resets this node to have no render effects.
Definition at line 657 of file nodePath.I.
References PandaNode::clear_effects(), is_empty(), and node().
void NodePath::clear_fog | ( | ) |
Completely removes any fog adjustment that may have been set via set_fog() or set_fog_off() from this particular node.
This allows whatever fogs might be otherwise affecting the geometry to show instead.
Definition at line 5384 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_light | ( | const NodePath & | light | ) |
Removes any reference to the indicated Light or PolylightNode from the NodePath.
Definition at line 2859 of file nodePath.cxx.
References PandaNode::as_light(), PandaNode::clear_attrib(), PandaNode::get_attrib(), PandaNode::get_effect(), RenderState::get_override(), PandaNode::get_state(), is_empty(), TypedObject::is_of_type(), node(), PandaNode::set_attrib(), and PandaNode::set_effect().
void NodePath::clear_light | ( | ) |
Completely removes any lighting operations that may have been set via set_light() or set_light_off() from this particular node.
Definition at line 2846 of file nodePath.cxx.
References PandaNode::clear_attrib(), PandaNode::clear_effect(), is_empty(), and node().
void NodePath::clear_mat | ( | ) | [inline] |
Completely removes any transform from the referenced node.
Definition at line 900 of file nodePath.I.
References PandaNode::clear_transform(), is_empty(), and node().
void NodePath::clear_material | ( | ) |
Completely removes any material adjustment that may have been set via set_material() from this particular node.
Definition at line 5297 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
int NodePath::clear_model_nodes | ( | ) | [inline] |
Recursively walks through the scene graph at this level and below, looking for ModelNodes, and calls model_node->set_preserve_transform(PT_drop_node) on each one.
This allows a subsequent call to flatten_strong() to eliminate all of the ModelNodes.
Returns the number of ModelNodes found.
Definition at line 2142 of file nodePath.I.
References is_empty(), and node().
void NodePath::clear_normal_map | ( | ) |
Undoes the effect of a previous call to set_normal_map().
Definition at line 4871 of file nodePath.cxx.
References clear_tex_gen(), clear_texture(), RenderState::get_attrib(), TextureStage::get_name(), TextureAttrib::get_num_on_stages(), TextureAttrib::get_on_stage(), and get_state().
Referenced by set_normal_map().
void NodePath::clear_occluder | ( | ) |
Completely removes any occluders that may have been set via set_occluder() from this particular node.
Definition at line 3232 of file nodePath.cxx.
References PandaNode::clear_effect(), is_empty(), and node().
void NodePath::clear_occluder | ( | const NodePath & | occluder | ) |
Removes any reference to the indicated occluder from the NodePath.
Definition at line 3244 of file nodePath.cxx.
References PandaNode::clear_effect(), PandaNode::get_effect(), is_empty(), TypedObject::is_of_type(), node(), and PandaNode::set_effect().
void NodePath::clear_project_texture | ( | TextureStage * | stage | ) | [inline] |
Undoes the effect of project_texture().
Definition at line 1827 of file nodePath.I.
References clear_tex_gen(), clear_tex_projector(), and clear_texture().
void NodePath::clear_render_mode | ( | ) |
Completely removes any render mode adjustment that may have been set on this node via set_render_mode_wireframe() or set_render_mode_filled().
Definition at line 5554 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_scissor | ( | ) |
Removes the scissor region that was defined at this node level by a previous call to set_scissor().
Definition at line 3379 of file nodePath.cxx.
References clear_effect().
void NodePath::clear_tag | ( | const string & | key | ) | [inline] |
Removes the value defined for this key on this particular node.
After a call to clear_tag(), has_tag() will return false for the indicated key.
Definition at line 2210 of file nodePath.I.
References PandaNode::clear_tag(), is_empty(), and node().
void NodePath::clear_tex_gen | ( | ) |
Removes the texture coordinate generation mode from all texture stages on this node.
Definition at line 4560 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
Referenced by clear_normal_map(), and clear_project_texture().
void NodePath::clear_tex_gen | ( | TextureStage * | stage | ) |
Disables automatic texture coordinate generation for the indicated texture stage.
Definition at line 4572 of file nodePath.cxx.
References PandaNode::clear_attrib(), PandaNode::get_attrib(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::clear_tex_projector | ( | ) |
Removes the TexProjectorEffect for all stages from this node.
Definition at line 4716 of file nodePath.cxx.
References PandaNode::clear_effect(), is_empty(), and node().
Referenced by clear_project_texture().
void NodePath::clear_tex_projector | ( | TextureStage * | stage | ) |
Removes the TexProjectorEffect for the indicated stage from this node.
Definition at line 4691 of file nodePath.cxx.
References PandaNode::clear_effect(), PandaNode::get_effect(), is_empty(), node(), and PandaNode::set_effect().
void NodePath::clear_tex_transform | ( | ) |
Removes all texture matrices from the current node.
Definition at line 4332 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_tex_transform | ( | TextureStage * | stage | ) |
Removes the texture matrix on the current node for the given stage.
Definition at line 4344 of file nodePath.cxx.
References PandaNode::clear_attrib(), PandaNode::get_attrib(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::clear_texture | ( | ) |
Completely removes any texture adjustment that may have been set via set_texture() or set_texture_off() from this particular node.
This allows whatever textures might be otherwise affecting the geometry to show instead.
Definition at line 3603 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
Referenced by clear_normal_map(), and clear_project_texture().
void NodePath::clear_texture | ( | TextureStage * | stage | ) |
Removes any reference to the indicated texture stage from the NodePath.
Definition at line 3615 of file nodePath.cxx.
References PandaNode::clear_attrib(), PandaNode::get_attrib(), RenderState::get_override(), PandaNode::get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::clear_transform | ( | Thread * | current_thread = Thread::get_current_thread() | ) | [inline] |
Sets the transform object on this node to identity.
Definition at line 668 of file nodePath.I.
References set_transform().
void NodePath::clear_transform | ( | const NodePath & | other, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline] |
Sets the transform object on this node to identity, relative to the other node.
This effectively places this node at the same position as the other node.
Definition at line 691 of file nodePath.I.
References set_transform().
void NodePath::clear_transparency | ( | ) |
Completely removes any transparency adjustment that may have been set on this node via set_transparency().
The geometry at this level and below will subsequently be rendered either transparent or not, to whatever other nodes may have had set_transparency() on them.
Definition at line 6151 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
void NodePath::clear_two_sided | ( | ) |
Completely removes any two-sided adjustment that may have been set on this node via set_two_sided().
The geometry at this level and below will subsequently be rendered either two-sided or one-sided, according to whatever other nodes may have had set_two_sided() on it, or according to the initial state otherwise.
Definition at line 5666 of file nodePath.cxx.
References PandaNode::clear_attrib(), is_empty(), and node().
int NodePath::compare_to | ( | const NodePath & | other | ) | const [inline] |
Returns a number less than zero if this NodePath sorts before the other one, greater than zero if it sorts after, or zero if they are equivalent.
Two NodePaths are considered equivalent if they consist of exactly the same list of nodes in the same order. Otherwise, they are different; different NodePaths will be ranked in a consistent but undefined ordering; the ordering is useful only for placing the NodePaths in a sorted container like an STL set.
Definition at line 2120 of file nodePath.I.
Referenced by OccluderEffect::compare_to_impl(), LightAttrib::compare_to_impl(), CompassEffect::compare_to_impl(), ClipPlaneAttrib::compare_to_impl(), BillboardEffect::compare_to_impl(), and CollisionHandlerEvent::SortEntries::operator()().
void NodePath::compose_color_scale | ( | const LVecBase4 & | scale, |
int | priority = 0 |
||
) |
multiplies the color scale component of the transform, with previous color scale leaving translation and rotation untouched.
Definition at line 2552 of file nodePath.cxx.
References PandaNode::get_attrib(), ColorScaleAttrib::get_scale(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
Referenced by NodePathCollection::compose_color_scale(), and compose_color_scale().
void NodePath::compose_color_scale | ( | PN_stdfloat | sx, |
PN_stdfloat | sy, | ||
PN_stdfloat | sz, | ||
PN_stdfloat | sa, | ||
int | priority = 0 |
||
) | [inline] |
Sets the color scale component of the transform.
Definition at line 1193 of file nodePath.I.
References compose_color_scale().
NodePath NodePath::copy_to | ( | const NodePath & | other, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Functions like instance_to(), except a deep copy is made of the referenced node and all of its descendents, which is then parented to the indicated node.
A NodePath to the newly created copy is returned.
Definition at line 851 of file nodePath.cxx.
References attach_new_node(), fail(), is_empty(), node(), and verify_complete().
int NodePath::count_num_descendants | ( | ) | const [inline] |
Returns the number of nodes at and below this level.
Definition at line 393 of file nodePath.I.
References is_empty().
NodePath NodePath::decode_from_bam_stream | ( | const string & | data, |
BamReader * | reader = NULL |
||
) | [static] |
Reads the string created by a previous call to encode_to_bam_stream(), and extracts and returns the NodePath on that string.
Returns NULL on error.
Definition at line 7069 of file nodePath.cxx.
References fail(), DatagramInputFile::get_datagram(), DatagramIterator::get_int32(), DatagramIterator::get_uint8(), TypedObject::is_of_type(), node(), NodePath(), DatagramInputFile::open(), DatagramInputFile::read_header(), BamReader::read_object(), BamReader::resolve(), and BamReader::set_source().
void NodePath::detach_node | ( | Thread * | current_thread = Thread::get_current_thread() | ) |
Disconnects the referenced node from its parent, but does not immediately delete it.
The NodePath retains a pointer to the node, and becomes a singleton NodePath.
This should be called to detach a node from the scene graph, with the option of reattaching it later to the same parent or to a different parent.
In practice, the only difference between remove_node() and detach_node() is that remove_node() also resets the NodePath to empty, which will cause the node to be deleted immediately if there are no other references. On the other hand, detach_node() leaves the NodePath referencing the node, which will keep at least one reference to the node for as long as the NodePath exists.
Definition at line 964 of file nodePath.cxx.
References Thread::get_pipeline_stage(), is_empty(), is_singleton(), node(), and PandaNode::reset_prev_transform().
Referenced by PandaFramework::clear_highlight(), NodePathCollection::detach(), and SmoothMover::handle_wrt_reparent().
void NodePath::do_billboard_axis | ( | const NodePath & | camera, |
PN_stdfloat | offset | ||
) |
Performs a billboard-type rotate to the indicated camera node, one time only, and leaves the object rotated.
This is similar in principle to heads_up().
Definition at line 5926 of file nodePath.cxx.
References get_parent(), LMatrix4f::get_row3(), get_transform(), heads_up(), is_empty(), LVecBase3f::normalize(), set_pos(), set_quat(), and LVector3f::up().
void NodePath::do_billboard_point_eye | ( | const NodePath & | camera, |
PN_stdfloat | offset | ||
) |
Performs a billboard-type rotate to the indicated camera node, one time only, and leaves the object rotated.
This is similar in principle to look_at(), although the point_eye billboard effect cannot be achieved using the ordinary look_at() call.
Definition at line 5959 of file nodePath.cxx.
References LVector3f::forward(), get_parent(), LMatrix4f::get_row3(), get_transform(), is_empty(), look_at(), LVecBase3f::normalize(), set_pos(), set_quat(), and LVector3f::up().
void NodePath::do_billboard_point_world | ( | const NodePath & | camera, |
PN_stdfloat | offset | ||
) |
Performs a billboard-type rotate to the indicated camera node, one time only, and leaves the object rotated.
This is similar in principle to look_at().
Definition at line 5990 of file nodePath.cxx.
References get_parent(), LMatrix4f::get_row3(), get_transform(), is_empty(), look_at(), LVecBase3f::normalize(), set_pos(), set_quat(), and LVector3f::up().
bool NodePath::encode_to_bam_stream | ( | string & | data, |
BamWriter * | writer = NULL |
||
) | const |
Converts the NodePath object into a single stream of data using a BamWriter, and stores that data in the indicated string.
Returns true on success, false on failure.
If the BamWriter is NULL, this behaves the same way as NodePath::write_bam_stream() and PandaNode::encode_to_bam_stream(), in the sense that it only writes this node and all nodes below it.
However, if the BamWriter is not NULL, it behaves very differently. In this case, it encodes the entire graph* of all nodes connected to the NodePath, including all parent nodes and siblings. This is necessary for correct streaming of related NodePaths and restoration of instances, etc., but it does mean you must detach() a node before writing it if you want to limit the nodes that get written.
This method is used by __reduce__ to handle streaming of NodePaths to a pickle file. The BamWriter case is used by the direct.stdpy.pickle module, while the saner, non-BamWriter case is used when the standard pickle module calls this function.
Definition at line 7005 of file nodePath.cxx.
References Datagram::add_int32(), Datagram::add_uint8(), get_node(), get_num_nodes(), node(), DatagramOutputFile::open(), DatagramOutputFile::put_datagram(), BamWriter::set_target(), DatagramOutputFile::write_header(), and BamWriter::write_object().
string NodePath::encode_to_bam_stream | ( | ) | const [inline] |
Converts the NodePath object into a single stream of data using a BamWriter, and returns that data as a string string.
Returns empty string on failure. This is similar to write_bam_stream().
This method is used by __reduce__ to handle streaming of NodePaths to a pickle file.
Definition at line 2397 of file nodePath.I.
NodePath NodePath::fail | ( | ) | [inline, static] |
Creates a NodePath with the ET_fail error type set.
Definition at line 145 of file nodePath.I.
Referenced by attach_new_node(), copy_to(), decode_from_bam_stream(), find(), find_path_to(), get_ancestor(), TexProjectorEffect::get_from(), PhysxActor::get_node_path(), WorkingNodePath::get_node_path(), WeakNodePath::get_node_path(), LightAttrib::get_off_light(), ClipPlaneAttrib::get_off_plane(), LightAttrib::get_on_light(), OccluderEffect::get_on_occluder(), ClipPlaneAttrib::get_on_plane(), get_tex_gen_light(), get_tex_projector_from(), get_tex_projector_to(), TexProjectorEffect::get_to(), get_top(), and instance_to().
NodePath NodePath::find | ( | const string & | path | ) | const |
Searches for a node below the referenced node that matches the indicated string.
Returns the shortest match found, if any, or an empty NodePath if no match can be found.
Definition at line 594 of file nodePath.cxx.
References fail(), NodePathCollection::get_path(), NodePathCollection::is_empty(), is_empty(), and not_found().
Referenced by SpeedTreeNode::add_from_stf(), and SpeedTreeNode::InstanceList::fillin().
NodePathCollection NodePath::find_all_matches | ( | const string & | path | ) | const |
Returns the complete set of all NodePaths that begin with this NodePath and can be extended by path.
The shortest paths will be listed first.
Definition at line 640 of file nodePath.cxx.
References is_empty(), and verify_complete().
Referenced by MeshDrawer::geometry(), PhysxTriangleMeshDesc::set_from_node_path(), PhysxConvexMeshDesc::set_from_node_path(), PhysxClothMeshDesc::set_from_node_path(), and unstash_all().
MaterialCollection NodePath::find_all_materials | ( | const string & | name | ) | const |
Returns a list of a materials applied to geometry at this node and below that match the indicated name (which may contain wildcard characters).
Definition at line 5238 of file nodePath.cxx.
References MaterialCollection::add_material(), is_empty(), GlobPattern::matches(), and node().
MaterialCollection NodePath::find_all_materials | ( | ) | const |
Returns a list of a materials applied to geometry at this node and below.
Definition at line 5217 of file nodePath.cxx.
References MaterialCollection::add_material(), is_empty(), and node().
NodePathCollection NodePath::find_all_paths_to | ( | PandaNode * | node | ) | const |
Returns the set of all NodePaths that extend from this NodePath down to the indicated node.
The shortest paths will be listed first.
Definition at line 656 of file nodePath.cxx.
References FindApproxPath::add_match_many(), FindApproxPath::add_match_pointer(), is_empty(), and verify_complete().
InternalNameCollection NodePath::find_all_texcoords | ( | ) | const |
Returns a list of all texture coordinate sets used by any geometry at this node level and below.
Definition at line 4967 of file nodePath.cxx.
References InternalNameCollection::add_name(), is_empty(), and node().
InternalNameCollection NodePath::find_all_texcoords | ( | const string & | name | ) | const |
Returns a list of all texture coordinate sets used by any geometry at this node level and below that match the indicated name (which may contain wildcard characters).
Definition at line 4993 of file nodePath.cxx.
References InternalNameCollection::add_name(), InternalName::find_ancestor(), InternalName::get_net_basename(), InternalName::get_top(), is_empty(), GlobPattern::matches(), and node().
TextureStageCollection NodePath::find_all_texture_stages | ( | const string & | name | ) | const |
Returns a list of a TextureStages applied to geometry at this node and below that match the indicated name (which may contain wildcard characters).
Definition at line 5177 of file nodePath.cxx.
References TextureStageCollection::add_texture_stage(), TextureStage::get_name(), is_empty(), GlobPattern::matches(), and node().
TextureStageCollection NodePath::find_all_texture_stages | ( | ) | const |
Returns a list of a TextureStages applied to geometry at this node and below.
Definition at line 5140 of file nodePath.cxx.
References TextureStageCollection::add_texture_stage(), is_empty(), and node().
TextureCollection NodePath::find_all_textures | ( | ) | const |
Returns a list of a textures applied to geometry at this node and below.
Definition at line 5056 of file nodePath.cxx.
References TextureCollection::add_texture(), is_empty(), and node().
Referenced by StaticTextFont::StaticTextFont().
TextureCollection NodePath::find_all_textures | ( | const string & | name | ) | const |
Returns a list of a textures applied to geometry at this node and below that match the indicated name (which may contain wildcard characters).
Definition at line 5077 of file nodePath.cxx.
References TextureCollection::add_texture(), is_empty(), GlobPattern::matches(), and node().
TextureCollection NodePath::find_all_textures | ( | TextureStage * | stage | ) | const |
Returns a list of a textures on geometry at this node and below that are assigned to the indicated texture stage.
Definition at line 5103 of file nodePath.cxx.
References TextureCollection::add_texture(), is_empty(), and node().
InternalNameCollection NodePath::find_all_vertex_columns | ( | ) | const |
Returns a list of all vertex array columns stored on some geometry found at this node level and below.
Definition at line 4920 of file nodePath.cxx.
References InternalNameCollection::add_name(), is_empty(), and node().
InternalNameCollection NodePath::find_all_vertex_columns | ( | const string & | name | ) | const |
Returns a list of all vertex array columns stored on some geometry found at this node level and below that match the indicated name (which may contain wildcard characters).
Definition at line 4942 of file nodePath.cxx.
References InternalNameCollection::add_name(), InternalName::get_name(), is_empty(), GlobPattern::matches(), and node().
Material * NodePath::find_material | ( | const string & | name | ) | const |
Returns the first material found applied to geometry at this node or below that matches the indicated name (which may contain wildcards).
Returns the material if it is found, or NULL if it is not.
Definition at line 5204 of file nodePath.cxx.
References is_empty(), and node().
NodePath NodePath::find_net_tag | ( | const string & | key | ) | const |
Returns the lowest ancestor of this node that contains a tag definition with the indicated key, if any, or an empty NodePath if no ancestor of this node contains this tag definition.
See set_tag().
Definition at line 6896 of file nodePath.cxx.
References find_net_tag(), get_parent(), has_tag(), is_empty(), and not_found().
Referenced by find_net_tag(), get_net_tag(), and has_net_tag().
Searches for the indicated node below this node and returns the shortest NodePath that connects them.
Definition at line 614 of file nodePath.cxx.
References FindApproxPath::add_match_many(), FindApproxPath::add_match_pointer(), fail(), NodePathCollection::get_path(), NodePathCollection::is_empty(), is_empty(), and not_found().
Referenced by PGItem::get_relative_frame().
Texture * NodePath::find_texture | ( | const string & | name | ) | const |
Returns the first texture found applied to geometry at this node or below that matches the indicated name (which may contain wildcards).
Returns the texture if it is found, or NULL if it is not.
Definition at line 5029 of file nodePath.cxx.
References is_empty(), and node().
Texture * NodePath::find_texture | ( | TextureStage * | stage | ) | const |
Returns the first texture found applied to geometry at this node or below that is assigned to the indicated texture stage.
Returns the texture if it is found, or NULL if it is not.
Definition at line 5044 of file nodePath.cxx.
References is_empty(), and node().
TextureStage * NodePath::find_texture_stage | ( | const string & | name | ) | const |
Returns the first TextureStage found applied to geometry at this node or below that matches the indicated name (which may contain wildcards).
Returns the TextureStage if it is found, or NULL if it is not.
Definition at line 5127 of file nodePath.cxx.
References is_empty(), and node().
*int NodePath::flatten_light | ( | ) |
Lightly flattens out the hierarchy below this node by applying transforms, colors, and texture matrices from the nodes onto the vertices, but does not remove any nodes.
This can result in improved rendering performance because there will be fewer transforms in the resulting scene graph, but the number of nodes will remain the same.
In particular, any NodePaths that reference nodes within this hierarchy will not be damaged. However, since this operation will remove transforms from the scene graph, it may be dangerous to apply to nodes where you expect to dynamically modify the transform, or where you expect the geometry to remain in a particular local coordinate system.
The return value is always 0, since flatten_light does not remove any nodes.
Definition at line 6787 of file nodePath.cxx.
References SceneGraphReducer::apply_attribs(), is_empty(), and node().
int NodePath::flatten_medium | ( | ) |
A more thorough flattening than flatten_light(), this first applies all the transforms, colors, and texture matrices from the nodes onto the vertices, and then removes unneeded grouping nodes--nodes that have exactly one child, for instance, but have no special properties in themselves.
This results in improved performance over flatten_light() because the number of nodes in the scene graph is reduced.
The return value is the number of nodes removed.
Definition at line 6812 of file nodePath.cxx.
References SceneGraphReducer::apply_attribs(), SceneGraphReducer::collect_vertex_data(), SceneGraphReducer::flatten(), is_empty(), SceneGraphReducer::make_compatible_state(), node(), and SceneGraphReducer::unify().
int NodePath::flatten_strong | ( | ) |
The strongest possible flattening.
This first applies all of the transforms to the vertices, as in flatten_medium(), but then it will combine sibling nodes together when possible, in addition to removing unnecessary parent-child nodes. This can result in substantially fewer nodes, but any nicely-grouped hierachical bounding volumes may be lost.
It is generally a good idea to apply this kind of flattening only to nodes that will be culled largely as a single unit, like a car. Applying this to an entire scene may result in overall poorer performance because of less-effective culling.
Definition at line 6845 of file nodePath.cxx.
References SceneGraphReducer::apply_attribs(), SceneGraphReducer::collect_vertex_data(), SceneGraphReducer::flatten(), is_empty(), SceneGraphReducer::make_compatible_state(), node(), and SceneGraphReducer::unify().
Referenced by ModelFlattenRequest::do_task().
void NodePath::force_recompute_bounds | ( | ) |
Forces the recomputing of all the bounding volumes at every node in the subgraph beginning at this node and below.
This should not normally need to be called, since the bounding volumes are supposed to be recomputed automatically when necessary. It may be useful when debugging, to verify that the bounding volumes have not become inadvertently stale; it may also be useful to force animated characters to update their bounding volumes (which does not presently happen automatically).
Definition at line 6676 of file nodePath.cxx.
References is_empty(), and node().
NodePath NodePath::get_ancestor | ( | int | index, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Returns the nth ancestor of the path, where 0 is the NodePath itself and get_num_nodes() - 1 is get_top().
This requires iterating through the path.
Also see get_node(), which returns the same thing as a PandaNode pointer, not a NodePath.
Definition at line 447 of file nodePath.cxx.
References fail(), NodePathComponent::get_next(), get_num_nodes(), and Thread::get_pipeline_stage().
unsigned short NodePath::get_antialias | ( | ) | const |
Returns the antialias setting that has been specifically set on this node via set_antialias(), or M_none if no setting has been made.
Definition at line 6244 of file nodePath.cxx.
References PandaNode::get_attrib(), AntialiasAttrib::get_mode(), is_empty(), and node().
const RenderAttrib * NodePath::get_attrib | ( | TypeHandle | type | ) | const [inline] |
Returns the render attribute of the indicated type, if it is defined on the node, or NULL if it is not.
This checks only what is set on this particular node level, and has nothing to do with what render attributes may be inherited from parent nodes.
Definition at line 543 of file nodePath.I.
References PandaNode::get_attrib(), is_empty(), and node().
PN_stdfloat NodePath::get_audio_volume | ( | ) | const |
Returns the complete audio volume that has been applied to this node via a previous call to set_audio_volume(), or 1.
(identity) if no volume has been applied to this particular node.
Definition at line 6340 of file nodePath.cxx.
References PandaNode::get_attrib(), AudioVolumeAttrib::get_volume(), and node().
int NodePath::get_bin_draw_order | ( | ) | const |
Returns the drawing order associated with the bin that this particular node was assigned to via set_bin(), or 0 if no bin was assigned.
Definition at line 3482 of file nodePath.cxx.
References PandaNode::get_attrib(), CullBinAttrib::get_draw_order(), is_empty(), and node().
string NodePath::get_bin_name | ( | ) | const |
Returns the name of the bin that this particular node was assigned to via set_bin(), or the empty string if no bin was assigned.
Definition at line 3461 of file nodePath.cxx.
References PandaNode::get_attrib(), CullBinAttrib::get_bin_name(), is_empty(), and node().
NodePath NodePath::get_child | ( | int | n, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const [inline] |
Returns a NodePath representing the nth child of the referenced node.
Definition at line 378 of file nodePath.I.
References get_num_children(), Thread::get_pipeline_stage(), and NodePath().
Referenced by ModelFlattenRequest::do_task(), PandaFramework::event_arrow_down(), PandaFramework::hide_collision_solids(), EggLoader::reparent_decals(), and PandaFramework::show_collision_solids().
NodePathCollection NodePath::get_children | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the set of all child nodes of the referenced node.
Definition at line 503 of file nodePath.cxx.
References NodePathCollection::add_path(), PandaNode::Children::get_child(), PandaNode::get_children(), PandaNode::Children::get_num_children(), Thread::get_pipeline_stage(), is_empty(), and node().
Referenced by PandaFramework::clear_highlight().
CollideMask NodePath::get_collide_mask | ( | ) | const [inline] |
Returns the union of all of the into_collide_masks for nodes at this level and below.
This is the same thing as node()->get_net_collide_mask().
If you want to return what the into_collide_mask of this node itself is, without regard to its children, use node()->get_into_collide_mask().
Definition at line 2036 of file nodePath.I.
References BitMask< WType, nbits >::all_off(), PandaNode::get_net_collide_mask(), is_empty(), and node().
Referenced by NodePathCollection::get_collide_mask().
LColor NodePath::get_color | ( | ) | const |
Returns the color that has been assigned to the node, or black if no color has been assigned.
Definition at line 2498 of file nodePath.cxx.
References PandaNode::get_attrib(), ColorAttrib::get_color(), ColorAttrib::get_color_type(), is_empty(), and node().
const LVecBase4 & NodePath::get_color_scale | ( | ) | const |
Returns the complete color scale vector that has been applied to this node via a previous call to set_color_scale() and/or set_alpha_scale(), or all 1's (identity) if no scale has been applied to this particular node.
Definition at line 2696 of file nodePath.cxx.
References PandaNode::get_attrib(), ColorScaleAttrib::get_scale(), is_empty(), and node().
Referenced by get_sa(), get_sb(), get_sg(), get_sr(), set_sa(), set_sb(), set_sg(), and set_sr().
NodePath NodePath::get_common_ancestor | ( | const NodePath & | other, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const [inline] |
Returns the lowest NodePath that both of these two NodePaths have in common: the first ancestor that both of them share.
If the two NodePaths are unrelated, returns NodePath::not_found().
Definition at line 348 of file nodePath.I.
References not_found().
int NodePath::get_depth_offset | ( | ) | const |
Returns the depth offset value if it has been specified using set_depth_offset, or 0 if not.
Definition at line 5906 of file nodePath.cxx.
References PandaNode::get_attrib(), DepthOffsetAttrib::get_offset(), is_empty(), and node().
bool NodePath::get_depth_test | ( | ) | const |
Returns true if depth-test rendering has been specifically set on this node via set_depth_test(), or false if depth-test rendering has been specifically disabled.
If nothing has been specifically set, returns true. See also has_depth_test().
Definition at line 5768 of file nodePath.cxx.
References PandaNode::get_attrib(), DepthTestAttrib::get_mode(), is_empty(), and node().
bool NodePath::get_depth_write | ( | ) | const |
Returns true if depth-write rendering has been specifically set on this node via set_depth_write(), or false if depth-write rendering has been specifically disabled.
If nothing has been specifically set, returns true. See also has_depth_write().
Definition at line 5838 of file nodePath.cxx.
References PandaNode::get_attrib(), DepthWriteAttrib::get_mode(), is_empty(), and node().
PN_stdfloat NodePath::get_distance | ( | const NodePath & | other | ) | const [inline] |
Returns the straight-line distance between this referenced node's coordinate frame's origin, and that of the other node's origin.
Definition at line 1172 of file nodePath.I.
References get_pos().
const RenderEffect * NodePath::get_effect | ( | TypeHandle | type | ) | const [inline] |
Returns the render effect of the indicated type, if it is defined on the node, or NULL if it is not.
Definition at line 595 of file nodePath.I.
References PandaNode::get_effect(), is_empty(), and node().
const RenderEffects * NodePath::get_effects | ( | ) | const [inline] |
Returns the complete RenderEffects that will be applied to this node.
Definition at line 646 of file nodePath.I.
References PandaNode::get_effects(), is_empty(), and node().
NodePath::ErrorType NodePath::get_error_type | ( | ) | const [inline] |
If is_empty() is true, this returns a code that represents the reason why the NodePath is empty.
Definition at line 219 of file nodePath.I.
Referenced by MeshDrawer::begin(), MeshDrawer::geometry(), and MeshDrawer::link_segment().
Fog * NodePath::get_fog | ( | ) | const |
Returns the fog that has been set on this particular node, or NULL if no fog has been set.
This is not necessarily the fog that will be applied to the geometry at or below this level, as another fog at a higher or lower level may override.
Definition at line 5446 of file nodePath.cxx.
References PandaNode::get_attrib(), FogAttrib::get_fog(), is_empty(), and node().
NodePath NodePath::get_hidden_ancestor | ( | DrawMask | camera_mask = PandaNode::get_overall_bit() , |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Returns the NodePath at or above the referenced node that is hidden to the indicated camera(s), or an empty NodePath if no ancestor of the referenced node is hidden (and the node should be visible).
Definition at line 6380 of file nodePath.cxx.
References PandaNode::get_draw_control_mask(), PandaNode::get_draw_show_mask(), NodePathComponent::get_next(), NodePathComponent::get_node(), Thread::get_pipeline_stage(), PandaNode::is_overall_hidden(), node(), and not_found().
Referenced by is_hidden(), and PandaFramework::show_collision_solids().
Returns the relative orientation of the bottom node as seen from the other node.
Definition at line 1932 of file nodePath.cxx.
References get_transform(), and is_empty().
LVecBase3 NodePath::get_hpr | ( | ) | const |
Retrieves the rotation component of the transform.
Definition at line 1413 of file nodePath.cxx.
References get_transform(), and is_empty().
Referenced by CDistributedSmoothNodeBase::broadcast_pos_hpr_full(), CDistributedSmoothNodeBase::broadcast_pos_hpr_xyh(), SmoothMover::handle_wrt_reparent(), and CDistributedSmoothNodeBase::initialize().
const int NodePath::get_instance_count | ( | ) | const |
Returns the geometry instance count, or 0 if disabled.
See set_instance_count.
Definition at line 3924 of file nodePath.cxx.
References PandaNode::get_attrib(), ShaderAttrib::get_instance_count(), is_empty(), and node().
int NodePath::get_key | ( | ) | const [inline] |
Returns an integer that is guaranteed to be the same for all NodePaths that represent the same node instance, and different for all NodePaths that represent a different node instance.
The same key will be returned for a particular instance as long as at least one NodePath exists that represents that instance; if all NodePaths for a particular instance destruct and a new one is later created, it may have a different index. However, a given key will never be reused for a different instance (unless the app has been running long enough that we overflow the integer key value).
Definition at line 267 of file nodePath.I.
References is_empty().
Referenced by remove_node().
const LMatrix4 & NodePath::get_mat | ( | ) | const [inline] |
Returns the transform matrix that has been applied to the referenced node, or the identity matrix if no matrix has been applied.
Definition at line 925 of file nodePath.I.
References TransformState::get_mat(), PandaNode::get_transform(), LMatrix4f::ident_mat(), is_empty(), and node().
Referenced by PGItem::activate_region(), GraphicsStateGuardian::fetch_specified_part(), PGItem::get_relative_frame(), NurbsSurfaceEvaluator::get_vertex(), and PGEntry::xform().
Returns the matrix that describes the coordinate space of the bottom node, relative to the other path's bottom node's coordinate space.
Definition at line 2326 of file nodePath.cxx.
References get_transform().
int NodePath::get_max_search_depth | ( | ) | [inline, static] |
Returns the current setting of the search depth limit.
See set_max_search_depth.
Definition at line 186 of file nodePath.I.
string NodePath::get_name | ( | ) | const [inline] |
Returns the name of the referenced node.
Definition at line 2380 of file nodePath.I.
References is_empty(), and node().
Referenced by PortalNode::cull_callback(), CConstrainTransformInterval::priv_step(), CConstrainPosInterval::priv_step(), CConstrainPosHprInterval::priv_step(), and CConstrainHprInterval::priv_step().
PN_stdfloat NodePath::get_net_audio_volume | ( | ) | const |
Returns the complete audio volume for this node taking highers nodes in the graph into account.
Definition at line 6358 of file nodePath.cxx.
References AudioVolumeAttrib::get_volume().
string NodePath::get_net_tag | ( | const string & | key | ) | const [inline] |
Returns the tag value that has been defined on this node, or the nearest ancestor node, for the indicated key.
If no value has been defined for the indicated key on any ancestor node, returns the empty string. See also get_tag().
Definition at line 2225 of file nodePath.I.
References find_net_tag(), and get_tag().
Referenced by CollisionHandlerEvent::throw_event_pattern().
PandaNode * NodePath::get_node | ( | int | index, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Returns the nth node of the path, where 0 is the referenced (bottom) node and get_num_nodes() - 1 is the top node.
This requires iterating through the path.
Also see node(), which is a convenience function to return the same thing as get_node(0) (since the bottom node is the most important node in the NodePath, and is the one most frequently referenced).
Note that this function returns the same thing as get_ancestor(index).node().
Definition at line 416 of file nodePath.cxx.
References NodePathComponent::get_next(), NodePathComponent::get_node(), get_num_nodes(), and Thread::get_pipeline_stage().
Referenced by encode_to_bam_stream(), and WorkingNodePath::get_node().
int NodePath::get_num_children | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const [inline] |
Returns the number of children of the referenced node.
Definition at line 366 of file nodePath.I.
References is_empty().
Referenced by PandaFramework::event_arrow_down(), get_child(), PandaFramework::hide_collision_solids(), EggLoader::reparent_decals(), and PandaFramework::show_collision_solids().
int NodePath::get_num_nodes | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the number of nodes in the path.
Definition at line 391 of file nodePath.cxx.
References Thread::get_pipeline_stage(), and is_empty().
Referenced by encode_to_bam_stream(), get_ancestor(), and get_node().
NodePath NodePath::get_parent | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const [inline] |
Returns the NodePath to the parent of the referenced node: that is, this NodePath, shortened by one node.
The parent of a singleton NodePath is defined to be the empty NodePath.
Definition at line 420 of file nodePath.I.
References Thread::get_pipeline_stage(), has_parent(), and NodePath().
Referenced by SpeedTreeNode::cull_callback(), do_billboard_axis(), do_billboard_point_eye(), do_billboard_point_world(), GraphicsEngine::do_cull(), PandaFramework::event_arrow_left(), PandaFramework::event_arrow_right(), PandaFramework::event_arrow_up(), find_net_tag(), heads_up(), look_at(), BaseIntegrator::precompute_angular_matrices(), BaseIntegrator::precompute_linear_matrices(), premunge_scene(), CollisionLevelStateBase::prepare_collider(), CConstrainTransformInterval::priv_step(), reverse_ls(), MultitexReducer::scan(), PandaFramework::set_highlight(), PipeOcclusionCullTraverser::set_scene(), set_tex_transform(), and set_transform().
Returns the relative position of the referenced node as seen from the other node.
Definition at line 1839 of file nodePath.cxx.
References TransformState::get_pos(), get_transform(), and is_empty().
LPoint3 NodePath::get_pos | ( | ) | const |
Retrieves the translation component of the transform.
Definition at line 1338 of file nodePath.cxx.
References TransformState::get_pos(), get_transform(), and is_empty().
Referenced by PathFind::add_obstacle_to_mesh(), Arrival::arrival_activate(), MeshDrawer::begin(), CDistributedSmoothNodeBase::broadcast_pos_hpr_full(), CDistributedSmoothNodeBase::broadcast_pos_hpr_xy(), CDistributedSmoothNodeBase::broadcast_pos_hpr_xyh(), PathFollow::check_if_possible(), Arrival::do_arrival(), Evade::do_evade(), Flee::do_flee(), AIBehaviors::do_flock(), PathFollow::do_follow(), ObstacleAvoidance::do_obstacle_avoidance(), Pursue::do_pursue(), Seek::do_seek(), Wander::do_wander(), Evade::evade_activate(), Flee::flee_activate(), get_distance(), CollisionHandlerFluidPusher::handle_entries(), SmoothMover::handle_wrt_reparent(), heads_up(), CDistributedSmoothNodeBase::initialize(), look_at(), ObstacleAvoidance::obstacle_detection(), PathFind::path_find(), CConstrainPosInterval::priv_step(), CConstrainPosHprInterval::priv_step(), set_fluid_pos(), set_pos(), and AICharacter::update().
Returns the delta vector from this node's position in the previous frame (according to set_prev_transform(), typically set via the use of set_fluid_pos()) and its position in the current frame, as seen in the indicated node's coordinate space.
This is the vector used to determine collisions. Generally, if the node was last repositioned via set_pos(), the delta will be zero; if it was adjusted via set_fluid_pos(), the delta will represent the change from the previous frame's position.
Definition at line 1860 of file nodePath.cxx.
References TransformState::get_pos(), get_prev_transform(), get_transform(), and is_empty().
LVector3 NodePath::get_pos_delta | ( | ) | const |
Returns the delta vector from this node's position in the previous frame (according to set_prev_transform(), typically set via the use of set_fluid_pos()) and its position in the current frame.
This is the vector used to determine collisions. Generally, if the node was last repositioned via set_pos(), the delta will be zero; if it was adjusted via set_fluid_pos(), the delta will represent the change from the previous frame's position.
Definition at line 1358 of file nodePath.cxx.
References TransformState::get_pos(), get_prev_transform(), get_transform(), and is_empty().
Referenced by CollisionHandlerFluidPusher::handle_entries(), and CollisionLevelStateBase::prepare_collider().
const TransformState * NodePath::get_prev_transform | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the transform that has been set as this node's "previous" position.
See set_prev_transform().
Definition at line 1179 of file nodePath.cxx.
References PandaNode::get_prev_transform(), is_empty(), and node().
Referenced by get_pos_delta(), CollisionHandlerFluidPusher::handle_entries(), CLerpNodePathInterval::priv_step(), and wrt_reparent_to().
LQuaternion NodePath::get_quat | ( | const NodePath & | other | ) | const |
Returns the relative orientation of the bottom node as seen from the other node.
Definition at line 1981 of file nodePath.cxx.
References get_transform(), LQuaternionf::ident_quat(), and is_empty().
LQuaternion NodePath::get_quat | ( | ) | const |
Retrieves the rotation component of the transform.
Definition at line 1439 of file nodePath.cxx.
References get_transform(), LQuaternionf::ident_quat(), and is_empty().
Referenced by CConstrainPosHprInterval::priv_step(), and CConstrainHprInterval::priv_step().
Given that the indicated point is in the coordinate system of the other node, returns the same point in this node's coordinate system.
Definition at line 2358 of file nodePath.cxx.
References get_transform().
Referenced by MeshDrawer::geometry(), and MeshDrawer::link_segment().
Given that the indicated vector is in the coordinate system of the other node, returns the same vector in this node's coordinate system.
Definition at line 2372 of file nodePath.cxx.
References get_transform().
Referenced by MeshDrawer::begin(), ObstacleAvoidance::do_obstacle_avoidance(), Wander::do_wander(), and ObstacleAvoidance::obstacle_detection().
RenderModeAttrib::Mode NodePath::get_render_mode | ( | ) | const |
Returns the render mode that has been specifically set on this node via set_render_mode(), or M_unchanged if nothing has been set.
Definition at line 5581 of file nodePath.cxx.
References PandaNode::get_attrib(), RenderModeAttrib::get_mode(), is_empty(), and node().
Referenced by set_render_mode_perspective(), and set_render_mode_thickness().
bool NodePath::get_render_mode_perspective | ( | ) | const |
Returns the flag that has been set on this node via set_render_mode_perspective(), or false if no flag has been set.
Definition at line 5621 of file nodePath.cxx.
References PandaNode::get_attrib(), RenderModeAttrib::get_perspective(), is_empty(), and node().
Referenced by set_render_mode_filled(), set_render_mode_thickness(), and set_render_mode_wireframe().
PN_stdfloat NodePath::get_render_mode_thickness | ( | ) | const |
Returns the render mode thickness that has been specifically set on this node via set_render_mode(), or 1.0 if nothing has been set.
Definition at line 5601 of file nodePath.cxx.
References PandaNode::get_attrib(), RenderModeAttrib::get_thickness(), is_empty(), and node().
Referenced by set_render_mode_filled(), set_render_mode_perspective(), and set_render_mode_wireframe().
PN_stdfloat NodePath::get_sa | ( | ) | const [inline] |
Gets the alpha scale component of the transform.
Definition at line 1285 of file nodePath.I.
References get_color_scale().
PN_stdfloat NodePath::get_sb | ( | ) | const [inline] |
Gets the blue scale component of the transform.
Definition at line 1275 of file nodePath.I.
References get_color_scale().
Returns the relative scale of the bottom node as seen from the other node.
Definition at line 2053 of file nodePath.cxx.
References get_transform(), and is_empty().
LVecBase3 NodePath::get_scale | ( | ) | const |
Retrieves the scale component of the transform.
Definition at line 1491 of file nodePath.cxx.
References get_transform(), and is_empty().
Referenced by get_sx().
PN_stdfloat NodePath::get_sg | ( | ) | const [inline] |
Gets the green scale component of the transform.
Definition at line 1265 of file nodePath.I.
References get_color_scale().
Returns the relative shear of the bottom node as seen from the other node.
Definition at line 2125 of file nodePath.cxx.
References get_transform(), and is_empty().
LVecBase3 NodePath::get_shear | ( | ) | const |
Retrieves the shear component of the transform.
Definition at line 1543 of file nodePath.cxx.
References get_transform(), and is_empty().
Referenced by get_shxy().
PN_stdfloat NodePath::get_shxy | ( | const NodePath & | other | ) | const [inline] |
Returns the relative shear of the referenced node as seen from the other node.
Definition at line 1083 of file nodePath.I.
References get_shear().
int NodePath::get_sort | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the sort value of the referenced node within its parent; that is, the sort number passed on the last reparenting operation for this node.
This will control the position of the node within its parent's list of children.
Definition at line 561 of file nodePath.cxx.
References PandaNode::find_child(), PandaNode::find_stashed(), PandaNode::get_child_sort(), Thread::get_pipeline_stage(), PandaNode::get_stashed_sort(), has_parent(), and node().
PN_stdfloat NodePath::get_sr | ( | ) | const [inline] |
Gets the red scale component of the transform.
Definition at line 1255 of file nodePath.I.
References get_color_scale().
NodePath NodePath::get_stashed_ancestor | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the NodePath at or above the referenced node that is stashed, or an empty NodePath if no ancestor of the referenced node is stashed (and the node should be visible).
Definition at line 6467 of file nodePath.cxx.
References PandaNode::find_stashed(), NodePathComponent::get_next(), NodePathComponent::get_node(), Thread::get_pipeline_stage(), node(), and not_found().
Referenced by is_stashed().
NodePathCollection NodePath::get_stashed_children | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the set of all child nodes of the referenced node that have been stashed.
These children are not normally visible on the node, and do not appear in the list returned by get_children().
Definition at line 532 of file nodePath.cxx.
References NodePathCollection::add_path(), PandaNode::get_num_stashed(), Thread::get_pipeline_stage(), PandaNode::get_stashed(), is_empty(), and node().
const RenderState * NodePath::get_state | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the complete state object set on this node.
Definition at line 1008 of file nodePath.cxx.
References PandaNode::get_state(), is_empty(), and node().
Referenced by clear_normal_map(), NodePathCollection::compose_color_scale(), compose_color_scale(), CLerpNodePathInterval::priv_step(), MultitexReducer::scan(), set_all_color_scale(), set_alpha_scale(), NodePathCollection::set_attrib(), set_audio_volume(), set_clip_plane(), set_clip_plane_off(), NodePathCollection::set_color_scale(), set_color_scale(), set_light(), set_light_off(), set_shader_auto(), set_tex_gen(), set_tex_transform(), NodePathCollection::set_texture(), and NodePathCollection::set_texture_off().
PN_stdfloat NodePath::get_sx | ( | const NodePath & | other | ) | const [inline] |
Returns the relative scale of the referenced node as seen from the other node.
Definition at line 1051 of file nodePath.I.
References get_scale().
string NodePath::get_tag | ( | const string & | key | ) | const [inline] |
Retrieves the user-defined value that was previously set on this node for the particular key, if any.
If no value has been previously set, returns the empty string. See also get_net_tag().
Definition at line 2175 of file nodePath.I.
References PandaNode::get_tag(), is_empty(), and node().
Referenced by get_net_tag().
RenderAttrib::TexGenMode NodePath::get_tex_gen | ( | TextureStage * | stage | ) | const |
Returns the texture coordinate generation mode for the given stage, or M_off if there is no explicit mode set for the given stage.
Definition at line 4619 of file nodePath.cxx.
References PandaNode::get_attrib(), TexGenAttrib::get_mode(), is_empty(), and node().
NodePath NodePath::get_tex_gen_light | ( | TextureStage * | stage | ) | const |
Returns the particular Light set for the indicated texgen mode's texture stage, or empty NodePath if no light is set.
This is only meaningful if the texgen mode (returned by get_tex_gen()) is M_light_vector.
Definition at line 4641 of file nodePath.cxx.
References fail(), PandaNode::get_attrib(), TexGenAttrib::get_light(), is_empty(), node(), and NodePath().
LVecBase3 NodePath::get_tex_hpr | ( | TextureStage * | stage | ) | const [inline] |
Returns the 3-D HPR set for the UVW's for the given stage on the current node.
This call is appropriate for 3-d texture coordinates.
Definition at line 1536 of file nodePath.I.
References is_empty(), and LVecBase3f::zero().
LVecBase3 NodePath::get_tex_hpr | ( | const NodePath & | other, |
TextureStage * | stage | ||
) | const [inline] |
Returns the 3-D HPR set for the UVW's for the given stage on the current node.
This call is appropriate for 3-d texture coordinates.
Definition at line 1802 of file nodePath.I.
References is_empty(), and LVecBase3f::zero().
LVecBase2 NodePath::get_tex_offset | ( | TextureStage * | stage | ) | const [inline] |
Returns the offset set for the UV's for the given stage on the current node.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1392 of file nodePath.I.
References is_empty(), and LVecBase2f::zero().
LVecBase2 NodePath::get_tex_offset | ( | const NodePath & | other, |
TextureStage * | stage | ||
) | const [inline] |
Returns the offset set for the UV's for the given stage on the current node.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1658 of file nodePath.I.
References is_empty(), and LVecBase2f::zero().
LVecBase3 NodePath::get_tex_pos | ( | TextureStage * | stage | ) | const [inline] |
Returns the offset set for the UVW's for the given stage on the current node.
This call is appropriate for 3-d texture coordinates.
Definition at line 1522 of file nodePath.I.
References is_empty(), and LVecBase3f::zero().
LVecBase3 NodePath::get_tex_pos | ( | const NodePath & | other, |
TextureStage * | stage | ||
) | const [inline] |
Returns the offset set for the UVW's for the given stage on the current node.
This call is appropriate for 3-d texture coordinates.
Definition at line 1788 of file nodePath.I.
References is_empty(), and LVecBase3f::zero().
NodePath NodePath::get_tex_projector_from | ( | TextureStage * | stage | ) | const |
Returns the "from" node associated with the TexProjectorEffect on the indicated stage.
The relative transform between the "from" and the "to" nodes is automatically applied to the texture transform each frame.
Definition at line 4751 of file nodePath.cxx.
References fail(), PandaNode::get_effect(), TexProjectorEffect::get_from(), is_empty(), node(), and not_found().
NodePath NodePath::get_tex_projector_to | ( | TextureStage * | stage | ) | const |
Returns the "to" node associated with the TexProjectorEffect on the indicated stage.
The relative transform between the "from" and the "to" nodes is automatically applied to the texture transform each frame.
Definition at line 4774 of file nodePath.cxx.
References fail(), PandaNode::get_effect(), TexProjectorEffect::get_to(), is_empty(), node(), and not_found().
PN_stdfloat NodePath::get_tex_rotate | ( | TextureStage * | stage | ) | const [inline] |
Returns the rotation set for the UV's for the given stage on the current node.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1407 of file nodePath.I.
References is_empty().
PN_stdfloat NodePath::get_tex_rotate | ( | const NodePath & | other, |
TextureStage * | stage | ||
) | const [inline] |
Returns the rotation set for the UV's for the given stage on the current node.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1673 of file nodePath.I.
References is_empty().
LVecBase2 NodePath::get_tex_scale | ( | TextureStage * | stage | ) | const [inline] |
Returns the scale set for the UV's for the given stage on the current node.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1422 of file nodePath.I.
References is_empty().
LVecBase2 NodePath::get_tex_scale | ( | const NodePath & | other, |
TextureStage * | stage | ||
) | const [inline] |
Returns the scale set for the UV's for the given stage on the current node.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1688 of file nodePath.I.
References is_empty().
LVecBase3 NodePath::get_tex_scale_3d | ( | TextureStage * | stage | ) | const [inline] |
Returns the scale set for the UVW's for the given stage on the current node.
This call is appropriate for 3-d texture coordinates.
Definition at line 1550 of file nodePath.I.
References is_empty().
LVecBase3 NodePath::get_tex_scale_3d | ( | const NodePath & | other, |
TextureStage * | stage | ||
) | const [inline] |
Returns the scale set for the UVW's for the given stage on the current node.
This call is appropriate for 3-d texture coordinates.
Definition at line 1816 of file nodePath.I.
References is_empty().
Texture * NodePath::get_texture | ( | ) | const |
Returns the base-level texture that has been set on this particular node, or NULL if no texture has been set.
This is not necessarily the texture that will be applied to the geometry at or below this level, as another texture at a higher or lower level may override.
See also find_texture().
Definition at line 3734 of file nodePath.cxx.
References PandaNode::get_attrib(), TextureAttrib::get_texture(), is_empty(), and node().
Referenced by has_texture().
Texture * NodePath::get_texture | ( | TextureStage * | stage | ) | const |
Returns the texture that has been set on the indicated stage for this particular node, or NULL if no texture has been set for this stage.
Definition at line 3754 of file nodePath.cxx.
References PandaNode::get_attrib(), TextureAttrib::get_on_texture(), is_empty(), and node().
Returns a singleton NodePath that represents the top of the path, or empty NodePath if this path is empty.
Definition at line 477 of file nodePath.cxx.
References fail(), NodePathComponent::get_next(), Thread::get_pipeline_stage(), is_empty(), and NodePathComponent::is_top_node().
Referenced by NonlinearImager::add_screen(), NonlinearImager::add_viewer(), get_top_node(), GraphicsEngine::render_frame(), NonlinearImager::set_viewer_camera(), and PhysxActor::update_transform().
PandaNode * NodePath::get_top_node | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const [inline] |
Returns the top node of the path, or NULL if the path is empty.
This requires iterating through the path.
Definition at line 230 of file nodePath.I.
References get_top(), is_empty(), and node().
const TransformState * NodePath::get_transform | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns the complete transform object set on this node.
Definition at line 1085 of file nodePath.cxx.
References PandaNode::get_transform(), is_empty(), and node().
Referenced by SpeedTreeNode::add_instances(), DXGraphicsStateGuardian9::bind_clip_plane(), DXGraphicsStateGuardian8::bind_clip_plane(), TinyGraphicsStateGuardian::bind_light(), DXGraphicsStateGuardian9::bind_light(), DXGraphicsStateGuardian8::bind_light(), SpeedTreeNode::cull_callback(), do_billboard_axis(), do_billboard_point_eye(), do_billboard_point_world(), GraphicsEngine::do_cull(), CollisionEntry::get_all(), CollisionEntry::get_all_contact_info(), CollisionEntry::get_contact_normal(), CollisionEntry::get_contact_pos(), get_hpr(), CollisionEntry::get_interior_point(), get_mat(), get_pos(), get_pos_delta(), get_quat(), get_relative_point(), get_relative_vector(), get_scale(), get_shear(), CollisionEntry::get_surface_normal(), CollisionEntry::get_surface_point(), NurbsSurfaceEvaluator::get_vertices(), CollisionHandlerPusher::handle_entries(), CollisionHandlerGravity::handle_entries(), CollisionHandlerFluidPusher::handle_entries(), CollisionHandlerFloor::handle_entries(), heads_up(), look_at(), PGItem::mouse_to_local(), BaseIntegrator::precompute_angular_matrices(), BaseIntegrator::precompute_linear_matrices(), CollisionLevelStateBase::prepare_collider(), PortalClipper::prepare_portal(), CLerpNodePathInterval::priv_step(), CConstrainTransformInterval::priv_step(), ProjectionScreen::recompute_if_stale(), MultitexReducer::scan(), set_fluid_pos(), set_hpr(), set_hpr_scale(), set_pos(), set_pos_hpr(), set_pos_quat(), set_quat(), set_quat_scale(), set_scale(), PipeOcclusionCullTraverser::set_scene(), set_shear(), set_transform(), CullTraverser::traverse(), wrt_reparent_to(), and PGItem::xform().
TransparencyAttrib::Mode NodePath::get_transparency | ( | ) | const |
Returns the transparent rendering that has been specifically set on this node via set_transparency(), or M_none if nontransparent rendering has been specifically set, or if nothing has been specifically set.
See also has_transparency(). This does not necessarily imply that the geometry will or will not be rendered transparent, as there may be other nodes that override.
Definition at line 6184 of file nodePath.cxx.
References PandaNode::get_attrib(), TransparencyAttrib::get_mode(), is_empty(), and node().
bool NodePath::get_two_sided | ( | ) | const |
Returns true if two-sided rendering has been specifically set on this node via set_two_sided(), or false if one-sided rendering has been specifically set, or if nothing has been specifically set.
See also has_two_sided(). This does not necessarily imply that the geometry will or will not be rendered two-sided, as there may be other nodes that override.
Definition at line 5698 of file nodePath.cxx.
References CullFaceAttrib::get_actual_mode(), PandaNode::get_attrib(), is_empty(), and node().
bool NodePath::has_antialias | ( | ) | const |
Returns true if an antialias setting has been explicitly mode on this particular node via set_antialias().
If this returns true, then get_antialias() may be called to determine what the setting was.
Definition at line 6231 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_attrib | ( | TypeHandle | type | ) | const [inline] |
Returns true if there is a render attribute of the indicated type defined on this node, or false if there is not.
Definition at line 556 of file nodePath.I.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_audio_volume | ( | ) | const |
Returns true if an audio volume has been applied to the referenced node, false otherwise.
It is still possible that volume at this node might have been scaled by an ancestor node.
Definition at line 6265 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_billboard | ( | ) | const |
Returns true if there is any billboard effect on the node.
Definition at line 6083 of file nodePath.cxx.
References PandaNode::has_effect(), is_empty(), and node().
bool NodePath::has_bin | ( | ) | const |
Returns true if the node has been assigned to the a particular rendering bin via set_bin(), false otherwise.
Definition at line 3448 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_clip_plane | ( | const NodePath & | clip_plane | ) | const |
Returns true if the indicated clipping plane has been specifically applied to this particular node.
This means that someone called set_clip_plane() on this node with the indicated clip_plane.
Definition at line 3131 of file nodePath.cxx.
References PandaNode::get_attrib(), ClipPlaneAttrib::has_on_plane(), is_empty(), TypedObject::is_of_type(), and node().
bool NodePath::has_clip_plane_off | ( | const NodePath & | clip_plane | ) | const |
Returns true if the indicated clipping plane has been specifically disabled on this particular node.
This means that someone called set_clip_plane_off() on this node with the indicated clip_plane.
Definition at line 3178 of file nodePath.cxx.
References PandaNode::get_attrib(), ClipPlaneAttrib::has_off_plane(), is_empty(), TypedObject::is_of_type(), and node().
bool NodePath::has_clip_plane_off | ( | ) | const |
Returns true if all clipping planes have been specifically disabled on this particular node.
This means that someone called set_clip_plane_off() on this node with no parameters.
Definition at line 3156 of file nodePath.cxx.
References PandaNode::get_attrib(), ClipPlaneAttrib::has_all_off(), is_empty(), and node().
bool NodePath::has_color | ( | ) | const |
Returns true if a color has been applied to the given node, false otherwise.
Definition at line 2486 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_color_scale | ( | ) | const |
Returns true if a color scale has been applied to the referenced node, false otherwise.
It is still possible that color at this node might have been scaled by an ancestor node.
Definition at line 2524 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_compass | ( | ) | const |
Returns true if there is any compass effect on the node.
Definition at line 6120 of file nodePath.cxx.
References PandaNode::has_effect(), is_empty(), and node().
bool NodePath::has_depth_offset | ( | ) | const |
Returns true if a depth-offset adjustment has been explicitly set on this particular node via set_depth_offset().
If this returns true, then get_depth_offset() may be called to determine which has been set.
Definition at line 5894 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_depth_test | ( | ) | const |
Returns true if a depth-test adjustment has been explicitly set on this particular node via set_depth_test().
If this returns true, then get_depth_test() may be called to determine which has been set.
Definition at line 5753 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_depth_write | ( | ) | const |
Returns true if a depth-write adjustment has been explicitly set on this particular node via set_depth_write().
If this returns true, then get_depth_write() may be called to determine which has been set.
Definition at line 5823 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_effect | ( | TypeHandle | type | ) | const [inline] |
Returns true if there is a render effect of the indicated type defined on this node, or false if there is not.
Definition at line 608 of file nodePath.I.
References PandaNode::has_effect(), is_empty(), and node().
Referenced by has_scissor().
bool NodePath::has_fog | ( | ) | const |
Returns true if a fog has been applied to this particular node via set_fog(), false otherwise.
This is not the same thing as asking whether the geometry at this node will be rendered with fog, as there may be a fog in effect from a higher or lower level.
Definition at line 5400 of file nodePath.cxx.
References PandaNode::get_attrib(), is_empty(), FogAttrib::is_off(), and node().
bool NodePath::has_fog_off | ( | ) | const |
Returns true if a fog has been specifically disabled on this particular node via set_fog_off(), false otherwise.
This is not the same thing as asking whether the geometry at this node will be rendered unfogged, as there may be a fog in effect from a higher or lower level.
Definition at line 5423 of file nodePath.cxx.
References PandaNode::get_attrib(), is_empty(), FogAttrib::is_off(), and node().
bool NodePath::has_light | ( | const NodePath & | light | ) | const |
Returns true if the indicated Light or PolylightNode has been specifically enabled on this particular node.
This means that someone called set_light() on this node with the indicated light.
Definition at line 2905 of file nodePath.cxx.
References PandaNode::as_light(), PandaNode::get_attrib(), PandaNode::get_effect(), PolylightEffect::has_light(), LightAttrib::has_on_light(), is_empty(), TypedObject::is_of_type(), and node().
bool NodePath::has_light_off | ( | ) | const |
Returns true if all Lights have been specifically disabled on this particular node.
This means that someone called set_light_off() on this node with no parameters.
Definition at line 2942 of file nodePath.cxx.
References PandaNode::get_attrib(), LightAttrib::has_all_off(), is_empty(), and node().
bool NodePath::has_light_off | ( | const NodePath & | light | ) | const |
Returns true if the indicated Light has been specifically disabled on this particular node.
This means that someone called set_light_off() on this node with the indicated light.
This interface does not support PolylightNodes, which cannot be turned off at a lower level.
Definition at line 2967 of file nodePath.cxx.
References PandaNode::as_light(), PandaNode::get_attrib(), LightAttrib::has_off_light(), is_empty(), and node().
bool NodePath::has_mat | ( | ) | const [inline] |
Returns true if a non-identity transform matrix has been applied to the referenced node, false otherwise.
Definition at line 912 of file nodePath.I.
References PandaNode::get_transform(), is_empty(), TransformState::is_identity(), and node().
bool NodePath::has_material | ( | ) | const |
Returns true if a material has been applied to this particular node via set_material(), false otherwise.
Definition at line 5309 of file nodePath.cxx.
References PandaNode::get_attrib(), is_empty(), MaterialAttrib::is_off(), and node().
bool NodePath::has_net_tag | ( | const string & | key | ) | const [inline] |
Returns true if the indicated tag value has been defined on this node or on any ancestor node, or false otherwise.
See also has_tag().
Definition at line 2237 of file nodePath.I.
References find_net_tag(), and is_empty().
Referenced by CollisionHandlerEvent::throw_event_pattern().
bool NodePath::has_occluder | ( | const NodePath & | occluder | ) | const |
Returns true if the indicated occluder has been specifically applied to this particular node.
This means that someone called set_occluder() on this node with the indicated occluder.
Definition at line 3275 of file nodePath.cxx.
References PandaNode::get_effect(), OccluderEffect::has_on_occluder(), is_empty(), TypedObject::is_of_type(), and node().
bool NodePath::has_parent | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const [inline] |
Returns true if the referenced node has a parent; i.e.
the NodePath chain contains at least two nodes.
Definition at line 407 of file nodePath.I.
References is_empty(), and is_singleton().
Referenced by PandaFramework::event_arrow_left(), PandaFramework::event_arrow_right(), PandaFramework::event_arrow_up(), get_parent(), get_sort(), premunge_scene(), reverse_ls(), PandaFramework::set_highlight(), set_tex_transform(), and set_transform().
bool NodePath::has_render_mode | ( | ) | const |
Returns true if a render mode has been explicitly set on this particular node via set_render_mode() (or set_render_mode_wireframe() or set_render_mode_filled()), false otherwise.
Definition at line 5568 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_scissor | ( | ) | const |
Returns true if a scissor region was defined at this node by a previous call to set_scissor().
This does not check for scissor regions inherited from a parent class. It also does not check for the presence of a low-level ScissorAttrib, which is different from the ScissorEffect added by set_scissor.
Definition at line 3394 of file nodePath.cxx.
References has_effect().
bool NodePath::has_tag | ( | const string & | key | ) | const [inline] |
Returns true if a value has been defined on this node for the particular key (even if that value is the empty string), or false if no value has been set.
See also has_net_tag().
Definition at line 2193 of file nodePath.I.
References PandaNode::has_tag(), is_empty(), and node().
Referenced by find_net_tag().
bool NodePath::has_tex_gen | ( | TextureStage * | stage | ) | const |
Returns true if there is a mode for automatic texture coordinate generation on the current node for the given stage.
Definition at line 4598 of file nodePath.cxx.
References PandaNode::get_attrib(), TexGenAttrib::has_stage(), is_empty(), and node().
bool NodePath::has_tex_projector | ( | TextureStage * | stage | ) | const |
Returns true if this node has a TexProjectorEffect for the indicated stage, false otherwise.
Definition at line 4728 of file nodePath.cxx.
References PandaNode::get_effect(), TexProjectorEffect::has_stage(), is_empty(), and node().
bool NodePath::has_tex_transform | ( | TextureStage * | stage | ) | const |
Returns true if there is an explicit texture matrix on the current node for the given stage.
Definition at line 4369 of file nodePath.cxx.
References PandaNode::get_attrib(), TexMatrixAttrib::has_stage(), is_empty(), and node().
bool NodePath::has_texcoord | ( | const string & | texcoord_name | ) | const [inline] |
Returns true if there are at least some vertices at this node and below that use the named texture coordinate set, false otherwise.
Pass the empty string for the default texture coordinate set.
Definition at line 1842 of file nodePath.I.
References has_vertex_column().
bool NodePath::has_texture | ( | ) | const |
Returns true if a texture has been applied to this particular node via set_texture(), false otherwise.
This is not the same thing as asking whether the geometry at this node will be rendered with texturing, as there may be a texture in effect from a higher or lower level.
Definition at line 3646 of file nodePath.cxx.
References get_texture().
bool NodePath::has_texture | ( | TextureStage * | stage | ) | const |
Returns true if texturing has been specifically enabled on this particular node for the indicated stage.
This means that someone called set_texture() on this node with the indicated stage name, or the stage_name is the default stage_name, and someone called set_texture() on this node.
Definition at line 3661 of file nodePath.cxx.
References PandaNode::get_attrib(), TextureAttrib::has_on_stage(), is_empty(), and node().
bool NodePath::has_texture_off | ( | ) | const |
Returns true if texturing has been specifically disabled on this particular node via set_texture_off(), false otherwise.
This is not the same thing as asking whether the geometry at this node will be rendered untextured, as there may be a texture in effect from a higher or lower level.
Definition at line 3685 of file nodePath.cxx.
References PandaNode::get_attrib(), TextureAttrib::has_all_off(), is_empty(), and node().
bool NodePath::has_texture_off | ( | TextureStage * | stage | ) | const |
Returns true if texturing has been specifically disabled on this particular node for the indicated stage.
This means that someone called set_texture_off() on this node with the indicated stage name, or that someone called set_texture_off() on this node to remove all stages.
Definition at line 3708 of file nodePath.cxx.
References PandaNode::get_attrib(), TextureAttrib::has_off_stage(), is_empty(), and node().
bool NodePath::has_transparency | ( | ) | const |
Returns true if a transparent-rendering adjustment has been explicitly set on this particular node via set_transparency().
If this returns true, then get_transparency() may be called to determine whether transparency has been explicitly enabled or explicitly disabled for this node.
Definition at line 6167 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_two_sided | ( | ) | const |
Returns true if a two-sided adjustment has been explicitly set on this particular node via set_two_sided().
If this returns true, then get_two_sided() may be called to determine which has been set.
Definition at line 5681 of file nodePath.cxx.
References PandaNode::has_attrib(), is_empty(), and node().
bool NodePath::has_vertex_column | ( | const InternalName * | name | ) | const |
Returns true if there are at least some vertices at this node and below that contain a reference to the indicated vertex data column name, false otherwise.
This is particularly useful for testing whether a particular model has a given texture coordinate set (but see has_texcoord()).
Definition at line 4908 of file nodePath.cxx.
References is_empty(), and node().
Referenced by has_texcoord().
void NodePath::heads_up | ( | PN_stdfloat | x, |
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction.
Definition at line 953 of file nodePath.I.
Referenced by do_billboard_axis(), and heads_up().
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction.
Definition at line 1708 of file nodePath.cxx.
References get_pos(), heads_up(), is_empty(), and set_quat().
void NodePath::heads_up | ( | const NodePath & | other, |
PN_stdfloat | x, | ||
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction.
Definition at line 1160 of file nodePath.I.
References heads_up().
void NodePath::heads_up | ( | const NodePath & | other, |
const LPoint3 & | point = LPoint3(0.0, 0.0, 0.0) , |
||
const LVector3 & | up = LVector3::up() |
||
) |
Behaves like look_at(), but with a strong preference to keeping the up vector oriented in the indicated "up" direction.
Definition at line 2407 of file nodePath.cxx.
References get_parent(), get_pos(), get_transform(), heads_up(), is_empty(), and set_quat().
void NodePath::hide | ( | ) | [inline] |
Makes the referenced node (and the entire subgraph below this node) invisible to all cameras.
It remains part of the scene graph, its bounding volume still contributes to its parent's bounding volume, and it will still be involved in collision tests.
Definition at line 1978 of file nodePath.I.
References PandaNode::adjust_draw_mask(), BitMask< PN_uint32, 32 >::all_off(), PandaNode::get_overall_bit(), is_empty(), and node().
Referenced by NodePathCollection::hide(), PandaFramework::hide_collision_solids(), HideInterval::priv_instant(), and ShowInterval::priv_reverse_instant().
void NodePath::hide | ( | DrawMask | camera_mask | ) | [inline] |
Makes the referenced node invisible just to the cameras whose camera_mask shares the indicated bits.
This will also hide any nodes below this node in the scene graph, including those nodes for which show() has been called, but it will not hide descendent nodes for which show_through() has been called.
Definition at line 1995 of file nodePath.I.
References PandaNode::adjust_draw_mask(), BitMask< PN_uint32, 32 >::all_off(), is_empty(), and node().
void NodePath::hide_bounds | ( | ) |
Stops the rendering of the bounding volume begun with show_bounds().
Definition at line 6640 of file nodePath.cxx.
References PandaNode::clear_effect(), is_empty(), and node().
Referenced by PandaFramework::clear_highlight().
NodePath NodePath::instance_to | ( | const NodePath & | other, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Adds the referenced node of the NodePath as a child of the referenced node of the indicated other NodePath.
Any other parent-child relations of the node are unchanged; in particular, the node is not removed from its existing parent, if any.
If the node already had an existing parent, this method will create a new instance of the node within the scene graph.
This does not change the NodePath itself, but does return a new NodePath that reflects the new instance node.
If the destination NodePath is empty, this creates a new instance which is not yet parented to any node. A new instance of this sort cannot easily be differentiated from other similar instances, but it is nevertheless a different instance and it will return a different get_id() value.
If the referenced node is already a child of the indicated NodePath, returns that already-existing instance, unstashing it first if necessary.
Definition at line 778 of file nodePath.cxx.
References fail(), Thread::get_pipeline_stage(), is_empty(), is_stashed(), node(), unstash(), and verify_complete().
Referenced by MayaPview::doIt(), PGItem::instance_to_state_def(), instance_under_node(), and PandaFramework::set_highlight().
NodePath NodePath::instance_under_node | ( | const NodePath & | other, |
const string & | name, | ||
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) | const |
Behaves like instance_to(), but implicitly creates a new node to instance the geometry under, and returns a NodePath to that new node.
This allows the programmer to set a unique state and/or transform on this instance.
Definition at line 830 of file nodePath.cxx.
References attach_new_node(), instance_to(), is_empty(), and remove_node().
bool NodePath::is_ancestor_of | ( | const NodePath & | other, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const [inline] |
Returns true if the node represented by this NodePath is a parent or other ancestor of the other NodePath, or false if it is not.
Definition at line 327 of file nodePath.I.
bool NodePath::is_empty | ( | ) | const [inline] |
Returns true if the NodePath contains no nodes.
Definition at line 196 of file nodePath.I.
Referenced by CollisionTraverser::add_collider(), CollisionHandlerPhysical::add_collider(), SpriteParticleRenderer::add_from_node(), SpeedTreeNode::add_from_stf(), MouseWatcher::add_group(), SpeedTreeNode::add_instances(), AttribNodeRegistry::add_node(), NonlinearImager::add_screen(), NonlinearImager::add_viewer(), adjust_all_priorities(), CompassEffect::adjust_transform(), BillboardEffect::adjust_transform(), ShaderGenerator::analyze_renderstate(), PhysicsCollisionHandler::apply_net_shove(), apply_texture_colors(), PhysxActor::attach_node_path(), calc_tight_bounds(), clear_antialias(), clear_attrib(), clear_audio_volume(), clear_billboard(), clear_bin(), clear_clip_plane(), clear_color(), clear_color_scale(), clear_compass(), clear_depth_offset(), clear_depth_test(), clear_depth_write(), clear_effect(), clear_effects(), clear_fog(), PandaFramework::clear_highlight(), clear_light(), clear_mat(), clear_material(), clear_model_nodes(), clear_occluder(), clear_render_mode(), clear_tag(), clear_tex_gen(), clear_tex_projector(), clear_tex_transform(), PandaFramework::clear_text(), clear_texture(), clear_transparency(), clear_two_sided(), compose_color_scale(), PGItem::compute_internal_bounds(), copy_to(), count_num_descendants(), SpeedTreeNode::cull_callback(), PortalNode::cull_callback(), BillboardEffect::cull_callback(), detach_node(), do_billboard_axis(), do_billboard_point_eye(), do_billboard_point_world(), GraphicsStateGuardian::do_issue_clip_plane(), TinyGraphicsStateGuardian::do_issue_light(), GraphicsStateGuardian::do_issue_light(), PandaFramework::event_A(), PandaFramework::event_B(), PandaFramework::event_C(), PandaFramework::event_c(), PandaFramework::event_L(), GraphicsStateGuardian::fetch_specified_part(), SpeedTreeNode::InstanceList::fillin(), find(), find_all_matches(), find_all_materials(), find_all_paths_to(), find_all_texcoords(), find_all_texture_stages(), find_all_textures(), find_all_vertex_columns(), find_material(), find_net_tag(), AttribNodeRegistry::find_node(), find_path_to(), find_texture(), find_texture_stage(), flatten_light(), flatten_medium(), flatten_strong(), force_recompute_bounds(), get_antialias(), get_attrib(), get_bin_draw_order(), get_bin_name(), get_children(), get_collide_mask(), get_color(), get_color_scale(), get_depth_offset(), get_depth_test(), get_depth_write(), get_effect(), get_effects(), get_fog(), get_hpr(), get_instance_count(), get_key(), get_mat(), PandaFramework::get_models(), LightAttrib::get_most_important_light(), get_name(), get_num_children(), get_num_nodes(), get_pos(), get_pos_delta(), get_prev_transform(), get_quat(), PGItem::get_relative_frame(), get_render_mode(), get_render_mode_perspective(), get_render_mode_thickness(), get_scale(), get_shear(), get_stashed_children(), get_state(), get_tag(), get_tex_gen(), get_tex_gen_light(), get_tex_hpr(), get_tex_offset(), get_tex_pos(), get_tex_projector_from(), get_tex_projector_to(), get_tex_rotate(), get_tex_scale(), get_tex_scale_3d(), get_texture(), get_top(), get_top_node(), get_transform(), get_transparency(), get_two_sided(), NurbsSurfaceEvaluator::get_vertex(), NurbsSurfaceEvaluator::get_vertices(), BillboardEffect::has_adjust_transform(), has_antialias(), has_attrib(), has_audio_volume(), has_billboard(), has_bin(), CollisionHandlerPhysical::has_center(), has_clip_plane(), has_clip_plane_off(), has_color(), has_color_scale(), has_compass(), has_depth_offset(), has_depth_test(), has_depth_write(), has_effect(), has_fog(), has_fog_off(), PandaFramework::has_highlight(), has_light(), has_light_off(), has_mat(), has_material(), has_net_tag(), has_occluder(), has_parent(), has_render_mode(), has_tag(), has_tex_gen(), has_tex_projector(), has_tex_transform(), has_texture(), has_texture_off(), has_transparency(), has_two_sided(), has_vertex_column(), heads_up(), hide(), hide_bounds(), CDistributedSmoothNodeBase::initialize(), instance_to(), PGItem::instance_to_state_def(), instance_under_node(), is_hidden(), is_stashed(), list_tags(), look_at(), AttribNodeRegistry::lookup_node(), ls(), node(), NodePath(), operator bool(), premunge_scene(), prepare_scene(), CLerpNodePathInterval::priv_step(), CConstrainTransformInterval::priv_step(), CConstrainPosInterval::priv_step(), CConstrainPosHprInterval::priv_step(), CConstrainHprInterval::priv_step(), project_texture(), PGItem::r_prepare_scene(), ProjectionScreen::recompute_if_stale(), MouseWatcher::remove_group(), remove_node(), AttribNodeRegistry::remove_node(), GraphicsEngine::render_frame(), EggLoader::reparent_decals(), reparent_to(), MouseWatcher::replace_group(), reverse_ls(), set_all_color_scale(), set_alpha_scale(), set_antialias(), set_attrib(), set_audio_volume(), set_audio_volume_off(), set_billboard_axis(), set_billboard_point_eye(), set_billboard_point_world(), set_bin(), DisplayRegion::set_camera(), set_clip_plane(), set_clip_plane_off(), set_collide_mask(), set_color(), set_color_off(), set_color_scale(), set_color_scale_off(), set_compass(), set_depth_offset(), set_depth_test(), set_depth_write(), set_effect(), set_effects(), set_fluid_pos(), set_fog(), set_fog_off(), PGItem::set_frame_style(), SpriteParticleRenderer::set_from_node(), PandaFramework::set_highlight(), set_hpr(), set_hpr_scale(), set_instance_count(), set_light(), set_light_off(), set_mat(), set_material(), set_material_off(), set_name(), set_occluder(), set_pos(), set_pos_hpr(), set_pos_hpr_scale(), set_pos_hpr_scale_shear(), set_pos_quat(), set_pos_quat_scale(), set_pos_quat_scale_shear(), set_prev_transform(), ProjectionScreen::set_projector(), set_quat(), set_quat_scale(), set_render_mode(), set_render_mode_filled(), set_render_mode_perspective(), set_render_mode_thickness(), set_render_mode_wireframe(), set_scale(), set_shader_auto(), set_shear(), NonlinearImager::set_source_camera(), set_state(), set_tag(), set_tex_gen(), set_tex_hpr(), set_tex_offset(), set_tex_pos(), set_tex_projector(), set_tex_rotate(), set_tex_scale(), set_tex_transform(), set_texture(), set_texture_off(), set_transform(), set_transparency(), set_two_sided(), NonlinearImager::set_viewer_camera(), show(), show_bounds(), show_through(), show_tight_bounds(), stash(), stash_to(), unify_texture_stages(), unstash(), PhysxActor::update_transform(), CollisionHandlerPhysical::validate_target(), verify_complete(), WorkingNodePath::WorkingNodePath(), write_bam_file(), write_bam_stream(), and wrt_reparent_to().
bool NodePath::is_hidden | ( | DrawMask | camera_mask = PandaNode::get_overall_bit() | ) | const [inline] |
Returns true if the referenced node is hidden from the indicated camera(s) either directly, or because some ancestor is hidden.
Definition at line 2009 of file nodePath.I.
References get_hidden_ancestor(), and is_empty().
Referenced by PandaFramework::hide_collision_solids().
bool NodePath::is_same_graph | ( | const NodePath & | other, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | const [inline] |
Returns true if the node represented by this NodePath is parented within the same graph as that of the other NodePath.
This is essentially the same thing as asking whether get_top() of both NodePaths is the same (e.g., both "render").
Definition at line 304 of file nodePath.I.
Referenced by NonlinearImager::add_screen(), NonlinearImager::add_viewer(), CConstrainPosInterval::priv_step(), CConstrainTransformInterval::priv_step(), CConstrainHprInterval::priv_step(), CConstrainPosHprInterval::priv_step(), and NonlinearImager::set_viewer_camera().
bool NodePath::is_singleton | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const [inline] |
Returns true if the NodePath contains exactly one node.
Definition at line 207 of file nodePath.I.
References Thread::get_pipeline_stage().
Referenced by detach_node(), has_parent(), remove_node(), stash(), and unstash().
bool NodePath::is_stashed | ( | ) | const [inline] |
Returns true if the referenced node is stashed either directly, or because some ancestor is stashed.
Definition at line 2020 of file nodePath.I.
References get_stashed_ancestor(), and is_empty().
Referenced by instance_to().
void NodePath::list_tags | ( | ) | const [inline] |
Lists the tags to the nout stream, one per line.
See PandaNode::list_tags() for a variant that allows you to specify the output stream.
Definition at line 2357 of file nodePath.I.
References is_empty(), PandaNode::list_tags(), and node().
void NodePath::look_at | ( | PN_stdfloat | x, |
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Sets the transform on this NodePath so that it rotates to face the indicated point in space.
This will overwrite any previously existing scale on the node, although it will preserve any translation.
Definition at line 941 of file nodePath.I.
Referenced by do_billboard_point_eye(), do_billboard_point_world(), look_at(), GraphicsOutput::make_cube_map(), and AICharacter::update().
Sets the hpr on this NodePath so that it rotates to face the indicated point in space.
Definition at line 1690 of file nodePath.cxx.
References get_pos(), is_empty(), look_at(), and set_quat().
void NodePath::look_at | ( | const NodePath & | other, |
PN_stdfloat | x, | ||
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Sets the hpr on this NodePath so that it rotates to face the indicated point in space, which is relative to the other NodePath.
Definition at line 1148 of file nodePath.I.
References look_at().
void NodePath::look_at | ( | const NodePath & | other, |
const LPoint3 & | point = LPoint3(0.0, 0.0, 0.0) , |
||
const LVector3 & | up = LVector3::up() |
||
) |
Sets the transform on this NodePath so that it rotates to face the indicated point in space, which is relative to the other NodePath.
Definition at line 2386 of file nodePath.cxx.
References get_parent(), get_pos(), get_transform(), is_empty(), look_at(), and set_quat().
void NodePath::ls | ( | ) | const [inline] |
Lists the hierarchy at and below the referenced node.
Definition at line 452 of file nodePath.I.
Referenced by PandaFramework::event_L(), and NodePathCollection::ls().
void NodePath::ls | ( | ostream & | out, |
int | indent_level = 0 |
||
) | const [inline] |
Lists the hierarchy at and below the referenced node.
Definition at line 462 of file nodePath.I.
References is_empty(), PandaNode::ls(), and node().
PandaNode * NodePath::node | ( | ) | const [inline] |
Returns the referenced node of the path.
Definition at line 244 of file nodePath.I.
References is_empty().
Referenced by PGItem::activate_region(), CollisionTraverser::add_collider(), CollisionHandlerPhysical::add_collider(), SpeedTreeNode::add_from_stf(), SpeedTreeNode::add_instances(), NonlinearImager::add_screen(), adjust_all_priorities(), ShaderGenerator::analyze_renderstate(), CollisionBox::apply_clip_plane(), PhysicsCollisionHandler::apply_net_shove(), apply_texture_colors(), DXGraphicsStateGuardian9::bind_clip_plane(), DXGraphicsStateGuardian8::bind_clip_plane(), calc_tight_bounds(), clear_antialias(), clear_attrib(), clear_audio_volume(), clear_billboard(), clear_bin(), clear_clip_plane(), clear_color(), clear_color_scale(), clear_compass(), clear_depth_offset(), clear_depth_test(), clear_depth_write(), clear_effect(), clear_effects(), clear_fog(), clear_light(), clear_mat(), clear_material(), clear_model_nodes(), clear_occluder(), MouseWatcherGroup::clear_regions(), clear_render_mode(), clear_tag(), clear_tex_gen(), clear_tex_projector(), clear_tex_transform(), clear_texture(), clear_transparency(), clear_two_sided(), compose_color_scale(), PGItem::compute_internal_bounds(), copy_to(), SpeedTreeNode::cull_callback(), PGItem::cull_callback(), PGEntry::cull_callback(), decode_from_bam_stream(), detach_node(), GraphicsStateGuardian::do_issue_clip_plane(), TinyGraphicsStateGuardian::do_issue_light(), GraphicsStateGuardian::do_issue_light(), MouseWatcherGroup::do_remove_region(), ModelFlattenRequest::do_task(), MouseWatcherGroup::do_update_regions(), encode_to_bam_stream(), PandaFramework::event_A(), PandaFramework::event_arrow_left(), PandaFramework::event_arrow_right(), GraphicsStateGuardian::fetch_specified_part(), SpeedTreeNode::InstanceList::fillin(), find_all_materials(), find_all_texcoords(), find_all_texture_stages(), find_all_textures(), find_all_vertex_columns(), find_material(), find_texture(), find_texture_stage(), flatten_light(), flatten_medium(), flatten_strong(), force_recompute_bounds(), GeoMipTerrain::generate(), MeshDrawer::geometry(), get_antialias(), get_attrib(), get_audio_volume(), get_bin_draw_order(), get_bin_name(), get_children(), get_collide_mask(), get_color(), get_color_scale(), get_depth_offset(), get_depth_test(), get_depth_write(), get_effect(), get_effects(), get_fog(), get_hidden_ancestor(), get_instance_count(), LightAttrib::get_light(), get_mat(), LightAttrib::get_most_important_light(), get_name(), get_prev_transform(), get_render_mode(), get_render_mode_perspective(), get_render_mode_thickness(), get_sort(), get_stashed_ancestor(), get_stashed_children(), get_state(), get_tag(), get_tex_gen(), get_tex_gen_light(), get_tex_projector_from(), get_tex_projector_to(), get_texture(), get_top_node(), get_transform(), get_transparency(), get_two_sided(), has_antialias(), has_attrib(), has_audio_volume(), has_billboard(), has_bin(), has_clip_plane(), has_clip_plane_off(), has_color(), has_color_scale(), has_compass(), has_depth_offset(), has_depth_test(), has_depth_write(), has_effect(), has_fog(), has_fog_off(), has_light(), has_light_off(), has_mat(), has_material(), has_occluder(), has_render_mode(), has_tag(), has_tex_gen(), has_tex_projector(), has_tex_transform(), has_texture(), has_texture_off(), has_transparency(), has_two_sided(), has_vertex_column(), hide(), hide_bounds(), PandaFramework::hide_collision_solids(), instance_to(), MeshDrawer::link_segment(), list_tags(), ls(), GraphicsOutput::make_cube_map(), premunge_scene(), PortalClipper::prepare_portal(), prepare_scene(), project_texture(), PGItem::r_prepare_scene(), ProjectionScreen::recompute_if_stale(), remove_node(), GraphicsEngine::render_frame(), EggLoader::reparent_decals(), reparent_to(), reverse_ls(), MultitexReducer::scan(), set_all_color_scale(), set_alpha_scale(), set_antialias(), set_attrib(), set_audio_volume(), set_audio_volume_off(), set_billboard_axis(), set_billboard_point_eye(), set_billboard_point_world(), set_bin(), DisplayRegion::set_camera(), set_clip_plane(), set_clip_plane_off(), set_collide_mask(), set_color(), set_color_off(), set_color_scale(), set_color_scale_off(), set_compass(), set_depth_offset(), set_depth_test(), set_depth_write(), set_effect(), set_effects(), set_fog(), set_fog_off(), PhysxTriangleMeshDesc::set_from_node_path(), PhysxConvexMeshDesc::set_from_node_path(), PhysxClothMeshDesc::set_from_node_path(), set_instance_count(), set_light(), set_light_off(), set_mat(), set_material(), set_material_off(), set_name(), set_occluder(), set_pos(), set_pos_hpr(), set_pos_hpr_scale(), set_pos_hpr_scale_shear(), set_pos_quat(), set_pos_quat_scale(), set_pos_quat_scale_shear(), set_prev_transform(), ProjectionScreen::set_projector(), set_render_mode(), set_render_mode_filled(), set_render_mode_perspective(), set_render_mode_thickness(), set_render_mode_wireframe(), set_shader_auto(), NonlinearImager::set_source_camera(), set_state(), set_tag(), set_tex_gen(), set_tex_projector(), set_tex_transform(), set_texture(), set_texture_off(), set_transform(), set_transparency(), set_two_sided(), NonlinearImager::set_viewer_camera(), SceneGraphAnalyzerMeter::setup_window(), FrameRateMeter::setup_window(), show(), show_bounds(), PandaFramework::show_collision_solids(), show_through(), show_tight_bounds(), stash_to(), unify_texture_stages(), GeoMipTerrain::update(), PhysicsCollisionHandler::validate_target(), verify_complete(), WorkingNodePath::WorkingNodePath(), write_bam_file(), write_bam_stream(), OccluderEffect::write_datagram(), LightAttrib::write_datagram(), ClipPlaneAttrib::write_datagram(), wrt_reparent_to(), and PGItem::xform().
NodePath NodePath::not_found | ( | ) | [inline, static] |
Creates a NodePath with the ET_not_found error type set.
Definition at line 119 of file nodePath.I.
Referenced by find(), find_net_tag(), find_path_to(), get_common_ancestor(), get_hidden_ancestor(), get_stashed_ancestor(), get_tex_projector_from(), and get_tex_projector_to().
NodePath::operator bool | ( | ) | const |
Returns true if the NodePath is valid (not empty), or false if it contains no nodes.
Definition at line 347 of file nodePath.cxx.
References is_empty().
bool NodePath::operator!= | ( | const NodePath & | other | ) | const [inline] |
Returns true if the two paths are not equivalent.
Definition at line 2086 of file nodePath.I.
bool NodePath::operator< | ( | const NodePath & | other | ) | const [inline] |
Returns true if this NodePath sorts before the other one, false otherwise.
The sorting order of two nonequivalent NodePaths is consistent but undefined, and is useful only for storing NodePaths in a sorted container like an STL set.
Definition at line 2100 of file nodePath.I.
bool NodePath::operator== | ( | const NodePath & | other | ) | const [inline] |
Returns true if the two paths are equivalent; that is, if they contain the same list of nodes in the same order.
Definition at line 2076 of file nodePath.I.
void NodePath::output | ( | ostream & | out | ) | const |
Writes a sensible description of the NodePath to the indicated output stream.
Definition at line 980 of file nodePath.cxx.
void NodePath::premunge_scene | ( | GraphicsStateGuardianBase * | gsg = NULL | ) |
Walks through the scene graph beginning at the bottom node, and internally adjusts any GeomVertexFormats for optimal rendering on the indicated GSG.
If this step is not done prior to rendering, the formats will be optimized at render time instead, for a small cost.
It is not normally necessary to do this on a model loaded directly from disk, since the loader will do this by default.
Definition at line 6568 of file nodePath.cxx.
References get_parent(), has_parent(), is_empty(), node(), and SceneGraphReducer::premunge().
void NodePath::prepare_scene | ( | GraphicsStateGuardianBase * | gsg | ) |
Walks through the scene graph beginning at the bottom node, and does whatever initialization is required to render the scene properly with the indicated GSG.
It is not strictly necessary to call this, since the GSG will initialize itself when the scene is rendered, but this may take some of the overhead away from that process.
In particular, this will ensure that textures and vertex buffers within the scene are loaded into graphics memory.
Definition at line 6596 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::prepare_scene().
void NodePath::project_texture | ( | TextureStage * | stage, |
Texture * | tex, | ||
const NodePath & | projector | ||
) |
A convenience function to enable projective texturing at this node level and below, using the indicated NodePath (which should contain a LensNode) as the projector.
Definition at line 4796 of file nodePath.cxx.
References is_empty(), TypedObject::is_of_type(), node(), NodePath(), set_tex_gen(), set_tex_projector(), and set_texture().
void NodePath::remove_node | ( | Thread * | current_thread = Thread::get_current_thread() | ) |
Disconnects the referenced node from the scene graph.
This will also delete the node if there are no other pointers to it.
Normally, this should be called only when you are really done with the node. If you want to remove a node from the scene graph but keep it around for later, you should probably use detach_node() instead.
In practice, the only difference between remove_node() and detach_node() is that remove_node() also resets the NodePath to empty, which will cause the node to be deleted immediately if there are no other references. On the other hand, detach_node() leaves the NodePath referencing the node, which will keep at least one reference to the node for as long as the NodePath exists.
Definition at line 917 of file nodePath.cxx.
References get_key(), Thread::get_pipeline_stage(), is_empty(), is_singleton(), node(), removed(), and PandaNode::reset_prev_transform().
Referenced by PGEntry::clear_cursor_def(), PandaFramework::clear_text(), MouseWatcherGroup::do_hide_regions(), MayaPview::doIt(), instance_under_node(), MeshDrawer::~MeshDrawer(), MeshDrawer2D::~MeshDrawer2D(), and ParticleSystem::~ParticleSystem().
NodePath NodePath::removed | ( | ) | [inline, static] |
Creates a NodePath with the ET_removed error type set.
Definition at line 132 of file nodePath.I.
Referenced by remove_node().
void NodePath::reparent_to | ( | const NodePath & | other, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Removes the referenced node of the NodePath from its current parent and attaches it to the referenced node of the indicated NodePath.
If the destination NodePath is empty, this is the same thing as detach_node().
If the referenced node is already a child of the indicated NodePath (via some other instance), this operation fails and leaves the NodePath detached.
Definition at line 683 of file nodePath.cxx.
References Thread::get_pipeline_stage(), is_empty(), node(), PandaNode::reset_prev_transform(), and verify_complete().
Referenced by ParticleSystem::ParticleSystem(), PfmTrans::process_pfm(), EggLoader::reparent_decals(), NodePathCollection::reparent_to(), PandaFramework::set_highlight(), and wrt_reparent_to().
void NodePath::reverse_ls | ( | ) | const [inline] |
Lists the hierarchy at and above the referenced node.
Definition at line 476 of file nodePath.I.
Referenced by reverse_ls().
int NodePath::reverse_ls | ( | ostream & | out, |
int | indent_level = 0 |
||
) | const [inline] |
Lists the hierarchy at and above the referenced node.
Definition at line 486 of file nodePath.I.
References get_parent(), has_parent(), is_empty(), node(), and reverse_ls().
void NodePath::set_all_color_scale | ( | PN_stdfloat | scale, |
int | priority = 0 |
||
) |
Scales all the color components of the object by the same amount, darkening the object, without (much) affecting alpha.
Note that any priority specified will also apply to the alpha scale.
Definition at line 2665 of file nodePath.cxx.
References PandaNode::get_attrib(), ColorScaleAttrib::get_scale(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_alpha_scale | ( | PN_stdfloat | scale, |
int | priority = 0 |
||
) |
Sets the alpha scale component of the transform without (much) affecting the color scale.
Note that any priority specified will also apply to the color scale.
Definition at line 2635 of file nodePath.cxx.
References PandaNode::get_attrib(), ColorScaleAttrib::get_scale(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_antialias | ( | unsigned short | mode, |
int | priority = 0 |
||
) |
Specifies the antialiasing type that should be applied at this node and below.
See AntialiasAttrib.
Definition at line 6203 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_attrib | ( | const RenderAttrib * | attrib, |
int | priority = 0 |
||
) | [inline] |
Adds the indicated render attribute to the scene graph on this node.
This attribute will now apply to this node and everything below. If there was already an attribute of the same type, it is replaced.
Definition at line 528 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by PandaFramework::open_framework(), and NodePathCollection::set_attrib().
void NodePath::set_audio_volume | ( | PN_stdfloat | volume, |
int | priority = 0 |
||
) |
Sets the audio volume component of the transform.
Definition at line 6291 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_audio_volume_off | ( | int | priority = 0 | ) |
Disables any audio volume attribute inherited from above.
This is not the same thing as clear_audio_volume(), which undoes any previous set_audio_volume() operation on this node; rather, this actively disables any set_audio_volume() that might be inherited from a parent node.
It is legal to specify a new volume on the same node with a subsequent call to set_audio_volume(); this new scale will apply to lower nodes.
Definition at line 6326 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_billboard_axis | ( | PN_stdfloat | offset = 0.0 | ) | [inline] |
Puts a billboard transition on the node such that it will rotate in two dimensions around the up axis.
Definition at line 1853 of file nodePath.I.
References NodePath().
void NodePath::set_billboard_axis | ( | const NodePath & | camera, |
PN_stdfloat | offset | ||
) |
Puts a billboard transition on the node such that it will rotate in two dimensions around the up axis, towards a specified "camera" instead of to the viewing camera.
Definition at line 6022 of file nodePath.cxx.
References is_empty(), node(), PandaNode::set_effect(), and LVector3f::up().
void NodePath::set_billboard_point_eye | ( | const NodePath & | camera, |
PN_stdfloat | offset | ||
) |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the top of the camera, towards a specified "camera" instead of to the viewing camera.
Definition at line 6040 of file nodePath.cxx.
References is_empty(), node(), PandaNode::set_effect(), and LVector3f::up().
void NodePath::set_billboard_point_eye | ( | PN_stdfloat | offset = 0.0 | ) | [inline] |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the top of the camera.
Definition at line 1866 of file nodePath.I.
References NodePath().
void NodePath::set_billboard_point_world | ( | PN_stdfloat | offset = 0.0 | ) | [inline] |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the sky.
Definition at line 1878 of file nodePath.I.
References NodePath().
void NodePath::set_billboard_point_world | ( | const NodePath & | camera, |
PN_stdfloat | offset | ||
) |
Puts a billboard transition on the node such that it will rotate in three dimensions about the origin, keeping its up vector oriented to the sky, towards a specified "camera" instead of to the viewing camera.
Definition at line 6057 of file nodePath.cxx.
References is_empty(), node(), PandaNode::set_effect(), and LVector3f::up().
void NodePath::set_bin | ( | const string & | bin_name, |
int | draw_order, | ||
int | priority = 0 |
||
) |
Assigns the geometry at this level and below to the named rendering bin.
It is the user's responsibility to ensure that such a bin already exists, either via the cull-bin Configrc variable, or by explicitly creating a GeomBin of the appropriate type at runtime.
There are two default bins created when Panda is started: "default" and "fixed". Normally, all geometry is assigned to "default" unless specified otherwise. This bin renders opaque geometry in state-sorted order, followed by transparent geometry sorted back-to-front. If any geometry is assigned to "fixed", this will be rendered following all the geometry in "default", in the order specified by draw_order for each piece of geometry so assigned.
The draw_order parameter is meaningful only for GeomBinFixed type bins, e.g. "fixed". Other kinds of bins ignore it.
Definition at line 3423 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by MouseWatcherGroup::do_show_regions(), and MultitexReducer::flatten().
void NodePath::set_clip_plane | ( | const NodePath & | clip_plane, |
int | priority = 0 |
||
) |
Adds the indicated clipping plane to the list of planes that apply to geometry at this node and below.
The clipping plane itself, a PlaneNode, should be parented into the scene graph elsewhere, to represent the plane's position in space; but until set_clip_plane() is called it will clip no geometry.
Definition at line 2995 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), TypedObject::is_of_type(), node(), and PandaNode::set_attrib().
void NodePath::set_clip_plane_off | ( | int | priority = 0 | ) |
Sets the geometry at this level and below to render using no clip_planes at all.
This is different from not specifying a clip_plane; rather, this specifically contradicts set_clip_plane() at a higher node level (or, with a priority, overrides a set_clip_plane() at a lower level).
If no clip_planes are in effect on a particular piece of geometry, that geometry is rendered without being clipped (other than by the viewing frustum).
Definition at line 3034 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_clip_plane_off | ( | const NodePath & | clip_plane, |
int | priority = 0 |
||
) |
Sets the geometry at this level and below to render without being clipped by the indicated PlaneNode.
This is different from not specifying the PlaneNode; rather, this specifically contradicts set_clip_plane() at a higher node level (or, with a priority, overrides a set_clip_plane() at a lower level).
Definition at line 3051 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), TypedObject::is_of_type(), node(), and PandaNode::set_attrib().
void NodePath::set_collide_mask | ( | CollideMask | new_mask, |
CollideMask | bits_to_change = CollideMask::all_on() , |
||
TypeHandle | node_type = TypeHandle::none() |
||
) | [inline] |
Recursively applies the indicated CollideMask to the into_collide_masks for all nodes at this level and below.
If node_type is not TypeHandle::none(), then only nodes matching (or inheriting from) the indicated PandaNode subclass are modified.
The default is to change all bits, but if bits_to_change is not all bits on, then only the bits that are set in bits_to_change are modified, allowing this call to change only a subset of the bits in the subgraph.
Definition at line 2057 of file nodePath.I.
References is_empty(), node(), and TypeHandle::none().
Referenced by NodePathCollection::set_collide_mask().
void NodePath::set_color | ( | PN_stdfloat | r, |
PN_stdfloat | g, | ||
PN_stdfloat | b, | ||
PN_stdfloat | a = 1.0 , |
||
int | priority = 0 |
||
) |
Applies a scene-graph color to the referenced node.
This color will apply to all geometry at this level and below (that does not specify a new color or a set_color_off()).
Definition at line 2430 of file nodePath.cxx.
Referenced by PandaFramework::open_framework().
void NodePath::set_color | ( | const LColor & | color, |
int | priority = 0 |
||
) |
Applies a scene-graph color to the referenced node.
This color will apply to all geometry at this level and below (that does not specify a new color or a set_color_off()).
Definition at line 2444 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_color_off | ( | int | priority = 0 | ) |
Sets the geometry at this level and below to render using the geometry color.
This is normally the default, but it may be useful to use this to contradict set_color() at a higher node level (or, with a priority, to override a set_color() at a lower level).
Definition at line 2460 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_color_scale | ( | const LVecBase4 & | scale, |
int | priority = 0 |
||
) |
Sets the color scale component of the transform, leaving translation and rotation untouched.
Definition at line 2584 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
Referenced by NodePathCollection::set_color_scale(), set_color_scale(), set_sa(), set_sb(), set_sg(), and set_sr().
void NodePath::set_color_scale | ( | PN_stdfloat | sx, |
PN_stdfloat | sy, | ||
PN_stdfloat | sz, | ||
PN_stdfloat | sa, | ||
int | priority = 0 |
||
) | [inline] |
Sets the color scale component of the transform.
Definition at line 1183 of file nodePath.I.
References set_color_scale().
void NodePath::set_color_scale_off | ( | int | priority = 0 | ) |
Disables any color scale attribute inherited from above.
This is not the same thing as clear_color_scale(), which undoes any previous set_color_scale() operation on this node; rather, this actively disables any set_color_scale() that might be inherited from a parent node. This also disables set_alpha_scale() at the same time.
It is legal to specify a new color scale on the same node with a subsequent call to set_color_scale() or set_alpha_scale(); this new scale will apply to lower geometry.
Definition at line 2621 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Puts a compass effect on the node, so that it will retain a fixed rotation relative to the reference node (or render if the reference node is empty) regardless of the transforms above it.
Definition at line 6097 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_effect().
void NodePath::set_depth_offset | ( | int | bias, |
int | priority = 0 |
||
) |
This instructs the graphics driver to apply an offset or bias to the generated depth values for rendered polygons, before they are written to the depth buffer.
This can be used to shift polygons forward slightly, to resolve depth conflicts, or self-shadowing artifacts on thin objects. The bias is always an integer number, and each integer increment represents the smallest possible increment in Z that is sufficient to completely resolve two coplanar polygons. Positive numbers are closer towards the camera.
Definition at line 5866 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_depth_test | ( | bool | depth_test, |
int | priority = 0 |
||
) |
Specifically sets or disables the testing of the depth buffer on this particular node.
This is normally on in the 3-d scene graph and off in the 2-d scene graph; it should be on for rendering most 3-d objects properly.
Definition at line 5720 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by MultitexReducer::flatten().
void NodePath::set_depth_write | ( | bool | depth_write, |
int | priority = 0 |
||
) |
Specifically sets or disables the writing to the depth buffer on this particular node.
This is normally on in the 3-d scene graph and off in the 2-d scene graph; it should be on for rendering most 3-d objects properly.
Definition at line 5790 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by MultitexReducer::flatten().
void NodePath::set_effect | ( | const RenderEffect * | effect | ) | [inline] |
Adds the indicated render effect to the scene graph on this node.
If there was already an effect of the same type, it is replaced.
Definition at line 583 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_effect().
Referenced by set_scissor().
void NodePath::set_effects | ( | const RenderEffects * | effects | ) | [inline] |
Sets the complete RenderEffects that will be applied this node.
This completely replaces whatever has been set on this node via repeated calls to set_attrib().
Definition at line 634 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_effects().
void NodePath::set_fluid_pos | ( | const NodePath & | other, |
PN_stdfloat | x, | ||
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Sets the translation component, without changing the "previous" position, so that the collision system will see the node as moving fluidly from its previous position to its new position.
Definition at line 977 of file nodePath.I.
References set_fluid_pos().
Sets the translation component of the transform, relative to the other node.
Definition at line 1781 of file nodePath.cxx.
References get_pos(), get_transform(), is_empty(), set_pos(), and set_transform().
void NodePath::set_fluid_pos | ( | PN_stdfloat | x, |
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Sets the translation component, without changing the "previous" position, so that the collision system will see the node as moving fluidly from its previous position to its new position.
Definition at line 756 of file nodePath.I.
Referenced by set_fluid_pos().
void NodePath::set_fluid_pos | ( | const LVecBase3 & | pos | ) |
Sets the translation component, without changing the "previous" position, so that the collision system will see the node as moving fluidly from its previous position to its new position.
See Also: NodePath::set_pos
Definition at line 1303 of file nodePath.cxx.
References get_transform(), is_empty(), set_pos(), and set_transform().
void NodePath::set_fog | ( | Fog * | fog, |
int | priority = 0 |
||
) |
Sets the geometry at this level and below to render using the indicated fog.
Definition at line 5353 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_fog_off | ( | int | priority = 0 | ) |
Sets the geometry at this level and below to render using no fog.
This is normally the default, but it may be useful to use this to contradict set_fog() at a higher node level (or, with a priority, to override a set_fog() at a lower level).
Definition at line 5369 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_hpr | ( | const NodePath & | other, |
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets the rotation component of the transform, relative to the other node.
Definition at line 1003 of file nodePath.I.
References set_hpr().
Sets the rotation component of the transform, relative to the other node.
Definition at line 1872 of file nodePath.cxx.
References get_transform(), is_empty(), set_hpr(), and set_transform().
void NodePath::set_hpr | ( | PN_stdfloat | h, |
PN_stdfloat | p, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets the rotation component of the transform, leaving translation and scale untouched.
Definition at line 782 of file nodePath.I.
Referenced by SmoothMover::apply_smooth_hpr(), SmoothMover::apply_smooth_pos_hpr(), CLerpNodePathInterval::priv_step(), set_hpr(), and set_tex_hpr().
void NodePath::set_hpr | ( | const LVecBase3 & | hpr | ) |
Sets the rotation component of the transform, leaving translation and scale untouched.
Definition at line 1370 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
Sets the rotation and scale components of the transform, leaving translation untouched.
Definition at line 1588 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
void NodePath::set_hpr_scale | ( | const NodePath & | other, |
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r, | ||
PN_stdfloat | sx, | ||
PN_stdfloat | sy, | ||
PN_stdfloat | sz | ||
) | [inline] |
Sets the rotation and scale components of the transform, leaving translation untouched.
This, or set_pos_hpr_scale, is the preferred way to update a transform when both hpr and scale are to be changed.
Definition at line 1119 of file nodePath.I.
References set_hpr_scale().
void NodePath::set_hpr_scale | ( | const NodePath & | other, |
const LVecBase3 & | hpr, | ||
const LVecBase3 & | scale | ||
) |
Sets the rotation and scale components of the transform, leaving translation untouched.
This, or set_pos_hpr_scale, is the preferred way to update a transform when both hpr and scale are to be changed.
Definition at line 2216 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
void NodePath::set_hpr_scale | ( | PN_stdfloat | h, |
PN_stdfloat | p, | ||
PN_stdfloat | r, | ||
PN_stdfloat | sx, | ||
PN_stdfloat | sy, | ||
PN_stdfloat | sz | ||
) | [inline] |
Sets the rotation and scale components of the transform, leaving translation untouched.
Definition at line 876 of file nodePath.I.
Referenced by CLerpNodePathInterval::priv_step(), and set_hpr_scale().
void NodePath::set_instance_count | ( | int | instance_count | ) |
Sets the geometry instance count, or 0 if geometry instancing should be disabled.
Do not confuse with instanceTo which only applies to animation instancing.
Definition at line 4286 of file nodePath.cxx.
References PandaNode::get_attrib(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_light | ( | const NodePath & | light, |
int | priority = 0 |
||
) |
Adds the indicated Light or PolylightNode to the list of lights that illuminate geometry at this node and below.
The light itself should be parented into the scene graph elsewhere, to represent the light's position in space; but until set_light() is called it will illuminate no geometry.
Definition at line 2720 of file nodePath.cxx.
References PandaNode::as_light(), PandaNode::get_attrib(), PandaNode::get_effect(), get_state(), is_empty(), TypedObject::is_of_type(), node(), PandaNode::set_attrib(), and PandaNode::set_effect().
void NodePath::set_light_off | ( | const NodePath & | light, |
int | priority = 0 |
||
) |
Sets the geometry at this level and below to render without using the indicated Light.
This is different from not specifying the Light; rather, this specifically contradicts set_light() at a higher node level (or, with a priority, overrides a set_light() at a lower level).
This interface does not support PolylightNodes, which cannot be turned off at a lower level.
Definition at line 2808 of file nodePath.cxx.
References PandaNode::as_light(), PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_light_off | ( | int | priority = 0 | ) |
Sets the geometry at this level and below to render using no lights at all.
This is different from not specifying a light; rather, this specifically contradicts set_light() at a higher node level (or, with a priority, overrides a set_light() at a lower level).
If no lights are in effect on a particular piece of geometry, that geometry is rendered with lighting disabled.
Definition at line 2788 of file nodePath.cxx.
References PandaNode::clear_effect(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_mat | ( | const LMatrix4 & | mat | ) |
Directly sets an arbitrary 4x4 transform matrix.
Definition at line 1677 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
Referenced by PGEntry::xform().
Converts the indicated matrix from the other's coordinate space to the local coordinate space, and applies it to the node.
Definition at line 2344 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_material | ( | Material * | mat, |
int | priority = 0 |
||
) |
Sets the geometry at this level and below to render using the indicated material.
Previously, this operation made a copy of the material structure, but nowadays it assigns the pointer directly.
Definition at line 5267 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_material_off | ( | int | priority = 0 | ) |
Sets the geometry at this level and below to render using no material.
This is normally the default, but it may be useful to use this to contradict set_material() at a higher node level (or, with a priority, to override a set_material() at a lower level).
Definition at line 5284 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by FrameRateMeter::setup_window(), and SceneGraphAnalyzerMeter::setup_window().
void NodePath::set_max_search_depth | ( | int | max_search_depth | ) | [inline, static] |
Certain operations, such as find() or find_all_matches(), require a traversal of the scene graph to search for the target node or nodes.
This traversal does not attempt to detect cycles, so an arbitrary cap is set on the depth of the traversal as a poor man's cycle detection, in the event that a cycle has inadvertently been introduced into the scene graph.
There may be other reasons you'd want to truncate a search before the bottom of the scene graph has been reached. In any event, this function sets the limit on the number of levels that a traversal will continue, and hence the maximum length of a path that may be returned by a traversal.
This is a static method, and so changing this parameter affects all of the NodePaths in the universe.
Definition at line 175 of file nodePath.I.
void NodePath::set_name | ( | const string & | name | ) | [inline] |
Changes the name of the referenced node.
Definition at line 2369 of file nodePath.I.
References is_empty(), and node().
Referenced by PfmTrans::process_pfm().
void NodePath::set_normal_map | ( | Texture * | normal_map, |
const string & | texcoord_name = string() , |
||
bool | preserve_color = false |
||
) |
A convenience function to set up a normal map on this geometry.
This uses the single highest-priority light on the object only. It also requires multitexture, and consumes at least two texture stages, in addition to what may already be in use.
The normal_map parameter is the texture that contains the normal map information (with a 3-d delta vector encoded into the r,g,b of each texel). texcoord_name is the name of the texture coordinate set that contains the tangent and binormal we wish to use. If preserve_color is true, then one additional texture stage is consumed to blend in the geometry's original vertex color.
Only one normal map may be in effect through this interface at any given time.
Definition at line 4826 of file nodePath.cxx.
References clear_normal_map(), TexturePool::get_normalization_cube_map(), NodePath(), set_tex_gen(), and set_texture().
void NodePath::set_occluder | ( | const NodePath & | occluder | ) |
Adds the indicated occluder to the list of occluders that apply to geometry at this node and below.
The occluder itself, an OccluderNode, should be parented into the scene graph elsewhere, to represent the occluder's position in space; but until set_occluder() is called it will clip no geometry.
Definition at line 3203 of file nodePath.cxx.
References PandaNode::get_effect(), is_empty(), TypedObject::is_of_type(), node(), and PandaNode::set_effect().
void NodePath::set_pos | ( | const NodePath & | other, |
PN_stdfloat | x, | ||
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Sets the translation component of the transform, relative to the other node.
Definition at line 964 of file nodePath.I.
References set_pos().
Sets the translation component of the transform, relative to the other node.
Definition at line 1725 of file nodePath.cxx.
References get_pos(), get_transform(), is_empty(), node(), PandaNode::reset_prev_transform(), set_pos(), set_pos_hpr_scale_shear(), and set_transform().
void NodePath::set_pos | ( | PN_stdfloat | x, |
PN_stdfloat | y, | ||
PN_stdfloat | z | ||
) | [inline] |
Sets the translation component of the transform, leaving rotation and scale untouched.
This also resets the node's "previous" position, so that the collision system will see the node as having suddenly appeared in the new position, without passing any points in between.
Definition at line 743 of file nodePath.I.
Referenced by SmoothMover::apply_smooth_pos(), SmoothMover::apply_smooth_pos_hpr(), do_billboard_axis(), do_billboard_point_eye(), do_billboard_point_world(), PathFollow::do_follow(), CollisionHandlerFluidPusher::handle_entries(), CLerpNodePathInterval::priv_step(), CConstrainPosInterval::priv_step(), set_fluid_pos(), GeoMipTerrain::set_focal_point(), set_pos(), set_tex_pos(), PathFollow::start(), and AICharacter::update().
void NodePath::set_pos | ( | const LVecBase3 & | pos | ) |
Sets the translation component of the transform, leaving rotation and scale untouched.
This also resets the node's "previous" position, so that the collision system will see the node as having suddenly appeared in the new position, without passing any points in between. See Also: NodePath::set_fluid_pos
Definition at line 1263 of file nodePath.cxx.
References get_transform(), is_empty(), node(), PandaNode::reset_prev_transform(), set_pos(), and set_transform().
Sets the translation and rotation component of the transform, leaving scale untouched.
Definition at line 1556 of file nodePath.cxx.
References get_transform(), is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_pos_hpr | ( | PN_stdfloat | x, |
PN_stdfloat | y, | ||
PN_stdfloat | z, | ||
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets the translation and rotation component of the transform, leaving scale untouched.
Definition at line 865 of file nodePath.I.
Referenced by SmoothMover::handle_wrt_reparent(), CLerpNodePathInterval::priv_step(), and set_pos_hpr().
Sets the translation and rotation component of the transform, relative to the other node.
Definition at line 2138 of file nodePath.cxx.
References TransformState::get_hpr(), TransformState::get_pos(), get_transform(), TransformState::has_components(), is_empty(), node(), PandaNode::reset_prev_transform(), set_pos_hpr_scale_shear(), and set_transform().
void NodePath::set_pos_hpr | ( | const NodePath & | other, |
PN_stdfloat | x, | ||
PN_stdfloat | y, | ||
PN_stdfloat | z, | ||
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets the translation and rotation component of the transform, relative to the other node.
Definition at line 1104 of file nodePath.I.
References set_pos_hpr().
void NodePath::set_pos_hpr_scale | ( | PN_stdfloat | x, |
PN_stdfloat | y, | ||
PN_stdfloat | z, | ||
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r, | ||
PN_stdfloat | sx, | ||
PN_stdfloat | sy, | ||
PN_stdfloat | sz | ||
) | [inline] |
Completely replaces the transform with new translation, rotation, and scale components.
Definition at line 887 of file nodePath.I.
Referenced by CLerpNodePathInterval::priv_step(), and set_pos_hpr_scale().
void NodePath::set_pos_hpr_scale | ( | const NodePath & | other, |
PN_stdfloat | x, | ||
PN_stdfloat | y, | ||
PN_stdfloat | z, | ||
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r, | ||
PN_stdfloat | sx, | ||
PN_stdfloat | sy, | ||
PN_stdfloat | sz | ||
) | [inline] |
Completely replaces the transform with new translation, rotation, and scale components, relative to the other node.
Definition at line 1132 of file nodePath.I.
References set_pos_hpr_scale().
void NodePath::set_pos_hpr_scale | ( | const LVecBase3 & | pos, |
const LVecBase3 & | hpr, | ||
const LVecBase3 & | scale | ||
) |
Replaces the translation, rotation, and scale components, implicitly setting shear to 0.
Definition at line 1618 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_pos_hpr_scale | ( | const NodePath & | other, |
const LVecBase3 & | pos, | ||
const LVecBase3 & | hpr, | ||
const LVecBase3 & | scale | ||
) |
Completely replaces the transform with new translation, rotation, and scale components, relative to the other node, implicitly setting shear to 0.
Definition at line 2258 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_pos_hpr_scale_shear | ( | const LVecBase3 & | pos, |
const LVecBase3 & | hpr, | ||
const LVecBase3 & | scale, | ||
const LVecBase3 & | shear | ||
) |
Completely replaces the transform with new translation, rotation, scale, and shear components.
Definition at line 1648 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
Referenced by CLerpNodePathInterval::priv_step(), set_pos(), and set_pos_hpr().
void NodePath::set_pos_hpr_scale_shear | ( | const NodePath & | other, |
const LVecBase3 & | pos, | ||
const LVecBase3 & | hpr, | ||
const LVecBase3 & | scale, | ||
const LVecBase3 & | shear | ||
) |
Completely replaces the transform with new translation, rotation, scale, and shear components, relative to the other node.
Definition at line 2292 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_pos_quat | ( | const NodePath & | other, |
const LVecBase3 & | pos, | ||
const LQuaternion & | quat | ||
) |
Sets the translation and rotation component of the transform, relative to the other node.
Definition at line 2176 of file nodePath.cxx.
References TransformState::get_pos(), TransformState::get_quat(), get_transform(), TransformState::has_components(), is_empty(), node(), PandaNode::reset_prev_transform(), set_pos_quat_scale_shear(), and set_transform().
void NodePath::set_pos_quat | ( | const LVecBase3 & | pos, |
const LQuaternion & | quat | ||
) |
Sets the translation and rotation component of the transform, leaving scale untouched.
Definition at line 1572 of file nodePath.cxx.
References get_transform(), is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
Referenced by CConstrainPosHprInterval::priv_step(), and CLerpNodePathInterval::priv_step().
void NodePath::set_pos_quat_scale | ( | const LVecBase3 & | pos, |
const LQuaternion & | quat, | ||
const LVecBase3 & | scale | ||
) |
Replaces the translation, rotation, and scale components, implicitly setting shear to 0.
Definition at line 1633 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
Referenced by CLerpNodePathInterval::priv_step().
void NodePath::set_pos_quat_scale | ( | const NodePath & | other, |
const LVecBase3 & | pos, | ||
const LQuaternion & | quat, | ||
const LVecBase3 & | scale | ||
) |
Completely replaces the transform with new translation, rotation, and scale components, relative to the other node, implicitly setting shear to 0.
Definition at line 2275 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_pos_quat_scale_shear | ( | const LVecBase3 & | pos, |
const LQuaternion & | quat, | ||
const LVecBase3 & | scale, | ||
const LVecBase3 & | shear | ||
) |
Completely replaces the transform with new translation, rotation, scale, and shear components.
Definition at line 1663 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
Referenced by CLerpNodePathInterval::priv_step(), and set_pos_quat().
void NodePath::set_pos_quat_scale_shear | ( | const NodePath & | other, |
const LVecBase3 & | pos, | ||
const LQuaternion & | quat, | ||
const LVecBase3 & | scale, | ||
const LVecBase3 & | shear | ||
) |
Completely replaces the transform with new translation, rotation, scale, and shear components, relative to the other node.
Definition at line 2309 of file nodePath.cxx.
References is_empty(), node(), PandaNode::reset_prev_transform(), and set_transform().
void NodePath::set_prev_transform | ( | const TransformState * | transform, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline] |
Sets the transform that represents this node's "previous" position, one frame ago, for the purposes of detecting motion for accurate collision calculations.
Definition at line 715 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_prev_transform().
Referenced by CollisionHandlerFluidPusher::handle_entries(), CLerpNodePathInterval::priv_step(), and wrt_reparent_to().
void NodePath::set_prev_transform | ( | const NodePath & | other, |
const TransformState * | transform, | ||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Sets the "previous" transform object on this node, relative to the other node.
This computes a new transform object that will have the indicated value when seen from the other node.
Definition at line 1234 of file nodePath.cxx.
void NodePath::set_quat | ( | const LQuaternion & | quat | ) |
Sets the rotation component of the transform, leaving translation and scale untouched.
Definition at line 1427 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
Referenced by do_billboard_axis(), do_billboard_point_eye(), do_billboard_point_world(), heads_up(), look_at(), CConstrainHprInterval::priv_step(), CLerpNodePathInterval::priv_step(), and set_quat().
void NodePath::set_quat | ( | const NodePath & | other, |
const LQuaternion & | quat | ||
) |
Sets the rotation component of the transform, relative to the other node.
Definition at line 1946 of file nodePath.cxx.
References get_transform(), is_empty(), set_quat(), and set_transform().
void NodePath::set_quat_scale | ( | const LQuaternion & | quat, |
const LVecBase3 & | scale | ||
) |
Sets the rotation and scale components of the transform, leaving translation untouched.
Definition at line 1603 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
Referenced by CLerpNodePathInterval::priv_step().
void NodePath::set_quat_scale | ( | const NodePath & | other, |
const LQuaternion & | quat, | ||
const LVecBase3 & | scale | ||
) |
Sets the rotation and scale components of the transform, leaving translation untouched.
This, or set_pos_quat_scale, is the preferred way to update a transform when both quat and scale are to be changed.
Definition at line 2237 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
void NodePath::set_render_mode | ( | RenderModeAttrib::Mode | mode, |
PN_stdfloat | thickness, | ||
int | priority = 0 |
||
) |
Sets up the geometry at this level and below (unless overridden) to render in the specified mode and with the indicated line and/or point thickness.
Definition at line 5539 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_render_mode_filled | ( | int | priority = 0 | ) |
Sets up the geometry at this level and below (unless overridden) to render in filled (i.e.
not wireframe) mode.
Definition at line 5480 of file nodePath.cxx.
References get_render_mode_perspective(), get_render_mode_thickness(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_render_mode_perspective | ( | bool | perspective, |
int | priority = 0 |
||
) |
Sets up the point geometry at this level and below to render as perspective sprites (that is, billboarded quads).
The thickness, as specified with set_render_mode_thickness(), is the width of each point in 3-D units, unless it is overridden on a per-vertex basis. This does not affect geometry other than points.
If you want the quads to be individually textured, you should also set a TexGenAttrib::M_point_sprite on the node.
Definition at line 5503 of file nodePath.cxx.
References get_render_mode(), get_render_mode_thickness(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_render_mode_thickness | ( | PN_stdfloat | thickness, |
int | priority = 0 |
||
) |
Sets up the point geometry at this level and below to render as thick points (that is, billboarded quads).
The thickness is in pixels, unless set_render_mode_perspective is also true, in which case it is in 3-D units.
If you want the quads to be individually textured, you should also set a TexGenAttrib::M_point_sprite on the node.
Definition at line 5524 of file nodePath.cxx.
References get_render_mode(), get_render_mode_perspective(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_render_mode_wireframe | ( | int | priority = 0 | ) |
Sets up the geometry at this level and below (unless overridden) to render in wireframe mode.
Definition at line 5465 of file nodePath.cxx.
References get_render_mode_perspective(), get_render_mode_thickness(), is_empty(), node(), and PandaNode::set_attrib().
Referenced by PandaFramework::open_framework().
void NodePath::set_sa | ( | PN_stdfloat | sa | ) | [inline] |
Sets the alpha scale component of the transform.
Definition at line 1242 of file nodePath.I.
References get_color_scale(), and set_color_scale().
void NodePath::set_sb | ( | PN_stdfloat | sb | ) | [inline] |
Sets the blue scale component of the transform.
Definition at line 1229 of file nodePath.I.
References get_color_scale(), and set_color_scale().
void NodePath::set_scale | ( | const NodePath & | other, |
PN_stdfloat | sx, | ||
PN_stdfloat | sy, | ||
PN_stdfloat | sz | ||
) | [inline] |
Sets the scale component of the transform, relative to the other node.
Definition at line 1040 of file nodePath.I.
References set_scale().
Sets the scale component of the transform, relative to the other node.
Definition at line 1994 of file nodePath.cxx.
References get_transform(), is_empty(), set_scale(), and set_transform().
void NodePath::set_scale | ( | const LVecBase3 & | scale | ) |
Sets the scale component of the transform, leaving translation and rotation untouched.
Definition at line 1452 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
void NodePath::set_scale | ( | const NodePath & | other, |
PN_stdfloat | scale | ||
) | [inline] |
Sets the scale component of the transform, relative to the other node.
Definition at line 1029 of file nodePath.I.
References set_scale().
void NodePath::set_scale | ( | PN_stdfloat | scale | ) | [inline] |
Sets the scale component of the transform, leaving translation and rotation untouched.
Definition at line 808 of file nodePath.I.
Referenced by MayaPview::doIt(), CLerpNodePathInterval::priv_step(), set_scale(), and set_tex_scale().
void NodePath::set_scissor | ( | const LPoint3 & | a, |
const LPoint3 & | b, | ||
const LPoint3 & | c, | ||
const LPoint3 & | d | ||
) |
Sets up a scissor region on the nodes rendered at this level and below.
The four points are understood to be relative to this node. When these points are projected into screen space, they define the bounding volume of the scissor region (the scissor region is the smallest onscreen rectangle that encloses all four points).
Definition at line 3334 of file nodePath.cxx.
References set_effect().
Sets up a scissor region on the nodes rendered at this level and below.
The two points are understood to be relative to this node. When these points are projected into screen space, they define the diagonally-opposite points that determine the scissor region.
Definition at line 3318 of file nodePath.cxx.
References set_effect().
void NodePath::set_scissor | ( | PN_stdfloat | left, |
PN_stdfloat | right, | ||
PN_stdfloat | bottom, | ||
PN_stdfloat | top | ||
) |
Sets up a scissor region on the nodes rendered at this level and below.
The four coordinates are understood to define a rectangle in screen space. These numbers are relative to the current DisplayRegion, where (0,0) is the lower-left corner of the DisplayRegion, and (1,1) is the upper-right corner.
Definition at line 3303 of file nodePath.cxx.
References set_effect().
Sets up a scissor region on the nodes rendered at this level and below.
The two points are understood to be relative to the indicated other node. When these points are projected into screen space, they define the diagonally-opposite points that determine the scissor region.
Definition at line 3350 of file nodePath.cxx.
References set_effect().
void NodePath::set_scissor | ( | const NodePath & | other, |
const LPoint3 & | a, | ||
const LPoint3 & | b, | ||
const LPoint3 & | c, | ||
const LPoint3 & | d | ||
) |
Sets up a scissor region on the nodes rendered at this level and below.
The four points are understood to be relative to the indicated other node. When these points are projected into screen space, they define the bounding volume of the scissor region (the scissor region is the smallest onscreen rectangle that encloses all four points).
Definition at line 3366 of file nodePath.cxx.
References set_effect().
void NodePath::set_sg | ( | PN_stdfloat | sg | ) | [inline] |
Sets the alpha scale component of the transform.
Definition at line 1216 of file nodePath.I.
References get_color_scale(), and set_color_scale().
void NodePath::set_shader_auto | ( | BitMask32 | shader_switch, |
int | priority = 0 |
||
) |
overloaded for auto shader customization
Definition at line 3828 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_shear | ( | PN_stdfloat | shxy, |
PN_stdfloat | shxz, | ||
PN_stdfloat | shyz | ||
) | [inline] |
Sets the shear component of the transform, leaving translation, rotation, and scale untouched.
Definition at line 839 of file nodePath.I.
Referenced by CLerpNodePathInterval::priv_step(), and set_shear().
void NodePath::set_shear | ( | const LVecBase3 & | shear | ) |
Sets the shear component of the transform, leaving translation and rotation untouched.
Definition at line 1504 of file nodePath.cxx.
References get_transform(), is_empty(), and set_transform().
void NodePath::set_shear | ( | const NodePath & | other, |
PN_stdfloat | shxy, | ||
PN_stdfloat | shxz, | ||
PN_stdfloat | shyz | ||
) | [inline] |
Sets the shear component of the transform, relative to the other node.
Definition at line 1072 of file nodePath.I.
References set_shear().
Sets the shear component of the transform, relative to the other node.
Definition at line 2066 of file nodePath.cxx.
References get_transform(), is_empty(), set_shear(), and set_transform().
void NodePath::set_sr | ( | PN_stdfloat | sr | ) | [inline] |
Sets the red scale component of the transform.
Definition at line 1203 of file nodePath.I.
References get_color_scale(), and set_color_scale().
void NodePath::set_state | ( | const NodePath & | other, |
const RenderState * | state, | ||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Sets the state object on this node, relative to the other node.
This computes a new state object that will have the indicated value when seen from the other node.
Definition at line 1062 of file nodePath.cxx.
void NodePath::set_state | ( | const RenderState * | state, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline] |
Changes the complete state object on this node.
Definition at line 503 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_state().
Referenced by NodePathCollection::compose_color_scale(), CLerpNodePathInterval::priv_step(), NodePathCollection::set_attrib(), NodePathCollection::set_color_scale(), NodePathCollection::set_texture(), and NodePathCollection::set_texture_off().
void NodePath::set_tag | ( | const string & | key, |
const string & | value | ||
) | [inline] |
Associates a user-defined value with a user-defined key which is stored on the node.
This value has no meaning to Panda; but it is stored indefinitely on the node until it is requested again.
Each unique key stores a different string value. There is no effective limit on the number of different keys that may be stored or on the length of any one key's value.
Definition at line 2161 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_tag().
void NodePath::set_tex_gen | ( | TextureStage * | stage, |
RenderAttrib::TexGenMode | mode, | ||
const string & | source_name, | ||
const NodePath & | light, | ||
int | priority = 0 |
||
) |
Enables automatic texture coordinate generation for the indicated texture stage.
This version of this method is useful when setting M_light_vector, which requires the name of the texture coordinate set that supplies the tangent and binormal, as well as the specific light to generate coordinates for.
Definition at line 4502 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_tex_gen | ( | TextureStage * | stage, |
RenderAttrib::TexGenMode | mode, | ||
const LTexCoord3 & | constant_value, | ||
int | priority = 0 |
||
) |
Enables automatic texture coordinate generation for the indicated texture stage.
This version of this method is useful when setting M_constant, which requires a constant texture coordinate value.
Definition at line 4532 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_tex_gen | ( | TextureStage * | stage, |
RenderAttrib::TexGenMode | mode, | ||
int | priority = 0 |
||
) |
Enables automatic texture coordinate generation for the indicated texture stage.
Definition at line 4471 of file nodePath.cxx.
References PandaNode::get_attrib(), get_state(), is_empty(), node(), and PandaNode::set_attrib().
Referenced by project_texture(), and set_normal_map().
void NodePath::set_tex_hpr | ( | const NodePath & | other, |
TextureStage * | stage, | ||
const LVecBase3 & | hpr | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1745 of file nodePath.I.
References is_empty(), set_hpr(), and set_tex_transform().
void NodePath::set_tex_hpr | ( | TextureStage * | stage, |
const LVecBase3 & | hpr | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1479 of file nodePath.I.
References is_empty(), set_hpr(), and set_tex_transform().
void NodePath::set_tex_hpr | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1731 of file nodePath.I.
References set_tex_hpr().
void NodePath::set_tex_hpr | ( | TextureStage * | stage, |
PN_stdfloat | h, | ||
PN_stdfloat | p, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated rotation, as a 3-D HPR, to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1465 of file nodePath.I.
Referenced by set_tex_hpr().
void NodePath::set_tex_offset | ( | TextureStage * | stage, |
const LVecBase2 & | uv | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1313 of file nodePath.I.
References is_empty(), and set_tex_transform().
void NodePath::set_tex_offset | ( | TextureStage * | stage, |
PN_stdfloat | u, | ||
PN_stdfloat | v | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1299 of file nodePath.I.
Referenced by set_tex_offset().
void NodePath::set_tex_offset | ( | const NodePath & | other, |
TextureStage * | stage, | ||
const LVecBase2 & | uv | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1579 of file nodePath.I.
References is_empty(), and set_tex_transform().
void NodePath::set_tex_offset | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | u, | ||
PN_stdfloat | v | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1565 of file nodePath.I.
References set_tex_offset().
void NodePath::set_tex_pos | ( | TextureStage * | stage, |
const LVecBase3 & | uvw | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1449 of file nodePath.I.
References is_empty(), set_pos(), and set_tex_transform().
void NodePath::set_tex_pos | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | u, | ||
PN_stdfloat | v, | ||
PN_stdfloat | w | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1702 of file nodePath.I.
References set_tex_pos().
void NodePath::set_tex_pos | ( | TextureStage * | stage, |
PN_stdfloat | u, | ||
PN_stdfloat | v, | ||
PN_stdfloat | w | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1436 of file nodePath.I.
Referenced by set_tex_pos().
void NodePath::set_tex_pos | ( | const NodePath & | other, |
TextureStage * | stage, | ||
const LVecBase3 & | uvw | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated offset to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1715 of file nodePath.I.
References is_empty(), set_pos(), and set_tex_transform().
void NodePath::set_tex_projector | ( | TextureStage * | stage, |
const NodePath & | from, | ||
const NodePath & | to | ||
) |
Establishes a TexProjectorEffect on this node, which can be used to establish projective texturing (but see also the NodePath::project_texture() convenience function), or it can be used to bind this node's texture transform to particular node's position in space, allowing a LerpInterval (for instance) to adjust this node's texture coordinates.
Definition at line 4666 of file nodePath.cxx.
References PandaNode::get_effect(), is_empty(), node(), and PandaNode::set_effect().
Referenced by project_texture().
void NodePath::set_tex_rotate | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | r | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated rotation, clockwise in degrees, to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1596 of file nodePath.I.
References is_empty(), and set_tex_transform().
void NodePath::set_tex_rotate | ( | TextureStage * | stage, |
PN_stdfloat | r | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated rotation, clockwise in degrees, to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1330 of file nodePath.I.
References is_empty(), and set_tex_transform().
void NodePath::set_tex_scale | ( | TextureStage * | stage, |
PN_stdfloat | su, | ||
PN_stdfloat | sv | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1362 of file nodePath.I.
References set_tex_scale().
void NodePath::set_tex_scale | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | scale | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage.
This call is appropriate for 2-d or 3-d texture coordinates.
Definition at line 1612 of file nodePath.I.
References is_empty(), set_scale(), and set_tex_transform().
void NodePath::set_tex_scale | ( | const NodePath & | other, |
TextureStage * | stage, | ||
const LVecBase2 & | scale | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1642 of file nodePath.I.
References is_empty(), and set_tex_transform().
void NodePath::set_tex_scale | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | su, | ||
PN_stdfloat | sv | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1628 of file nodePath.I.
References set_tex_scale().
void NodePath::set_tex_scale | ( | TextureStage * | stage, |
PN_stdfloat | su, | ||
PN_stdfloat | sv, | ||
PN_stdfloat | sw | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1494 of file nodePath.I.
References set_tex_scale().
void NodePath::set_tex_scale | ( | TextureStage * | stage, |
PN_stdfloat | scale | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage.
This call is appropriate for 2-d or 3-d texture coordinates.
Definition at line 1346 of file nodePath.I.
References is_empty(), set_scale(), and set_tex_transform().
Referenced by set_tex_scale().
void NodePath::set_tex_scale | ( | const NodePath & | other, |
TextureStage * | stage, | ||
const LVecBase3 & | scale | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1773 of file nodePath.I.
References is_empty(), set_scale(), and set_tex_transform().
void NodePath::set_tex_scale | ( | TextureStage * | stage, |
const LVecBase3 & | scale | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1507 of file nodePath.I.
References is_empty(), set_scale(), and set_tex_transform().
void NodePath::set_tex_scale | ( | const NodePath & | other, |
TextureStage * | stage, | ||
PN_stdfloat | su, | ||
PN_stdfloat | sv, | ||
PN_stdfloat | sw | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UVW's for the given stage.
This call is appropriate for 3-d texture coordinates.
Definition at line 1760 of file nodePath.I.
References set_tex_scale().
void NodePath::set_tex_scale | ( | TextureStage * | stage, |
const LVecBase2 & | scale | ||
) | [inline] |
Sets a texture matrix on the current node to apply the indicated scale to UV's for the given stage.
This call is appropriate for ordinary 2-d texture coordinates.
Definition at line 1376 of file nodePath.I.
References is_empty(), and set_tex_transform().
void NodePath::set_tex_transform | ( | const NodePath & | other, |
TextureStage * | stage, | ||
const TransformState * | transform | ||
) |
Sets the texture matrix on the current node to the indicated transform for the given stage.
Definition at line 4410 of file nodePath.cxx.
References get_parent(), get_state(), has_parent(), is_empty(), node(), NodePath(), and PandaNode::set_attrib().
void NodePath::set_tex_transform | ( | TextureStage * | stage, |
const TransformState * | transform | ||
) |
Sets the texture matrix on the current node to the indicated transform for the given stage.
Definition at line 4308 of file nodePath.cxx.
References PandaNode::get_attrib(), is_empty(), node(), and PandaNode::set_attrib().
Referenced by set_tex_hpr(), set_tex_offset(), set_tex_pos(), set_tex_rotate(), and set_tex_scale().
void NodePath::set_texture | ( | TextureStage * | stage, |
Texture * | tex, | ||
int | priority = 0 |
||
) |
Adds the indicated texture to the list of textures that will be rendered on the indicated multitexture stage.
If there are multiple texture stages specified (possibly on multiple different nodes at different levels), they will all be applied to geometry together, according to the stage specification set up in the TextureStage object.
Definition at line 3524 of file nodePath.cxx.
References PandaNode::get_attrib(), RenderState::get_override(), PandaNode::get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_texture | ( | Texture * | tex, |
int | priority = 0 |
||
) |
Adds the indicated texture to the list of textures that will be rendered on the default texture stage.
This is the convenience single-texture variant of this method; it is now superceded by set_texture() that accepts a stage and texture. You may use this method if you just want to adjust the default stage.
Definition at line 3506 of file nodePath.cxx.
References TextureStage::get_default(), and is_empty().
Referenced by GraphicsOutput::get_texture_card(), PfmTrans::process_pfm(), project_texture(), set_normal_map(), and NodePathCollection::set_texture().
void NodePath::set_texture_off | ( | int | priority = 0 | ) |
Sets the geometry at this level and below to render using no texture, on any stage.
This is different from not specifying a texture; rather, this specifically contradicts set_texture() at a higher node level (or, with a priority, overrides a set_texture() at a lower level).
Definition at line 3555 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by PandaFramework::open_framework(), and NodePathCollection::set_texture_off().
void NodePath::set_texture_off | ( | TextureStage * | stage, |
int | priority = 0 |
||
) |
Sets the geometry at this level and below to render using no texture, on the indicated stage.
This is different from not specifying a texture; rather, this specifically contradicts set_texture() at a higher node level (or, with a priority, overrides a set_texture() at a lower level).
Definition at line 3571 of file nodePath.cxx.
References PandaNode::get_attrib(), RenderState::get_override(), PandaNode::get_state(), is_empty(), node(), and PandaNode::set_attrib().
void NodePath::set_transform | ( | const TransformState * | transform, |
Thread * | current_thread = Thread::get_current_thread() |
||
) | [inline] |
Changes the complete transform object on this node.
Definition at line 678 of file nodePath.I.
References is_empty(), node(), and PandaNode::set_transform().
Referenced by clear_transform(), CollisionHandlerPusher::handle_entries(), CollisionHandlerGravity::handle_entries(), CollisionHandlerFloor::handle_entries(), CConstrainTransformInterval::priv_step(), set_fluid_pos(), set_hpr(), set_hpr_scale(), set_mat(), set_pos(), set_pos_hpr(), set_pos_hpr_scale(), set_pos_hpr_scale_shear(), set_pos_quat(), set_pos_quat_scale(), set_pos_quat_scale_shear(), set_quat(), set_quat_scale(), set_scale(), set_shear(), set_transform(), PhysxActor::update_transform(), wrt_reparent_to(), and PGItem::xform().
void NodePath::set_transform | ( | const NodePath & | other, |
const TransformState * | transform, | ||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Sets the transform object on this node, relative to the other node.
This computes a new transform object that will have the indicated value when seen from the other node.
Definition at line 1154 of file nodePath.cxx.
References get_parent(), get_transform(), has_parent(), is_empty(), NodePath(), and set_transform().
void NodePath::set_transparency | ( | TransparencyAttrib::Mode | mode, |
int | priority = 0 |
||
) |
Specifically sets or disables transparent rendering mode on this particular node.
If no other nodes override, this will cause items with a non-1 value for alpha color to be rendered partially transparent.
Definition at line 6134 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by PfmTrans::process_pfm().
void NodePath::set_two_sided | ( | bool | two_sided, |
int | priority = 0 |
||
) |
Specifically sets or disables two-sided rendering mode on this particular node.
If no other nodes override, this will cause backfacing polygons to be drawn (in two-sided mode, true) or culled (in one-sided mode, false).
Definition at line 5643 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_attrib().
Referenced by NonlinearImager::add_viewer(), MultitexReducer::flatten(), FrameRateMeter::setup_window(), and SceneGraphAnalyzerMeter::setup_window().
void NodePath::show | ( | DrawMask | camera_mask | ) | [inline] |
Makes the referenced node visible just to the cameras whose camera_mask shares the indicated bits.
This undoes the effect of a previous hide() call. It will not reveal the node if a parent node has been hidden. However, see show_through().
Definition at line 1926 of file nodePath.I.
References PandaNode::adjust_draw_mask(), BitMask< PN_uint32, 32 >::all_off(), is_empty(), and node().
void NodePath::show | ( | ) | [inline] |
Undoes the effect of a previous hide() on this node: makes the referenced node (and the entire subgraph below this node) visible to all cameras.
This will not reveal the node if a parent node has been hidden.
Definition at line 1910 of file nodePath.I.
References PandaNode::adjust_draw_mask(), BitMask< PN_uint32, 32 >::all_off(), PandaNode::get_overall_bit(), is_empty(), and node().
Referenced by ShowInterval::priv_instant(), HideInterval::priv_reverse_instant(), NodePathCollection::show(), and PandaFramework::show_collision_solids().
void NodePath::show_bounds | ( | ) |
Causes the bounding volume of the bottom node and all of its descendants (that is, the bounding volume associated with the the bottom arc) to be rendered, if possible.
The rendering method is less than optimal; this is intended primarily for debugging.
Definition at line 6612 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_effect().
Referenced by PandaFramework::set_highlight().
void NodePath::show_through | ( | ) | [inline] |
Makes the referenced node visible just to the cameras whose camera_mask shares the indicated bits.
Unlike show(), this will reveal the node even if a parent node has been hidden, thus "showing through" a parent's hide().
Definition at line 1943 of file nodePath.I.
References PandaNode::adjust_draw_mask(), BitMask< PN_uint32, 32 >::all_off(), PandaNode::get_overall_bit(), is_empty(), and node().
void NodePath::show_through | ( | DrawMask | camera_mask | ) | [inline] |
Makes the referenced node visible just to the cameras whose camera_mask shares the indicated bits.
Unlike show(), this will reveal the node even if a parent node has been hidden via the one-parameter hide() method, thus "showing through" a parent's hide(). (However, it will not show through a parent's hide() call if the no-parameter form of hide() was used.)
Definition at line 1962 of file nodePath.I.
References PandaNode::adjust_draw_mask(), BitMask< PN_uint32, 32 >::all_off(), is_empty(), and node().
void NodePath::show_tight_bounds | ( | ) |
Similar to show_bounds(), this draws a bounding box representing the "tight" bounds of this node and all of its descendants.
The bounding box is recomputed every frame by reexamining all of the vertices; this is far from efficient, but this is intended for debugging.
Definition at line 6628 of file nodePath.cxx.
References is_empty(), node(), and PandaNode::set_effect().
void NodePath::stash | ( | int | sort = 0 , |
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Removes the referenced node (and the entire subgraph below this node) from the scene graph in any normal sense.
The node will no longer be visible and is not tested for collisions; furthermore, no normal scene graph traversal will visit the node. The node's bounding volume no longer contributes to its parent's bounding volume.
A stashed node cannot be located by a normal find() operation (although a special find string can still retrieve it).
Definition at line 6415 of file nodePath.cxx.
References Thread::get_pipeline_stage(), is_empty(), is_singleton(), and verify_complete().
Referenced by NodePathCollection::stash().
void NodePath::stash_to | ( | const NodePath & | other, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Similar to reparent_to(), but the node is added to its new parent's stashed list, so that the result is equivalent to calling reparent_to() immediately followed by stash().
Definition at line 707 of file nodePath.cxx.
References Thread::get_pipeline_stage(), is_empty(), node(), PandaNode::reset_prev_transform(), and verify_complete().
void NodePath::unify_texture_stages | ( | TextureStage * | stage | ) |
Searches through all TextureStages at this node and below.
Any TextureStages that share the same name as the indicated TextureStage object are replaced with this object, thus ensuring that all geometry at this node and below with a particular TextureStage name is using the same TextureStage object.
Definition at line 5164 of file nodePath.cxx.
References is_empty(), and node().
void NodePath::unstash | ( | int | sort = 0 , |
Thread * | current_thread = Thread::get_current_thread() |
||
) |
Undoes the effect of a previous stash() on this node: makes the referenced node (and the entire subgraph below this node) once again part of the scene graph.
Definition at line 6435 of file nodePath.cxx.
References Thread::get_pipeline_stage(), is_empty(), is_singleton(), and verify_complete().
Referenced by instance_to(), NodePathCollection::unstash(), and unstash_all().
void NodePath::unstash_all | ( | Thread * | current_thread = Thread::get_current_thread() | ) |
Unstashes this node and all stashed child nodes.
Definition at line 6452 of file nodePath.cxx.
References find_all_matches(), unstash(), and NodePathCollection::unstash().
bool NodePath::verify_complete | ( | Thread * | current_thread = Thread::get_current_thread() | ) | const |
Returns true if all of the nodes described in the NodePath are connected, or false otherwise.
Definition at line 6498 of file nodePath.cxx.
References PandaNode::find_parent(), NodePathComponent::get_length(), NodePathComponent::get_next(), NodePathComponent::get_node(), Thread::get_pipeline_stage(), is_empty(), Thread::is_true_threads(), and node().
Referenced by attach_new_node(), copy_to(), find_all_matches(), find_all_paths_to(), instance_to(), reparent_to(), stash(), stash_to(), unstash(), and wrt_reparent_to().
bool NodePath::write_bam_file | ( | const Filename & | filename | ) | const |
Writes the contents of this node and below out to a bam file with the indicated filename.
This file may then be read in again, as is, at some later point. Returns true if successful, false on some kind of error.
Definition at line 6937 of file nodePath.cxx.
References BamFile::close(), is_empty(), node(), BamFile::open_write(), and BamFile::write_object().
Referenced by MayaPview::doIt().
bool NodePath::write_bam_stream | ( | ostream & | out | ) | const |
Writes the contents of this node and below out to the indicated stream.
Definition at line 6960 of file nodePath.cxx.
References BamFile::close(), is_empty(), node(), BamFile::open_write(), and BamFile::write_object().
void NodePath::write_bounds | ( | ostream & | out | ) | const |
Writes a description of the bounding volume containing the bottom node and all of its descendants to the indicated output stream.
Definition at line 6689 of file nodePath.cxx.
void NodePath::wrt_reparent_to | ( | const NodePath & | other, |
int | sort = 0 , |
||
Thread * | current_thread = Thread::get_current_thread() |
||
) |
This functions identically to reparent_to(), except the transform on this node is also adjusted so that the node remains in the same place in world coordinates, even if it is reparented into a different coordinate system.
Definition at line 732 of file nodePath.cxx.
References get_prev_transform(), get_transform(), is_empty(), node(), reparent_to(), PandaNode::reset_prev_transform(), set_prev_transform(), set_transform(), and verify_complete().
Referenced by NodePathCollection::wrt_reparent_to().