AmiBroker 6.27.1 BETA Read Me

November 2, 2017 17:10

THIS IS A BETA VERSION OF THE SOFTWARE. EXPECT BUGS !!!

Backup your data files and entire AmiBroker folder first!

INSTALLATION INSTRUCTIONS

First you need to have full version of AmiBroker 6.20 installed. Then just run the BETA installer and follow the instructions.

Then run AmiBroker. You should see "AmiBroker 6.27.1" written in the About box.

See CHANGE LOG below for detailed list of changes. Note that only changes that affect end-user directly are listed here. Internal code changes/refactoring is usually not mentioned.

UPGRADE POLICY: This version is a free upgrade for users who purchased AmiBroker license after September 26, 2015.

6.27 FEATURE HIGHLIGHT:

6.27 is focused on improvements of features introduced earlier. See CHANGE LOG for details.

6.26 FEATURE HIGHLIGHT:

This version brings:

• static variable declaration
• new Voice functions (VoiceSetRate/VoiceSetVolume/VoiceWaitUntilDone)
• clickable links in Analysis result list
• comment folding in the editor
• ability to handle Internet connection errors in the formula via GetLastOSError
• new mouse hover notifications in GUI controls (notifyMouseEnter / notifyMouseLeave) that allow to trigger actions in the formula on mouse hover (without checking mouse position and without constant refreshes)
• fixes to passing by reference in AFL
• fixes & improvements to Gui functions and much more - check the CHANGE LOG below !

6.25 FEATURE HIGHLIGHT:

This version brings:

• new Gui controls (toggle button, checkbox, radio button)
• new AFL functions for GUI
• passing variables by reference in AFL,
• Auto-optimization framework
• HTML5 compatibility in Web Research
• many other improvements

6.22 FEATURE HIGHLIGHT:

This version is experimental because we are migrating 64-bit version to brand new compiler (VC++ 2017). Such migrations pretty often brings some compatibility risks therefore backup is highly recommended (although you can always go back by just installing previous version). We needed to migrate not only the program itself but many internal libraries taking care not to break backward compatibility.

Note that migration does NOT affect 32-bit version. It is still compiled with old compiler.

Why do we migrate to new compiler with 64-bit version?

1. New compiler supports new CPU instructions (SSE3/AVX) that we can use to offer better performance
2. According to our tests new compiler support produces faster code by itself (better optimizations, auto-vectorization, etc)
3. New compiler is better with error checking (less bugs to slip through)
4. We don't need to care about compatibility with pre-Vista systems in 64-bits version and all 64-bit capable CPUs are "modern" enough.

Why do we stay with old compiler in 32-bit version?

1. New compiler does not produce code compatible with older operating systems (XP or earlier). Old compiler offers 100% compatibility with all Windows versions
2. New compiler requires modern CPUs

Exact performance improvement is function dependent and hardware dependent. Many functions are faster by 30-50% but in some cases such as Min()/Max() functions as large as 8x speed up can be observed in 64-bit version.

6.21 FEATURE HIGHLIGHT:

This version features preliminary support for native chart GUI (buttons and edits at the moment). Please be resonable with Gui* functions and be aware of Windows limits.
As all controls in Windows (buttons, edit boxes, etc) are actual Window objects they are subject to Windows limitation.
And there is a limit of 10000 windows PER PROCESS. So don't try to create thousands of buttons (like a button for every bar of data) because
first you will see huge performance decrease and next you will hit the limit and run into problems (crash)
https://blogs.msdn.microsoft.com/oldnewthing/20070718-00/?p=25963

Best practice is to keep the number under 100-200.

If you need more consider using low-level graphics instead.

Here is a sample formula that shows basic usage of Gui* functions:

GuiButton( "Custom button", 1, 10, 40, 100, 30, 7 );
GuiButton( "Dynamic "+Date(), 2, 120, 40, 150, 30, 7 );
GuiButton( "System button", 3, 320, 40, 100, 30, 7 );
GuiEdit( 5, 450, 40, 100, 20, 31 );

