Project > Field

Photo Browser

Shows this model's photo pins as thumbnails grouped by level, grid or linked object. Filter them, go to a pin's view and object, open a photo, delete a pin or export an HTML photo report.

Status

The public ask

No public source is on record for this tool.

Events it listens to

It needs these Navisworks event hooks, so installing it also copies the shared hooks folder:

• doc-closed
• doc-opened

Files

Paths are relative to the Playground.extension folder.

• Project.tab/Field.panel/Photo_Browser.pushbutton/bundle.yaml
• Project.tab/Field.panel/Photo_Browser.pushbutton/icon.dark.png
• Project.tab/Field.panel/Photo_Browser.pushbutton/icon.png
• Project.tab/Field.panel/Photo_Browser.pushbutton/icon.small.dark.png
• Project.tab/Field.panel/Photo_Browser.pushbutton/icon.small.png
• Project.tab/Field.panel/Photo_Browser.pushbutton/script.py

Install

1. Only this tool. In Navisworks, click pyNavis > Playground, search for Photo Browser, tick it and click Install.
2. The whole extension. Download Playground.extension.zip, unzip it, put the Playground.extension folder in %APPDATA%\pyNavis\extensions\, and click pyNavis > Reload. Photo Browser is on the Project tab, Field panel.

You need pyNavis 1.3.0 or later.

Source

The tool's own files, word for word as published in pynavis/Playground. Paths are relative to the Playground.extension folder.

script.py

The script that runs on a click.

# -*- coding: utf-8 -*-
"""Opens the photo pins of this model as thumbnails grouped by level, grid or object, with Go to and a report."""
from pynavis import toast

from namo import field_photobrowser, fourd_common, photopins, ui


def run():
    if ui.is_runner():
        toast.info('Photo Browser is a window', 'Run it from the ribbon.')
        return
    doc = fourd_common.active_doc()
    records = photopins.store(doc)
    pins = records.list()
    if not pins:
        toast.info('No photo pins in this model', 'Use Photo Pins to pin site photos to points in the model.')
        return
    field_photobrowser.show(doc, records, pins)
    if records.note:
        toast.info('Photo pins from local data', records.note)


run()

Library modules this tool uses

From the shared namo library, which installs with every tool. Each name opens the module on GitHub.

• namo.field_photobrowserPhoto Browser: a modeless window of photo-pin thumbnails grouped by level, grid or linked object, with a filter, Go to, Open photo, Delete pin and an HTML photo report.
• namo.fourd_commonHelpers the 4D, Quantities and Field tools share: scopes, default files, text.
• namo.photopinsPhoto Pins and the Photo Browser: site photos pinned to points in the model.
• namo.uiWPF building blocks for Playground tools, themed from the pyNavis design system.

bundle.yaml

The bundle contract: the keys pyNavis reads for this tool.

title: Photo\nBrowser
tooltip: Shows this model's photo pins as thumbnails grouped by level, grid or linked object. Filter them, go to a pin's view and object, open a photo, delete a pin or export an HTML photo report.
context: doc