GPUCommand

from panda3d._rplight import GPUCommand
class GPUCommand

Bases:

This class can be seen like a packet, to be transferred to the GPU. It has a command type, which tells the GPU what to do once it recieved this “packet”. It stores a limited amount of floating point components.

Inheritance diagram

Inheritance diagram of GPUCommand

enum CommandType

The different types of GPUCommands. Each type has a special case in the command queue processor. When adding new types, those need to be handled in the command target, too.

enumerator CMD_invalid = 0
enumerator CMD_store_light = 1
enumerator CMD_remove_light = 2
enumerator CMD_store_source = 3
enumerator CMD_remove_sources = 4
__init__(param0: GPUCommand)
__init__(command_type: CommandType)

This will construct a new GPUCommand of the given command type. The command type should be of GPUCommand::CommandType, and determines what data the GPUCommand contains, and how it will be handled.

static get_uses_integer_packing() → bool

This returns how integer are packed into the data stream. If the returned value is true, then integers are packed using their binary representation converted to floating point format. If the returned value is false, then integers are packed by simply casting them to float, e.g. val = (float)i;

push_float(v: float)

This adds an integer to the back of the GPUCommand. Its used by all other push_xxx methods, and simply stores the value, then increments the write pointer. When the amount of floats exceeds the capacity of the GPUCommand, an error will be printed, and the method returns without doing anything else.

push_int(v: int)

This adds an integer to the back of the GPUCommand. Depending on the setting in convert_int_to_float, this will either just convert the int to a float by casting it, or just do a bitwise copy.

push_mat3(v: panda3d.core.LMatrix3)

This appends a floating point 3x3 matrix to the GPUCommand, by pushing all components in row-order to the command. This occupies a space of 9 floats.

push_mat4(v: panda3d.core.LMatrix4)

This appends a floating point 4x4 matrix to the GPUCommand, by pushing all components in row-order to the command. This occupies a space of 16 floats.

push_vec3(v: panda3d.core.LVecBase3)

This appends a 3-component floating point vector to the command. It basically just calls push_float() for every component, in the order x, y, z, which causes the vector to occupy the space of 3 floats.

push_vec3(v: panda3d.core.LVecBase3i)

This appends a 3-component integer vector to the command. It basically just calls push_int() for every component, in the order x, y, z, which causes the vector to occupy the space of 3 floats.

push_vec4(v: panda3d.core.LVecBase4)

This appends a 4-component floating point vector to the command. It basically just calls push_float() for every component, in the order x, y, z, which causes the vector to occupy the space of 3 floats.

push_vec4(v: panda3d.core.LVecBase4i)

This appends a 4-component integer vector to the command. It basically just calls push_int() for every component, in the order x, y, z, w, which causes the vector to occupy the space of 4 floats.

write(out: panda3d.core.ostream)

This method prints the type, size, and data of the GPUCommand to the console. This helps for debugging the contents of the GPUCommand. Keep in mind that integers might be shown in their binary float representation, depending on the setting in the GPUCommand::convert_int_to_float method.

write_to(dest: panda3d.core.PTA_uchar, command_index: int)

This method writes all the data of the GPU command to a given target. The target should be a pointer to memory being big enough to hold the data. Presumably #dest will be a handle to texture memory. The command_index controls the offset where the data will be written to.

its data to command_index * GPU_COMMAND_ENTRIES. When writing the GPUCommand in a GPUCommandList, the command_index will most likely be the index of the command in the list.