Unify Manual

Your complete reference to PlugInGuru's creative playground!

User Tools

Site Tools


linked-media

This is an old revision of the document!


Linked Media

Unify v1.8 adds support for linked media. Every patch in a library can optionally have a link to an associated media item. Three distinct media types are supported:

  1. An image file (stored somewhere under the library's Media folder),
  2. A HTML file (also stored under the library's Media folder), or
  3. A URL link to content hosted on a separate server (e.g. on the Internet)

The presence of a link is indicated by a colored outline around the patch's library image, shown just to the right of the patch metadata banner. (See Navigating Unify's graphical user interface.) Clicking the library image opens the linked media item.

  • Local image files are opened in the Unify window; click anywhere in the image to close it.
  • Local HTML files are also opened in the Unify window, in a simplified browser interface with Back and Close buttons at the top.
  • Internet URL links are usually opened in the user's default web browser, but these can also be opened in the Unify window if desired, in one of two ways:
    • The default can be changed in the Settings view
    • Holding down Option/ALT while clicking the library image will override the default on a one-time basis.

Links for a library's patches are defined in a file links.txt which may optionally reside in the library's Media folder. This is a plain text file; you will need to have a true plain-text editor if you want to change it.

The links.txt file is basically a list of pattern / target pairs, one per line. Blank lines may be interspersed to improve legibility, and comment lines (indicated by an initial “#” symbol) may also be added to provide documentation. Here is an example:

# This is a links list. Blank lines and lines starting with "#" (comments) are ignored.
# Remaining lines consist of 2 parts: a "pattern", and a "target".
# Use quotation marks if pattern or target contain embedded spaces.
# Unify will search down the list for the first pattern which matches the current patch name.
# The target can either be a web URL or a path (relative to Media folder) to a local image file.
 
  Bloo*           http://192.168.1.99/phpinfo.php   # Open URL "locally" in Unify window
  "Colours Test"  hubble_ngc3318_potw2203a_0.png    # Open image locally
  "Clicking *"    http://192.168.1.99/phpinfo.php/  # Slash at end means open in browser
 
# The pattern "*" will match anything, so I put it last in the list.
# Adding "?" at the end of the web URL causes unify to add "library" and "patch" parameters
# automatically, for the benefit of e.g. PHP scripts at the server end.
    *       http://192.168.1.99/unify.php?/     # Can be combined with slash (which will be removed)

The first item on each pattern/target line can either be the full name of a patch, or a partial name, where some characters are replaced by the special characters “?” and “*”. When Unify loads a patch, it compares the new patch name against each pattern in turn, and stops at the first match. The pattern character “?” will match any single character in the patch name, and “*” will match any sequence of characters. In the example above, the last pattern in the file is “*” all by itself, which is guaranteed to match any patch name. Putting this at the end of the file guarantees that every patch in the library will be linked to the final target, if and only if its name does not match any of the earlier patterns.

The second item on each pattern/target line can be either a URL or blah.

Three miscellaneous syntax rules:

  1. Use double quotation-marks around any pattern or target which has embedded spaces.
  2. Spaces and tabs can be used freely on any line.
  3. Anything which comes after the target will be ignored (provided it is separated by at least one space or tab) and is effectively a comment.
linked-media.1643989696.txt.gz · Last modified: 2023/05/08 18:59 (external edit)