Method read

Engine/source/forest/forestDataFile.cpp:86–171

}

bool ForestData::read( Stream &stream )
{
   // Read our identifier... so we know we're 
   // not reading in pure garbage.
   char id[4] = { 0 };
   stream.read( 4, id );
   if ( dMemcmp( id, "FKDF", 4 ) != 0 )
   {
      Con::errorf( "ForestDataFile::read() - This is not a Forest planting file!" );
      return false;
   }

   // Empty ourselves before we really begin reading.
   clear();

   // Now the version number.
   U8 version;
   stream.read( &version );
   if ( version > (U8)FILE_VERSION )
   {
      Con::errorf( "ForestDataFile::read() - This file was created with an newer version of Forest!" );
      return false;
   }

   // Read in the names of the ForestItemData datablocks
   // and recover the datablock.
   Vector<ForestItemData*> allDatablocks;
   U32 count;
   stream.read( &count );
   allDatablocks.setSize( count );
   for ( U32 i=0; i < count; i++ )
   {
      StringTableEntry name = stream.readSTString();
      ForestItemData* data = ForestItemData::find( name );
      
      // TODO: Change this to instead create a dummy forest data
      // for each so that the user can swap it with the right one.
      if ( data == NULL )
      {
         Con::warnf( "ForestData::read - ForestItemData named %s was not found.", name );
         Con::warnf( "Note this can occur if you have deleted or renamed datablocks prior to loading this forest and is not an 'error' in this scenario." );
      }
      
      allDatablocks[ i ] = data;
   }

   U8 dataIndex;
   Point3F pos;
   QuatF rot;
   F32 scale;
   ForestItemData* data;
   MatrixF xfm;

   U32 skippedItems = 0;

   // Read in the items.
   stream.read( &count );
   for ( U32 i=0; i < count; i++ )