Debian Codegraph @

examples/anim_util.h

raw
1 // Copyright 2015 Google Inc. All Rights Reserved.
2 //
3 // Use of this source code is governed by a BSD-style license
4 // that can be found in the COPYING file in the root of the source
5 // tree. An additional intellectual property rights grant can be found
6 // in the file PATENTS. All contributing project authors may
7 // be found in the AUTHORS file in the root of the source tree.
8 // -----------------------------------------------------------------------------
9 //
10 // Utilities for animated images
11
12 #ifndef WEBP_EXAMPLES_ANIM_UTIL_H_
13 #define WEBP_EXAMPLES_ANIM_UTIL_H_
14
15 #ifdef HAVE_CONFIG_H
16 #include "webp/config.h"
17 #endif
18
19 #include "webp/types.h"
20
21 #ifdef __cplusplus
22 extern "C" {
23 #endif
24
25 typedef enum {
26 ANIM_GIF,
27 ANIM_WEBP
28 } AnimatedFileFormat;
29
30 typedef struct {
31 uint8_t* rgba; // Decoded and reconstructed full frame.
32 int duration; // Frame duration in milliseconds.
33 int is_key_frame; // True if this frame is a key-frame.
34 } DecodedFrame;
35
36 typedef struct {
37 AnimatedFileFormat format;
38 uint32_t canvas_width;
39 uint32_t canvas_height;
40 uint32_t bgcolor;
41 uint32_t loop_count;
42 DecodedFrame* frames;
43 uint32_t num_frames;
44 void* raw_mem;
45 } AnimatedImage;
46
47 // Deallocate everything in 'image' (but not the object itself).
48 void ClearAnimatedImage(AnimatedImage* const image);
49
50 // Read animated image file into 'AnimatedImage' struct.
51 // If 'dump_frames' is true, dump frames to 'dump_folder'.
52 // Previous content of 'image' is obliterated.
53 // Upon successful return, content of 'image' must be deleted by
54 // calling 'ClearAnimatedImage'.
55 int ReadAnimatedImage(const char filename[], AnimatedImage* const image,
56 int dump_frames, const char dump_folder[]);
57
58 // Given two RGBA buffers, calculate max pixel difference and PSNR.
59 // If 'premultiply' is true, R/G/B values will be pre-multiplied by the
60 // transparency before comparison.
61 void GetDiffAndPSNR(const uint8_t rgba1[], const uint8_t rgba2[],
62 uint32_t width, uint32_t height, int premultiply,
63 int* const max_diff, double* const psnr);
64
65 // Return library versions used by anim_util.
66 void GetAnimatedImageVersions(int* const decoder_version,
67 int* const demux_version);
68
69 #ifdef __cplusplus
70 } // extern "C"
71 #endif
72
73 #endif // WEBP_EXAMPLES_ANIM_UTIL_H_