gs_catalog_html — DRIVE `gsplat` op

• 数据种类:table → table

• 调用: import fullseye as fs; fs.ledger.gs_catalog_html(items, out_path=None, *, title='3DGS catalogue', lang=('ja', 'en', 'zh', 'tw', 'ko', 'de', 'hi', 'fr'), up=(0.0, 0.0, 1.0), bg: 'str' = 'gray', max_bytes: 'int' = 16777216, unit_mm: 'float' = 1000.0, fov_deg: 'float' = 35.0, thumb_px: 'int' = 256, dims=True, spin: 'bool' = True, spin_deg_per_s: 'float' = 20.0, bake_light=(0.3, -0.5, 0.8), ambient: 'float' = 0.35, max_radius: 'int' = 64, mobile_quality=0.5, mobile_above: 'int' = 300000) -> 'dict'(要直接调用实现,import gsviewer; gsviewer.gs_catalog_html(items, out_path=None, *, title='3DGS catalogue', lang=('ja', 'en', 'zh', 'tw', 'ko', 'de', 'hi', 'fr'), up=(0.0, 0.0, 1.0), bg: 'str' = 'gray', max_bytes: 'int' = 16777216, unit_mm: 'float' = 1000.0, fov_deg: 'float' = 35.0, thumb_px: 'int' = 256, dims=True, spin: 'bool' = True, spin_deg_per_s: 'float' = 20.0, bake_light=(0.3, -0.5, 0.8), ambient: 'float' = 0.35, max_radius: 'int' = 64, mobile_quality=0.5, mobile_above: 'int' = 300000) -> 'dict';从台账取用则 opsdrive.get("gs_catalog_html"))

• GPU:无(仅 CPU 参考实现)

用法

写出单个自包含的目录 HTML:从缩略图列表中选择多个 3DGS 并查看。

> 以下的详细说明为原文 —— 摘要与标题已翻译。

各品のサムネイルは gsplatnp.gs_render(numpy の EWA 描画)が、ページの最初の視点と同じカメラで描いた PNG (thumb_px 四方)。押すと同じページの中で 3-D の表示に切り替わり、「一覧に戻る」(Esc でも)で戻る。データは選ばれた品の分だけ DecompressionStream で伸ばし、切り替えると前の品のテクスチャ・バッファを解放する。容量の上限 max_bytes は全体で、品ごとの割り当て = (上限 − ページ − サムネイル) をガウシアンの数に比例して配る。

割り当てを超える品は gs_viewer_html と同じ順で間引き、品ごとの記録を返す。

Parameters

items : list of dict

{"gs": dict | "path": str, "name": str|{lang}, "desc": str|{lang}, "note": str|{lang}, "hotspots": [...], "camera": {...}}。name は必須。

out_path, title, lang, up, bg, max_bytes, unit_mm, fov_deg, dims, spin, bake_light, ambient, max_radius, mobile_quality :

gs_viewer_html と同じ。

thumb_px : int

サムネイルの 1 辺(画素)。

Returns

dict

path・bytes・items(品ごとの n_input / n_kept / n_dropped / thinned / dims_mm /

thumb_bytes / camera)・n_dropped_total・external_urls(= 0)。out_path が None なら html も。

Raises

ValueError

items が空・name が無い・gs と path のどちらも無い、ほかは gs_viewer_html と同じ。

空の入力(items が空の list)は ValueError。

Examples

>>> import gsviewer

>>> r = gsviewer.gs_catalog_html([{"path": "mug.ply", "name": "Mug"}, {"path": "shoe.splat", "name": "Shoe"}],

... "catalog.html", title="Shop") # doctest: +SKIP

参考(示例数据、文献)

• 示例数据目录(下载 URL / 许可证) —— 2-D 用 skimage.data(BSD/公有领域)加合成图,3-D 给出真实数据源(Stanford/PDS 等)的下载 URL。

• 算子来历与参考文献 —— 该算子族所依据的研究/方法出处。

• 算法的正典(作者、年份)与用途见上面的族使用指南。

可运行的示例(实际调用该算子并已验证的样例)

• gsplat_product_viewer — py -3.11 examples/gsplat_product_viewer.py

类型可衔接的下一个算子(可接受 `table` 作为输入)

course_layout · course_occupancy · course_contains · world_build · world_camera · world_move · lidar_scan · rss_longitudinal_same

同类别(`gsplat`)

gs_from_world · gs_update · gs_render · gs_render_fn · gs_read_file · gs_viewer_html

*Provenance: gsviewer.py — DRIVE 算子登记表。本条目由 tools/opdocs.py md 自动生成(请勿手工编辑)。*

gs_catalog_html — DRIVE gsplat op

用法