---

pandatool/src/flt/fltBeadID.cxx

Go to the documentation of this file.

// Filename: fltBeadID.cxx
// Created by:  drose (24Aug00)
//
////////////////////////////////////////////////////////////////////
//
// PANDA 3D SOFTWARE
// Copyright (c) 2001, Disney Enterprises, Inc.  All rights reserved
//
// All use of this software is subject to the terms of the Panda 3d
// Software license.  You should have received a copy of this license
// along with this source code; you will also find a current copy of
// the license at http://www.panda3d.org/license.txt .
//
// To contact the maintainers of this program write to
// panda3d@yahoogroups.com .
//
////////////////////////////////////////////////////////////////////

#include "fltBeadID.h"
#include "fltRecordReader.h"
#include "fltRecordWriter.h"

TypeHandle FltBeadID::_type_handle;

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::Constructor
//       Access: Public
//  Description:
////////////////////////////////////////////////////////////////////
FltBeadID::
FltBeadID(FltHeader *header) : FltBead(header) {
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::get_id
//       Access: Public
//  Description: Returns the id (name) of this particular bead.  Each
//               MultiGen bead will have a unique name.
////////////////////////////////////////////////////////////////////
const string &FltBeadID::
get_id() const {
  return _id;
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::set_id
//       Access: Public
//  Description: Changes the id (name) of this particular bead.  This
//               should be a name that is unique to this bead.
////////////////////////////////////////////////////////////////////
void FltBeadID::
set_id(const string &id) {
  _id = id;
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::output
//       Access: Public
//  Description: Writes a quick one-line description of the record, but
//               not its children.  This is a human-readable
//               description, primarily for debugging; to write a flt
//               file, use FltHeader::write_flt().
////////////////////////////////////////////////////////////////////
void FltBeadID::
output(ostream &out) const {
  out << get_type();
  if (!_id.empty()) {
    out << " " << _id;
  }
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::extract_record
//       Access: Protected, Virtual
//  Description: Fills in the information in this bead based on the
//               information given in the indicated datagram, whose
//               opcode has already been read.  Returns true on
//               success, false if the datagram is invalid.
////////////////////////////////////////////////////////////////////
bool FltBeadID::
extract_record(FltRecordReader &reader) {
  if (!FltBead::extract_record(reader)) {
    return false;
  }

  _id = reader.get_iterator().get_fixed_string(8);
  return true;
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::extract_ancillary
//       Access: Protected, Virtual
//  Description: Checks whether the given bead, which follows this
//               bead sequentially in the file, is an ancillary record
//               of this bead.  If it is, extracts the relevant
//               information and returns true; otherwise, leaves it
//               alone and returns false.
////////////////////////////////////////////////////////////////////
bool FltBeadID::
extract_ancillary(FltRecordReader &reader) {
  if (reader.get_opcode() == FO_long_id) {
    string s = reader.get_iterator().get_remaining_bytes();
    size_t zero_byte = s.find('\0');
    _id = s.substr(0, zero_byte);
    return true;
  }

  return FltBead::extract_ancillary(reader);
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::build_record
//       Access: Protected, Virtual
//  Description: Fills up the current record on the FltRecordWriter with
//               data for this record, but does not advance the
//               writer.  Returns true on success, false if there is
//               some error.
////////////////////////////////////////////////////////////////////
bool FltBeadID::
build_record(FltRecordWriter &writer) const {
  if (!FltBead::build_record(writer)) {
    return false;
  }

  writer.update_datagram().add_fixed_string(_id.substr(0, 7), 8);
  return true;
}

////////////////////////////////////////////////////////////////////
//     Function: FltBeadID::write_ancillary
//       Access: Protected, Virtual
//  Description: Writes whatever ancillary records are required for
//               this record.  Returns FE_ok on success, or something
//               else if there is some error.
////////////////////////////////////////////////////////////////////
FltError FltBeadID::
write_ancillary(FltRecordWriter &writer) const {
  if (_id.length() > 7) {

    // Although the manual mentions nothing of this, it is essential
    // that the length of the record be a multiple of 4 bytes.
    string id = _id;
    while ((id.length() % 4) != 0) {
      id += '\0';
    }
    Datagram dc(id);

    FltError result = writer.write_record(FO_long_id, dc);
    if (result != FE_ok) {
      return result;
    }
  }

  return FltBead::write_ancillary(writer);
}

---