ANTz Files

- Release Notes -                                        http://openantz.com

         also see 'Tickets - Bugs' and 'Wiki' on sf.net/p/openantz

----------------------------------------------------------------------------
antz_msw_2013-11-11

1) Select Region tool added, (press SHIFT while dragging to add nodes.)

----------------------------------------------------------------------------
antz_msw_2013-10-07

1) freeglut.dll was debug, broke many systems, is now release version.

----------------------------------------------------------------------------
antz_msw_2013-10-02

1) antz.exe application missing from last release 2013-10-01 ver.

----------------------------------------------------------------------------
antz_msw_2013-10-01

1) Bug# 96 Fixed - Camera targeting is now time corrected for faster lock.
2) Fixed camera target for root pin and rod to center at object top.

----------------------------------------------------------------------------
antz_msw_2013-08-20

1) Updated to freeglut 2.8.1 official release, previously using a beta ver.
2) Bug# 94 Fixed - Can't debug ANTz with VS 2008, error with freeglut.dll

----------------------------------------------------------------------------
antz_msw_2013-05-28

1) New GUI Command Console enhances modify and select capabilities.
 a) press 'Enter' to activate GUI Command Console.
 b) press 'Esc' to leave GUI Console and return keyboard to Game Mode.
2) ';' semi-colon is NOW down a branch level, single quote (') for UP.

----------------------------------------------------------------------------
antz_msw_2013-05-23

NEW or updated features:

1) New 'Save Selected' button upper left, or hold 'Alt' with 'K' key or 123.
2) New command line arguments, from system console run 'antz.exe -?'
  a) Command argument 'antz -n ...' can specify global parameters.
  b) Argument '-p' specifies OSC ports versus '-o' to specify IP and ports.

----------------------------------------------------------------------------
antz_msw_2013-05-01                                    NEW, updated or fixed

1) VS2008 project files now in 'antz\sdk\windows\vs2008\'
2) TouchOSC 'Simple' layout pg1 and pg2 control several more commands.
   Launch antz from system console with port arguments 'antz udp 8000 9000'

- TouchOSC 'Simple' layout pg1 -
   Sliders 1-3 control background color
   4th slider is scale scene Z
   4th toggle is Select ALL

- pg2 -
   1 = Camera, 3 = Grid, 4 = Pin
   5 = Color Prev, 6 = Color Next, 7 = Fullscreen toggle, 8 = Texture ID
   9 = Alpha down, 10 = Alpha Mode, 11 = Hide, 12 = Alpha Up
   13 = New, 14 = Topo, 15 = Geometry, 16 = Delete
 
- pg3 - 
   background color using trackpad

BUGS resolved:

84) TouchOSC trackpad does not allow repeated sliding, snaps back. (fixed)

----------------------------------------------------------------------------
antz_msw_2013-02-22                                    NEW, updated or fixed

1) oscpack library added for OSC over UDP to 3rd parties such as NeatTools.
2) New CSV 'antzglobals.csv' startup init file, press '1' key to load/save.
4) Window position restored when exiting Full Screen.
5) Changed OS code methodology to use a separate npos.c file for each OS

Launch antz from console and pass RX/TX ports 'c:> antz udp 8000 9000'
TouchOSC 'simple' template is hardcoded, tutorial at www.hexler.com
Also see wiki page - [OSC_API]

----------------------------------------------------------------------------
antz_msw_2012-12-19

NEW or updated features:

1) Selection Wireframes turn OFF if you select Camera Mode with 'C' key.
2) Zero offset is now default for all root nodes except pin and rod.
3) Updated MySQL docs at http://sourceforge.net/p/openantz/wiki/Database/

BUGS resolved:

84) 'Tab' gets stuck after loading database, click a pin with mouse..(fixed)
85) Tags for root nodes appear below object, depending on topo type. (fixed)
87) antz_msw_2012-12-16 fails to compile, linker .../​libmysql.lib (fixed)

Known issues & BUGS:

88) MySQL stops working after 2-3 Load or Save operations.

----------------------------------------------------------------------------
antz_msw_2012-12-16

NEW or updated features:

