From f11ad0ce28a1d06de80dc35ca94425a3f969d0c2 Mon Sep 17 00:00:00 2001 From: rlartot <94693724+rlartot@users.noreply.github.com> Date: Sun, 25 Oct 2026 01:26:33 +0000 Subject: [PATCH] Ribbon tooltips: written help for six more tools (#2758) (#4592) Combine, Loft, Mirror, Circular pattern, Rectangular pattern and Sweep get the same two-sentence help as the first six (en, fr, ja, zh). Text only. Co-authored-by: Claude Sonnet 5.5 --- assets/locales/en.json | 6 ++++++ assets/locales/fr.json | 6 ++++++ assets/locales/ja.json | 6 ++++++ assets/locales/zh.json | 6 ++++++ crates/ui-egui/src/command_help.rs | 21 +++++++++++++++++---- 5 files changed, 41 insertions(+), 4 deletions(-) diff --git a/assets/locales/en.json b/assets/locales/en.json index c8dc9b70e..cb37d5534 100644 --- a/assets/locales/en.json +++ b/assets/locales/en.json @@ -1121,11 +1121,17 @@ "help.mit": "MIT licence", "help.notice": "NOTICE", "help.solid.chamfer": "Cuts the selected edges with a flat bevel of the distance you set. Use it to break sharp edges or to ease the entry of a pin or screw.", + "help.solid.combine": "Joins bodies, cuts them out of a target body, or keeps only the volume they share, and can keep the tool bodies. Use it to merge parts, to cut one shape with another or to find where two bodies overlap.", "help.solid.extrude": "Pushes a sketch profile into 3D along a distance, adding or removing material. Use it to turn a flat outline into a block, a boss or a pocket.", "help.solid.fillet": "Rounds the selected edges with a smooth circular blend of the radius you set. Use it to soften sharp edges for strength, comfort or looks.", "help.solid.hole": "Drills a round hole of the diameter you set at a chosen point on a face. Use it for screw clearances, pins and other simple round openings.", + "help.solid.loft": "Blends a smooth solid between two or more sketch profiles, or from a profile to a point. Use it for transitions, funnels, handles and any shape that changes section along its length.", + "help.solid.mirror": "Makes a mirrored copy of the selected bodies or features across a plane, and can merge it with the original. Use it for symmetric parts, so that you model one half and get both.", + "help.solid.pattern.circular": "Repeats the selected objects around an axis, for the count and total angle you set. Use it for bolt circles, spokes, fins and teeth.", + "help.solid.pattern.rectangular": "Repeats the selected objects in one or two directions with the count and spacing you set. Use it for rows and grids of holes, ribs, pins or feet.", "help.solid.revolve": "Spins a sketch profile around an axis to make a round solid. Use it for shafts, knobs, bowls and any part that is round about a centre line.", "help.solid.shell": "Hollows out a solid, leaving walls of the thickness you set, and can open the faces you pick. Use it for boxes, covers and other thin-walled parts.", + "help.solid.sweep": "Drags a sketch profile along a path to make a solid. Use it for pipes, rails, handles and any part of constant section that follows a curve.", "help.third_party": "Third-party licences", "home.back": "Back to {name}", "home.crashes": "Crash reports", diff --git a/assets/locales/fr.json b/assets/locales/fr.json index 3b8ca7183..0df580fc4 100644 --- a/assets/locales/fr.json +++ b/assets/locales/fr.json @@ -868,11 +868,17 @@ "help.mit": "Licence MIT", "help.notice": "NOTICE", "help.solid.chamfer": "Coupe les arêtes sélectionnées par un biseau plat de la distance indiquée. À utiliser pour casser des arêtes vives ou faciliter l'entrée d'une goupille ou d'une vis.", + "help.solid.combine": "Joint des corps, les retire d'un corps cible ou ne garde que le volume qu'ils ont en commun, et peut conserver les corps outils. À utiliser pour fusionner des pièces, tailler une forme avec une autre ou repérer où deux corps se recouvrent.", "help.solid.extrude": "Pousse le profil d'une esquisse en 3D sur une distance, en ajoutant ou en retirant de la matière. À utiliser pour transformer un contour plat en bloc, en bossage ou en poche.", "help.solid.fillet": "Arrondit les arêtes sélectionnées par un raccord circulaire lisse du rayon indiqué. À utiliser pour adoucir des arêtes vives par souci de solidité, de confort ou d'aspect.", "help.solid.hole": "Perce un trou rond du diamètre indiqué en un point choisi d'une face. À utiliser pour les passages de vis, les goupilles et autres ouvertures rondes simples.", + "help.solid.loft": "Raccorde en douceur deux profils d'esquisse ou plus, ou un profil et un point, par un solide lissé. À utiliser pour les transitions, entonnoirs, poignées et toute forme dont la section change sur sa longueur.", + "help.solid.mirror": "Crée une copie symétrique des corps ou fonctions sélectionnés par rapport à un plan, et peut la fusionner avec l'original. À utiliser pour les pièces symétriques : on modélise une moitié et on obtient les deux.", + "help.solid.pattern.circular": "Répète les objets sélectionnés autour d'un axe, selon le nombre et l'angle total indiqués. À utiliser pour les cercles de perçages, rayons, ailettes et dents.", + "help.solid.pattern.rectangular": "Répète les objets sélectionnés dans une ou deux directions, selon le nombre et l'espacement indiqués. À utiliser pour les rangées et grilles de trous, nervures, goupilles ou pieds.", "help.solid.revolve": "Fait tourner le profil d'une esquisse autour d'un axe pour obtenir un solide de révolution. À utiliser pour les arbres, boutons, bols et toute pièce ronde autour d'une ligne centrale.", "help.solid.shell": "Évide un solide en laissant des parois de l'épaisseur indiquée, et peut ouvrir les faces choisies. À utiliser pour les boîtes, couvercles et autres pièces à parois minces.", + "help.solid.sweep": "Entraîne le profil d'une esquisse le long d'une trajectoire pour obtenir un solide. À utiliser pour les tuyaux, rails, poignées et toute pièce de section constante qui suit une courbe.", "help.third_party": "Licences tierces", "home.back": "Revenir à {name}", "home.crashes": "Rapports de plantage", diff --git a/assets/locales/ja.json b/assets/locales/ja.json index 7c362e9f1..143283a4d 100644 --- a/assets/locales/ja.json +++ b/assets/locales/ja.json @@ -1121,11 +1121,17 @@ "help.mit": "MITライセンス", "help.notice": "NOTICE", "help.solid.chamfer": "選択した辺を、指定した距離で平らに斜めに削ります。鋭い角を落とすときや、ピンやねじを入れやすくするときに使います。", + "help.solid.combine": "複数の立体を結合したり、対象の立体から切り取ったり、共通する体積だけを残したりでき、工具の立体を残すこともできます。部品の結合、ある形での切り抜き、2つの立体が重なる範囲の確認に使います。", "help.solid.extrude": "スケッチの輪郭を指定した距離だけ立体方向に押し出し、材料を足したり削ったりします。平面の図形をブロック、突起、ポケットにするときに使います。", "help.solid.fillet": "選択した辺を、指定した半径のなめらかな円弧で丸めます。強度や持ちやすさ、見た目のために鋭い角を和らげるときに使います。", "help.solid.hole": "面上の指定した位置に、指定した直径の丸い穴をあけます。ねじのクリアランスやピン穴など、単純な丸い開口に使います。", + "help.solid.loft": "2つ以上のスケッチの輪郭の間、または輪郭から点までを、なめらかな立体でつなぎます。移行部、漏斗、ハンドルなど、長さに沿って断面が変わる形に使います。", + "help.solid.mirror": "選択した立体またはフィーチャを平面に対して鏡像でコピーし、元の立体と結合することもできます。左右対称の部品で、半分だけモデリングして両側を得るときに使います。", + "help.solid.pattern.circular": "選択したオブジェクトを、指定した数と全体の角度で軸のまわりに繰り返し配置します。ボルト円、スポーク、フィン、歯などに使います。", + "help.solid.pattern.rectangular": "選択したオブジェクトを、指定した数と間隔で1方向または2方向に繰り返し配置します。穴、リブ、ピン、脚の列や格子状の配置に使います。", "help.solid.revolve": "スケッチの輪郭を軸のまわりに回転させ、丸い立体を作ります。軸、つまみ、ボウルなど、中心線まわりに丸い部品に使います。", "help.solid.shell": "立体の中をくり抜き、指定した厚さの壁を残します。選んだ面を開口にすることもできます。箱、カバーなどの薄肉の部品に使います。", + "help.solid.sweep": "スケッチの輪郭をパスに沿って動かし、立体を作ります。パイプ、レール、ハンドルなど、一定の断面で曲線をたどる部品に使います。", "help.third_party": "サードパーティライセンス", "home.back": "{name} に戻る", "home.crashes": "クラッシュレポート", diff --git a/assets/locales/zh.json b/assets/locales/zh.json index 2d910b75f..9a188da96 100644 --- a/assets/locales/zh.json +++ b/assets/locales/zh.json @@ -1121,11 +1121,17 @@ "help.mit": "MIT 许可证", "help.notice": "NOTICE", "help.solid.chamfer": "用指定的距离在所选边上切出一个平直的斜面。用于去除锐边,或使销钉、螺钉更容易插入。", + "help.solid.combine": "将多个实体合并、从目标实体中切除,或只保留它们共有的体积,还可以保留工具实体。用于合并零件、用一个形体切割另一个形体,或找出两个实体重叠的位置。", "help.solid.extrude": "将草图轮廓按指定距离拉伸为三维形体,可以增加或去除材料。用于把平面轮廓变成方块、凸台或凹槽。", "help.solid.fillet": "用指定半径的平滑圆弧将所选的边倒圆。用于出于强度、手感或外观的考虑而柔化锐边。", "help.solid.hole": "在面上的指定位置钻出指定直径的圆孔。用于螺钉过孔、销孔等简单的圆形开口。", + "help.solid.loft": "在两个或更多草图轮廓之间,或从轮廓到一个点,生成平滑过渡的实体。用于过渡段、漏斗、手柄等截面沿长度变化的形体。", + "help.solid.mirror": "将所选实体或特征相对于一个平面生成镜像副本,还可以与原件合并。用于对称零件,只需建一半即可得到两侧。", + "help.solid.pattern.circular": "将所选对象按指定的数量和总角度绕轴重复排列。用于螺栓圆周分布、辐条、散热片和轮齿。", + "help.solid.pattern.rectangular": "将所选对象按指定的数量和间距沿一个或两个方向重复排列。用于成排或成网格的孔、加强筋、销钉或支脚。", "help.solid.revolve": "将草图轮廓绕一条轴旋转,生成圆形的实体。用于轴、旋钮、碗等围绕中心线呈圆形的零件。", "help.solid.shell": "将实体掏空,留下指定厚度的壁,还可以打开所选的面。用于盒子、盖子等薄壁零件。", + "help.solid.sweep": "沿路径拖动草图轮廓生成实体。用于管道、导轨、手柄等截面恒定且沿曲线延伸的零件。", "help.third_party": "第三方许可证", "home.back": "返回 {name}", "home.crashes": "崩溃报告", diff --git a/crates/ui-egui/src/command_help.rs b/crates/ui-egui/src/command_help.rs index 464772e8e..af53e6dbe 100644 --- a/crates/ui-egui/src/command_help.rs +++ b/crates/ui-egui/src/command_help.rs @@ -6,7 +6,20 @@ use crate::i18n; /// The commands that have help text. Each one needs a `help.` message in the catalogs. -pub const DOCUMENTED: &[&str] = &["solid.chamfer", "solid.extrude", "solid.fillet", "solid.hole", "solid.revolve", "solid.shell"]; +pub const DOCUMENTED: &[&str] = &[ + "solid.chamfer", + "solid.combine", + "solid.extrude", + "solid.fillet", + "solid.hole", + "solid.loft", + "solid.mirror", + "solid.pattern.circular", + "solid.pattern.rectangular", + "solid.revolve", + "solid.shell", + "solid.sweep", +]; /// The help for `command` in the current language, when it has any. pub fn help(command: &str) -> Option { @@ -96,7 +109,7 @@ mod tests { for id in DOCUMENTED { assert!(help(id).is_some_and(|text| !text.is_empty()), "{id}"); } - assert!(help("solid.pattern.rectangular").is_none()); + assert!(help("solid.draft").is_none()); } #[test] @@ -104,7 +117,7 @@ mod tests { assert_eq!(row_tip("solid.shell", "Shell", Some("S"), None).as_deref(), Some("Shell (S)")); assert_eq!(row_tip("solid.hole", "Hole", None, None).as_deref(), Some("Hole")); assert_eq!(row_tip("solid.hole", "Hole", None, Some("Select a face")).as_deref(), Some("Select a face")); - assert_eq!(row_tip("solid.pattern.rectangular", "Pattern", None, None), None); - assert_eq!(row_tip("solid.pattern.rectangular", "Pattern", None, Some("No body")).as_deref(), Some("No body")); + assert_eq!(row_tip("solid.draft", "Draft", None, None), None); + assert_eq!(row_tip("solid.draft", "Draft", None, Some("No body")).as_deref(), Some("No body")); } }