Improve tooltips.
Some checks failed
Python Linting / Run Ruff (push) Has been cancelled
Python Linting / Run Pylint (push) Has been cancelled
Build package / Build Test (3.10) (push) Has been cancelled
Build package / Build Test (3.11) (push) Has been cancelled
Build package / Build Test (3.12) (push) Has been cancelled
Build package / Build Test (3.13) (push) Has been cancelled
Build package / Build Test (3.14) (push) Has been cancelled

This commit is contained in:
Talmaj Marinc 2026-05-21 22:14:18 +02:00
parent 2c3be9dd66
commit baad55913f

View File

@ -169,16 +169,11 @@ class DepthAnything3Inference(io.ComfyNode):
io.Combo.Input("resize_method", io.Combo.Input("resize_method",
options=["upper_bound_resize", "lower_bound_resize"], options=["upper_bound_resize", "lower_bound_resize"],
default="upper_bound_resize", default="upper_bound_resize",
tooltip="upper_bound_resize: scale so the longest side = process_res " tooltip="- upper_bound_resize: scale so the longest side = process_res (caps memory, default).\n"
"(caps memory, default). " "- lower_bound_resize: scale so the shortest side = process_res (preserves more detail on tall/wide images, uses more memory)."),
"lower_bound_resize: scale so the shortest side = process_res "
"(preserves more detail on tall/wide images, uses more memory)."),
io.DynamicCombo.Input("mode", io.DynamicCombo.Input("mode",
tooltip="mono: single image or independent batch — " tooltip="- mono: single image or independent batch — use with any model.\n"
"use with any model. " "- multiview: all frames processed together with cross-view attention for geometric consistency; also outputs camera pose — requires DA3-Small or DA3-Base.",
"multiview: all frames processed together with "
"cross-view attention for geometric consistency; "
"also outputs camera pose — requires DA3-Small or DA3-Base.",
options=[ options=[
io.DynamicCombo.Option("mono", []), io.DynamicCombo.Option("mono", []),
io.DynamicCombo.Option("multiview", [ io.DynamicCombo.Option("multiview", [
@ -186,35 +181,23 @@ class DepthAnything3Inference(io.ComfyNode):
options=["saddle_balanced", "saddle_sim_range", options=["saddle_balanced", "saddle_sim_range",
"first", "middle"], "first", "middle"],
default="saddle_balanced", default="saddle_balanced",
tooltip="Which view to use as the geometric anchor " tooltip="Which view to use as the geometric anchor (only applied when S >= 3 and no extrinsics are provided).\n"
"(only applied when S >= 3 and no extrinsics " "- saddle_balanced: picks the view whose CLS-token features are closest to the median across similarity, norm and variance — best general choice.\n"
"are provided). " "- saddle_sim_range: picks the view with the widest similarity spread to other views — favours the most distinct viewpoint.\n"
"saddle_balanced: picks the view whose CLS-token " "- first / middle: deterministic positional fallbacks."),
"features are closest to the median across "
"similarity, norm and variance — best general "
"choice. "
"saddle_sim_range: picks the view with the widest "
"similarity spread to other views — favours "
"the most distinct viewpoint. "
"first / middle: deterministic positional fallbacks."),
io.Combo.Input("pose_method", io.Combo.Input("pose_method",
options=["cam_dec", "ray_pose"], options=["cam_dec", "ray_pose"],
default="cam_dec", default="cam_dec",
tooltip="cam_dec: small MLP on the final camera token " tooltip="- cam_dec: small MLP on the final camera token (DA3-Small/Base).\n"
"(DA3-Small/Base). " "- ray_pose: RANSAC over the DualDPT ray output (DA3-Small/Base only)."),
"ray_pose: RANSAC over the DualDPT ray output "
"(DA3-Small/Base only)."),
]), ]),
]), ]),
], ],
outputs=[ outputs=[
DA3Geometry.Output("geometry", DA3Geometry.Output("geometry",
tooltip="DA3_GEOMETRY dict of raw tensors. " tooltip="DA3_GEOMETRY dict of raw tensors.\n"
"Always: 'depth' (B,H,W), 'image', 'mode'. " "- Always: 'depth' (B,H,W), 'image', 'mode'.\n"
"Optional: 'sky' + 'mask' (Mono/Metric), " "- Optional: 'sky' + 'mask' (Mono/Metric), 'confidence' raw (Small/Base), 'extrinsics' + 'intrinsics' (multi-view)."),
"'confidence' raw (Small/Base), "
"'extrinsics' + 'intrinsics' (multi-view). "
"Feed into DepthAnything3Render or MoGeRender."),
], ],
) )
@ -335,9 +318,9 @@ class DepthAnything3Render(io.ComfyNode):
io.Combo.Input("normalization", io.Combo.Input("normalization",
options=["v2_style", "min_max", "raw"], options=["v2_style", "min_max", "raw"],
default="v2_style", default="v2_style",
tooltip="'v2_style': mean/std normalisation for perceptually balanced results (default). " tooltip="- v2_style: mean/std normalisation for perceptually balanced results (default).\n"
"'min_max': stretches the full depth range to [0, 1] for maximum contrast. " "- min_max: stretches the full depth range to [0, 1] for maximum contrast.\n"
"'raw': no scaling — preserves metric units for DA3-Metric-Large."), "- raw: no scaling — preserves metric units for DA3-Metric-Large."),
io.Boolean.Input("apply_sky_clip", default=False, io.Boolean.Input("apply_sky_clip", default=False,
tooltip="Clip sky-region depth to the 99th percentile of foreground depth before " tooltip="Clip sky-region depth to the 99th percentile of foreground depth before "
"normalisation. Requires a 'sky' tensor in the geometry " "normalisation. Requires a 'sky' tensor in the geometry "
@ -354,10 +337,10 @@ class DepthAnything3Render(io.ComfyNode):
inputs=[ inputs=[
DA3Geometry.Input("geometry"), DA3Geometry.Input("geometry"),
io.DynamicCombo.Input("output", io.DynamicCombo.Input("output",
tooltip="depth: normalised greyscale depth image. " tooltip="- depth: normalised greyscale depth image.\n"
"depth_colored: depth mapped through the Turbo colormap. " "- depth_colored: depth mapped through the Turbo colormap.\n"
"sky_mask: sky probability in [0, 1] (Mono/Metric variants only). " "- sky_mask: sky probability in [0, 1] (Mono/Metric variants only).\n"
"confidence: normalised depth confidence (Small/Base variants only).", "- confidence: normalised depth confidence (Small/Base variants only).",
options=[ options=[
io.DynamicCombo.Option("depth", cls._DEPTH_RENDER_INPUTS), io.DynamicCombo.Option("depth", cls._DEPTH_RENDER_INPUTS),
io.DynamicCombo.Option("depth_colored", cls._DEPTH_RENDER_INPUTS), io.DynamicCombo.Option("depth_colored", cls._DEPTH_RENDER_INPUTS),