1) SHIFT+'?' key to Save time-stamped MySQL database.
2) '?' key for MySQL Menu using GUI console to choose DB to load.
3) 'libmysql.dll' added to app folder.
4) MySQL install setup at http://sourceforge.net/p/openantz/wiki/Database/

Known issues & BUGS (ticket #):

81) Chops off nodes when saving MySQL, rounds down to nearest 128th node.
   scenes with less then 128 nodes are not saved at all.
82) MySQL does not store tags (yet.)
83) Torus ratio or scale issue with database nodes.
84) 'Tab' gets stuck after loading database, click a pin with mouse to fix.

----------------------------------------------------------------------------
antz_msw_2012-12-08

NEW or updated features:

1) New 'point' topo = 7, zero offset, unity scale and spherical coords.
2) Tags can now be loaded from the file dialog 'L' key or Presets 1/2/3.

BUGS resolved (ticket #):

80) New root Pin node causes camera to jump towards origin. (fixed)
79) Right-Click on 'tool: Link' indicator does not loop list. (fixed)
78) New sub-objects cascade branching and jumps camera. (fixed)
66) Camera target has wrong scale with pin with parent = topo sphere.(fixed)

----------------------------------------------------------------------------
antz_msw_2012-11-21

BUGS resolved (ticket #):

Note: This ver will work up to 266 child nodes per parent, crashes if more.

Known issues & BUGS (ticket #):

77) Crashes when loading if more then 32 child branches per parent.(pending)

----------------------------------------------------------------------------
antz_msw_2012-11-20

BUGS resolved (ticket #):

70) Grid z-scaling causes problem with... branch level 0 objects. (fixed)
71) 'N' key delay, camera origin jump and flickering. (fixed)
72) Links don't work in latest versions. (fixed)
73) New node causes camera to jump. (fixed)

Known issues & BUGS (ticket #):

74) JPG texture is skewed with color artifacts and banding.

----------------------------------------------------------------------------
antz_msw_2012-11-03

BUGS resolved (ticket #):

75) 'V' key does not change texture map. (fixed)
76) Load problem for files >4MB that use CRLF line endings. (fixed)

----------------------------------------------------------------------------
antz_msw_2012-10-22

NEW or updated features:

1) Faster tag sync, a million nodes takes about a second.

BUGS resolved (ticket #):

64) Tag sync time is n squared!... not bad until n = 100K+ nodes. (fixed)

Known issues & BUGS (ticket #):

63) CSV 'err 4257 - unexpec...' and 'err: 2388 - OpenGL error: 1281'.
*Workaround is to use a '\r' instead of '\n' at end of each line.

----------------------------------------------------------------------------
antz_msw_2012-10-19

NEW or updated features:

1) Node limit increased to 2 million, reminder to use '\' key to subsample.
2) App RAM limit now 3.5GB, VS->Linker->System->Enable Large...Support >2GB.

BUGS resolved (ticket #):

68) 'N' key crashes app or freezes screen. (fixed)

Known issues & BUGS (ticket #):

69) Mouse click delay with nVidia Quadro 4000 on infinitez.

----------------------------------------------------------------------------
antz_msw_2012-10-15

NEW or updated features:

1) CSV load time improved, a million nodes takes about 1 - 2 minutes.
2) Subsampling is faster, draw routine now uses a threaded async z-sort. 

Known issues & BUGS (ticket #):

65) Tag files cannot be merged into the scene.
66) Camera target has wrong scale with pin with parent = topo sphere.
67) CSV writes huge 1.2GB file and then crashes. (random)

----------------------------------------------------------------------------
antz_msw_2012-10-11

NEW or updated features:

1) Fast CSV file loading with single file support for a million nodes.
2) Tag files can now be chosen with the file dialog or with presets 123.
3) Main folder is now the app folder with sub-folders for code, data & docs.

1) '?' key opens MySQL DB menu loader, SHIFT-? to save a time-stamped DB.
4) Tag file is now written when saving node state file.
5) Added libmysql.dll to app folder.

BUGS resolved (ticket #):

17) freeglut glutGetModifiers() called outside an input callback (fixed)

