Recent changes to IO_Channels

WikiPage IO_Channels modified by Shane Saxon

Shane Saxon — Fri, 13 Apr 2012 00:15:25 -0000

--- v8 
+++ v9 
@@ -75,6 +75,8 @@
 
 
 ------
+a simple 2 node example tutorial (requires ANTzCh0001.csv and ANTzChMap0001.csv)
+
 run antz
 
 press 'P' to load the channel map and tracks

WikiPage IO_Channels modified by Shane Saxon

Shane Saxon — Fri, 13 Apr 2012 00:13:59 -0000

--- v7 
+++ v8 
@@ -3,37 +3,100 @@
 -------
 Currently there are two files associated with IO channels:
 
-ANTzCh0001.csv - holds the track data, no limit on number of tracks or sample count.
-ANTzChMap0001.csv - maps tracks to node attributes. The nodes have a parameter channelInput and channelOutput stored in ANTz0001.csv (State File).
-
-note that currently channelInput is channel_x column in the ANTz0001.CSV this will be updated shortly.  ChannelOutput is also not currently supported.
-
-NOTE!!! line returns do not support DOS style 'CRLF' (for now... use just plain 'CR'  or 'LF' but not both (needs to be verified...))
-
+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
 
-translateRate_x
-translateRate_y
-translateRate_z
-rotateRate_x
-rotateRate_y
-rotateRate_z
-scaleRate_x
-scaleRate_y
-scaleRate_z
-
-tagOffset_x
-tagOffset_y
-tagOffset_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...
+
+
+------
+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
+

WikiPage IO_Channels modified by Shane Saxon

Shane Saxon — Sat, 31 Mar 2012 21:24:53 -0000

--- v6 
+++ v7 
@@ -1,4 +1,4 @@
-[Home] - [User_Manual]
+[Home] - [User_Manual] - hosted at [openANTz.com](http://openantz.com/)
 
 -------
 Currently there are two files associated with IO channels:

WikiPage IO_Channels modified by Shane Saxon

Shane Saxon — Fri, 30 Mar 2012 07:45:10 -0000

--- v5 
+++ v6 
@@ -1,3 +1,6 @@
+[Home] - [User_Manual]
+
+-------
 Currently there are two files associated with IO channels:
 
 ANTzCh0001.csv - holds the track data, no limit on number of tracks or sample count.

WikiPage IO_Channels modified by Shane Saxon

Shane Saxon — Tue, 27 Mar 2012 00:30:25 -0000

WikiPage IO Channels modified by Shane Saxon

Shane Saxon — Sun, 25 Mar 2012 21:48:21 -0000

--- v3 
+++ v4 
@@ -5,7 +5,7 @@
 
 note that currently channelInput is channel_x column in the ANTz0001.CSV this will be updated shortly.  ChannelOutput is also not currently supported.
 
-NOTE!!! line returns do not support DOS style 'CRLF' for now... use just plain 'CR'  or 'LF' but not both (needs to be verified...)
+NOTE!!! line returns do not support DOS style 'CRLF' (for now... use just plain 'CR'  or 'LF' but not both (needs to be verified...))
 
 Currently supported node attributes:

WikiPage IO Channels modified by Shane Saxon

Shane Saxon — Sun, 25 Mar 2012 21:46:42 -0000

--- v2 
+++ v3 
@@ -5,6 +5,8 @@
 
 note that currently channelInput is channel_x column in the ANTz0001.CSV this will be updated shortly.  ChannelOutput is also not currently supported.
 
+NOTE!!! line returns do not support DOS style 'CRLF' for now... use just plain 'CR'  or 'LF' but not both (needs to be verified...)
+
 Currently supported node attributes:
 
 translate_x

WikiPage IO Channels modified by Shane Saxon

Shane Saxon — Sun, 25 Mar 2012 21:27:33 -0000

--- v1 
+++ v2 
@@ -27,20 +27,8 @@
 scaleRate_y
 scaleRate_z
 
-tagMode
 tagOffset_x
 tagOffset_y
 tagOffset_z
 
-geometry
 ratio
-topo
-facet
-
-colorIndex
-color_r
-color_g
-color_b
-color_a
-textureID
-hide

WikiPage IO Channels modified by Shane Saxon

Shane Saxon — Sun, 25 Mar 2012 20:56:00 -0000

Currently there are two files associated with IO channels: ANTzCh0001.csv - holds the track data, no limit on number of tracks or sample count. ANTzChMap0001.csv - maps tracks to node attributes. The nodes have a parameter channelInput and channelOutput stored in ANTz0001.csv (State File). note that currently channelInput is channel_x column in the ANTz0001.CSV this will be updated shortly. ChannelOutput is also 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 translateRate_x translateRate_y translateRate_z rotateRate_x rotateRate_y rotateRate_z scaleRate_x scaleRate_y scaleRate_z tagMode tagOffset_x tagOffset_y tagOffset_z geometry ratio topo facet colorIndex color_r color_g color_b color_a textureID hide