summaryrefslogtreecommitdiffstats
path: root/dom/canvas/ImageBitmapUtils.h
blob: 39be43d8ae54e3f6ba3491482fad1b10757f11cd (plain)
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
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim:set ts=2 sw=2 sts=2 et cindent: */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#ifndef mozilla_dom_ImageBitmapUtils_h
#define mozilla_dom_ImageBitmapUtils_h

#include "mozilla/UniquePtr.h"
#include "nsTArrayForwardDeclare.h"

namespace mozilla {

namespace layers {
class Image;
struct PlanarYCbCrData;
}

namespace dom {

struct ChannelPixelLayout;
template<typename> class Sequence;

typedef nsTArray<ChannelPixelLayout> ImagePixelLayout;

/*
 * This function creates an ImagePixelLayout object which describes the
 * default layout of the given ImageBitmapFormat with the given width, height
 * and stride.
 */
UniquePtr<ImagePixelLayout>
CreateDefaultPixelLayout(ImageBitmapFormat aFormat,
                         uint32_t aWidth, uint32_t aHeight, uint32_t aStride);

/*
 * This function extracts information from the aImage parameter to customize
 * the ImagePixelLayout object, that is, this function creates a customized
 * ImagePixelLayout object which exactly describes the pixel layout of the
 * given aImage.
 */
UniquePtr<ImagePixelLayout>
CreatePixelLayoutFromPlanarYCbCrData(const layers::PlanarYCbCrData* aData);

/*
 * Get the number of channels of the given ImageBitmapFormat.
 */
uint8_t
GetChannelCountOfImageFormat(ImageBitmapFormat aFormat);

/*
 * Get the needed buffer size to store the image data in the given
 * ImageBitmapFormat with the given width and height.
 */
uint32_t
CalculateImageBufferSize(ImageBitmapFormat aFormat,
                         uint32_t aWidth, uint32_t aHeight);

/*
 * This function always copies the image data in _aSrcBuffer_ into _aDstBuffer_
 * and it also performs color conversion if the _aSrcFormat_ and the
 * _aDstFormat_ are different.
 *
 * The source image is stored in the _aSrcBuffer_ and the corresponding pixel
 * layout is described by the _aSrcLayout_.
 *
 * The copied and converted image will be stored in the _aDstBuffer_, which
 * should be allocated with enough size before invoking this function and the
 * needed size could be found by the CalculateImageBufferSize() method.
 *
 * The returned ImagePixelLayout object describes the pixel layout of the result
 * image and will be null if on failure.
 */
UniquePtr<ImagePixelLayout>
CopyAndConvertImageData(ImageBitmapFormat aSrcFormat,
                        const uint8_t* aSrcBuffer,
                        const ImagePixelLayout* aSrcLayout,
                        ImageBitmapFormat aDstFormat,
                        uint8_t* aDstBuffer);

/*
 * This function tries to find the best ImageBitmapFormat, from the aCandiates,
 * which can be converted from the aSrcFormat. The algorithm now merely returns
 * the FIRST one, from the aCandidates, which can be converted from the
 * aSrcFormat.
 *
 * TODO: The algorithm should be updated after we implement optimizations for
 *       different platforms (different kinds of layers::Image), considering
 *       that some conversion might be cheaper through hardware.
 */
ImageBitmapFormat
FindBestMatchingFromat(ImageBitmapFormat aSrcFormat,
                       const Sequence<ImageBitmapFormat>& aCandidates);

} // namespace dom
} // namespace mozilla


#endif // mozilla_dom_ImageBitmapUtils_h