Some minor docs improvements (#7614)
This commit is contained in:
parent
cfca7ebd6d
commit
da39198142
|
|
@ -1,4 +1,4 @@
|
|||
//! Helpers for zooming the whole GUI of an app (changing [`Context::pixels_per_point`].
|
||||
//! Helpers for zooming the whole GUI of an app (changing [`Context::pixels_per_point`]).
|
||||
//!
|
||||
use crate::{Button, Context, Key, KeyboardShortcut, Modifiers, Ui};
|
||||
|
||||
|
|
|
|||
|
|
@ -50,8 +50,8 @@ This is so that you can set `UPDATE_SNAPSHOTS=true` and update all tests, withou
|
|||
If you want to update all snapshot images, even those that are within error margins,
|
||||
run with `UPDATE_SNAPSHOTS=force`.
|
||||
|
||||
If you want to have multiple snapshots in the same test, it makes sense to collect the results in a `Vec`
|
||||
([look here](https://github.com/emilk/egui/blob/70a01138b77f9c5724a35a6ef750b9ae1ab9f2dc/crates/egui_demo_lib/src/demo/demo_app_windows.rs#L388-L427) for an example).
|
||||
If you want to have multiple snapshots in the same test, it makes sense to collect the results in a `SnapshotResults`
|
||||
([look here](https://github.com/emilk/egui/blob/d1fcd740ded5d69016c993a502b52e67f5d492d7/crates/egui_demo_lib/src/demo/demo_app_windows.rs#L387-L420) for an example).
|
||||
This way they can all be updated at the same time.
|
||||
|
||||
You should add the following to your `.gitignore`:
|
||||
|
|
@ -67,7 +67,7 @@ You should add the following to your `.gitignore`:
|
|||
* …they are brittle since unrelated side effects (like a change in color) can cause the test to fail
|
||||
* …images take up repo space
|
||||
* images should…
|
||||
* …be checked in or otherwise be available (egui use [git LFS](https://git-lfs.com/) files for this purpose)
|
||||
* …be checked in or otherwise be available (egui uses [git LFS](https://git-lfs.com/) files for this purpose)
|
||||
* …depict exactly what's tested and nothing else
|
||||
* …have a low resolution to avoid growth in repo size
|
||||
* …have a low comparison threshold to avoid the test passing despite unwanted differences (the default threshold should be fine for most usecases!)
|
||||
|
|
|
|||
|
|
@ -52,6 +52,7 @@ impl Display for ExceededMaxStepsError {
|
|||
}
|
||||
|
||||
/// The test Harness. This contains everything needed to run the test.
|
||||
///
|
||||
/// Create a new Harness using [`Harness::new`] or [`Harness::builder`].
|
||||
///
|
||||
/// The [Harness] has a optional generic state that can be used to pass data to the app / ui closure.
|
||||
|
|
|
|||
|
|
@ -26,6 +26,7 @@ pub struct SnapshotOptions {
|
|||
}
|
||||
|
||||
/// Helper struct to define the number of pixels that can differ before the snapshot is considered a failure.
|
||||
///
|
||||
/// This is useful if you want to set different thresholds for different operating systems.
|
||||
///
|
||||
/// The default values are 0 / 0.0
|
||||
|
|
|
|||
|
|
@ -4,6 +4,6 @@ script_path=$( cd "$(dirname "${BASH_SOURCE[0]}")" ; pwd -P )
|
|||
cd "$script_path/.."
|
||||
|
||||
cargo doc -p eframe --target wasm32-unknown-unknown --lib --no-deps
|
||||
cargo doc -p emath -p epaint -p egui -p eframe -p egui-winit -p egui_extras -p egui_glow --lib --no-deps --all-features --open
|
||||
cargo doc -p emath -p epaint -p egui -p eframe -p egui-winit -p egui_extras -p egui_glow -p egui_kittest --lib --no-deps --all-features --open
|
||||
|
||||
# cargo watch -c -x 'doc -p emath -p epaint -p egui --lib --no-deps --all-features'
|
||||
|
|
|
|||
Loading…
Reference in New Issue