Mirrors/servo
1
0
Fork 0
mirror of https://github.com/servo/servo.git synced 2025-08-04 05:00:08 +01:00
Code Issues Projects Releases Packages Wiki Activity

style: Document the restyle_damage module.

Browse source
This commit is contained in:
Emilio Cobos Álvarez 2017-01-01 22:11:05 +01:00
parent a5005a9967
commit 2cef9c948e
No known key found for this signature in database
GPG key ID: 056B727BB9C1027C
1 changed files with 9 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

15
components/style/servo/restyle_damage.rs
View file

@ -2,6 +2,11 @@
* License, v. 2.0. If a copy of the MPL was not distributed with this * 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/. */ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
//! The restyle damage is a hint that tells layout which kind of operations may
//! be needed in presence of incremental style changes.
#![deny(missing_docs)]
use computed_values::display; use computed_values::display;
use heapsize::HeapSizeOf; use heapsize::HeapSizeOf;
use properties::ServoComputedValues; use properties::ServoComputedValues;
@ -53,6 +58,8 @@ impl HeapSizeOf for ServoRestyleDamage {
} }
impl ServoRestyleDamage { impl ServoRestyleDamage {
/// Compute the appropriate restyle damage for a given style change between
/// `old` and `new`.
pub fn compute(old: &Arc<ServoComputedValues>, pub fn compute(old: &Arc<ServoComputedValues>,
new: &Arc<ServoComputedValues>) -> ServoRestyleDamage { new: &Arc<ServoComputedValues>) -> ServoRestyleDamage {
compute_damage(old, new) compute_damage(old, new)
@ -60,10 +67,6 @@ impl ServoRestyleDamage {
/// Returns a bitmask that represents a flow that needs to be rebuilt and /// Returns a bitmask that represents a flow that needs to be rebuilt and
/// reflowed. /// reflowed.
///
/// Use this instead of `ServoRestyleDamage::all()` because
/// `ServoRestyleDamage::all()` will result in unnecessary sequential resolution
/// of generated content.
pub fn rebuild_and_reflow() -> ServoRestyleDamage { pub fn rebuild_and_reflow() -> ServoRestyleDamage {
REPAINT | REPOSITION | STORE_OVERFLOW | BUBBLE_ISIZES | REFLOW_OUT_OF_FLOW | REFLOW | REPAINT | REPOSITION | STORE_OVERFLOW | BUBBLE_ISIZES | REFLOW_OUT_OF_FLOW | REFLOW |
RECONSTRUCT_FLOW RECONSTRUCT_FLOW
@ -81,8 +84,8 @@ impl ServoRestyleDamage {
} }
} }
/// Supposing the *parent* of a flow with the given `position` property has this damage, /// Supposing the *parent* of a flow with the given `position` property has
/// returns the damage that we should add to this flow. /// this damage, returns the damage that we should add to this flow.
pub fn damage_for_child(self, pub fn damage_for_child(self,
parent_is_absolutely_positioned: bool, parent_is_absolutely_positioned: bool,
child_is_absolutely_positioned: bool) child_is_absolutely_positioned: bool)