IO_Channels

[Home] - [User_Manual] - hosted at openANTz.com

---

Currently there are two files associated with IO channels:

ANTzCh0001.csv - holds the track data, limit on number of tracks = 100 or no limit on sample count.
ANTzChMap0001.csv - maps tracks to node attributes. The nodes have a parameter ch_input_id and ch_output_id stored in ANTz0001.csv (State File).

ch_output_id is not currently supported.

Currently supported node attributes:

translate_x
translate_y
translate_z
rotate_x
rotate_y
rotate_z
scale_x
scale_y
scale_z

translate_rate_x - in general do not use the rate, use direct positioning
translate_rate_y - that is translate_x, rotate_x, and scale_x
translate_rate_z
rotate_rate_x
rotate_rate_y
rotate_rate_z
scale_rate_x
scale_rate_y
scale_rate_z

tag_mode ----- 0 is OFF, 1 is outline, 2 is not outline with colored text
tag_offset_x - position offset relative to the node
tag_offset_y
tag_offset_z

geometry
ratio
topo
facet

color_index- colorIndex is not yet auto-updated, so nothing will happen
color_r ----- use direct color instead
color_g
color_b
color_a
color_shift - not working until next release (planned for 2012-04-12)

texture_id - can use to create animated video textures!!! (2048 current limit)

hide - 0 is show, 1 is hide

---

there are limits to the number of tracks, and channel_id mappings...

in short:
tracks - 1000 - columns in ANTzCh0001.csv

Max ch_input_id assignments is based on the number of total properties assignable
currently 10000 per type.

https://sourceforge.net/p/openantz/wiki/Globals_and_Limits/

kNPmaxTrackToAttributeMappings 1000 - number of mappings supported
kNPtrackBufferSize 65535 - number of samples in the circular track buffer
kNPmaxTracks 1000 - maximum number of tracks
kNPmaxFloatProperties 10000 - max track to node float property assignments
kNPmaxUcharProperties 10000 - max track to node uchar property assignments
kNPmaxLineLength 10000 - limits the row length of track data
kNPmaxTokens 1000 - limits the number of tracks

These limits will be increased shortly...

---

a simple 2 node example tutorial (requires ANTzCh0001.csv and ANTzChMap0001.csv)

run antz

press 'P' to load the channel map and tracks
press 'N' to create a node
press 'Enter' to select the primary torus

then press '>' to change the toroids channel (ch_input_id == channel_id)

---

ANTzCh0001.csv - track data
any number of tracks (columns) and sample depth (rows)

---

ANTzChMap0001.csv
maps node->attributes to tracks in 'sets' grouped by 'channel_id'
(does not contain node->ch_input_id which is in the ANTz000x.csv)

relevant columns are:
channel_id - corresponds to node->ch_input_id
track - number corresponds to which column in ANTzCh0001.csv
attribute - the name of the node attribute to map to the track

---

ANTz000x.csv (State File) ch_input_id == channel_id in the ANTzChMap0001.csv file