Known issues & BUGS (ticket #):

62) CSV files prior to 2012 are not currently supported, will load funny.
63) CSV 'err 4257 - unexpec...' and 'err: 2388 - OpenGL error: 1281'.

----------------------------------------------------------------------------
antz_msw_2012-07-21

NEW or updated features:

1) '\' backslash key will subsample to draw faster, SHIFT reverses.
2) Node limit increased to 1 million, max child nodes per parent now 128.

----------------------------------------------------------------------------
antz_2012-05-05

NEW or updated features:

1) L+R button will now always switch to Examiner XZ target mode.

----------------------------------------------------------------------------
antz_2012-05-04

NEW or updated features:

1) OSX version released, should work on Mac's running 10.5, 10.6 or 10.7
2) Normalized offsets for topo types to sit on/near the surface of parent.
- a) Torus center to tube center is 1.5 with height offset of 0.75 (half).
- b) Cube edge length = sqrt(2) = 1.414, height offset is 0.7071 (half).
- c) Sphere and Cylinder have radius and offset of 1 unit.
- d) Pin Height to center of dome remains unchanged at 5 units.
- e) Rod Height remains unchanged at 10 units.

*note that pre-existing CSV files may display slightly differently.

BUGS resolved (ticket #):

58) Links display wrong color. (fixed)
59) Links receive double commands. (fixed)

Known issues & BUGS (ticket #):

60) OSX version does not have an Open File Dialog.

----------------------------------------------------------------------------
antz_msw_2012-05-02

NEW or updated features:

1) Link nodes now connect to top of Rod topo instead of base.

BUGS resolved (ticket #):

54) Deleting a node while using the Link tool crashes app. (fixed)
55) Deleting node at link endpoint A deletes the node at endpoint B. (fixed)
56) Tool indicator displays wrong tool type. (fixed)
57) Link nodes connect to base of sub-node Pins instead of the top. (fixed)

----------------------------------------------------------------------------
antz_msw_2012-05-01

NEW or updated features:

1) Link nodes now support text tags.
2) Link node thickness (ratio) now set by mouse Combo/Size tool using R-drag.
3) Channels attribute mapping limits increased from 10,000 to 500,000.

BUGS resolved (ticket #):

39) Channels crash while subscribing nodes when loading file set. (fixed)
53) Sub-Grids scaled when Pin being scaled with mouse. (fixed)

----------------------------------------------------------------------------
antz_msw_2012-04-30

NEW or updated features:

1) Link node type added, connect any two nodes.
- a) 'Link Tool' added to create new links using the mouse.
- b) CSV state file uses new node 'type' = kNodeLink = 7
- c) CSV parent_id used for endpoint 'A', child_id is endpoint 'B'.
- d) 'R' key (ratio) increases radius, SHIFT-R to decrease.
2) Camera now targets the center of sub-nodes, not just Root Pin.

BUGS resolved (ticket #):

50) Topo/selection causes elongated cylinder. (not a bug)
52) Hide and Info tools respond to ANY command. (fixed)

Known issues & BUGS (ticket #):

49) Forcing Anti-Aliasing ON causes picking error at object edges
51) VMware Fusion with W7 problem with RGBA textures. (bug with VMware)

----------------------------------------------------------------------------
antz_msw_2012-04-22

NEW or updated features:

1) 'T' key now selects 'Tool' type, (previously selected Texture map.)
2) 'V' key replaces selection of Texture maps for images and Video.
3) Cylinder Topo, texture map and coordinates wrapped around like globe.
4) Rod Topo, radius uses ratio, scale_z length, doesn't effect sub-nodes.

BUGS resolved (ticket #):

36) Camera moving in Examiner XZ mode with mouse Left-Drag. (fixed)
38) Camera only translates with keys after R-button mouse Fly Mode. (fixed)

----------------------------------------------------------------------------
antz_msw_2012-04-20

NEW or updated features:

1) 12X faster texture loading, makes image animation load time tolerable.
2) Added Cylinder Geometry type with 'proper' texturing.
3) Camera mode auto-switches tool type to 'Pick', locks out all other types.

