Filename

Specification

extension

• Type: String or Array.

• Allowed extension or array of allowed extensions.

In combination with type buffer the file can be used for better file input dialog.

[
  {
    "name": "fileName",
    "type": "filename",
    "label": "File name",
    "semantic": "file:name"
  },
  {
    "name": "data",
    "type": "buffer",
    "label": "Data",
    "semantic": "file:data"
  }
]

nested

• Available types:

Type	Specification
array	Provides an array of nested parameters which are shown when the value of the parameter is set (value is not empty)
string	Provides URL address of an RPC to load list of nested parameters.
object	Provides a detailed specification of nested parameters.

Usage of nested fields:

{
    "name": "myFilename",
    "type": "filename",
    "label": "My Filename",
    "nested": "rpc://getNestedFields"
}

Examples

File Input

When combined with filename parameter, the buffer can be used for a file input dialog.

Appearance

Premapped File Inputs

Source

[
	{
		"name": "fileName",
		"type": "filename",
		"label": "File name",
		"semantic": "file:name"
	},
	{
		"name": "data",
		"type": "buffer",
		"label": "Data",
		"semantic": "file:data"
	}
]

Allowed File Extensions

You can restrict allowed extensions by adding extension option.

Appearance

Example of File Extension Parameter

Source

[
	{
		"name": "upload",
		"label": "Name of file to upload",
		"type": "filename",
		"extension": ["jpg", "bmp", "png"]
	}
]