Anatomy of the Project Window

Anatomy of the Project Window

The screenshot below shows a typical project window. Although quite simple, it contains a great deal of useful information.

  • Category header: Files in your Project are automatically assigned to a category. The Project display only contains "Patcher" files, but other Projects might contain "Media" files, "Code" files, "Externals", and so on. Categories are only shown if there are matching files in the Project.
  • Patcher opened with project: A project may contain one or more "top-level patchers". These are displayed in bold in the Project window, and are automatically opened when the Project is loaded.
  • Explicit vs. Implicit Project member: Files listed with the word "(implicit)" after their names are dependencies. In other words, they are used by some other file in the Project. The "(implicit)" denotes that the file is not itself referenced by the Project -- the file is only displayed because it is being used by something else. Removing the parent of an implicit dependency will cause the dependency to be removed from the Project window as well.
    "Explicit" Project members, on the other hand, are shown in the Project window whether or not they are in use by other files. Another way of thinking about it: all implicit files are dependencies; explicit files may or may not be dependencies.
  • Global vs. Local Project members: Files listed in italics are in the global search path of Max (detailed discussion below). Files listed in non-italics are in the Project's local search path (more detail below). Note that missing Project members will be displayed in red in the Project window.
  • Details view: When the Details view is shown, and a file from the list is selected, a variety of information is displayed: the name, kind and absolute path of the file. If the file is a dependency (whether explicit or implicit), a link is shown to highlight the patchers in the file list which use it. Also shown is whether the file is opened with the project or not.
  • Project toolbar: The Project toolbar permits a number of useful operations, including opening the Project's folder in the Finder/Explorer, showing or hiding the Details view, adding new or existing files, and reloading the Project. For more information, sett the The Manage Project and Project Settings guides.
If your Project is missing a file and you know where the file is located on your hard drive, you can drag the file into the Project window to resolve the item's missing status.