BUGS resolved (ticket #):

47) Latest version won't deselect all. (fixed)
48) Selecting root pin duplicates toroid. (startup default now 'Combo' tool)

----------------------------------------------------------------------------
antz_msw_2012-04-19

NEW or updated features:

1) Mouse Create Tool now works as a Combo Tool:
- a) L-click creates Root Nodes when background clicked.
- b) L-click on a Root Pin will create multiple New nodes at branch level 1.
- c) L-drag & R-drag moves and scales objects, background moves camera.
2) Tools more active XYZ Axes aware for Create, Combo, Move, Rotate, Size.
3) Indicators now grey out unavailable Axes.
4) Root Pin now displays as grey instead of red when sub-object selected.

----------------------------------------------------------------------------
antz_msw_2012-04-18

NEW or updated features:

1) Mouse Wheel now changes Tool Type.
2) Tool Type mode change displays usage Hints in GUI console.
3) Indicators change based on Tool Type and active node type.
4) Mouse Create Tool now makes New nodes and R-click will Delete.
5) Mouse Alpha Tool added to change transparency.
6) Mouse Tool types added: Move(translate), Rotate, and Size(Scale & Ratio).
7) Mouse Picking now clicks on wireframe geometry as if it were solid.
8) Active Axes now effects tools: move, rotate, size and combo.
9) Changed the translate_z distance factor with parent topo type torus.

BUGS resolved (ticket #):

42) Transparency shows black where grid background should be. (partial fix)
44) Delete corrupts the node data map tree structure. (fixed)
45) Sphere Mapping reverts to old mapping based on camera view angle.(fixed)
46) translate_z for non-torus topo with torus parent is off by 2x Pi.(fixed)

Known issues & BUGS (ticket #):

38) Camera only translates with keys after R-button mouse Fly Mode.
39) Channels crash while subscribing nodes when loading file set.
41) Selection-related bug. (possibly fixed with bug 44, needs testing)
43) Linux - Grid Lines are not drawn.

----------------------------------------------------------------------------
antz_msw_2012_04_16

NEW or updated features:

1) Indicators at top left of screen are now mouse clickable.
2) Select Active Axes by clicking on the Coord X/Y/Z indicators.
3) Select Mode by clicking on the indicator, Right & Left buttons.
4) Select Tool by clicking on the indicator, Right & Left buttons.
5) Several new Mouse Tool types are avialable.

BUGS resolved (ticket #):

33) Linux version is not available for download (fixed).

----------------------------------------------------------------------------
antz_msw_2012_04_14

BUGS resolved (ticket #):

37) Sphere Mapping Longitude coordinates offset 180 degrees. (fixed)

Known issues & BUGS (ticket #):

36) Camera moving in Examiner XZ mode with mouse Left-Drag.

----------------------------------------------------------------------------
antz_msw_2012_04_13

NEW or updated features:

1) Sphere mapping, press '3' to load example, Earth texture included.
2) Grid default segments changed to 12x6 for proper display of Earth map.
3) Improvements to the Mode and Tool behaviour.

BUGS resolved (ticket #):

29) Docs using LF line ending in the .txt files instead of CRLF. (fixed)
31) Camera is frozen and cannot be moved by mouse or keyboard. (fixed)
35) HUD elements hard to see with alternate transparency modes. (fixed)

Known issues & BUGS (ticket #):

27) Linux logs out if no pin-nodes in the scene.
33) Linux version is not available for download.
34) OSX version is not available for download.

----------------------------------------------------------------------------
antz_msw_2012_04_11

NEW or updated features:

1) Indicators display coords with active axes, scale and mouse tool mode.

BUGS resolved (ticket #):

30) Camera Mode drops out into Pin Mode if an object clicked. (fixed)

Known issues & BUGS (ticket #):

31) Camera is frozen and cannot be moved by mouse or keyboard. (can't repeat)

----------------------------------------------------------------------------
antz_msw_2012_04_10

NEW or updated features:

1) IO Channels docs are in progress, see the 'Discussions' area for help.
2) Camera Look mode now maintains orientation after releasing mouse button.

