TheCloud/panda3d
1
0
Fork 0
mirror of https://github.com/panda3d/panda3d.git synced 2025-10-01 09:23:03 -04:00
Code Issues Packages Projects Releases Wiki Activity

pgraph: API reference improvements for NodePath

Browse Source
This commit is contained in:
rdb 2021-02-21 10:15:33 +01:00
parent 3592404fa8
commit a05405c475
2 changed files with 58 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
panda/src/pgraph/nodePath.I
View File

@ -998,7 +998,8 @@ compose_color_scale(PN_stdfloat sr, PN_stdfloat sg, PN_stdfloat sb, PN_stdfloat
}
/**
* Sets the red scale component of the transform
* Sets the red component of the color scale.
* @see set_color_scale()
*/
INLINE void NodePath::
set_sr(PN_stdfloat sr) {
@ -1009,7 +1010,8 @@ set_sr(PN_stdfloat sr) {
}
/**
* Sets the alpha scale component of the transform
* Sets the green component of the color scale.
* @see set_color_scale()
*/
INLINE void NodePath::
set_sg(PN_stdfloat sg) {
@ -1020,7 +1022,8 @@ set_sg(PN_stdfloat sg) {
}
/**
* Sets the blue scale component of the transform
* Sets the blue component of the color scale.
* @see set_color_scale()
*/
INLINE void NodePath::
set_sb(PN_stdfloat sb) {
@ -1031,7 +1034,8 @@ set_sb(PN_stdfloat sb) {
}
/**
* Sets the alpha scale component of the transform
* Sets the alpha component of the color scale.
* @see set_color_scale()
*/
INLINE void NodePath::
set_sa(PN_stdfloat sa) {
@ -1042,7 +1046,8 @@ set_sa(PN_stdfloat sa) {
}
/**
* Gets the red scale component of the transform
* Gets the red component of the color scale.
* @see get_color_scale()
*/
INLINE PN_stdfloat NodePath::
get_sr() const {
@ -1050,7 +1055,8 @@ get_sr() const {
}
/**
* Gets the green scale component of the transform
* Gets the green component of the color scale.
* @see get_color_scale()
*/
INLINE PN_stdfloat NodePath::
get_sg() const {
@ -1058,7 +1064,8 @@ get_sg() const {
}
/**
* Gets the blue scale component of the transform
* Gets the blue component of the color scale.
* @see get_color_scale()
*/
INLINE PN_stdfloat NodePath::
get_sb() const {
@ -1066,7 +1073,8 @@ get_sb() const {
}
/**
* Gets the alpha scale component of the transform
* Gets the alpha component of the color scale.
* @see get_color_scale()
*/
INLINE PN_stdfloat NodePath::
get_sa() const {
@ -1838,6 +1846,8 @@ show_through(DrawMask camera_mask) {
* 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.
*
* To undo this, call show().
*/
INLINE void NodePath::
hide() {

40
panda/src/pgraph/nodePath.cxx
View File

@ -959,6 +959,11 @@ set_pos(const LVecBase3 &pos) {
node()->reset_prev_transform();
}
/**
* Sets the X component of the position transform, leaving other components
* untouched.
* @see set_pos()
*/
void NodePath::
set_x(PN_stdfloat x) {
nassertv_always(!is_empty());
@ -967,6 +972,11 @@ set_x(PN_stdfloat x) {
set_pos(pos);
}
/**
* Sets the Y component of the position transform, leaving other components
* untouched.
* @see set_pos()
*/
void NodePath::
set_y(PN_stdfloat y) {
nassertv_always(!is_empty());
@ -975,6 +985,11 @@ set_y(PN_stdfloat y) {
set_pos(pos);
}
/**
* Sets the Z component of the position transform, leaving other components
* untouched.
* @see set_pos()
*/
void NodePath::
set_z(PN_stdfloat z) {
nassertv_always(!is_empty());
@ -1127,6 +1142,11 @@ set_scale(const LVecBase3 &scale) {
set_transform(transform->set_scale(scale));
}
/**
* Sets the x-scale component of the transform, leaving other components
* untouched.
* @see set_scale()
*/
void NodePath::
set_sx(PN_stdfloat sx) {
nassertv_always(!is_empty());
@ -1136,6 +1156,11 @@ set_sx(PN_stdfloat sx) {
set_transform(transform->set_scale(scale));
}
/**
* Sets the y-scale component of the transform, leaving other components
* untouched.
* @see set_scale()
*/
void NodePath::
set_sy(PN_stdfloat sy) {
nassertv_always(!is_empty());
@ -1145,6 +1170,11 @@ set_sy(PN_stdfloat sy) {
set_transform(transform->set_scale(scale));
}
/**
* Sets the z-scale component of the transform, leaving other components
* untouched.
* @see set_scale()
*/
void NodePath::
set_sz(PN_stdfloat sz) {
nassertv_always(!is_empty());
@ -4214,6 +4244,8 @@ get_material() const {
/**
* Recursively searches the scene graph for references to the given material,
* and replaces them with the new material.
*
* @since 1.10.0
*/
void NodePath::
replace_material(Material *mat, Material *new_mat) {
@ -4936,6 +4968,8 @@ get_transparency() const {
* Specifically sets or disables a logical operation on this particular node.
* If no other nodes override, this will cause geometry to be rendered without
* color blending but instead using the given logical operator.
*
* @since 1.10.0
*/
void NodePath::
set_logic_op(LogicOpAttrib::Operation op, int priority) {
@ -4948,6 +4982,8 @@ set_logic_op(LogicOpAttrib::Operation op, int priority) {
* Completely removes any logical operation that may have been set on this
* node via set_logic_op(). The geometry at this level and below will
* subsequently be rendered using standard color blending.
*
* @since 1.10.0
*/
void NodePath::
clear_logic_op() {
@ -4960,6 +4996,8 @@ clear_logic_op() {
* particular node via set_logic_op(). If this returns true, then
* get_logic_op() may be called to determine whether a logical operation has
* been explicitly disabled for this node or set to particular operation.
*
* @since 1.10.0
*/
bool NodePath::
has_logic_op() const {
@ -4974,6 +5012,8 @@ has_logic_op() const {
* has_logic_op(). This does not necessarily imply that the geometry will
* or will not be rendered with the given logical operation, as there may be
* other nodes that override.
*
* @since 1.10.0
*/
LogicOpAttrib::Operation NodePath::
get_logic_op() const {