The Perforce service's primary task is to version files, so Swarm makes it easy to browse the depot. Start browsing by clicking thelink in the top toolbar.
Swarm displays a list of breadcrumb links to help you quickly navigate to higher level directories quickly.
Links with folder icons represent directories of files within the depot. Click a directory link to display the contents of that directory.
Click thelink with the up-arrow icon, when it appears, to navigate to the current directory's parent.
Links with dog-eared page icons represent individual files within the depot. See below for more information.
Click the “History” for more information.tab to display the list of changes made to files in the current directory, or any directories it contains. See
Swarm creates links for files and directories wherever they appear in the Swarm UI.
Browsing deleted files and folders
When thecheckbox is checked, Swarm includes deleted folders and files in the file display.
Deleted folders and files are presented slightly muted compared to non-deleted entries.
When Swarm is asked to display a file, if the file is a type that Swarm can display, Swarm presents the file's contents. Clicking thebutton displays the file content with no surrounding page markup. Clicking the button causes the file to be downloaded.
Along with the file's name, Swarm displays the version number for the
currently displayed file. For example, this heading indicates that version
logo-lg.png is being
displayed. Every version of a file is available on the
If the version of a file being previewed has been deleted, the version number appears in red:
Swarm displays the contents of text files (include the Perforce
line numbers. When possible, syntax highlighting is applied to make
identification of various elements within the file easier.
For more information on Perforce filetypes, see Perforce Command Reference: File Types
Clickto add a column to the display that identifies the userid responsible for each line of the file.
Each userid presented is a link that, when clicked, displays the changelist that provided the associated text. Muted userids indicate that the associated text is from the same changelist as the line above. For example, the userid gnicol is responsible for lines 1 through 9 in the screenshot above.
When you hover your pointer over a userid in the blame column, a tooltip appears displaying the associated changelist description.
Swarm displays web-safe images.
The checkerboard background in this example is not part of the logo; it helps identify where transparency exists.
imagick (an optional module that integrates
ImageMagick into PHP) is installed, Swarm can also display the following
Swarm 2014.1 includes support for displaying select 3D model file types in the browser:
Supported file types include:
DAE - including any referenced web-safe texture images.
STL - both binary and ASCII versions of the format.
OBJ - including any referenced
MTLfiles, and web-safe texture images.
When Swarm can display a 3D model, it renders a generic grid stage and places the model in the center, scaled to make viewing straightforward. A toggle control appears in the top right: when enabled, you can control the view with the mouse, and when not enabled, permits auto-rotation to occur (when possible).
Click and hold the left mouse button to begin rotating the view. Drag while holding the left mouse button to rotate the view.
Click and hold the right mouse button to begin panning the view. Drag while holding the right mouse button to pan the view.
Roll the mouse wheel up or down to adjust the magnification of the view.
When possible, a second control appears allowing you to toggle between showing the model with surfaces, or just showing the model's wireframe.
For systems with hardware acceleration, if your browser supports WebGL and hardware acceleration is enabled, Swarm renders the model and enables auto-rotation.