ExPikaPaka
d2ba88c93d
rest of the panel The animations advanced one frame per mouse movement and stood still whenever the mouse did. schedule_extra_frame() only guarantees an idle event at the moment the next frame is due; GLCanvas3D::on_idle() returns without rendering anything unless something marked the canvas dirty by then, and nothing had. set_dirty() on the gizmo is what on_idle reads, through GLGizmoBase::update_items_state(), to find out there are frames still to draw. Thirty-odd more pictures, covering the paint tools, brush size, the connected-area fill, the five views, the five projections, subdivision, feature-adaptive refinement, remeshing, hard edges, slivers, geometry smoothing, filament mixing and denoise. The generator grew three more drawing languages beside the shaded relief, each picked by what the setting is rather than by taste: a flat mesh of triangles where the subject is the mesh or a tool, a section where the subject is where the surface sits relative to where it was, and a flat ramp of greys where the subject is which filament a spot ends up as. Lighting a colour illustration or looking down on a vertical change would both add a second thing moving between two pictures meant to differ in one. Mapping is one ball with the checker laid on it five ways, which is the whole of what choosing a projection does - except Unwrap, which is not a projection onto the model and so is drawn as the flat layout it produces.
6.6 KiB
Tooltip illustrations
The texture-displacement panel's tooltips can carry a picture under their text: a still image, or a short animation that loops while the tooltip is open. Several settings in that panel describe a shape rather than a number - what Rotation turns, what Tile repeats, what Invert turns inside out - and a sentence about a shape is read twice and understood once.
Where a tooltip is drawn
GLGizmoTextureDisplacement::panel_tooltip() replaces ImGuiWrapper::tooltip() throughout the panel.
It differs in two ways.
It places the tooltip beside the panel instead of under the mouse. The panel is pinned to the right
edge of the canvas, so a tooltip following the mouse covers the control it is explaining, and one
carrying a picture covers most of the panel with it. The tooltip goes to the left of
m_tooltip_anchor_min/_max - the panel's own screen rectangle, or the texture picker's while that
popup is up and the tooltip comes from inside it - and to the right only when there is no room on the
left. This is the placement the picker popup itself already uses.
ImGui normally keeps a tooltip glued to the mouse and ignores SetNextWindowPos(). Orca's imgui
branch honours a position set for a tooltip (see the ImGuiWindowFlags_Tooltip branch of Begin() in
deps_src/imgui/imgui.cpp) and still clamps the result inside the canvas, which is what keeps a tall
tooltip near the bottom edge on screen.
It also gives the tooltip a fixed width rather than one derived from its text, because a picture has to be laid out against something, and a column of tooltips that are all one width is steadier to read.
Where the pictures live
resources/images/texture_displacement/, as PNG, JPG, BMP or GIF. A tooltip names them by file:
hover_tip(_u8L("Repeats the texture across the painted area. ..."),
{ { "tile_off.png", _L("Off") }, { "tile_on.png", _L("On") } });
Several in one tooltip are laid out side by side at equal widths, which is how a setting is shown as a comparison - the same model at two values of it. The caption under each is translated; the file name is not.
A file that is missing or will not decode is skipped, and a tooltip whose pictures are all missing is exactly the text tooltip it was before. So the art for a tooltip can land after the tooltip does, and a half-finished set never breaks the panel.
Decoding and playback
slic3r/GUI/AnimatedTexture.hpp decodes a file once and uploads one GL texture per frame. Stills go
through wxImage; GIFs go through wxGIFDecoder, whose raw palette indices are composited here frame
by frame, replaying the disposal method each frame asks for. That replay is what makes an animation
look continuous: a GIF frame is a sub-rectangle drawn over what came before it, so an animation that
only re-sends the pixels that changed draws as a flicker of disconnected patches without it.
A frame delay of 0 or 1 hundredths of a second is read as 100 ms, the convention browsers settle on, so an animation authored against that plays at the speed it was authored at.
The animation restarts when its tooltip opens, rather than running off a free-running clock: these are short loops of one setting going from one value to another, and joining one halfway through shows the end of a change the user never saw the start of.
Driving the frames takes two calls, not one. GLCanvas3D::schedule_extra_frame() only guarantees an
idle event at the moment the next frame is due; GLCanvas3D::on_idle() returns without rendering
anything unless something has marked the canvas dirty by then, so an animation left to the timer alone
advances one frame per mouse movement and stands still whenever the mouse does. set_dirty() on the
gizmo is what on_idle reads, through GLGizmoBase::update_items_state(), to find out there are frames
still to draw. The pair of them is what makes an animation play at its own speed and stop costing
anything the moment its tooltip closes.
Making one
scripts/gen_texture_displacement_tips.py draws the lot, in four languages, picked by what the
setting actually is:
- A shaded relief, for the settings that are about a pattern: Depth, Tile, Tile size, Rotation, Repeat/Mirror, Smoothing, Edge fade, Invert, Blend and the Normal, Fast, Checker and Distortion views. One motif - a ring inside a square frame - runs through all of them, because using one shape everywhere is what lets two pictures be compared: whatever differs between them is the setting, since nothing else is.
- A flat mesh of triangles, for the settings that are about the mesh or about a tool: the paint tools, brush size, the connected-area fill, subdivision, feature-adaptive refinement, remeshing, hard edges, slivers and the wireframe view. These carry the one accent colour in the set, meaning "painted", because that is the only thing in such a picture that is not geometry.
- A section, for Midlevel and for smoothing the geometry. The reason generalises: shading reads slopes, so a height field moved up or down as a whole shades identically to where it started, and any setting whose meaning is where the surface sits relative to where it was is invisible from above and has to be drawn from the side.
- A flat ramp of greys, for Mix filaments, Mixed colors and Denoise. Those are about which filament a spot ends up as; lighting one would only add a second thing changing between two pictures meant to differ in one.
The five Mapping pictures are one ball with a checker laid on it five ways, which is the whole of what choosing a projection does - except Unwrap, which is not a projection onto the model at all and so is drawn as the flat layout it produces.
Captures of the real tool are still the first choice for anything involving a real model or real filament colour: Bake, the mixed-colour count on a photograph, Adjust placement, the frame window and the UV editor's seam tool have no picture yet for that reason.
Either way:
- Square, around 256 px (192 for an animation, where every frame ships). The tooltip is about 20 em wide, so that is roughly native size on a 100% display and downscales cleanly above it. A single picture is capped at 10 em tall and centred, two side by side take half the width each.
- Neutral grey. These say what a shape does; colour in one reads as a third thing the setting does, and has to work against both themes.
- Animations loop seamlessly and stay short - 16 frames at 100 ms, under about 150 KB. They sit in
resources/, which ships with every copy of the application. A sweep driven by a cosine over the frame count loops with no step, since it starts and ends at the same value and the same rate. - No text in the picture. Captions are translated; pixels are not.