Release notes > Version 2.07 from June 2010

Version 2.07 from June 2010

Availability

Available from CUSP site from June 5th 2010.

New capabilities

RenderChartLog – added to allow chart log to be captured as a string result rather than written to file.

RenderPdf – overloads added to support compression and font embedding (as for SavePdf).

Readcomment – takes a string (from one of the RenderXxx calls) as an alternative to a filename.

Enumerations – were starting at 2 which wastes one possibility. Fixed.

PostScript names – DefineFont updated so the caller can change the PostScript names associated with the base set of 14 fonts. For example Arial might not be required to map to Helvetica these days!

DrawKey – given key position should be logged for you if you are placing a key against log axes. Fixed.

DrawNote – oddly, the ‘Percentage’ style was not supported for notes. Now works as for keys.

Log axes – user-supplied range was getting rounded out to the next tick mark with log axes. Fixed.

Bubblechart – adds ‘Altitude’ as a style which uses the current set of Altitude colors to color each marker depending on the incidence value (3rd argument). A ScaleBar may be used to interpret the colors.

LineGraph,Scatter – as a side effect of the above, you can now set MarkerColors to an arbitrary vector of colors. These will be reshaped as needed and used to color each point, overriding the normal series color. The placeholder in the legend ignores this vector and always uses the series color. Also applies to Polar and Cloud as you would expect. Various examples updated to check this out – FishFinder has coloured buoys now!

FindExtremes – returns the (xyxy) bounding box of the data (arguments as for Scatter) and any generated control points if you have set the ‘Curves’ style. It is possible for Beziers to stray outside the limits of the data, but never outside their control points, so you can use this to set axis ranges if you need to.

DrawKey – change to explicitly positioned key to de-couple Baseline and Left key styles. The issue was that Baseline also had the effect of placing the legend placeholder at the x-coord given instead of placing the edge of the box here, which was a bit illogical. Now you have to say Left to get this effect.

KeyDefinition – overload added to Constructor to allow exact specification of Line+Marker legend. Required to add custom legends to contour plots.

Notes – new style ‘Cropped’ which eliminates entire note if any part of it would be clipped at the axis limit. Also makes sure to clip in-line keys which previously escaped the clipping rectangle.

DrawMultiple – failed if there were no PageLabels (or SplitBy) set. Fixed.

Wrapped text with super/subscripts – if the wrap-point fell in non-baselined text it was not correctly positioned on the following line(s). Also a tag with no following text was not closed properly in SVG leading to ill-formed XML which stops the viewer at this point. Both fixed.

Set functions – any Setter that takes an array argument (e.g. sp.SetXTickmarks) adds an overload to allow it to be called with no argument to reset the internal state to default. This is useful in the case of a Trellis where several charts are almost the same, but some settings need to be cancelled. For properties which take double values, passing either NaN or the current missing value will also reset.

Text wrapping – captions with heavy use of small tags (typically superscripted footnote refs) could get split in mid-tag which makes a complete mess of the resulting html. Wrapped legends were allowing too much space for the key placeholder so broke the text too early. Fixed.

PDF output – was measuring characters like “” incorrectly – these are mapped to octal in the ‘old’ Windows positions and we were looking up the metrics assuming Unicode. Fixed.

AddComment – was not handling hi-Unicode characters entered directly from the keyboard rather than encoded in HTML-style strings. Now makes the mapping to &#xhhhh; automatically and reverses it in ReadComment (assumes users won’t use this very geeky style of encoding!).

ZDatumLines – added for use in 3D charts and contour plots. Also we now have DatumTags to simplify the process of annotating lines which mark ranges in typical QA charts. These are used up in x,y,z order. Use DatumTagStyle to adjust the default alignment or place the tags ‘AtEnd’.

XAxis labels – when we have a midlined X-axis we correctly killed the first label, but when the Y-axis is at the right (or is a duplicate) then we may want to kill the last xlabel instead/as well. Also we need a way to tell the labelling that a secondary axis in upcoming. New XStyle OmitLast does this.

Secondary axes – a multi-axis chart in the first cell of a trellis carried the ‘right-axis’ style forward into the next cell unless explicitly reset. Fixed.

Trellis grid – gridline was not drawn in the 1 by 2 case. Fixed.

Synchronised Y-axes – new axis style Synch will force the tickmarks of a secondary axis to mate up nicely with the primary, so it can share a common set of gridlines. Related feature is axis style Balanced which forces matching numbers of ticks above and below the axis which is always set at the zero point.

Arrows – balanced axes get arrows on both ends. Also captions can be passed as 2-element arrays to go left/right on X-axis and bottom/top on y-axis. Most non-standard charts ignore all but the first caption if you do pass more than one. A few related bugs flushed out – you can now have Xstyle Top in harmony with a balanced y-axis and AtEnd caption. New XStyle OmitLast kills the final label which may be about to collide with a secondary axis or an AtEnd caption on a right-hand y-axis.

SetNewline – added for scripting environments (like APL) which don’t support \n and so on as splitters. This augments the hard-wired newline characters \n and \r with a single character of your choice.

Polynomial fit – was using an unnecessarily general algorithm. Updated to call a nice LU decomposition library that turned up on a maths blog and runs a lot faster for heavy datasets.

ScatterPlot and BubbleChart – styles updated to include OnTopModel. This should always have been there!

Histogram – style now gives detailed control over which X-datumlines are drawn to mark mean, and up to three multiples of the std deviation. These may be tagged as required with DatumLineTags.

Spanned labels on 3D charts – implemented for X-axis only for now. Probably used for column charts!

Html tagging – unclosed <sup> and <sub> tags left the baseline adjustment behind so that the next text output was incorrectly placed. Now all html flags are explicitly reset and baseline restored at the end of each text block

Send comments on this topic
© Dyalog Ltd 2013