mirror of
https://github.com/yuzu-emu/FasTC.git
synced 2025-01-10 05:15:38 +00:00
a80944901e
In order to better facilitate the change from block stream order to non-block stream order, a lot of changes were introduced to the way that we feed texture data to the compressors. This data is embodied in the CompressionJob struct. We have made it so that the compression job points to both the in and out pointers for our compressed and uncompressed data. Furthermore, we have made sure that the struct also contains the format that its compressing for, so that if any threading programs would like to chop up a compression job into smaller chunks based on the format, it doesn't need to know the format explicitly, it just needs to know certain properties about the format. Moreover, the user can now define the start and end pixels from which we would like to compress to. We can compress subsets of data by changing the in and out pointers and the width and height values. The compressors will read data linearly until they reach the out pixels based on the width of the given pixel.
120 lines
4.8 KiB
C++
120 lines
4.8 KiB
C++
/* FasTC
|
|
* Copyright (c) 2012 University of North Carolina at Chapel Hill. All rights reserved.
|
|
*
|
|
* Permission to use, copy, modify, and distribute this software and its documentation for educational,
|
|
* research, and non-profit purposes, without fee, and without a written agreement is hereby granted,
|
|
* provided that the above copyright notice, this paragraph, and the following four paragraphs appear
|
|
* in all copies.
|
|
*
|
|
* Permission to incorporate this software into commercial products may be obtained by contacting the
|
|
* authors or the Office of Technology Development at the University of North Carolina at Chapel Hill <otd@unc.edu>.
|
|
*
|
|
* This software program and documentation are copyrighted by the University of North Carolina at Chapel Hill.
|
|
* The software program and documentation are supplied "as is," without any accompanying services from the
|
|
* University of North Carolina at Chapel Hill or the authors. The University of North Carolina at Chapel Hill
|
|
* and the authors do not warrant that the operation of the program will be uninterrupted or error-free. The
|
|
* end-user understands that the program was developed for research purposes and is advised not to rely
|
|
* exclusively on the program for any reason.
|
|
*
|
|
* IN NO EVENT SHALL THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL OR THE AUTHORS BE LIABLE TO ANY PARTY FOR
|
|
* DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE
|
|
* USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL OR THE
|
|
* AUTHORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*
|
|
* THE UNIVERSITY OF NORTH CAROLINA AT CHAPEL HILL AND THE AUTHORS SPECIFICALLY DISCLAIM ANY WARRANTIES, INCLUDING,
|
|
* BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AND ANY
|
|
* STATUTORY WARRANTY OF NON-INFRINGEMENT. THE SOFTWARE PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY
|
|
* OF NORTH CAROLINA AT CHAPEL HILL AND THE AUTHORS HAVE NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES,
|
|
* ENHANCEMENTS, OR MODIFICATIONS.
|
|
*
|
|
* Please send all BUG REPORTS to <pavel@cs.unc.edu>.
|
|
*
|
|
* The authors may be contacted via:
|
|
*
|
|
* Pavel Krajcevski
|
|
* Dept of Computer Science
|
|
* 201 S Columbia St
|
|
* Frederick P. Brooks, Jr. Computer Science Bldg
|
|
* Chapel Hill, NC 27599-3175
|
|
* USA
|
|
*
|
|
* <http://gamma.cs.unc.edu/FasTC/>
|
|
*/
|
|
|
|
#ifndef _TEX_COMP_H_
|
|
#define _TEX_COMP_H_
|
|
|
|
#include "CompressedImage.h"
|
|
#include "CompressionJob.h"
|
|
|
|
#include <iosfwd>
|
|
#include "ImageFwd.h"
|
|
|
|
// Forward declarations
|
|
class ImageFile;
|
|
|
|
struct SCompressionSettings {
|
|
SCompressionSettings(); // defaults
|
|
|
|
// The compression format for the image.
|
|
FasTC::ECompressionFormat format;
|
|
|
|
// The flag that requests us to use SIMD, if it is available
|
|
bool bUseSIMD;
|
|
|
|
// The number of threads to spawn in order to process the data
|
|
int iNumThreads;
|
|
|
|
// Some compression formats take a measurement of quality when
|
|
// compressing an image. If the format supports it, this value
|
|
// will be used for quality purposes.
|
|
int iQuality;
|
|
|
|
// The number of compressions to perform. The program will compress
|
|
// the image this many times, and then take the average of the timing.
|
|
int iNumCompressions;
|
|
|
|
// This setting measures the number of blocks that a thread
|
|
// will process at any given time. If this value is zero,
|
|
// which is the default, the work will be divided by the
|
|
// number of threads, and each thread will do it's job and
|
|
// exit.
|
|
int iJobSize;
|
|
|
|
// This flags instructs the compression routine to be launched in succession
|
|
// with many threads at once. Atomic expressions based on the availability
|
|
// in the platform and compiler will provide synchronization.
|
|
bool bUseAtomics;
|
|
|
|
// This flag instructs the infrastructure to use the compression routine from
|
|
// PVRTexLib. If no such lib is found during configuration then this flag is
|
|
// ignored. The quality being used is the fastest compression quality.
|
|
bool bUsePVRTexLib;
|
|
|
|
// This is the output stream with which we should output the logs for the
|
|
// compression functions.
|
|
std::ostream *logStream;
|
|
};
|
|
|
|
template<typename PixelType>
|
|
extern CompressedImage *CompressImage(FasTC::Image<PixelType> *img, const SCompressionSettings &settings);
|
|
|
|
extern bool CompressImageData(
|
|
const unsigned char *data,
|
|
const unsigned int width,
|
|
const unsigned int height,
|
|
unsigned char *cmpData,
|
|
const unsigned int cmpDataSz,
|
|
const SCompressionSettings &settings
|
|
);
|
|
|
|
// This function computes the Peak Signal to Noise Ratio between a
|
|
// compressed image and a raw image.
|
|
extern double ComputePSNR(const CompressedImage &ci, const ImageFile &file);
|
|
|
|
// This is a multi-platform yield function that preempts the current thread
|
|
// based on the threading library that we're using.
|
|
extern void YieldThread();
|
|
|
|
#endif //_TEX_COMP_H_
|