File: paint_invalidation_reason.h

package info (click to toggle)
chromium 138.0.7204.183-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,908 kB
  • sloc: cpp: 34,937,088; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (109 lines) | stat: -rw-r--r-- 3,578 bytes parent folder | download | duplicates (10)
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
// Copyright 2014 The Chromium Authors
// 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_INVALIDATION_REASON_H_
#define THIRD_PARTY_BLINK_RENDERER_PLATFORM_GRAPHICS_PAINT_INVALIDATION_REASON_H_

#include <stdint.h>

#include <iosfwd>

#include "third_party/blink/renderer/platform/platform_export.h"

namespace blink {

// Reasons of paint invalidation and raster invalidation. A paint invalidation
// reason (<= kLayoutMax) is set in renderer/core (mostly layout and paint)
// on a DisplayItemClient to indicate it will paint differently from the
// previous painted result. During raster invalidation, we use paint
// invalidation reasons as raster invalidation reasons for display items,
// and raster invalidation reasons (> kLayoutMax) for changes such as
// reordering of display item and paint chunks.
enum class PaintInvalidationReason : uint8_t {
  kNone,
  // This is used for mere size change of LayoutBox that can be invalidated for
  // the changed part instead of the whole box.
  kIncremental,
  // Hit test changes do not require raster invalidation.
  kHitTest,
  kNonFullMax = kHitTest,

  // Non-layout full paint invalidation reasons.

  kStyle,
  kOutline,
  kImage,
  kBackplate,
  kBackground,
  kSelection,
  kCaret,
  kNonLayoutMax = kCaret,

  // Full paint invalidation reasons related to layout changes.

  kLayout,
  kAppeared,
  kDisappeared,
  // Scroll bars, scroll corner, etc.
  kScrollControl,
  // The object is invalidated as a part of a subtree full invalidation (forced
  // by LayoutObject::SetSubtreeShouldDoFullPaintInvalidation()).
  kSubtree,
  kSVGResource,
  // TODO(wangxianzhu): This should probably be a non-layout reason.
  kDocumentMarker,
  kLayoutMax = kDocumentMarker,

  // The following are not used for paint invalidation, but for raster
  // invalidation only.

  // The initial PaintInvalidationReason of a DisplayItemClient.
  kJustCreated,
  kReordered,
  kChunkAppeared,
  kChunkDisappeared,
  kChunkUncacheable,
  kChunkReordered,
  kPaintProperty,
  // For tracking of direct raster invalidation of full composited layers. The
  // invalidation may be implicit, e.g. when a layer is created.
  kFullLayer,
  // This needs to be the last reason because DisplayItemClient::Invalidate()
  // requires this reason to override other reasons.
  kUncacheable,
  kMax = kUncacheable,
};

PLATFORM_EXPORT const char* PaintInvalidationReasonToString(
    PaintInvalidationReason);

inline constexpr bool IsFullPaintInvalidationReason(
    PaintInvalidationReason reason) {
  return reason > PaintInvalidationReason::kNonFullMax;
}

inline constexpr bool IsNonLayoutFullPaintInvalidationReason(
    PaintInvalidationReason reason) {
  return reason > PaintInvalidationReason::kNonFullMax &&
         reason <= PaintInvalidationReason::kNonLayoutMax;
}

inline constexpr bool IsLayoutFullPaintInvalidationReason(
    PaintInvalidationReason reason) {
  return reason > PaintInvalidationReason::kNonLayoutMax &&
         reason <= PaintInvalidationReason::kLayoutMax;
}

inline constexpr bool IsLayoutPaintInvalidationReason(
    PaintInvalidationReason reason) {
  return reason == PaintInvalidationReason::kIncremental ||
         IsLayoutFullPaintInvalidationReason(reason);
}

PLATFORM_EXPORT std::ostream& operator<<(std::ostream&,
                                         PaintInvalidationReason);

}  // namespace blink

#endif  // THIRD_PARTY_BLINK_RENDERER_PLATFORM_GRAPHICS_PAINT_INVALIDATION_REASON_H_