BUGS resolved (ticket #):

28) Camera Mode locks in when supposed to be in default Pin Mode. (fixed)

----------------------------------------------------------------------------
antz_msw_2012_04_09

NEW or updated features:

1) Channels work, ANTzCh0001.csv and ANTzChMap0001.csv, press '2' then 'P'.
2) Camera mode behavior improved.
3) Default record_id URL changed to http://openantz.com/code/docs/id.html

BUGS resolved (ticket #):

3)  Can't Save Files using hot keys SHIFT+1, 2 or 3. (fixed)
21) Channels - color pointers not deleting from list. (fixed)
22) Channels - ANTzChMap000x.csv breaks with quoted field names. (fixed)
23) Channels - scale and ratio mapped to the wrong tracks. (fixed)
24) Channels Map needs to add support for 'int' data types. (fixed)
25) Node State File ANTz000x.csv header is improperly formatted. (fixed)
26) Channels loading files twice causes a gap in playback. (fixed)

Known issues & BUGS (ticket #):

19) Camera heading jumps when L-button pressed during fly mode.

----------------------------------------------------------------------------
antz_msw_2012_04_05

NEW or updated features:

1) Camera Look Mode, click Right mouse button then use Left button for Look.

BUGS resolved (ticket #):

1)  mouse mode locked in. (fixed)
11) Channel numbers exceed actual channel count. (fixed)
12) Channels are all the same. (fixed)
15) Channel ANTzCh000x.csv file crashes with CRLF. (fixed)
18) 'Info Tool' and 'Hide Tool' act strange when objects selected. (fixed)

Known issues & BUGS (ticket #):

13) Loading ANTzChMap000x.csv causes un-predictable behavior.

----------------------------------------------------------------------------
antz_msw_2012_03_31

NEW or updated features:

1) Displays openANTz.com URL in GUI console on startup.
2) ANTz000x.csv fields changed for Channels support (backwards compatible.)

BUGS resolved (ticket #):

10) Channels NOT synced to ANTz000x.csv StateFile. (fixed)
14) Delete Node displays wrong node ID - memory violation. (fixed)

Known issues & BUGS (ticket #):

11) Channel numbers exceed actual channel count.
12) Channels are all the same.
13) Loading ANTzChMap000x.csv causes un-predictable behavior.
15) Channel ANTzCh000x.csv file crashes with CRLF.

----------------------------------------------------------------------------
antz_msw_2012_03_25

Keyboard Command Changes:
selection toggle has been moved to '?' key.
'spacebar' will pause channel playback (and soon will pause all animation).

NEW features:

1) IO Channels playback from file is now supported:
- a) 'P' key will load and start Playing the channels file.
- b) '<' and '>' keys will change the channel of selected nodes.
- c) ANTzCh0001.csv stores track data.
- d) ANTzChMap0001.csv maps tracks to nodes.

----------------------------------------------------------------------------
antz_msw_2012_03_23

NEW features:

1) Expand or compact entire scene object positions using the Root Grid. 
- a) First select the Root Grid pressing 'G' (press until id:6 displayed).
- b) then repeatedly press 'X' until 'axes: Z' selected.
- c) now expand scene using the (scale) 'Z' key and 'SHIFT+Z' to compact.

This readme.txt, the antz_install.txt and antz_cheatsheet.txt are now
included in the main ANTz...zip 'Release' folder with the antz app.

BUGS resolved (ticket #):

1) mouse mode locked in. (pending, additional testing reqired to verify)
4) Text Tags still display even when node hidden. (fixed)
5) Text Tags show box without text with object off left side screen. (fixed)
6) Text Tags shown for nodes directly behind camera. (fixed)
7) 'L' key - File Dialog can't be seen in Fullscreen. (permanent workaround)
8) Crash on App Startup - ANTz_2012_03_19 (fixed)

Known issues & BUGS (ticket #):

2) part/​all of Screen Freezes, locks up. (see Tickets for workaround)
3) Can't Save Files using keys SHIFT+1, 2 or 3. (see Tickets for workaround)

----------------------------------------------------------------------------