Panda3D
|
This is the highest level of grouping for TextureImages. More...
#include "paletteGroup.h"
Public Member Functions | |
void | add_texture_swap_info (const string sourceTextureName, const vector_string &swapTextures) |
Store textureswap information from textures.txa. More... | |
void | clear_depends () |
Eliminates all the dependency information for this group. More... | |
virtual int | complete_pointers (TypedWritable **p_list, BamReader *manager) |
Called after the object is otherwise completely read from a Bam file, this function's job is to store the pointers that were retrieved from the Bam file for each pointer object written. More... | |
virtual void | finalize (BamReader *manager) |
This method is called by the BamReader after all pointers everywhere in the world have been completely read in. More... | |
void | get_complete_placements (pvector< TexturePlacement *> &placements) const |
Adds the set of TexturePlacements associated with this group and all dependent groups to the indicated vector. More... | |
int | get_dependency_level () const |
Returns the dependency level of this group. More... | |
int | get_dependency_order () const |
Returns the dependency order of this group. More... | |
const string & | get_dirname () const |
Returns the directory name associated with the palette group. More... | |
int | get_dirname_order () const |
Returns the dependency order of this group. More... | |
int | get_egg_count () const |
Returns the number of egg files that share this PaletteGroup. More... | |
const PaletteGroups & | get_groups () const |
Returns the set of groups this group depends on. More... | |
int | get_margin_override () const |
Returns the set of groups this group depends on. More... | |
PalettePage * | get_page (const TextureProperties &properties) |
Returns the page associated with the indicated properties. More... | |
void | get_placements (pvector< TexturePlacement *> &placements) const |
Adds the set of TexturePlacements associated with this group to the indicated vector. More... | |
virtual TypeHandle | get_type () const |
void | group_with (PaletteGroup *other) |
Indicates a dependency of this group on some other group. More... | |
bool | has_dirname () const |
Returns true if the directory name has been explicitly set for this group. More... | |
bool | has_margin_override () const |
Returns the set of groups this group depends on. More... | |
void | increment_egg_count () |
Increments by one the number of egg files that are known to reference this PaletteGroup. More... | |
bool | is_none_texture_swap () const |
Returns textureswap information is set or not, True if it's not set. More... | |
bool | is_preferred_over (const PaletteGroup &other) const |
Returns true if this group should be preferred for adding textures over the other group, if both are available. More... | |
void | optimal_resize () |
Attempts to resize each PalettteImage down to its smallest possible size. More... | |
void | place_all () |
Once all the textures have been assigned to this group, try to place them all onto suitable PaletteImages. More... | |
TexturePlacement * | prepare (TextureImage *texture) |
Marks the indicated Texture as ready for placing somewhere within this group, and returns a placeholder TexturePlacement object. More... | |
void | reset_dependency_level () |
Unconditionally sets the dependency level and order of this group to zero, in preparation for a later call to set_dependency_level(). More... | |
void | reset_images () |
Throws away all of the current PaletteImages, so that new ones may be created (and the packing made more optimal). More... | |
void | set_dependency_level (int level) |
Sets the dependency level of this group to the indicated level, provided that level is not lower than the level that was set previously. More... | |
bool | set_dependency_order () |
Updates the dependency order of this group. More... | |
void | set_dirname (const string &dirname) |
Sets the directory name associated with the palette group. More... | |
void | set_margin_override (const int override) |
Returns the set of groups this group depends on. More... | |
void | setup_shadow_images () |
Ensures that each PaletteImage's _shadow_image has the correct filename and image types, based on what was supplied on the command line and in the .txa file. More... | |
void | unplace (TexturePlacement *placement) |
Removes the texture from its position on a PaletteImage, if it has been so placed. More... | |
void | update_images (bool redo_all) |
Regenerates each PaletteImage on this group that needs it. More... | |
void | update_unknown_textures (const TxaFile &txa_file) |
Checks for new information on any textures within the group for which some of the saved information is incomplete. More... | |
virtual void | write_datagram (BamWriter *writer, Datagram &datagram) |
Fills the indicated datagram up with a binary representation of the current object, in preparation for writing to a Bam file. More... | |
void | write_image_info (ostream &out, int indent_level=0) const |
Writes a list of the PaletteImages associated with this group, and all of their textures, to the indicated output stream. More... | |
![]() | |
TypedWritable (const TypedWritable ©) | |
virtual ReferenceCount * | as_reference_count () |
Returns the pointer cast to a ReferenceCount pointer, if it is in fact of that type. More... | |
string | encode_to_bam_stream () const |
Converts the TypedWritable object into a single stream of data using a BamWriter, and returns that data as a string string. More... | |
bool | encode_to_bam_stream (string &data, BamWriter *writer=NULL) const |
Converts the TypedWritable object into a single stream of data using a BamWriter, and stores that data in the indicated string. More... | |
virtual TypeHandle | force_init_type () |
UpdateSeq | get_bam_modified () const |
Returns the current bam_modified counter. More... | |
void | mark_bam_modified () |
Increments the bam_modified counter, so that this object will be invalidated and retransmitted on any open bam streams. More... | |
void | operator= (const TypedWritable ©) |
virtual bool | require_fully_complete () const |
Some objects require all of their nested pointers to have been completed before the objects themselves can be completed. More... | |
virtual void | update_bam_nested (BamWriter *manager) |
Called by the BamWriter when this object has not itself been modified recently, but it should check its nested objects for updates. More... | |
![]() | |
TypedObject (const TypedObject ©) | |
TypedObject * | as_typed_object () |
Returns the object, upcast (if necessary) to a TypedObject pointer. More... | |
const TypedObject * | as_typed_object () const |
Returns the object, upcast (if necessary) to a TypedObject pointer. More... | |
int | get_best_parent_from_Set (const std::set< int > &) const |
int | get_type_index () const |
Returns the internal index number associated with this object's TypeHandle, a unique number for each different type. More... | |
bool | is_exact_type (TypeHandle handle) const |
Returns true if the current object is the indicated type exactly. More... | |
bool | is_of_type (TypeHandle handle) const |
Returns true if the current object is or derives from the indicated type. More... | |
void | operator= (const TypedObject ©) |
![]() | |
Namable (const string &initial_name="") | |
Namable (const Namable ©) | |
void | clear_name () |
Resets the Namable's name to empty. More... | |
const string & | get_name () const |
bool | has_name () const |
Returns true if the Namable has a nonempty name set, false if the name is empty. More... | |
Namable & | operator= (const Namable &other) |
void | output (ostream &out) const |
Outputs the Namable. More... | |
void | set_name (const string &name) |
Static Public Member Functions | |
static TypeHandle | get_class_type () |
static void | init_type () |
static void | register_with_read_factory () |
Registers the current object as something that can be read from a Bam file. More... | |
![]() | |
static bool | decode_raw_from_bam_stream (TypedWritable *&ptr, ReferenceCount *&ref_ptr, const string &data, BamReader *reader=NULL) |
Reads the string created by a previous call to encode_to_bam_stream(), and extracts the single object on that string. More... | |
static TypeHandle | get_class_type () |
static void | init_type () |
![]() | |
static TypeHandle | get_class_type () |
static void | init_type () |
This function is declared non-inline to work around a compiler bug in g++ 2.96. More... | |
![]() | |
static TypeHandle | get_class_type () |
static void | init_type () |
Friends | |
class | PaletteGroups |
Additional Inherited Members | |
![]() | |
static TypedWritable *const | Null = (TypedWritable*)0L |
This is the highest level of grouping for TextureImages.
Textures are assigned to one or several PaletteGroups based on the information in the .txa file; each PaletteGroup is conceptually a collection of textures that are to be moved around (into texture memory, downloaded, etc.) in one big chunk. It is the set of all textures that may be displayed together at any given time.
Definition at line 47 of file paletteGroup.h.
void PaletteGroup::add_texture_swap_info | ( | const string | sourceTextureName, |
const vector_string & | swapTextures | ||
) |
Store textureswap information from textures.txa.
Definition at line 819 of file paletteGroup.cxx.
References is_none_texture_swap().
Referenced by finalize(), and TxaFile::write().
void PaletteGroup::clear_depends | ( | ) |
Eliminates all the dependency information for this group.
Definition at line 90 of file paletteGroup.cxx.
References PaletteGroups::clear(), and group_with().
Referenced by get_dirname(), and Palettizer::read_txa_file().
|
virtual |
Called after the object is otherwise completely read from a Bam file, this function's job is to store the pointers that were retrieved from the Bam file for each pointer object written.
The return value is the number of pointers processed from the list.
Reimplemented from TypedWritable.
Definition at line 713 of file paletteGroup.cxx.
References TypedWritable::complete_pointers(), PaletteGroups::complete_pointers(), and finalize().
Referenced by write_datagram().
|
virtual |
This method is called by the BamReader after all pointers everywhere in the world have been completely read in.
It's a hook at which the object can do whatever final setup it requires that depends on other pointers being valid.
Reimplemented from TypedWritable.
Definition at line 750 of file paletteGroup.cxx.
References add_texture_swap_info(), TypedWritable::fillin(), PaletteGroups::fillin(), DatagramIterator::get_bool(), DatagramIterator::get_int16(), DatagramIterator::get_int32(), PalettePage::get_properties(), DatagramIterator::get_string(), DatagramIterator::get_uint32(), BamReader::read_pointers(), and BamReader::register_finalize().
Referenced by complete_pointers().
void PaletteGroup::get_complete_placements | ( | pvector< TexturePlacement *> & | placements | ) | const |
Adds the set of TexturePlacements associated with this group and all dependent groups to the indicated vector.
See get_placements().
Definition at line 181 of file paletteGroup.cxx.
References PaletteGroups::begin(), PaletteGroups::end(), get_placements(), PaletteGroups::make_complete(), and reset_dependency_level().
Referenced by get_placements(), and Palettizer::report_statistics().
int PaletteGroup::get_dependency_level | ( | ) | const |
Returns the dependency level of this group.
This is a measure of how specific the group is; the lower the dependency level, the more specific the group.
Groups depend on other groups in a hierarchical relationship. In general, if group a depends on group b, then b->get_dependency_level() > a->get_dependency_level().
Thus, groups that lots of other groups depend on have a higher dependency level; groups that no one else depends on have a low dependency level. This is important when deciding which groups are best suited for assigning a texture to; in general, the texture should be assigned to the most specific suitable group (i.e. the one with the lowest dependency level).
Definition at line 301 of file paletteGroup.cxx.
References get_dependency_order().
Referenced by set_dependency_order().
int PaletteGroup::get_dependency_order | ( | ) | const |
Returns the dependency order of this group.
This is similar in principle to the dependency level, but it represents the inverse concept: if group a depends on group b, then a->get_dependency_order() > b->get_dependency_order().
This is not exactly the same thing as n - get_dependency_level(). In particular, this can be used to sort the groups into an ordering such that all the groups that group a depends on appear before group a in the list.
Definition at line 321 of file paletteGroup.cxx.
References get_dirname_order().
Referenced by get_dependency_level(), is_preferred_over(), and set_dependency_order().
const string & PaletteGroup::get_dirname | ( | ) | const |
Returns the directory name associated with the palette group.
See set_dirname().
Definition at line 79 of file paletteGroup.cxx.
References clear_depends().
Referenced by has_dirname(), set_dependency_order(), ImageFile::set_filename(), and TxaFile::write().
int PaletteGroup::get_dirname_order | ( | ) | const |
Returns the dependency order of this group.
This is similar in principle to the dependency level, but it represents the inverse concept: if group a depends on group b, then a->get_dirname_order() > b->get_dirname_order().
This is not exactly the same thing as n - get_dependency_level(). In particular, this can be used to sort the groups into an ordering such that all the groups that group a depends on appear before group a in the list.
Definition at line 341 of file paletteGroup.cxx.
References is_preferred_over().
Referenced by get_dependency_order(), is_preferred_over(), and set_dependency_order().
int PaletteGroup::get_egg_count | ( | ) | const |
Returns the number of egg files that share this PaletteGroup.
Definition at line 387 of file paletteGroup.cxx.
References get_page().
Referenced by increment_egg_count(), and is_preferred_over().
const PaletteGroups & PaletteGroup::get_groups | ( | ) | const |
Returns the set of groups this group depends on.
Definition at line 120 of file paletteGroup.cxx.
References get_margin_override().
Referenced by group_with(), Palettizer::report_pi(), and Palettizer::report_statistics().
int PaletteGroup::get_margin_override | ( | ) | const |
Returns the set of groups this group depends on.
Definition at line 130 of file paletteGroup.cxx.
References set_margin_override().
Referenced by get_groups().
PalettePage * PaletteGroup::get_page | ( | const TextureProperties & | properties | ) |
Returns the page associated with the indicated properties.
If no page object has yet been created, creates one.
Definition at line 399 of file paletteGroup.cxx.
References prepare().
Referenced by get_egg_count(), and place_all().
void PaletteGroup::get_placements | ( | pvector< TexturePlacement *> & | placements | ) | const |
Adds the set of TexturePlacements associated with this group to the indicated vector.
The vector is not cleared before this operation; if the user wants to retrieve the set of placements particular to this group only, it is the user's responsibility to clear the vector first.
Definition at line 166 of file paletteGroup.cxx.
References get_complete_placements().
Referenced by get_complete_placements(), has_margin_override(), and Palettizer::report_statistics().
void PaletteGroup::group_with | ( | PaletteGroup * | other | ) |
Indicates a dependency of this group on some other group.
This means that the textures assigned to this group may be considered successfully assigned if they are actually placed in the other group. In practice, this means that the textures associated with the other palette group will always be resident at runtime when textures from this palette group are required.
Definition at line 110 of file paletteGroup.cxx.
References get_groups(), and PaletteGroups::insert().
Referenced by clear_depends(), and TxaFile::write().
bool PaletteGroup::has_dirname | ( | ) | const |
Returns true if the directory name has been explicitly set for this group.
If it has not, get_dirname() returns an empty string.
Definition at line 68 of file paletteGroup.cxx.
References get_dirname().
Referenced by Palettizer::get_default_group(), set_dirname(), and TxaFile::write().
bool PaletteGroup::has_margin_override | ( | ) | const |
Returns the set of groups this group depends on.
Definition at line 151 of file paletteGroup.cxx.
References get_placements().
Referenced by set_margin_override().
void PaletteGroup::increment_egg_count | ( | ) |
Increments by one the number of egg files that are known to reference this PaletteGroup.
This is designed to aid the heuristics in texture placing; it's useful to know how many different egg files are sharing a particular PaletteGroup.
Definition at line 376 of file paletteGroup.cxx.
References get_egg_count().
Referenced by is_preferred_over().
bool PaletteGroup::is_none_texture_swap | ( | ) | const |
Returns textureswap information is set or not, True if it's not set.
Definition at line 834 of file paletteGroup.cxx.
Referenced by add_texture_swap_info().
bool PaletteGroup::is_preferred_over | ( | const PaletteGroup & | other | ) | const |
Returns true if this group should be preferred for adding textures over the other group, if both are available.
In other words, this is a more specific group than the other one.
Definition at line 354 of file paletteGroup.cxx.
References get_dependency_order(), get_dirname_order(), get_egg_count(), and increment_egg_count().
Referenced by TextureImage::assign_groups(), and get_dirname_order().
void PaletteGroup::optimal_resize | ( | ) |
Attempts to resize each PalettteImage down to its smallest possible size.
Definition at line 601 of file paletteGroup.cxx.
References PalettePage::optimal_resize(), and reset_images().
Referenced by Palettizer::optimal_resize(), and write_image_info().
void PaletteGroup::place_all | ( | ) |
Once all the textures have been assigned to this group, try to place them all onto suitable PaletteImages.
Definition at line 489 of file paletteGroup.cxx.
References PalettePage::assign(), TexturePlacement::get_omit_reason(), get_page(), TexturePlacement::get_properties(), PalettePage::place_all(), and update_unknown_textures().
Referenced by Palettizer::process_all(), Palettizer::process_command_line_eggs(), and unplace().
TexturePlacement * PaletteGroup::prepare | ( | TextureImage * | texture | ) |
Marks the indicated Texture as ready for placing somewhere within this group, and returns a placeholder TexturePlacement object.
The texture is not placed immediately, but may be placed later when place_all() is called; at this time, the TexturePlacement fields will be filled in as appropriate.
Definition at line 423 of file paletteGroup.cxx.
References ImageFile::get_alpha_file_channel(), ImageFile::get_alpha_filename(), Filename::get_dirname(), Filename::get_extension(), ImageFile::get_filename(), TextureImage::get_preferred_source(), TextureImage::get_source(), Palettizer::get_texture(), and unplace().
Referenced by get_page(), and TextureImage::write_scale_info().
|
static |
Registers the current object as something that can be read from a Bam file.
Definition at line 664 of file paletteGroup.cxx.
References BamReader::get_factory(), and write_datagram().
Referenced by update_images().
void PaletteGroup::reset_dependency_level | ( | ) |
Unconditionally sets the dependency level and order of this group to zero, in preparation for a later call to set_dependency_level().
Definition at line 203 of file paletteGroup.cxx.
References set_dependency_level().
Referenced by get_complete_placements(), and Palettizer::read_txa_file().
void PaletteGroup::reset_images | ( | ) |
Throws away all of the current PaletteImages, so that new ones may be created (and the packing made more optimal).
Definition at line 617 of file paletteGroup.cxx.
References PalettePage::reset_images(), and setup_shadow_images().
Referenced by optimal_resize(), and Palettizer::reset_images().
void PaletteGroup::set_dependency_level | ( | int | level | ) |
Sets the dependency level of this group to the indicated level, provided that level is not lower than the level that was set previously.
Also cascades to all dependent groups. See get_dependency_level().
This call recurses to correctly set the dependency level of all PaletteGroups in the hierarchy.
Definition at line 222 of file paletteGroup.cxx.
References PaletteGroups::begin(), PaletteGroups::end(), set_dependency_level(), and set_dependency_order().
Referenced by Palettizer::read_txa_file(), reset_dependency_level(), and set_dependency_level().
bool PaletteGroup::set_dependency_order | ( | ) |
Updates the dependency order of this group.
This number is the inverse of the dependency level, and can be used to rank the groups in order so that all the groups that a given group depends on will appear first in the list. See get_dependency_order().
This function returns true if anything was changed, false otherwise.
Definition at line 246 of file paletteGroup.cxx.
References PaletteGroups::begin(), PaletteGroups::end(), get_dependency_level(), get_dependency_order(), get_dirname(), get_dirname_order(), and set_dependency_order().
Referenced by Palettizer::read_txa_file(), set_dependency_level(), and set_dependency_order().
void PaletteGroup::set_dirname | ( | const string & | dirname | ) |
Sets the directory name associated with the palette group.
This is an optional feature that can be used to place the maps for the different palette groups into different install directories.
Definition at line 56 of file paletteGroup.cxx.
References has_dirname().
Referenced by Palettizer::get_default_group(), Palettizer::read_txa_file(), and TxaFile::write().
void PaletteGroup::set_margin_override | ( | const int | override | ) |
Returns the set of groups this group depends on.
Definition at line 140 of file paletteGroup.cxx.
References has_margin_override().
Referenced by get_margin_override(), and TxaFile::write().
void PaletteGroup::setup_shadow_images | ( | ) |
Ensures that each PaletteImage's _shadow_image has the correct filename and image types, based on what was supplied on the command line and in the .txa file.
Definition at line 634 of file paletteGroup.cxx.
References PalettePage::setup_shadow_images(), and update_images().
Referenced by Palettizer::all_params_set(), and reset_images().
void PaletteGroup::unplace | ( | TexturePlacement * | placement | ) |
Removes the texture from its position on a PaletteImage, if it has been so placed.
Definition at line 467 of file paletteGroup.cxx.
References TexturePlacement::get_group(), TexturePlacement::get_page(), TexturePlacement::is_placed(), place_all(), and PalettePage::unplace().
Referenced by prepare().
void PaletteGroup::update_images | ( | bool | redo_all | ) |
Regenerates each PaletteImage on this group that needs it.
Definition at line 649 of file paletteGroup.cxx.
References register_with_read_factory(), and PalettePage::update_images().
Referenced by Palettizer::generate_images(), and setup_shadow_images().
void PaletteGroup::update_unknown_textures | ( | const TxaFile & | txa_file | ) |
Checks for new information on any textures within the group for which some of the saved information is incomplete.
This may be necessary before we can properly place all of the textures.
Definition at line 519 of file paletteGroup.cxx.
References TexturePlacement::determine_size(), TexturePlacement::get_texture(), TextureImage::got_txa_file(), TexturePlacement::is_size_known(), TxaFile::match_texture(), TextureImage::post_txa_file(), TextureImage::pre_txa_file(), and write_image_info().
Referenced by place_all(), Palettizer::process_all(), and Palettizer::process_command_line_eggs().
Fills the indicated datagram up with a binary representation of the current object, in preparation for writing to a Bam file.
Reimplemented from TypedWritable.
Definition at line 677 of file paletteGroup.cxx.
References Datagram::add_bool(), Datagram::add_int16(), Datagram::add_int32(), Datagram::add_string(), Datagram::add_uint32(), complete_pointers(), TypedWritable::write_datagram(), PaletteGroups::write_datagram(), and BamWriter::write_pointer().
Referenced by register_with_read_factory().
void PaletteGroup::write_image_info | ( | ostream & | out, |
int | indent_level = 0 |
||
) | const |
Writes a list of the PaletteImages associated with this group, and all of their textures, to the indicated output stream.
Definition at line 548 of file paletteGroup.cxx.
References TexturePlacement::get_omit_reason(), TexturePlacement::get_texture(), TexturePlacement::get_uv_area(), TexturePlacement::get_x_size(), TexturePlacement::get_y_size(), optimal_resize(), and PalettePage::write_image_info().
Referenced by Palettizer::report_pi(), and update_unknown_textures().