/usr/include/vtk-5.8/vtkMCubesReader.h is in libvtk5-dev 5.8.0-5.
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 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 | /*=========================================================================
Program: Visualization Toolkit
Module: vtkMCubesReader.h
Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
All rights reserved.
See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notice for more information.
=========================================================================*/
// .NAME vtkMCubesReader - read binary marching cubes file
// .SECTION Description
// vtkMCubesReader is a source object that reads binary marching cubes
// files. (Marching cubes is an isosurfacing technique that generates
// many triangles.) The binary format is supported by W. Lorensen's
// marching cubes program (and the vtkSliceCubes object). The format
// repeats point coordinates, so this object will merge the points
// with a vtkLocator object. You can choose to supply the vtkLocator
// or use the default.
// .SECTION Caveats
// Binary files assumed written in sun/hp/sgi (i.e., Big Endian) form.
//
// Because points are merged when read, degenerate triangles may be removed.
// Thus the number of triangles read may be fewer than the number of triangles
// actually created.
//
// The point merging does not take into account that the same point may have
// different normals. For example, running vtkPolyDataNormals after
// vtkContourFilter may split triangles because of the FeatureAngle
// ivar. Subsequent reading with vtkMCubesReader will merge the points and
// use the first point's normal. For the most part, this is undesirable.
//
// Normals are generated from the gradient of the data scalar values. Hence
// the normals may on occasion point in a direction inconsistent with the
// ordering of the triangle vertices. If this happens, the resulting surface
// may be "black". Reverse the sense of the FlipNormals boolean flag to
// correct this.
// .SECTION See Also
// vtkContourFilter vtkMarchingCubes vtkSliceCubes vtkLocator
#ifndef __vtkMCubesReader_h
#define __vtkMCubesReader_h
#include "vtkPolyDataAlgorithm.h"
#define VTK_FILE_BYTE_ORDER_BIG_ENDIAN 0
#define VTK_FILE_BYTE_ORDER_LITTLE_ENDIAN 1
class vtkIncrementalPointLocator;
class VTK_IO_EXPORT vtkMCubesReader : public vtkPolyDataAlgorithm
{
public:
vtkTypeMacro(vtkMCubesReader,vtkPolyDataAlgorithm);
void PrintSelf(ostream& os, vtkIndent indent);
// Description:
// Construct object with FlipNormals turned off and Normals set to true.
static vtkMCubesReader *New();
// Description:
// Specify file name of marching cubes file.
vtkSetStringMacro(FileName);
vtkGetStringMacro(FileName);
// Description:
// Set / get the file name of the marching cubes limits file.
vtkSetStringMacro(LimitsFileName);
vtkGetStringMacro(LimitsFileName);
// Description:
// Specify a header size if one exists. The header is skipped and not used at this time.
vtkSetClampMacro(HeaderSize,int,0,VTK_LARGE_INTEGER);
vtkGetMacro(HeaderSize,int);
// Description:
// Specify whether to flip normals in opposite direction. Flipping ONLY
// changes the direction of the normal vector. Contrast this with flipping
// in vtkPolyDataNormals which flips both the normal and the cell point
// order.
vtkSetMacro(FlipNormals,int);
vtkGetMacro(FlipNormals,int);
vtkBooleanMacro(FlipNormals,int);
// Description:
// Specify whether to read normals.
vtkSetMacro(Normals,int);
vtkGetMacro(Normals,int);
vtkBooleanMacro(Normals,int);
// Description:
// These methods should be used instead of the SwapBytes methods.
// They indicate the byte ordering of the file you are trying
// to read in. These methods will then either swap or not swap
// the bytes depending on the byte ordering of the machine it is
// being run on. For example, reading in a BigEndian file on a
// BigEndian machine will result in no swapping. Trying to read
// the same file on a LittleEndian machine will result in swapping.
// As a quick note most UNIX machines are BigEndian while PC's
// and VAX tend to be LittleEndian. So if the file you are reading
// in was generated on a VAX or PC, SetDataByteOrderToLittleEndian otherwise
// SetDataByteOrderToBigEndian.
void SetDataByteOrderToBigEndian();
void SetDataByteOrderToLittleEndian();
int GetDataByteOrder();
void SetDataByteOrder(int);
const char *GetDataByteOrderAsString();
// Description:
// Turn on/off byte swapping.
vtkSetMacro(SwapBytes,int);
vtkGetMacro(SwapBytes,int);
vtkBooleanMacro(SwapBytes,int);
// Description:
// Set / get a spatial locator for merging points. By default,
// an instance of vtkMergePoints is used.
void SetLocator(vtkIncrementalPointLocator *locator);
vtkGetObjectMacro(Locator,vtkIncrementalPointLocator);
// Description:
// Create default locator. Used to create one when none is specified.
void CreateDefaultLocator();
// Description:
// Return the mtime also considering the locator.
unsigned long GetMTime();
protected:
vtkMCubesReader();
~vtkMCubesReader();
int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *);
char *FileName;
char *LimitsFileName;
vtkIncrementalPointLocator *Locator;
int SwapBytes;
int HeaderSize;
int FlipNormals;
int Normals;
private:
vtkMCubesReader(const vtkMCubesReader&); // Not implemented.
void operator=(const vtkMCubesReader&); // Not implemented.
};
#endif
|