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
155
156
|
/*******************************************************************************
* animation.h
*
* ---------------------------------------------------------------------------
* Persistence of Vision Ray Tracer ('POV-Ray') version 3.7.
* Copyright 1991-2013 Persistence of Vision Raytracer Pty. Ltd.
*
* POV-Ray is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License as
* published by the Free Software Foundation, either version 3 of the
* License, or (at your option) any later version.
*
* POV-Ray 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 Affero General Public License for more details.
*
* You should have received a copy of the GNU Affero General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
* ---------------------------------------------------------------------------
* POV-Ray is based on the popular DKB raytracer version 2.12.
* DKBTrace was originally written by David K. Buck.
* DKBTrace Ver 2.0-2.12 were written by David K. Buck & Aaron A. Collins.
* ---------------------------------------------------------------------------
* $File: //depot/public/povray/3.x/source/base/animation/animation.h $
* $Revision: #1 $
* $Change: 6069 $
* $DateTime: 2013/11/06 11:59:40 $
* $Author: chrisc $
*******************************************************************************/
#ifndef POVRAY_BASE_ANIMATION_H
#define POVRAY_BASE_ANIMATION_H
#include <vector>
#include "base/configbase.h"
#include "base/fileinputoutput.h"
#include "base/pov_err.h"
#include "base/types.h"
#include "base/image/image.h"
namespace pov_base
{
class Animation
{
public:
enum CodecType
{
LosslessCodec = 0, // file format default choice
LossyCodec = 1, // file format default choice
PNGCodec,
BMPCodec,
JPEGCodec,
MPEG1Codec, // i-frames only - note that JPEG library DCT can be reused [trf]
MPEG2Codec // i-frames only - note that JPEG library DCT can be reused [trf]
};
enum FileType
{
AVI,
MOV,
MPEG
};
enum ColorEncodingType
{
RGB,
YUV,
YUV422,
YUV420,
YUV411,
YUV410
};
struct ReadOptions
{
float gamma;
bool gammacorrect;
ReadOptions() : gamma(1.0f), gammacorrect(false) { }
};
struct WriteOptions
{
ColorEncodingType colorencoding;
unsigned char compress; // relative quality from 100 best to 0 worst
unsigned char bpcc; // bits per colour component
bool alphachannel;
float gamma;
float blurradius; // blur radius 0.0 to 1.0 (for better lossy compression without aa) - turned off by 0.0
float bluredgethreshold; // edge threshold 0.0 to 1.0 (grayscale difference of clipped pixels, only blur if difference larger than threshold) - turned off by 1.0
float framespersecond; // has to support very odd framerates i.e. for NTSC - defaults to standard 24 fps cinema/movie frame rate
WriteOptions() : colorencoding(YUV), compress(75), alphachannel(false), gamma(1.0f), blurradius(0.0), bluredgethreshold(1.0), framespersecond(24.0) { }
};
virtual ~Animation();
static Animation *Open(FileType aftype, IStream *file, const ReadOptions& options = ReadOptions()); // reading only
static Animation *Open(FileType aftype, CodecType codec, OStream *file, unsigned int w, unsigned int h, const WriteOptions& options = WriteOptions()); // writing only
void AppendFrame(Image *image); // writing only - NOTE: This method reserves the right to *modify* the image passed to it!!! [trf]
Image *ReadNextFrame(); // reading only
float GetLengthInSeconds() const;
unsigned int GetLengthInFrames() const;
unsigned int GetCurrentFrame() const; // reading only
void SetCurrentFrame(unsigned int frame); // reading only
unsigned int GetWidth() const { return width; }
unsigned int GetHeight() const { return height; }
const vector<string>& GetWarnings() const;
void ClearWarnings();
protected:
FileType fileType;
IStream *inFile;
OStream *outFile;
unsigned int width;
unsigned int height;
ReadOptions readOptions;
WriteOptions writeOptions;
vector<string> warnings;
CodecType codec;
unsigned int currentFrame;
unsigned int totalFrames;
float frameDuration;
Animation(FileType aftype, IStream *file, const ReadOptions& options);
Animation(FileType aftype, CodecType codec, OStream *file, unsigned int w, unsigned int h, const WriteOptions& options);
Image *ReadFrame(IStream *file);
POV_LONG WriteFrame(OStream *file, const Image *image);
void ComputeBlurMask(const Image& image, Image& mask);
void GetBlurredPixel(const Image& image, unsigned int x, unsigned int y, float& red, float& green, float& blue);
private:
void *state;
float blurMatrix[16][16]; // only uses 15 x 15 maximum (16 x 16 for better alignment)
int blurMatrixRadius;
/// not available
Animation();
/// not available
Animation(const Animation&);
/// not available
Animation& operator=(Animation&);
};
}
#endif // POVRAY_BASE_ANIMATION_H
|
