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
|
// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef THIRD_PARTY_BLINK_RENDERER_PLATFORM_GRAPHICS_PAINT_DISPLAY_ITEM_CLIENT_H_
#define THIRD_PARTY_BLINK_RENDERER_PLATFORM_GRAPHICS_PAINT_DISPLAY_ITEM_CLIENT_H_
#include "third_party/blink/renderer/platform/geometry/int_rect.h"
#include "third_party/blink/renderer/platform/graphics/dom_node_id.h"
#include "third_party/blink/renderer/platform/graphics/paint_invalidation_reason.h"
#include "third_party/blink/renderer/platform/platform_export.h"
#include "third_party/blink/renderer/platform/wtf/assertions.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
namespace blink {
// The class for objects that can be associated with display items. A
// DisplayItemClient object should live at least longer than the document cycle
// in which its display items are created during painting. After the document
// cycle, a pointer/reference to DisplayItemClient should be no longer
// dereferenced unless we can make sure the client is still alive.
class PLATFORM_EXPORT DisplayItemClient {
public:
DisplayItemClient()
: paint_invalidation_reason_(PaintInvalidationReason::kJustCreated) {
#if DCHECK_IS_ON()
OnCreate();
#endif
}
virtual ~DisplayItemClient() {
#if DCHECK_IS_ON()
OnDestroy();
#endif
}
#if DCHECK_IS_ON()
// Tests if this DisplayItemClient object has been created and has not been
// deleted yet.
bool IsAlive() const;
String SafeDebugName(bool known_to_be_safe = false) const;
#endif
virtual String DebugName() const = 0;
// Needed for paint chunk clients only. Returns the id of the DOM node
// associated with this DisplayItemClient, or kInvalidDOMNodeId if there is no
// associated DOM node or this DisplayItemClient is never used as a paint
// chunk client.
virtual DOMNodeId OwnerNodeId() const { return kInvalidDOMNodeId; }
// The visual rect of this DisplayItemClient. For SPv1, it's in the object
// space of the object that owns the GraphicsLayer, i.e. offset by
// GraphicsLayer::OffsetFromLayoutObjectWithSubpixelAccumulation().
// It's in the space of the parent transform node.
virtual IntRect VisualRect() const = 0;
// The outset will be used to inflate visual rect after the visual rect is
// mapped into the space of the composited layer, for any special raster
// effects that might expand the rastered pixel area.
virtual float VisualRectOutsetForRasterEffects() const { return 0; }
// The rect that needs to be invalidated partially for rasterization in this
// client. It's in the same coordinate space as VisualRect().
virtual IntRect PartialInvalidationVisualRect() const { return IntRect(); }
// Called by PaintController::FinishCycle() for all clients after painting.
virtual void ClearPartialInvalidationVisualRect() const {}
// Indicates that the client will paint display items different from the ones
// cached by PaintController. However, PaintController allows a client to
// paint new display items that are not cached or to no longer paint some
// cached display items without calling this method.
// See PaintController::ClientCacheIsValid() for more details.
void Invalidate(
PaintInvalidationReason reason = PaintInvalidationReason::kFull) const {
// If a full invalidation reason is already set, do not overwrite it with
// a new reason.
if (IsFullPaintInvalidationReason(GetPaintInvalidationReason()) &&
// However, kUncacheable overwrites any other reason.
reason != PaintInvalidationReason::kUncacheable)
return;
paint_invalidation_reason_ = reason;
}
PaintInvalidationReason GetPaintInvalidationReason() const {
return paint_invalidation_reason_;
}
// A client is considered "just created" if its display items have never been
// validated by any PaintController since it's created.
bool IsJustCreated() const {
return paint_invalidation_reason_ == PaintInvalidationReason::kJustCreated;
}
// Whether the client is cacheable. The uncacheable status is set when the
// client produces any display items that skipped caching of any
// PaintController.
bool IsCacheable() const {
return paint_invalidation_reason_ != PaintInvalidationReason::kUncacheable;
}
// True if the client's display items are cached in PaintControllers without
// needing to update.
bool IsValid() const {
return paint_invalidation_reason_ == PaintInvalidationReason::kNone;
}
String ToString() const;
private:
friend class FakeDisplayItemClient;
friend class ObjectPaintInvalidatorTest;
friend class PaintController;
void Validate() const {
paint_invalidation_reason_ = PaintInvalidationReason::kNone;
}
#if DCHECK_IS_ON()
void OnCreate();
void OnDestroy();
#endif
mutable PaintInvalidationReason paint_invalidation_reason_;
DISALLOW_COPY_AND_ASSIGN(DisplayItemClient);
};
inline bool operator==(const DisplayItemClient& client1,
const DisplayItemClient& client2) {
return &client1 == &client2;
}
inline bool operator!=(const DisplayItemClient& client1,
const DisplayItemClient& client2) {
return &client1 != &client2;
}
PLATFORM_EXPORT std::ostream& operator<<(std::ostream&,
const DisplayItemClient*);
PLATFORM_EXPORT std::ostream& operator<<(std::ostream&,
const DisplayItemClient&);
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_PLATFORM_GRAPHICS_PAINT_DISPLAY_ITEM_CLIENT_H_
|
