# file

Defines input stream file.

### Synopsis

`file <input_file> <priority> <time_offset>`

### Description

Defines an input stream file to weave with other input stream files.

The priority determines the order in which chunks with overlapping times are written to the output stream. Smaller priority numbers are higher. The time offset is similar to the `streamstarttime` offset except it offsets only this stream file when weaving it into the output stream.

The maximum number of files you can weave with Weaver is set to 20 (although the number varies based on the size of the input files). If you need to weave more than twenty files, set `USE_MAC_IO` to 1 and recompile Weaver.

### Arguments

input_file
  Name of a chunked file to weave.

priority
  Priority in relation to parent task; 0 to 7FFFFFFF (hex). Priority and parent tasks priority should not exceed 200.

time_offset
  Offsets only this stream file when weaving it into the output stream; 0 to 7FFFFFFF (hex), in audio ticks.

### Caveats

None.