This file is indexed.

/usr/include/crystalspace-2.0/cstool/debugimagewriter.h is in libcrystalspace-dev 2.0+dfsg-1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
/*
    Copyright (C) 2004 by Jorrit Tyberghein
	      (C) 2004 by Frank Richter

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Library General Public
    License as published by the Free Software Foundation; either
    version 2 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Library General Public License for more details.

    You should have received a copy of the GNU Library General Public
    License along with this library; if not, write to the Free
    Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
*/

#ifndef __CS_CSTOOL_DEBUGIMAGEWRITER_H__
#define __CS_CSTOOL_DEBUGIMAGEWRITER_H__

/**\file
 * Image object debugging helper
 */

#include "csutil/csstring.h"
#include "csutil/scf.h"
#include "igraphic/imageio.h"
#include "iutil/databuff.h"
#include "iutil/vfs.h"
#include "ivaria/reporter.h"

/**
 * Helper class allowing in debug builds for to quickly dump an iImage 
 * object onto disk for visual inspection.
 * \note Only works in debug builds.
 */
class CS_CRYSTALSPACE_EXPORT csDebugImageWriter
{
  static void Report (int severity, const char* msg, ...)
  {
#ifdef CS_DEBUG
    va_list arg;
    va_start (arg, msg);
    csReportV (iSCF::SCF->object_reg, severity, "crystalspace.debugimagewriter",
      msg, arg);
    va_end (arg);
#endif
  }
public:
  /**
   * Write an image onto disk.
   * \param image The image to be written.
   * \param filename The VFS name of the file to be written.
   * \remarks \a filename is a string with printf() style format specifiers.
   * \remarks If \a filename does not contain an absolute VFS path, it will
   *  be treated as relative to "/tmp/".
   * \sa \ref FormatterNotes
   */
  static void DebugImageWrite (iImage* image, const char* filename, ...)
  {
  #ifdef CS_DEBUG
    CS_ASSERT(iSCF::SCF->object_reg);
    csRef<iImageIO> imgsaver =
      csQueryRegistry<iImageIO> (iSCF::SCF->object_reg);
    if (!imgsaver) 
    {
      Report (CS_REPORTER_SEVERITY_ERROR, "No iImageIO");
      return;
    }
    csRef<iVFS> vfs =
      csQueryRegistry<iVFS> (iSCF::SCF->object_reg);
    if (!vfs) 
    {
      Report (CS_REPORTER_SEVERITY_ERROR, "No iVFS");
      return;
    }
    
    csString finalFilename;
    va_list arg;
    va_start (arg, filename);
    finalFilename.FormatV (filename, arg);
    va_end (arg);
    
    csRef<iDataBuffer> buf = imgsaver->Save (image, "image/png");
    if (!buf) 
    {
      Report (CS_REPORTER_SEVERITY_ERROR, "Error saving image");
      return;
    }
    vfs->PushDir ();
    vfs->ChDir ("/tmp");
    bool written = vfs->WriteFile (finalFilename, (char*)buf->GetInt8 (), 
      buf->GetSize ());
    vfs->PopDir ();
    if (!written)
    {
      Report (CS_REPORTER_SEVERITY_ERROR, "Could not write to %s", 
	finalFilename.GetData ());
    }
  #else
    // Make -Wall happy
    (void)image;
    (void)filename;
  #endif
  }
};

#endif // __CS_CSTOOL_DEBUGIMAGEWRITER_H__