GuiSetColors( 1, 3, 2, colorRed, colorBlack, colorRed, colorWhite, colorBlue, colorYellow, colorRed, colorBlack, colorYellow );
GuiSetColors( 3, 3, 0 ); // default (system) look

editText = GuiGetText( 5 );

Title = "Text entered: " + editText + "\nLast event: " + GuiGetEvent( 0, 2 );

id = GuiGetEvent( 0, 0 );
event = GuiGetEvent( 0, 1 );

if( id == 3 && event == 1 ) GuiSetText("Button clicked",5);

CHANGE LOG

CHANGES FOR VERSION 6.27.1 (as compared to 6.26.0)

• AFL Editor: preprocessor command (#include/#include_once/#pragma) are highlighted with different color to give visual clue that preprocessor command is NOT regular code
• AFL: #pragma enable_static_decl accepts prefix given in quotation marks (as regular string).
  #pragma enable_static_decl "myprefix{chartid}"
• AFL: due to changes in 6.25 BETA TimeFrameSet applied on 1-tick base interval could result in division by zero exception. Fixed.
• AFL: Error 66 has new meaning now. It is issued to prevent attempts to mix static declarations with old style access. Error 66. Variables with '---' prefix are inaccesible via StaticVarGet/Set/Remove in this formula. This prefix is reserved by #pragma ena
• AFL: Removed Error 66: invalid identifier from VarSet/VarGet. Instead of issuing error message, VarGet/VarSet automatically sanitizes invalid identifiers by replacing all characters other than digits and A-Z, a-z letters by underscore
• AFL: runtime tokens {chartid}, {symbol}, {interval} are now supported in #pragma enable_static_decl
• AFL: SetFormulaName - displays error 67 if user tries to use file-system forbidden characters for formula name
• AFL: StaticVarRemove() when called with EMPTY string: StaticVarRemove("") nullifies all static variables declared with static keyword within given formula, so this:

#pragma enable_static_decl(test)
static _x, _y, _z;

_x = 1;
_y = 2;
_z = 3;

StaticVarRemove(""); // nullify all declared static variables

printf("%g %g %g", _x, _y, _z );

is equivalent to writing
  
#pragma enable_static_decl(test)
static _x, _y, _z;

_x = 1;
_y = 2;
_z = 3;

_x = Null; _y = Null; _z = Null;

printf("%g %g %g", _x, _y, _z );

// note that setting declared static variable to Null value results in removing it from memory

StaticVarRemove("") - returns number of variables nullified. Returns 0 on failure (no declared static variables found in current formula)

• AFL: when declared static variable is assigned the NULL value, it will be removed from memory when formula finishes
• ASCII importer: importer logged "ran of industry space" even if it didn't. Fixed.
• CBT: If user called ApplyStop AND calls EnterTrade from low-level backtest and did not switch backtestRegular mode to raw mode (which should be done), backtester would automatically turn on 2nd phase stops handling to prevent crash
• Charts: a crash could occur if user had lots of drawn trendlines on multiple panes and some of them had start date BEFORE first available bar and RT stream was frequently updating. Fixed.
• Make #pragma enable_static_decl is now private functionality. This means that it will work just fine but we don't provide any help/support except of what is written in readme/manual
• New Analysis: you can now copy dates between "From" and "To" date pickers (right click menu or Ctrl+C/Ctrl+V)
• UI: Bar replay From-to controls support copy-paste (right click or Ctrl+C/Ctrl+V)
• UI:added preprocessor color picker in Tools->Preferences, "Editor"
• 6.27.1 fix: In 6.27.0 VarSet did not work properly. Fixed.
• 6.27.1 fix: Backtest: since 6.25 crash could occur if "detailed log" was enabled and trade was not entered due to unsufficent funds because format string was not matching arguments. Fixed.

CHANGES FOR VERSION 6.26.0 (as compared to 6.25.0)

• AFL: new static keyword: declare identifier as static variable - a little 'revolution' in static variable use, declare variable as static and use as 'regular' variable, no need to call functions
  
  // the pragma below is required to enable support for static declarations
// it also defines the prefix which is added to variables declared with static keyword
// it is one prefix per formula.
#pragma enable_static_decl(prefix)

// it is really good idea to consequently use naming convention that
// distinguishes declared static variables from the others
// we highly recommend using UNDERSCORE '_' before all declared static variables
// so they can be easily spotted in the code
// The other choice could be s_ prefix

static _myvar;  // this var is also accessible by "prefix_myvar"

printf( "This variable is really static %g", _myvar++ );

// keep in mind that for speed static variable is read only once at the declaration
// and saved only once - when formula execution is completed
// This way declared static variables offer same speed as regular variables (no speed penalty)
  
• AFL Editor: contrast of error location indicator on dark backgrounds increased
• AFL Editor: C-style comments /* ... */ are now foldable in the editor
• AFL Editor: new menu choices View->Fold Comments / Unfold Comments - allow to fold/unfold all multi-line comments (enclosed with /* .... */)
• AFL: added constants notifyClicked, notifySetFocus, notifyKillFocus, notifyHitReturn, notifyEditChange, notifySelChange, notifyMouseEnter, notifyMouseLeave
• AFL: Another protection against users shooting themselves in foot, VarSet/VarGet now displays error when you try to use characters different than A-Z, 0-9 and '_' in variable names
• AFL: Attempt to use single subscript on matrix variable now results in error message "Accessing Matrix elements requires two subscript operators"
• AFL: Due to the fact that Windows may send WM_MOUSEMOVE message even if mouse did not move, AmiBroker now has internal check that prevents ReqestMouseMoveRefresh from triggering if mouse position did not change
• AFL: GetLastOSError (for getting last error message from Windows) - allows getting information about and handling of runtime OS errors
  
  // Example 1:
fh = fopen("non_existing_file.txt", "r" );

if( ! fh )
{
   printf("File can not be open because: %s", GetLastOSError() );
}

// Example 2:
ih = InternetOpenUrl("http://non_existing_host.com" );

if( ! ih )
{
   printf("Internet connection can not be open because: %s", GetLastOSError() );
}
• AFL: GuiButton and GuiToggle in native OS style use background color of the chart for small border instead of default grey
• AFL: GuiButton/GuiCHeckBox/GuiToggle/GuiRadio support now new events notifyMouseEnter (64) and notifyMouseLeave(128) which detect hovering without need for constant refreshes
  
  #pragma enable_static_decl(myprefix)

static _counter;

flags = notifyMouseEnter | notifyMouseLeave;

GuiButton("test", 1, 20, 20, 100, 100, flags);
GuiCheckBox("test 2", 2, 200, 20, 200, 20, flags );

GuiSetColors( 2, 2, 0, colorRed, colorBlue );

Title = StrFormat( "%s. Refresh # %g\n", GuiGetEvent( 0, 2 ), _counter++ );

nc = GuiGetEvent( 0 , 1 );

if( nc == notifyMouseEnter ) GfxTextOut( "MOUSE ENTER", 200, 50 );
if( nc == notifyMouseLeave ) GfxTextOut( "MOUSE LEAVE", 200, 50 );

_TRACE(Title );
  
• AFL: GuiCheckBox and GuiRadio now support custom colors of text and background
• AFL: In 6.25 Gui* keyboard navigation interferred with delete key and possibly other shortcuts due to the way how windows works. Implemented workaround so keys are only intercepted if child window (control) has focus.
• AFL: In 6.25 Gui* keyboard navigation was turned on by default, now it is off by default but can be turned on if you use SetOption("GuiEnableKeyboard", True )
• AFL: In 6.25 GuiGetCheck returned -1 on unchanged. Now it returns only 0 (unchecked) or 1 (checked)
• AFL: In case of Windows INET API error, Internet* functions now report Warning 507 instead of generic error 47. Warning 507 is Level-3 warning, i.e. editor-only, which means it will pop up in the formula editor, but won't break execution in runtime (indic
• AFL: Now can use subscript operator [ ] on references to arrays and matrices
• AFL: Passing by reference does not create nested references in user-defined function calls
• AFL: VoiceSetRate( rate ) - sets SAPI voice (speech synthesis) rate. Rate of 0 (zero) is "normal", negative is slower, positive is faster (allowable range -10..+10)
• AFL: VoiceSetVolume( volume ) - sets SAPI voice (speech synthesis) volume (0..100)
• AFL: VoiceWaitUntilDone( timeout ) - waits until voice has finished speaking or specified timeout (1..100ms) has elapsed. Returns True if voice finished, False if the timeout elapsed
  
  VoiceSetRate( -10 );
Say("I am speaking slowly", False);

while( ! VoiceWaitUntilDone( 100 ) );
printf("Done 1\n");

VoiceSetRate( 0 );
Say("I am speaking normally", False);

while( ! VoiceWaitUntilDone( 100 ) );
printf("Done 2\n");

VoiceSetRate( 5 );
Say("I am speaking fast", False);

  
• broker.master file is saved to a new name and renamed later to avoid corruption when Windows decides to shutdown, restart or sleep during save
• Dev: 64-bit new compiler (VC2017) broke backward compatibility with singletons that UI lib uses causing infinite loop when High Contrast scheme was used. Workaround implemented.
• Misc: 64-bit: Restored correct manifest (from pre6.22) with compat records so Win 10 does not lie about version number and re-added 24-bit large PNG icon
• New Analysis: Added support for clickable links. If you put @link URL in any cell of Analysis result list it creates a clickable row. If you double click on the row while holding down ALT key it will open the link
  
  AddTextColumn("@link http://www.amibroker.com/", "double click me with ALT key");

// Hidden links are possible if you add the @link in the column past the last defined one
AddRow( "ticker\tdatetime\ttest\t@link http://www.amibroker.com" );


CHANGES FOR VERSION 6.25.0 (as compared to 6.22.0)

• 64-bit: In 6.22 the array division could produce 1ulp (units at least place) rounding errors due to too excessive new VC++2017 compiler optimizations. Workaround implemented to avoid that.
• Added support for formatDateTimeISON (ISO format NO dashes: YYYYMMDD for end of day and YYYYMMDD HHMMSS for intraday)
  AddColumn( DateTime(), "dt", formatDateTimeISON );
  Filter = 1;
  
• AFL Editor: added one-time message "In the Debug mode number of bars is limited to 200 bars. You can change it in Tools->Preferences, Debugger tab" because users don't read docs
• AFL: ApplyStop now has 8th argument: ActivationFloor that defines the amount of profit (in dollars or percents, according to stopmode) that must be exceeded before stop is activated
• AFL: Gui* - controls are created in the order of occurence in AFL formula (instead shuffled or reverse as in previous version)
• AFL: Gui* - keyboard navigation is now enabled (you can tab between controls and use arrows to navigate control groups such as radio boxes)
• AFL: IsNull() accepts matrix input and returns 0 (False), i.e. "variable is not null" if variable is of matrix type
• AFL: math functions such as sin(), sqrt(), etc can now be applied to matrices (element-wise operation) (previously such attempt resulted in access violation)
• AFL: New feature: Passing arguments as reference (allows modification of arguments passed - easy way to return multiple values), to pass by reference use & (address-of) operator before variable identifier
  Reference is actually a pointer to (address of) the variable. If it is passed to function it allows original variable to be modified.
  The difference between AFL and C language is that while you are using address-of operator when you call function,
  you don't need any special syntax in the function itself. This has advantage that same function can be called with arguments passed by value and by reference
  and which one is used is just directed by the way you call the function. AFL automatically and transparently knows that it needs to dereference addresses when
  references are used in aritmetic operations, function calls or assignments.

  function test( x, y )
  {
  x += 1;
  y += 2;
  }

  a = 23;
  b = 25;
  printf("Before function call: a=%g, b=%g\n", a, b );

  test( &a, &b ); // pass references (variables get modified)

  printf("After function by ref call: a=%g, b=%g\n", a, b );

  test( a, b ); // pass values (no modification happens)

  printf("After function by val call: a=%g, b=%g\n", a, b );

  
  
• AFL: new function GuiCheckBox - creates check box
• AFL: new function GuiGetCheck( id ) - gets 'checked' or "ON" state of toggle, checkbox and radio buttons
• AFL: new function GuiRadio - creates radio button
• AFL: new function GuiSetCheck( id, checked ) - sets 'checked' or 'ON' state of toggle, checkbox and radio buttons
• AFL: new function GuiSetFont( "fontface", size )
• AFL: new function GuiToggle - creates toggle button (like normal button but it toggles between "on" and "off" state with each click)
• AFL: SetOption("OptimizeSaveParams", True ); - turns on generation of AFL file that contains values of optimization parameters producing best result. The generated file has the same name as formula run but has .opt.afl extension
  
  This functionality is provided to simplify creation of auto-optimization schemes

  How to use:

  1. Create your main formula, say it's file name is "Formulas/Custom/MainFormula.afl"
  2. Create your opt param formula: "Formulas/Custom/MainFormula.opt.afl"
  In the opt param formula type:
  // This file will be automatically overwritten by optimizer with best values
  first_param = 6;
  second_param = 12;

  3. In the main formula type:

  #include "Formulas/Custom/MainFormula.opt.afl"

  x = Optimize("first_param", first_param, 3, 10, 1 );
  y = Optimize("second_param", second_param, 11, 30, 1 );

  // causes automatic generation of MainFormula.opt.afl
  SetOption("OptimizeSaveParams", 1 );

  // dummy system using two params
  Buy = Cross( C, MA( C, x ) );
  Sell = Cross( MA( C, y ), C );

  4. Run optimization

  After it is complete MainFormula.opt.afl will be overwritten with optimum values

  
  
• AFL: When using TimeFrame functions, QuickAFL now uses ratio of requested_interval/current_interval multipled by 30 to better estimate required bars
• ships with newest AmiQuote 3.22 (see AmiQuote read me for details)
• Analysis: Detailed log displays information about ignored ScaleIn/Outs because of insufficient funds or trade size constraints
• Analysis: Detailed log now displays all warnings about skipped/ignored signals in RED color so they are easier to spot
• Data: when performing X:Y split and X or Y exceeded 255 the factor was incorrectly displayed (negative) in the Symbol window. Fixed.
• formatDateTimeISO and formatDateTimeISON added to syntax highlighter definitions
• Scheduler: Repeat "Daily" mode repeated batch run every day even if some days were unchecked. Fixed.
• UI: Place Order dialog - allows typing stop distances smaller than 0.1 now
• UI: Prefs/Charting: Turning on "Collapse parameter sections" option causes all sections in Parameter window to be collapsed (NOT good idea for newbies as they wont see the controls !)
• Web Research: many HTML5 pages did not display properly because of the fact that web browser used old IE7 mode. Now browser uses IE11 mode at minimum for proper HTML5 rendering

CHANGES FOR VERSION 6.22.0 (as compared to 6.21.0)

• 64-bit: migrated all code to new compiler VC++2017 which seems to produce better code for x64 resulting in 30...50% speed improvements for many AFL functions. The only negative seems to be much bigger runtime libs
• 64-bit: AFL: Sum() function 2x faster
• 64-bit: AFL: Max() and Min() functions 8x faster
• 64-bit: AFL: Ref() funciton 2x faster
• 64-bit: AFL: MACD(), ROC(), StDev(), LinearReg() and many other functions faster by 30-50%
• AFL: GetExtraData does not trigger code check and profile warning about referencing future quotes if plugin implements new GetExtraDataEx function
• AFL: GuiEdit complained about 2nd parameter instead of 1st (being less than zero)

CHANGES FOR VERSION 6.21.0 (as compared to 6.20.1)

• AFL: decreased memory fragmentation when user changes type of variable from array to scalar and back thousands of times
• AFL: GuiButton( "Text", id, x, y, width , height , notifyflags ) - creates a button
  "Text" is a text to be displayed on the button
  x, y are pixel coordinates of top-left corner of the control
  width, height are pixel width and height of the control

  notifyflags - decides which events fire execution of your formula, it can be any combination of values below
  1 - clicked (button)
  2 - setfocus (all)
  4 - killfocus (all)
  8 - hit enter/return key (edit)
  16 - edit change (edit)

• AFL: GuiEdit( id, x, y, width, height, notifyflags ); - creates an edit field
  x, y are pixel coordinates of top-left corner of the control
  width, height are pixel width and height of the control

  notifyflags - decides which events fire execution of your formula, it can be any combination of values below
  1 - clicked (button)
  2 - setfocus (all)
  4 - killfocus (all)
  8 - hit enter/return key (edit)
  16 - edit change (edit)

• AFL: GuiGetEvent( num, what = 0 )
  what = 0 - ID of control that received event (number)
  what = 1 - the notification code (number)
  what = 2 - the ID, the code and the notification description as text (string)

  num parameter defines the index of notification in the queue. 0 is first received (or "oldest") since last execution.

  Usually there is zero (when formula execution was not triggered by UI event) or one event in the queue but
  note that there can be MORE than one event notification in the queue if your formula is slow to process. To retrieve them all use increasing "num" parameter as long as GuiGetEvent does not return zero (in what =0, =1 mode) or empty string (what=2).

  
  // read all pending events
  for( i = 0; id = GuiGetEvent( i ); i++ )
  {
  code = GuiGetEvent( i, 1 );
  text = GuiGetEvent( i, 2 );
  }

• AFL: GuiGetText( id ) - get text from control
• AFL: GuiSetColors( idFrom, idTo, border , clrText = -1, clrBack = -1, clrBorder = -1, clrSelText = -1, clrSelBack = -1, clrSelBorder = -1, clrHoverText = -1, clrHoverBack = -1, clrHoverBorder = -1, clrDisText = -1, clrDisBack = -1, clrDisBorder = -1)
  
  idFrom, idTo - define range of control IDs that will use new colors. To set color for single control use the same value for both idFrom and idTo
  border - defines border width of button (does not affect other control types)

  clrText, clrBack, clrBorder - define colors of control text (fgcolor), background (bgcolor) and border (if border width is > 0 ) in "default" control state (unselected)
  selectfgcolor. -1 means colorDefault and if all colors are set to default then control uses SYSTEM (Windows) look

  clrSelText, clrSelBack, clrSelBorder - define colors in selected state
  clrHoverText, clrHoverBack, clrHoverBorder - define colors in hover (mouse over) state
  clrDisText, clrDisBack, clrDisBorder - define colors in disabled state

  Please note that currently only buttons support custom colors and custom border
  As for v6.21 Edit fields always use system look
  

• AFL: GuiSetText( "text", id ) - set text of the control
  
• AFL: RequestMouseMoveRefresh() - request formula execution / refresh when mouse is moved INSIDE given chart pane (so it only triggers for ONE window under the cursor)
  This provides less resource consuming way to handle chart graphics that depends on mouse hovering over chart pane than using RequestTimedRefresh as it only triggers one window currently under the cursor and only does not trigger refreshes when mouse does not move

  NOTE2: mouse move refreshes come "as fast as possible". if your code is fast you can get butter smooth animation (even 50fps)

  Example:
  Plot( C, "Price", colorDefault );
GfxCircle( GetCursorXPosition(1), GetCursorYPosition(1), 7 );
RequestMouseMoveRefresh();
  
• If Quote.exe is missing and AmiBroker can't do auto-update of quotes, a detailed information is displayed of where it expects Quote.exe file to be present
• Plugin loading changed: first AmiBroker attempts to load plugins for "Plugins" subfolder from where Broker.EXE file is located (new behavior) and if subfolder is NOT found, it then defaults to old behavior (using "Plugins" subfolder under current working

If you experience any problem with this beta version please send detailed description of the problem (especially the steps needed to reproduce it) to support at amibroker.com