A newer version of Max is available. Click here to access the latest version of the documentation

fpic Reference

Display an image

fpic

Examples

Place a picture in a patch (for the sheer beauty of it)... ...or make it functional by placing ubutton objects over it... Make a slide show by changing pictures, or move a picture by changing its offset

Discussion

We recommend using files with the PNG file format, though other common file formats such as JPG will also work on all platforms.

Arguments

None.

Attributes

alpha [float] (default: 1.)

Sets the transparency of the displayed image. The range is a floating point value in the range 0. (transparent) to 1.0 (opaque).

autofit [int] (default: 0)

Toggles the ability to automatically scale a loaded image file to fit the fpic object's display area. This attribute is disabled when using an SVG file.

destrect [4 floats]

Specifies the left-top and bottom-right positions of the loaded graphic image. If these values do not correspond to the size of the graphic image, the image will be scaled to fit the current fpic window size.

embed [int] (default: 0)

Toggles the ability to embed the graphic you are using and save it as part of the main patch. The default behavior is 0 (don't save the image with the patcher file).

forceaspect [int] (default: 0)7.0.0

When enabled, any change to the x or y scale of the fpic automatically adjusts the other so that the aspect ratio of fpic object remains the same as the source image.

pic [symbol] (default: <none>)

Designates the pathname of the graphic file for the fpic to use.

xoffset [float] (default: 0.)

Specifies the number of pixels by which the upper left corner of the subpatch is to be offset horizontally within the fpic object's viewing window.

yoffset [float] (default: 0.)

Specifies the number of pixels by which the upper left corner of the subpatch is to be offset vertically within the fpic object's viewing window.

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.

Messages

bang7.0.0

The image loaded by fpic will be sent via the outlet as a matrix in response to a bang.

(drag)

When a image file is dragged from the Max File Browser to an fpic object, the image will be loaded.

(mouse)

In an unlocked patcher, you can change the offset of the picture by holding down the Shift and Command keys on Macintosh or Shift and Control keys on Windows and dragging on fpic; the current offset of the picture is shown in the Assistance portion of the patcher window as you drag.

noscale

Disable image scaling

offset

Arguments

horizontal [int]
vertical [int]
The word offset, followed by two numbers, specifies the number of pixels by which the left upper corner of the picture is to be offset horizontally and vertically from the left upper corner of the fpic box. By default the left upper corner of the picture is located at the left upper corner of fpic (that is, with an offset of 0,0). With successive slightly different offset messages, a picture can be moved inside fpic, and fpic can window different portions of a large picture. (In order to give the appearance of smooth transitions when moving an image, the old image is not erased when using the offset message. This may cause an undesired appearance if your picture contains a blank background that doesn't cover up what's beneath it.)

pict

Arguments

filename [list]
The word pict, followed by the name of a graphics file in Max's search path, opens the file and displays the picture, replacing whatever picture was previously displayed. The fpic object accepts PNG files and, if QuickTime Version 7.1 or later is installed, other picture file formats that are listed in the QuickTime appendix.

read

Arguments

filename [list]
The word read, followed by a symbol which specifies a filename, looks for a QuickTime graphic file with that name in Max's file search path, and opens it if it exists, displaying it in a graphic window. If the filename contains any spaces or special characters, the name should be enclosed in double quotes or each special character should be preceded by a backslash (\). The word read by itself puts up a standard Open Document dialog box and displays the common graphics files supported by QuickTime.

readany

Arguments

filename [list]
The word readany, followed by a symbol which specifies a filename, functions in the same manner as the read message, except that the Open Document dialog box does not filter its display by the currently supported filetypes.

rect

Arguments

horizontal [int]
vertical [int]
width [int]
height [int]
The word rect, followed by four numbers that specify the size of scaling rectangle to apply to fit the input image within, loads the graphics file from disc into RAM and displays it. The first two numbers specify the placement in the graphic window as offset values, and the second two numbers specify the width and height, in pixels, of the rectangle.

See Also

Name Description
imovie Play video
lcd Display graphics (deprecated)
matrixctrl Matrix switch control
panel Colored background area
pictctrl Picture-based control
pictslider Picture-based slider control
ubutton Transparent button