standalone Reference

Configure parameters for standalone applications

standalone

Description

The standalone object lets you set options for creating a standalone application from a Max patch, and is used in conjunction with the Build Application/Collective... item found in the File menu. You should only have one standalone object in your top-level patch.

Examples

Arguments

None.

Attributes

allwindowsactive [int]

Controls the initial setting of All Windows Active when the standalone is launched.

appicon_mac [symbol]

Specify an .icns file as the standalone's application icon on MacOS.

appicon_win [symbol]

Specify an .ico file as the standalone's application icon on Windows.

bundleidentifier [symbol]

The unique identifier string provided to the OS for your application bundle, e.g. "com.mycompany.myappname".

cantclosetoplevelpatchers [int]

When selected, this option renders it impossible to close the top-level patcher in the standalone you build.

cefsupport [int]

Enables Max's CEF support for the jweb object in the standalone. Disable to reduce standalone size.

copysupport [int]

When enabled, Max will copy additional resources to the standalone's support folder, including a full set of externals, shaders, Javascript support files, etc. Disable to reduce standalone size. Note that extensions and MIDI/audio externals are always included, even if this option is disabled.

database [int]

Enables Max's file database support in the standalone.

gensupport [int]

Enables Max's support for gen~, jit.gen, jit.pix and jit.gl.pix objects. Disable to reduce standalone size.

noloadbangdefeating [int]

When a patch is opened, the action of the loadbang object can be disabled if you hold down the Command and Shift keys (Macintosh) or Control and Shift keys (Windows). When checked, this option will make your standalone always perform loadbang actions regardless of the state of the keyboard.

overdrive [int]

Controls the initial setting of Overdrive when the standalone is launched.

preffilename [symbol]

Save default settings for a standalone application to a custom Preference folder who's name is specified by a symbol. When the standalone is opened, it will save the standalone's preferences to a folder located at ~/Library/Application Support/[preffilename] (Mac) or C:\Users\[Your username]\AppData\Roaming\[preffilename] (Windows). If this is not set, standalone preferences will default to creating a folder within ~/Library/Application Support/Cycling '74 or C:\Users\[Your username]\AppData\Roaming\Cycling '74 named for the application.

searchformissingfiles [int]

When checked, Max will use the search path to look for files that are not included in the collective inside your standalone. This includes objects that may not be present in a patch but are called on by Max to support the proper functioning of included objects. For example, the JSUI object requires various jitter objects to work, but does not require you to instantiate them in the patch.

The primary reason to disable searching for missing files is to test your standalone to see if it includes all the necessary files to work if you move it to another machine.

Please be aware that this option must be enabled (as it is by default) in order for users of your standalone application to be able to drag and drop files or otherwise use files not inluded in your application.

statusvisible [int]

Status window flag

usesearchpath [int]

When checked, the standalone will create a search path consisting of all subfolders of the folder containing the application. Leaving this option unchecked is primarily of interest to Mac users, who might wish to put their standalone into the Applications folder, but avoid the startup cost of adding all the subfolders of the Applications folder to the search path. On Windows, the application is inside its own folder, so there usually are an insignificant number of subfolders to worry about.

Common Box Attributes

annotation [symbol]

Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.

background [int] (default: 0)

Adds or removes the object from the patcher's background layer. background 1 adds the object to the background layer, background 0 removes it. Objects in the background layer are shown behind all objects in the default foreground layer.

color [4 floats]

Sets the color for the object box outline.

fontface [int]

Sets the type style used by the object. The options are:

plain
bold
italic
bold italic Possible values:

0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'

fontname [symbol]

Sets the object's font.

fontsize [float]

Sets the object's font size (in points). Possible values:

'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'

hidden [int] (default: 0)

Toggles whether an object is hidden when the patcher is locked.

hint [symbol]

Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.

ignoreclick [int] (default: 0)

Toggles whether an object ignores mouse clicks in a locked patcher.

jspainterfile [symbol]

JS Painter File

patching_rect [4 floats] (default: 0. 0. 100. 0.)

Sets the position and size of the object in the patcher window.

position [2 floats]

g/s(set)

Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.

presentation [int] (default: 0)

Sets whether an object belongs to the patcher's presentation.

presentation_rect [4 floats] (default: 0. 0. 0. 0.)

Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.

rect [4 floats]

g/s(set)

Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).

size [2 floats]

g/s(set)

Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.

textcolor [4 floats]

Sets the color for the object's text in RGBA format.

textjustification [int]

Sets the justification for the object's text. Possible values:

0 = 'left'
1 = 'center'
2 = 'right'

varname [symbol]

Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.

See Also

Name Description
Sharing Max Patchers Sharing Max Patchers