In this release, new concept of multi structure is introduce. This multi structure enables snapper/entry to have nested same-classification children. For example, a multi bay has 2 sub bay children. In order to support this structure, there are few behaviors and engine functions added to handle these multi cases separately from the normal structure.

There is a change on how we stream UnitLoadContainer and its unit loads. This is so that failing to unstream one unit load will not cause the entire UnitLoadContainer to fail to unstream.

As of 16.0, preview image support has been implemented for core Parts and is no longer exclusive to DsParts.

The system for generating preview images is:

1. Preview images are saved to cmWritable("tmp/partPreviewImageCache/")
2. A str->Url map is stored in Space cacheData for easy access
3. Post finalize after merge hook collects unrendered parts (cm/core/part/hooks.cm)
4. If unrendered parts list is large enough, renderPartPreviewImagesTask task begins (cm/core/part/tasks.cm)

As a part of the effort to standardize and improve query dialogs utilized in CET, we have created a core implementation of Query Dialogs for Parts and PropObjs. This new implementation is meant to phase out the current implementation in cm/abstract/tools/queryDialog/abstractQueryDialog.cm.

This Query dialog is designed to be opt-in and it should not require migration effort. The code for the QueryDialog system can be found in the cm.core.part.query package. An overridden implementation for handling ProdParts and SpecOptions can be found in cm.abstract.party.query.

Static Method Call

Doing a static method call without the first argument being an instance of the class or an instance of a derived class, would incorrectly be able to bind to a function without class as first parameter.

private class Foo {}

private void bar(str k) {}

Foo.bar("");//this call would incorrectly bind to the function above

Repeated case in string switch

A repeated case in a case expression list would fail to be detected

    switch("foo") {
      case "foo": {}
      case "foo", "bar": {} //repeated case "foo" in case expression list would incorrectly be allowed
    }

Changes to CardConfig

Field showPreview has been renamed to activate.

# CardConfig
Old: public bool showPreview=true;
New: public bool activate = true;

init.cm

As of 16.0, preview image support has been implemented for core Parts and is no longer exclusive to DsParts.

As a result, the global constant dsPreviewColumn has been removed from cm.abstract.dataSymbol. A new constant of the column (called partPreviewColumn) has been added and is registered in cm/core/init/corePartColumns.cm.

In cm/abstract/dataSymbol/init.cm
Removed: public const DsPreviewColumn dsPreviewColumn();

In cm/core/init/corePartColumns.cm
Added: public const PartPreviewColumn partPreviewColumn();

DsOptionInfoTree

DsOptionInfoTree now extends SpecOptionInfoTree. It no longer stores values for str description, str price, str groupDescription, or SpecOption specOpt. SpecOptionInfoTree stores the SpecOption for the tree and values like description and price are acquired directly from the SpecOption.

The following has been removed/added in DsOptionInfoTree:

// FIELDS
Removed: public str description;
Removed: public str price;
Removed: public str groupDescription;
Removed: public SpecOption specOpt;

// CONSTRUCTORS
Removed: public constructor(str key, str description, str price, Part owner, DsPDataOption option, str header="", bool choosableInCalculation=true) {}
Removed: public constructor(str key, str description, str groupDescription, str price, Part owner, DsPDataOption option, str header="", bool choosableInCalculation=true) {}
Removed: public constructor(PartInfoTree parent, str key, str description, str price, Part owner, DsPDataOption option, str header="", bool choosableInCalculation=true) {}
Removed: public constructor(PartInfoTree parent, str key, str description, str groupDescription, str price, Part owner, DsPDataOption option, str header="", bool choosableInCalculation=true) {}
Removed: public constructor(PartInfoTree parent, str key, str description, str groupDescription, str price, Part owner, DsPDataOption option, SpecOption specOpt, str header="", bool choosableInCalculation=true) {}
Added: public constructor(Part owner, DsPDataOption option, PartInfoTree parent=null, str key=null, SpecOption specOpt=null, str header="", bool choosableInCalculation=true)

DsPartTagColumn has been deprecated.

Use AbsTagPartColumnn in cm.abstract.part.partColumn .

DsPreviewColumn

As of 16.0, preview image support has been implemented for core Parts and is no longer exclusive to DsParts.

As a result, the global constant dsPreviewColumn has been removed from cm.abstract.dataSymbol as well as the DsPreviewColumn itself. The core version of this column is in cm/core/calc/init/partPreviewColumn.cm. A renamer has also been added to direct loaded DsPreviewColumn types to the new PartPreviewColumn type. A new constant of the column (called partPreviewColumn) has been added and is registered in cm/core/init/corePartColumns.cm.

In cm/abstract/dataSymbol/partColumns/prdPreviewColumn.cm
Removed: public class DsPreviewColumn extends BasicPartColumn : inherit constructors {}
Removed: public class DsPreviewImageGridCell extends DsImageGridCell {}


In cm/core/init/partPreviewColumn.cm and cm/core/calc/previewImageGridCell.cm
Added: public class PartPreviewColumn extends BasicPartColumn : inherit constructors {}
Added: public class PreviewImageGridCell extends ImageGridCell : inherit constructors {}

Cleanup of DsTocExtensionToolboxCard

Argument str cardProductLevelCode has been changed to ProductLevel cardLevel. The default value remains as null.

Old: public constructor(Window parent,
                        str label,
                        symbol pkg,
                        str name,
                        DataCatalog catalog,
                        ProductCatalog productCatalog,
                        str sortKey=null,
                        bool useInPaperSpace=false,
                        str cardProductLevelCode=null) {
New: public constructor(Window parent,
                        str label,
                        symbol pkg,
                        str name|,
                        DataCatalog catalog,
                        ProductCatalog productCatalog,
                        str sortKey=null,
                        bool useInPaperSpace=false,
                        ProductLevel cardLevel=null) {

Cleanup of DsButtonDropDownTreeView constructor

Removed unused argument Brush brush=null from the constructor.

Old: public constructor(Window parent,
                        Font font=systemFont(),
                        Brush brush=null, // MergeTODO 16.0 Prism: Remove as this is not used!
                        Brush stdBrush=dsGradientBrush,
                        Brush hoverBrush=dsLightGradientBrush,
                        Brush mouseDownBrush=dsSuperLightGradientBrush,
                        FrameStyle frameStyle=dsRoundedFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        pointI margins=(6, 4),
                        alignment align=left,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=true,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        int minWidth=-1,
                        int autoOpenDelay=500,
                        bool autoGestures=false,
                        Image selectionImage=null,
                        str selectionLabel=null,
                        Brush selectionBrush=null,
                        str key=null,
                        str label=null,
                        color labelColor=color(0, 0, 0),
                        Image image=null,
                        Image disabledImage=null,
                        bool useFocusRectangle=true,
                        bool keepInsideScreen=true) {
New: public constructor(Window parent,
                        Font font=systemFont(),
                        Brush stdBrush=dsGradientBrush,
                        Brush hoverBrush=dsLightGradientBrush,
                        Brush mouseDownBrush=dsSuperLightGradientBrush,
                        FrameStyle frameStyle=dsRoundedFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        pointI margins=(6, 4),
                        alignment align=left,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=true,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        int minWidth=-1,
                        int autoOpenDelay=500,
                        bool autoGestures=false,
                        Image selectionImage=null,
                        str selectionLabel=null,
                        Brush selectionBrush=null,
                        str key=null,
                        str label=null,
                        color labelColor=color(0, 0, 0),
                        Image image=null,
                        Image disabledImage=null,
                        bool useFocusRectangle=true,
                        bool keepInsideScreen=true) {

Updates to DsToolboxThumbnailView constructor

The cosntructor has a new argument buttonType btnType with a default value of buttonType.undefined

Old: public constructor(Window parent, pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        pointI margins=(0, 0),
                        DsDragAnimationEnv dragAnimationEnv=null,
                        FrameStyle frameStyle=toolboxButtonFrameStyle,
                        frame3DState frameState=frameStateDown,
                        bool facelift=false,
                        SrcRef src=#:src) {
New: public constructor(Window parent, pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        pointI margins=(0, 0),
                        DsDragAnimationEnv dragAnimationEnv=null,
                        FrameStyle frameStyle=toolboxButtonFrameStyle,
                        frame3DState frameState=frameStateDown,
                        bool facelift=false,
                        buttonType btnType=buttonType.undefined,
                        SrcRef src=#:src) {

Cleanup of DsGridWindow

There were some references to legacy frame logic that was removed.

Removed: extend public void paintFrame3D(DsGridWindowPaintArgs args) {

Previously the defaultFrameStyle method applied a WinFrame with thin3DFrameOld for selected and label. This has now been updated to thin3DFrame.

extend public void defaultFrameStyle(DsFrameStyle style) {
    style."default" = WinFrame(PenFrame(linePen), frame3DState.frameStateFlat);
    Old: style."selected" = WinFrame(thin3DFrameOld, frameStateDown);
    New: style."selected" = WinFrame(thin3DFrame, frameStateDown);

    Old: style."label" = WinFrame(thin3DFrameOld, frameStateUp);
    New: style."label" = WinFrame(thin3DFrame, frameStateUp);
}

Cleanup of CatalogTocLimbBuilder interfaces

Method appendThumbnails now passes in dsUILevel lastNonIcon and is final.

Old: extend public void appendThumbnails(LibraryLimb parent, ProductLevel productLevel) {}
New: final public void appendThumbnails(LibraryLimb parent, ProductLevel productLevel, dsUILevel lastNonIcon) {

Method createThumbnail now passes in a str thumbDesc.

Old: extend public DsBasicThumbnail createThumbnail(ProductLevel parent, DsPData data) {
New: extend public DsBasicThumbnail createThumbnail(ProductLevel parent,
                                                    DsPData data,
                                                    str thumbDesc=null) {

Cleanup of DsThumbnailsLimb constructor

The constructor now takes in an extra argument buttonType btnType with a default value of buttonType.medium.

Old: public constructor(LibraryLimb parent, symbol pkg, str key,
                        DsBasicThumbnail[] thumbnails=null,
                        LibraryLimbVisibility vs=null,
                        Image image=null, bool frame=true, str label=null,
                        str toolTipText=null, Image toolTipImage=null,
                        int maxRows=3/*-1 == full size*/) {
New: public constructor(LibraryLimb parent, symbol pkg, str key,
                        DsBasicThumbnail[] thumbnails=null,
                        LibraryLimbVisibility vs=null,
                        Image image=null, bool frame=true, str label=null,
                        str toolTipText=null, Image toolTipImage=null,
                        int maxRows=3/*-1 == full size*/,
                        buttonType btnType=buttonType.medium) {

public functions

This function has been removed. Instead call ApplianceEnv.buildQuickProperties(..) directly.

Removed: public void buildWGAQuickProperty(Snapper snapper, ApplianceEnv applianceEnv, QuickProperties props) {

This function has been removed. Instead call ApplianceEnv.quickPropertiesChanged(..) directly.

Removed: public bool quickPropertyWGAChanged(Snapper snapper, ApplianceEnv applianceEnv, str key, Object value) {

class WhiteGoodsAccessory

Added a defaut hidden argument to constructor.

Old: public constructor(..) {
New: public constructor(.., bool hidden=false) {

Removed method hidden=. Instead use constructor.

Removed: extend public bool hidden=(bool v) {

class WgApplianceEnv

Removed two obsolete constructors. Instead use constructor which covers both obsolete constructors.

Removed: public constructor(str article,
		       str brand=null,
		       str model3DStr=null,
		       str eanCode=null,
		       str extProductSheetLink=null,
		       str cetType=null,
		       size snapperSize = (0, 0, 0),
		       size nicheSize = (0, 0, 0),
		       double depthOffset=0,
		       double heightOffset=0,
		       fanCm3DType fanType=fanCm3DType.undefined,
		       str imageStr=null,
		       symbol creatorPkg=#:package : caller eval,
		       bool hidden=false) {

Removed: public constructor(str article,
		       str brand=null,
		       str model3DStr=null,
		       str eanCode=null,
		       str extProductSheetLink=null,
		       str cetType=null,
		       size snapperSize = (0, 0, 0),
		       size nicheSize = (0, 0, 0),
		       double depthOffset=0,
		       double heightOffset=0,
		       fanCm3DType fanType=fanCm3DType.undefined,
		       symbol creatorPkg=#:package : caller eval,
		       bool hidden = false) {

class MhSnapperSpreadToolAnimation

Removed redundant method selection(). It has been replaced with Animation.getSelection().

Removed: public AnimationSelection selection()
Replacement: public AnimationSelection getSelection()

class MhEngineEntryBase

Added default engine as argument when calling below method.

 Old: public MhEngineConstructionEntry toConstructionEntry()
 New: public MhEngineConstructionEntry toConstructionEntry(MhEngine engine=null)

class MhSystemConfigurationItem

Added new argument to rebuildProp and rebuildProps so that we can choose which rebuildFlag to use instead of always using diffRebuildProps.domain.

Old: extend public void rebuildProp(str k) {
New: extend public void rebuildProp(str k, diffRebuildProps rebuildFlag=diffRebuildProps.domain) {

Old: extend public void rebuildProps(str[] keys) {
New: extend public void rebuildProps(str[] keys, diffRebuildProps rebuildFlag=diffRebuildProps.domain) {

class MhEngineEntryBase

Removed the method sortedChildren(MhEngine engine, function(MhEngineEntry, MhEngineEntry, Object):int sortFunc), use sortedChildren(MhEngine engine, function(MhEngineEntry, MhEngineEntry, Object):int sortFunc, Object arg=null) instead.

public class MhEngineEntryBase : abstract, unstreamable {
    Removed: extend public MhEngineEntry[] sortedChildren(MhEngine engine, function(MhEngineEntry, MhEngineEntry, Object):int sortFunc) : deprecated {
}

class MhEngineConstructionEntry

Removed the following deprecated constructors.

public class MhEngineConstructionEntry extends MhEngineSnapperEntry : inherit constructors {
    Removed: public constructor(box b, Transform t, LayerSet classification=null) : deprecated {
    Removed: public constructor(box b, LayerSet classification) : deprecated {
}

class EngineVisualiserDialog

Removed the following deprecated fields and methods.

private class EngineVisualiserDialog extends DialogWindow {
    Removed: public TreeView leftTreeView : deprecated;
    Removed: public REDRenderView3D preview3D : deprecated;
    Removed: extend public void updateEntriesInTreeView() : deprecated {}
    Removed: extend public void updateGraphics() : deprecated {}
}

Moved functions

The following functions have been moved from abstract.materialHandling.storage.engine to abstract.materialHandling.

Moved: public MhEngineEntry[] mhImportedChildren(MhEngineEntry entry, MhEngine engine) {
Moved: public MhEngineEntry[] mhPopulatedChildren(MhEngineEntry entry, MhEngine engine) {
Moved: public int mhEntryXPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

The following functions have been moved from abstract.materialHandling.storage.engine to abstract.materialHandling.engine.

Moved: public MhEngineEntry->double mhEntryXPositions(MhEngineEntry[] entries, bool unmodify) {
Moved: public MhEngineEntry[] mhXSortedEntries(MhEngineEntry[] entries, bool unmodify) {
Moved: public MhEngineEntry->double mhEntryYPositions(MhEngineEntry[] entries, bool unmodify) {
Moved: public MhEngineEntry[] mhYSortedEntries(MhEngineEntry[] entries, bool unmodify) {

The following functions have been added.

New: public int mhEntryPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {
New: public int mhEntryYPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

The following function has been removed from abstract.materialHandling.storage.engine. Use the functions listed instead.

Removed: public int entryYPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {
Use: public int mhEntryYPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

The following functions have been removed, use the replacement functions listed instead.

Removed: public MhEngineEntry[] mhAbsImportedChildren(MhEngineEntry entry, MhEngine engine) {
Use: public MhEngineEntry[] mhImportedChildren(MhEngineEntry entry, MhEngine engine) {

Removed: public MhEngineEntry[] mhAbsPopulatedChildren(MhEngineEntry entry, MhEngine engine) {
Use: public MhEngineEntry[] mhPopulatedChildren(MhEngineEntry entry, MhEngine engine) {

Removed: public int mhAbsEntryRootXYZPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {
Use: public int mhEntryRootXYZPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

Removed: public int mhAbsEntryFuncRunOrderSort(MhEngineEntry a, MhEngineEntry b, Object env) {
Use: public int mhEntryFuncRunOrderSort(MhEngineEntry a, MhEngineEntry b, Object env) {

Removed: public int mhAbsEntryXPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {
Use: public int mhEntryXPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

Removed: public int mhAbsEntryPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {
Use: public int mhEntryPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

Removed: public int mhAbsEntryYPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {
Use: public int mhEntryYPosSort(MhEngineEntry a, MhEngineEntry b, Object env) {

Removed: public MhEngineEntry->double mhAbsEntryXPositions(MhEngineEntry[] entries, bool unmodify) {
Use: public MhEngineEntry->double mhEntryXPositions(MhEngineEntry[] entries, bool unmodify) {

Removed: public MhEngineEntry[] mhAbsXSortedEntries(MhEngineEntry[] entries, bool unmodify) {
Use: public MhEngineEntry[] mhXSortedEntries(MhEngineEntry[] entries, bool unmodify) {

Removed: public MhEngineEntry->double mhAbsEntryYPositions(MhEngineEntry[] entries, bool unmodify) {
Use: public MhEngineEntry->double mhEntryYPositions(MhEngineEntry[] entries, bool unmodify) {

Removed: public MhEngineEntry[] mhAbsYSortedEntries(MhEngineEntry[] entries, bool unmodify) {
Use: public MhEngineEntry[] mhYSortedEntries(MhEngineEntry[] entries, bool unmodify) {

LinkedNeighbors interface changes

New optional arguments are added to these functions in order to reduce number of set and seq created.

Old: public (Snapper{}) endNeighbors(MhSnapper this, LayerSet ls=null) {
New: public (Snapper{}) endNeighbors(MhSnapper this, LayerSet ls=null, Snapper{} snappers=null) {

Old: public (Snapper{}) nextNeighbors(MhSnapper this, LayerSet ls=null) {
New: public (Snapper{}) nextNeighbors(MhSnapper this, LayerSet ls=null, Snapper{} snappers=null) {

Old: public (Snapper{}) prevNeighbors(MhSnapper this, LayerSet ls=null) {
New: public (Snapper{}) prevNeighbors(MhSnapper this, LayerSet ls=null, Snapper{} snappers=null) {

Old: public (Snapper{}) linkedNeighbors(MhSnapper this, LayerSet ls=null) {
New: public (Snapper{}) linkedNeighbors(MhSnapper this, LayerSet ls=null, Snapper{} snappers=null) {

Bound with children functions and methods

There were various different functions and methods to retrieve bounds of snappers including their children bound. We have reduce the number of interfaces by combining them where possible.

We have consolidated the following MhSnapper methods into one. Replace all calls to childrenBound(bool recursive=true), childrenShapeLocalBound(symbol[] symbols=null), and childrenShapeBound(symbol[] symbols=null, SnapperFilter filter=null) with childrenShapeBound(symbol[] symbols=null, SnapperFilter filter=null, bool recursive=false).

Note that the old childrenBound(bool recursive=true) method has recursive's default argument set to true while the new method has recursive's default argument set to false, so any calls to childrenBound() should be replaced with childrenShapeBound(recursive=true).

Old:
public class MhSnapper extends Snapper {

    /**
     * Children bound.
     */
    extend public box childrenBound(bool recursive=true) {
        box bc();
        bool empty=true;
        
        forChildren(MhSnapper c in this) {
            box b = c.localBound();
            b.transform(c.rot == 0deg ? Transform(c.pos) : Transform(c.pos, c.rot));
            
            if (b != box0) {
                if (empty) bc = b;
                else bc += b;
                empty = false;
            }
            
            if (recursive) bc += c.childrenBound(..);
        }
        
        return bc;
    }


    /**
     * Children shape local bound.
     */
    extend public box childrenShapeLocalBound(symbol[] symbols=null) {
        box bc();
        bool empty=true;

        forChildren(MhSnapper c in this) {
            box b = c.shapeBound(symbols);

            if (b != box0) {
                if (empty) bc = b;
                else bc += b;
                empty = false;
            }
        }

        if (MhSnapperBehavior b = snapperInfosBehavior()) {
            for (info in b.infos) {
                info.shape.?setOwner(this);

                box b = info.shape.?localBound(symbols);
                if (b != box0) {
                    if (empty) bc = b;
                    else bc += b;
                }
                info.shape.?setOwner(null);
            }
        }
        
        return bc;
    }


    /**
     * Children shape bound.
     */
    extend public box childrenShapeBound(symbol[] symbols=null, SnapperFilter filter=null) {
        box bc();
        bool empty=true;

        //for (MhSnapper c in children) {
        forChildren(MhSnapper c in this) {
            if (filter and !filter.accepts(c)) continue;
            box b = c.shapeBound(symbols);

            if (b != box0) {
                b.transform(mhTransform(c.pos, c.rot));
                if (empty) bc = b;
                else bc += b;
                empty = false;
            }
        }
        
        for (info in snapperInfos()) {
            try {
                info.shape.?setOwner(this);
                
                box b = info.shape.?localBound(symbols);
                if (b != box0) {
                    b.transform(mhTransform(info.pos, info.rot));
                    if (empty) bc = b;
                    else bc += b;
                    empty = false;
                }
            } finally {
                info.shape.?setOwner(null);
            }
        }
        
        return bc;
    }
}

New:
public class MhSnapper extends Snapper {

    /**
     * Children shape bound.
     */
    extend public box childrenShapeBound(symbol[] symbols=null, SnapperFilter filter=null, bool recursive=false) {
        box bc();
        bool empty = true;

        forChildren(MhSnapper c in this) {
            if (filter and !filter.accepts(c)) continue;
            box b = c.shapeBound(symbols);

            if (b.volume > 0) {
                b.transform(mhTransform(c.pos, c.rot));
                if (empty) bc = b;
                else bc += b;
                empty = false;
            }
            
            if (recursive) {
                box cbc = c.childrenShapeBound(..);
                if (cbc.volume > 0) {
                    cbc.transform(mhTransform(c.pos, c.rot));
                    if (empty) bc = cbc;
                    else bc += cbc;
                    empty = false;
                }
            }
        }

        for (info in snapperInfos()) {
            try {
                info.shape.?setOwner(this);
                box b = info.shape.?localBound(symbols);
                if (b.volume > 0) {
                    b.transform(mhTransform(info.pos, info.rot));
                    if (empty) bc = b;
                    else bc += b;
                    empty = false;
                }
            } finally {
                info.shape.?setOwner(null);
            }
        }

        return bc;
    }
}

Important to note is that we have also made a behavioral change. Previously in localBoundWithChildren(MhSnapper owner, symbol[] symbols=null, SnapperFilter filter=null) and shapeBoundWithChildren(MhSnapper owner, symbol[] symbols, SnapperFilter filter=null) we would always include the result of the children bounds regardless of what they were. Now in both of these functions, we only include the children bounds if their bound volumes are not zero. This is to fix the issue where we could include empty bounds into the resultant bound. Now you may even have a resultant bound that does not include (0, 0, 0) within it. Be aware of this as there may be some existing logic in your codebase that relied on this false positive behavior previously, you can now be more specific in the bounds you include.

Aside from that, we have updated localBoundWithChildren and shapeBoundWithChildren to use the newly introduced MhSnapper.childrenShapeBound(symbol[] symbols=null, SnapperFilter filter=null, bool recursive=false) method.

Old:
/**
 * Get localbound with children
 */
public box localBoundWithChildren(MhSnapper owner, symbol[] symbols=null, SnapperFilter filter=null) {

  
    if (!owner) return box();

    box bc(); bool first = true;
    if (!filter or filter.accepts(owner)) {
        bc = owner.shapeBound(symbols);
        bc += owner.childrenShapeBound(symbols);
        first = false;
    }
    
    forChildren(MhSnapper child in owner) {
        if (child.includeChildrenInLocalBound) {
            box b = localBoundWithChildren(child, symbols, filter);
            Transform t = mhTransform(child.pos, child.rot);
            b = b.transformed(t);
            bc = first ? b : bc + b;
            if (first) first = false;
        }
    }
    
    return bc;
}


/**
 * Get shape bound with children
 */
public box shapeBoundWithChildren(MhSnapper owner, symbol[] symbols, SnapperFilter filter=null) {
    if (!owner) return box();

    box bc(); bool first = true;
    if (!filter or filter.accepts(owner)) {
        bc = owner.shapeBound(symbols);
        bc += owner.childrenShapeBound(symbols, filter); //say what
        first = false;
    }
    
    forChildren(MhSnapper child in owner) {
        box b = shapeBoundWithChildren(child, symbols, filter);
        Transform t = mhTransform(child.pos, child.rot);
        b = b.transformed(t);
        bc = first ? b : bc + b;
        if (first) first = false;
    }
    
    return bc;
}

New:
/**
 * Localbound with children.
 * This differ from shapeBoundWithChildren as this recursiveness controlled by `includeChildrenInLocalBound`.
 */
public box localBoundWithChildren(MhSnapper owner, symbol[] symbols=null, SnapperFilter filter=null) {
    if (filter and !filter.accepts(owner)) return box();
    if (!owner) return box();

    box bc = owner.shapeBound(symbols);
    box b = localBoundWithChildrenRe(..);
    if (b.volume > 0) bc += b;

    return bc;
}
private box localBoundWithChildrenRe(MhSnapper owner, symbol[] symbols, SnapperFilter filter) {
    if (filter and !filter.accepts(owner)) return box();
    if (!owner.includeChildrenInLocalBound) return box();

    box bc = owner.childrenShapeBound(symbols, filter);
    forChildren(MhSnapper c in owner) {
        box b = localBoundWithChildrenRe(c, -..);
        if (b.volume > 0) {
            b.transform(mhTransform(c.pos, c.rot));
            bc += b;
        }
    }

    return bc;
}


New:
/**
 * Get shape bound with children.
 * Always recursive.
 */
public box shapeBoundWithChildren(MhSnapper owner, symbol[] symbols=null, SnapperFilter filter=null) {
    if (!owner) return box();

    box bc();
    
    if (!filter and filter.accepts(owner)) {
        bc = owner.shapeBound(symbols);
        
        box cbc = owner.childrenShapeBound(symbols, filter, recursive=true);
        if (cbc.volume > 0) bc += cbc;
    }

    return bc;
}

class MhStorageSpawnerSelector

Updated logic and method to find best matched spawner by including the minimum numbers of non-matched symbols.

Removed:
    /**
     * Find best match spawner.
     */
    extend public SnapperSpawner findBestMatchSpawner(LayerSet classification, SnapperSpawner current, MhAssortment assortment, bool &exactMatch) {
        if (MhSpawnerStore spawnerStore = assortment.?spawnerStore) {
            int maxMatchCount;
            // use all sorted to ensure consistency.
            for (_, spawner in spawnerStore.allSorted()) {
                if (!accepts(classification, spawner)) continue;

                // prioritize exact match
                if (classification.equal(spawner.classification)) {
                    current = spawner;
                    exactMatch = true;
                    break;
                }

                LayerSet intersect = classification*spawner.classification;
                int layerMatchCount = intersect.count;
                if (layerMatchCount > maxMatchCount) {
                    current = spawner;
                    maxMatchCount = layerMatchCount;
                }
            }
        }

        return current;
    }


Added:
    /**
     * Find best match spawner.
     */
    extend public SnapperSpawner findBestMatchSpawner(LayerSet classification, MhSnapperSpawner[] spawners) {
        SnapperSpawner res = null;
        int maxMatchCount = -maxInt;
        int minRemainder = maxInt;

        // use all sorted to ensure consistency.
        for (spawner in spawners) {
            if (!accepts(classification, spawner)) continue;
            
            // prioritize exact match
            LayerSet ls = spawner.classification;
            if (classification.equal(ls)) {
                res = spawner;
                break;
            }
            
            LayerSet intersect = classification*ls;
            if (!intersect) continue;

            int layerMatchCount = intersect.count;
            int remainder = (ls - intersect).count;

            if (layerMatchCount > maxMatchCount or remainder < minRemainder) {
                res = spawner;
                maxMatchCount = layerMatchCount;
                minRemainder = remainder;
            }
        }
        
        return res;
    }

class MhBayEditorItem

The method forceRebuildProps(MhStorageEditorDialog dialog) has been moved into the parent class MhStorageEditorItem.

Frame editor changes

Function mhFrameEditorReinsertFrames has been made public.

Old: package void mhFrameEditorReinsertFrames(MhStorageEditorSpace space) {
New: public void mhFrameEditorReinsertFrames(MhStorageEditorSpace space) {

class MhStorageConfiguration

Removed deprecated method unitLoadCountX().

public class MhStorageConfiguration extends MhSystemConfiguration {

Removed:
    extend public int unitLoadCountX() : deprecated {
        return getValue(cMhNoOfUnitLoadsPK).?int;
    }
}

class MhSingleUprightFrameShape

The class MhSingleUprightFrameShape is removed.

Removed: public class MhSingleUprightFrameShape extends MhFrameShape {

class MhUpdateImportPrimsFunction

The class MhUpdateImportPrimsFunction has been removed as it is not used in the abstract.

Removed: public class MhUpdateImportPrimsFunction extends MhSystemEngineFunction : deprecated {

class MhRowChildrenUnlinkFunction

The class MhRowChildrenUnlinkFunction has been removed as it is not used in the abstract.

Removed: public class MhRowChildrenUnlinkFunction extends MhSystemEngineFunction : deprecated {

MhRowPickUpFrameVessel changes

This vessel has a new field addSelection which acts as a flag to add snapper's selection to the list of selection.

public class MhRowPickUpFrameVessel extends MhApplyColorFrameVessel {
    /**
     * Add Selection.
     */
    public bool addSelection;

    /**
     * Constructor.
     */
    public constructor(str key, bool active=true, CoreObject owner=null, str->Object args=null,
    Object env=null, symbol{} tags=null, color c=color(224, 32, 32)|, bool addSelection=true) {
            super(..|);
            this.addSelection = addSelection;
    }

    /**
     * Add to selection.
     */
    public Snapper{} addToSelection(Snapper s) {
            if (addSelection) return super(..);
            return null;
    }
}

MhStorageSelectionBehavior changes

Renamed the following method:

public class MhStorageSelectionBehavior extends MhSelectionBehavior {

Old: extend public void addtionalSnapperInSelection(MhSnapper snapper, SnapperSelection sel, Line mouseLine) { }
New: extend public void additionalSnapperInSelection(MhSnapper snapper, SnapperSelection sel, Line mouseLine) { }
}

MhRowChildSelectionBehavior changes

Renamed the following methods:

public class MhRowChildSelectionBehavior extends MhStorageSelectionBehavior {

Old: extend public bool addtionalLinkedSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {
New: extend public bool additionalLinkedSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {


Old: extend public void addtionalFilteredSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {
New: extend public void additionalFilteredSnappers(MhSnapper snapper, SnapperSelection sel, Line mouseLine) {
}

MhBayEntryLayout changes

Removed the following fields and methods as well as renamed levelsEntries to levelEntries.

With the removal of getLevelEntry(bool first, bool last), replace it with getLevelEntry(bool first, bool last, int idx=-1).

We have undeprecated constructor(MhEngineConstructionEntry levelEntry, MhEngineConstructionEntry botLevelEntry=null, MhEngineConstructionEntry topLevelEntry=null) and updated it to work with the field levelEntries.

public class MhBayEntryLayout extends MhEntryLayout {

Removed: public MhEngineConstructionEntry levelEntry : deprecated;


Old: public MhEngineEntry[] levelsEntries;
New: public MhEngineEntry[] levelEntries;


Removed:
    extend public MhEngineConstructionEntry getLevelEntry(bool first, bool last) : deprecated {
        return getLevelEntry(.., idx=-1).MhEngineConstructionEntry;
    }
}

Constants changes

cPredefinedConfig has been renamed to cPredefinedBayConfigDefVal and its value has been modified from _predefinedConfig to _predefinedBayConfigDefault to better reflect its usage.

Old: 
/**
 * Predefine key.
 */
public const str cPredefinedConfig = "_predefinedConfig";


New:
/**
 * Predefined bay config default value.
 */
public const str cPredefinedBayConfigDefVal = "_predefinedBayConfigDefault";

A constant mhFrameHeighDiffKey was moved from abstract.materialHandling to abstract.materialHandling.storage.

public const str mhFrameHeighDiffKey = "frameHeightDiff";

Few unit load functions are moved

The functions removeUniqueName, unitLoadEq, and findEqualUnitLoad are moved to cm/abstract/unitLoad/functions.cm from cm/abstract/materialHandling/storage/unitLoadFunctions.cm.

Moved:
    public str removeUniqueName(Object o) {
    public bool unitLoadEq(UnitLoad unitLoad, UnitLoad l) {
    public UnitLoad findEqualUnitLoad(UnitLoad unitLoad, World w=null) {

class MhShuttleRowPickUpFrameVessel

This class is now removed.

Removed: public class MhShuttleRowPickUpFrameVessel extends MhRowPickUpFrameVessel {

class AbsTagPartColumn

Made AbsTagPartColumn public for use.

public class AbsTagPartColumn extends BasicPartColumn

SpecOptionInfoTree has had constructors removed and consolidated into one constructor.

Added: public constructor(Part owner, SpecOption specOpt, PartInfoTree parent=null, str key=null, PartColumn[] columns=null) {}

Removed: public constructor(Part owner, SpecOption specOpt) {}
Removed: public constructor(Part owner, SpecOption specOpt, rest: PartColumn[] columns) {}
Removed: public constructor(Part owner, SpecOption specOpt, PartColumn[] columns) {}

UnitLoadDialog Redesign Changes

In 15.5 Minor we introduced a new UnitLoadDialog design while still retaining all the logic used for the old design. In 16.0 Major we are now removing all the old logic and will only be maintaining the new design. If you would like to maintain the old design in your extension, you will need to copy over the removed interfaces and logic into your dialog class.

The following fields and methods were only used for the old design and have been removed:

public class UnitLoadDialog extends DialogWindow {
    //Fields.
    public TreeView userRegisteredTree;
    public DropDownTreeView systemRegisteredTree;

    // Methods.
    extend public SubWindow buildAddTemplateWin(Window parent) {
    extend public void buildUserUnitLoadWin(Window sub, Window templateInsert) {
    extend public void buildApplyButtons() {
    extend public pointI paneMargin() {
    extend public void updateUnitLoadSelectorWin() {
    extend public void updatePreviewWin() {
    extend public void updatePropsWin() {
    extend public void updatePanes() {
    extend public void addSelectedTemplateToUserRegistry(bool refresh) {
    extend public str propsLabel(UnitLoad unitLoad) {
    extend public TreeViewItem getSelectedSystemUnitLoad() {
}

The following fields and methods were temporarily added in 15.5 Minor to support the new design without removing the old design. They have been removed or modified (renamed) now that the old design is no longer supported:

public class UnitLoadDialog extends DialogWindow {
    //Fields.
    Removed: public bool useV2;

    // Methods.
    Removed: public constructor(bool useV2, Window parent=null, pointI pos=(-1, -1)) {

    Removed: extend public void buildUnitLoadSelectorWin2() {
    Replacement: extend public void buildUnitLoadSelectorWin() {

    Removed: extend public void buildPropertiesWin2() {
    Replacement: extend public void buildPropertiesWin() {
    
    Removed: extend public void buildPreviewWin2() {
    Replacement: extend public void buildPreviewWin() {

    Removed: extend public void renameUnitLoadItem(UnitLoadTreeViewItem2 item, str newName) {
    Replacement: extend public void renameUnitLoadItem(UnitLoadTreeViewItem item, str newName) {
    
    Removed: extend public UnitLoadTreeViewItem2 getSelectedUnitLoadTVI() {
    Replacement: extend public UnitLoadTreeViewItem getSelectedUnitLoadTVI() {

The logic of the following methods in UnitLoadDialog have been modified to fit the new design. We have removed the logic used for the old design.

public class UnitLoadDialog extends DialogWindow {
    extend public void build() {
    extend public void buildUnitLoadSelectorWin() {
    extend public void buildPropertiesWin() {
    extend public void buildPreviewWin() {
    extend public void unitLoadSelectionChanged() {
    public void rebuild() {
    extend public void populatePropsWindow(UnitLoad mtbh) {
    extend public void removeProps() {
    extend public void createPropsUI(UnitLoad mtbh) {
    extend public void animApplyCallback() {
    extend public void applyAllCallback(UnitLoad[] applyUnitLoads) {
    extend public void afterPropertyChanged(CoreProperty property, Object oldValue) {
    extend public void clearModifiedUnitLoads(str->UnitLoad newLoads=null) {
    extend public UnitLoad getSelectedUserUnitLoad(bool actual=false) {
    extend public bool selectUserUnitLoad(UnitLoad mtbh) {
    extend public void validateUserUnitLoadsInUse() {
}

Removed the temporary function introduced in 15.5 Minor to choose between using the old or new dialog design.

Removed:
/**
 * Temporary interface to useV2 dialog. FIXME 16.0 remove
 */
public void showUnitLoadDialog(bool useV2, bool closeIfValid=false,
                               UnitLoad selectUnitLoad=null) {

Replacement:
/**
 * Show the current Material to be Handled dialog or 
 *  create a new one and show that.
 */
public void showUnitLoadDialog(bool closeIfValid=false,
                               UnitLoad selectUnitLoad=null) {

Removed the following globals:

Removed: public pointI unitLoadGetLastDialogPos() : deprecated { return lastDialogPos; } 
Removed: public const str cUnitLoadDialogTreeKey = "mhmtbhDialogTree";

The class UnitLoadTreeViewItem2 has been removed and the current state of UnitLoadTreeViewItem is now identical to UnitLoadTreeViewItem2 in 15.5 Minor.

Removed:
/**
 * Unit load tree view item.
 * FIXME 16.0 Rename to UnitLoadTreeViewItem.
 */
public class UnitLoadTreeViewItem2 extends TreeViewItem : inherit constructors {

Some other details to be mentioned:

1. When using the new design, refer to registeredUnitLoadTV instead for the list of unit loads in the drawing.

public class UnitLoadDialog extends DialogWindow {
    Old: public TreeView userRegisteredTree;
    New: public UnitLoadDropDownTreeView registeredUnitLoadTV;
}

2. The feature of adding new unit loads objects into the drawing has been modified. systemRegisteredTree is not used in the new design and has been replaced with a new dialog UnitLoadTemplateSelectorDialog.

public class UnitLoadDialog extends DialogWindow {
    Old: public DropDownTreeView systemRegisteredTree;
    New:
    /**
     * Open unit load template selector dialog.
     */
    extend public void openTemplateSelectorDialog() {
        UnitLoadTemplateSelectorDialog(this);
    }


    Old: extend public void addSelectedTemplateToUserRegistry(bool refresh) {
    New: extend public void addSelectedTemplateToUserRegistry(UnitLoad ul, UnitLoadGroup grp) {
}

3. We have moved the responsibility of duplicating/renaming/removing unit loads from UnitLoadTreeViewItem into UnitLoadDialog for the new design. If you have extended UnitLoadTreeViewItem and modified these features, considering extending these methods in your UnitLoadDialog class.

public class UnitLoadDialog extends DialogWindow {
    // Methods.
    extend public bool allowModifyUnitLoad() {
    extend public bool allowRemoveUnitLoad() {
    extend public void openRenamePopup() {
    extend public void renameUnitLoadItem(UnitLoadTreeViewItem item, str newName) {
    extend public void duplicateUnitLoad() {
    extend public void removeUnitLoad() {
    extend public int promptUserRemoveUnitLoad() {
}

This class has been greatly simplified. We have removed the custom draw logic, ability to drag and reposition UnitLoadTreeViewItem objects in the TreeView, and the custom drawn buttons used to rename/copy/remove the UnitLoadTreeViewItem object. Below are the removed fields and methods in UnitLoadTreeViewItem.

public class UnitLoadTreeViewItem extends TreeViewItem : inherit constructors {
    // Fields.
    public rectI editButtonRect;
    public rectI cpyButtonRect;
    public rectI rmButtonRect;
    public byte over = 0;

    // Methods.
    extend public void drawColoredRect(PixelDevice c, rectI r, rectI clipRect, treeViewItemState state, treeViewSelectionStyle style) {
    extend public void drawMainArrow(PixelDevice d, rectI r, rectI clipRect) {
    extend public int btnMult(str btnName) {
    extend public bool allowModify() {
    extend public bool allowRemove() {
    extend public rectI drawBtn(str btnK, Image img, PixelDevice d, rectI r, rectI clipRect) {
    extend public rectI drawBtn(str btnK, Image img, PixelDevice d, rectI r, rectI clipRect, bool disable) {
    extend public pointI getBtnPos(str btnK, Image img, rectI r) {
    extend public Brush backgroundBrush(treeViewItemState state) {
    extend public bool showSelectedAsWhite(treeViewItemState state, treeViewSelectionStyle style) {
    extend public ScrollBar vScrollBar(bool ifVisible=false) {
    extend public void updateApplyButtons(TreeView tv) {
    extend public void openEditNamePopup(TreeView tv) {
    extend public void editName(str newName, TreeView tv) {
    extend public void copyUnitLoadDown(TreeView tv) {
    extend public void removeUnitLoad(TreeView tv) {
    extend public void updateTreeView(TreeView tv) {
    extend public bool isMainSelection() {
    extend public bool isMultiSelect() {

animationUtil.cm

Removed the following deprecated interfaces

Removed: public void simulateMove(Animation a, line[] moveLines, WindowView view=null) {
Removed: public void simulateMove(Animation a, line moveLine, WindowView view=null) {
Removed: public void simulateMove(Animation a, point2D[] ps, WindowView view=null) {
Removed: public void simulateMove(Animation a, point2D p, WindowView view=null) {
Removed: public void simulateClick(Animation a, line[] clickLines, WindowView view=null) {
Removed: public void simulateClick(Animation a, line clickLine, WindowView view=null) {
Removed: public void simulateClick(Animation a, point2D[] clickPos, WindowView view=null) {
Removed: public void simulateClick(Animation a, point2D clickPos=point2D(), WindowView view=null) {

The reason for this is that the Animation argument is redundant, since there is only one active animation at any given moment. As replacement, use the corresponding simulateAnimationMove(..) or simulateAnimationClicks(..) function. They work in the same way, with the exception that they always target the active animation (animation()).

Move of AplicationManager

ApplicationManager has been moved to cm.application. If you get any build/compile errors,you can include the following in your package.cm : use cm.application;

Toolbox animation helpers

The following function has been removed, its replacement lives in cm.core.toolbox:

Old: public Animation getLazyToolboxAnimation(symbol snapperPkg, str snapperName, str c3CatalogId) : deprecated {
New: public Animation lazyGetToolboxAnimation(symbol animationPkg, str animationName, AnimationSpawner spawner=null, str c3CatalogId=null) {

Constructor changes to ViewModeBar

We have introduced a new argument bool insidePopupView with a default value of false.

Old: public constructor(Window parent) {
New: public constructor(Window parent, bool insidePopupView=false) {

Removal of contextualViewSettingsCategorizationItem.cm

This file and all content in it has been removed. It contained an experimental "auto categorization" system that has not been released and is now superseded by a similar system in cm/core/visibility/categorize/ that was released in 15.5 minor.

The following public interfaces were removed:

Removed: public void autoAddUserCategoriesFromToolbar(Object o) {
Removed: public class CategorizationToolbar extends ContextualViewToolbar {
Removed: public class CATContextualViewToolbarScrollWin extends ContextualViewToolbarScrollWin {
Removed: public class CategorizationToolbarModel extends ContextualViewToolbarModel {
Removed: public class CategoryRecordToolbarItem extends ToolbarModelItem {

class NavigationBehavior3D

To improve performance we have implemented a cache for picking in 3d. This means the cost of calling objectsAt multiple times on the same mouseline is greatly reduced. This means we can make the call to objectsAt when it is guaranteed that the result will be used instead of doing it once and passing the result along to where it perhaps will be used.

Old: extend public void move(View3D view, Object[] objectsAtPos) {
New: extend public void move(View3D view, WindowViewMouseInfo mi) {

In this case, the argument objectsAtPos was computed as follows:

Object[] objects = view.objectsAt(mi.pos, selectionOnTop=true, onlySelectable=true);
view.removeObjects(objects, [Class: ViewFocusPoint, DropArea]);

Consider if there are cases when you don't need objectsAt, e.g., during animations.

Removal of logging drawing and usage statistics

Removed interfaces related to the collection of usage and drawing statistics which is now deprecated.

Removed:
public void initCoreUsageLog()
public CoreUsageSampler coreUsageSampler()
public StatsUsageDB coreUsageSamplerDB()
public class CoreUsageSampler
public bool dbgTestStatisticsReporting=(bool v)

Mirror

The Snapper mirror functionality uses the space coordinates of the Snapper and the space coordinates of the mirroring plane to calculate the mirrored Snapper position and rotation. However, this was not implemented completely for Child Snappers.

Starting 16.0, Child Snappers will now mirror based on its local coordinates, and uses its parent's symmetry line as the reflecting plane instead. The new strategy ignores the need to have the parent snappers coordinate to be correct, also removing the hassle to translate coordinates to space and back to the child's local coordinates.

To ensure your child snappers work correctly with mirror, make sure the parent snappers have their mirrorPoint() and angleOfSymmetry() methods overriden to return the proper values. mirrorPoint() still return a value in space coordinates for child snappers. Please refer to this article for an explanation of what each method should return - Mirroring Snappers

We added a tool to aid in finding the correct value in Debug Graphics Toolbar : Mirror

If you have implemented fixes for mirroring child snappers in your extension previously, we recommend to remove any code that perform previously unhandled transformations for child snappers, and instead return corresponding values for mirrorPoint() and angleOfSymmetry() if the default values do not work for your case.

We also removed some code which do not have any use anymore in MirrorEnv:

Removed: public int->Point2D oldMirrorPoints();
Removed: public int->Angle oldAnglesOfSymmetry();

class SnapperSelection

Old: extend public void cleanUpSelectionIds(int{} ids) {
New: extend public void cleanUpSelectionIds(int{} ids, bool undoable=true) {

Removal of CoreBoundSaver

The following classes and functions have been removed as they have been superseeded by FrameWindow's ability to automatically save size and position. You can see more details under the Runtime / Behavior Changes for cm.win.

Removed: public BoundSaver coreBoundSaver() {
Removed: public class CoreSingleBoundSaver extends BoundSaver {
Removed: public class CoreMultiBoundSaver extends BoundSaver {

# CoreAppWindow
Removed: final public void saveWindowBound() {

The following functionality has been renamed and moved to cm.application

Old: public bool isPrimaryCoreAppWindow(CoreAppWindow this) {
New: public bool isPrimaryAppWindow(AppWindow appWindow) {

PreviewImageGridCell

As of 16.0, preview image support has been implemented for core Parts and is no longer exclusive to DsParts.

As a result, a new PreviewImageGridCell type has been made to replace the old DsPreviewImageGridCell type.

In cm/core/calc/previewImageGridCell.cm
Added: public class PreviewImageGridCell extends ImageGridCell : inherit constructors {}

In cm/abstract/dataSymbol/partColumns/prdPreviewColumn.cm
Removed: public class DsPreviewImageGridCell extends DsImageGridCell {}

class DwgDialog

Old: extend public void removeDwgSnapper(Snapper candidate, bool silent=false) {
New: extend public void removeDwgSnapperAndXrefs(Snapper candidate, bool silent=false) {

class DwgLayersCard

Changed to use a TreeView rather than creating subwindows. Many definitions have been changed or moved.

Fields:

Removed: private ScrollableSubWindow mainContainer;
Removed: public DwgLayer focusLayer;
Removed: public LayerBarSelectButton->DwgLayer barToLayer;

Old: public DwgLayer{} selectedLayers;
New: extend public DwgLayer{} selectedLayers() {

Methods:

Removed: final public void clearLayerButtonStates() {
Removed: final public DwgLayer getLayer(Window window) {
Removed: final public void scrollToLayer(DwgLayer layer) {
Removed: final public void selectedLayer(DwgLayer z, bool v) {

Old: final public void updateLayerStates(bool updateVisibility=true) {
New: final public void updateLayerStates() {
Old: final public void updateContent(bool clear=true) {
New: final public void updateContent() {
Old: final public void appendToSelection(DwgLayer z, bool pushdown=false) {
New: final public void appendToSelection(DwgLayer z) {
Old: final public void setLayerColor(DwgLayer z, color c, bool ignoreUserMaterial=false) {
New: final public void setLayerColor(DwgLayer layer, color c, bool ignoreUserMaterial) {

class GAdvImage

Old: public constructor(Url url, str originalFileName = null, LayerExpr layer=null, int previewSize=125) {
New: public constructor(Url url, str originalFileName = null, LayerExpr layer=null, int previewSize=125, bool filled=true) {
Old: public constructor(str key, LayerExpr layer=null, int previewSize=125) {
New: public constructor(str key, LayerExpr layer=null, int previewSize=125, bool filled=true) {

PartPreviewColumn

As of 16.0, preview image support has been implemented for core Parts and is no longer exclusive to DsParts.

As a result, the global constant dsPreviewColumn has been removed from cm.abstract.dataSymbol as well as the DsPreviewColumn itself. The core version of this column is in cm/core/calc/init/partPreviewColumn.cm. A renamer has also been added to direct loaded DsPreviewColumn types to the new PartPreviewColumn type. A new constant of the column (called partPreviewColumn) has been added and is registered in cm/core/init/corePartColumns.cm.

In cm/abstract/dataSymbol/partColumns/prdPreviewColumn.cm
Removed: public class DsPreviewColumn extends BasicPartColumn : inherit constructors {}
Removed: public class DsPreviewImageGridCell extends DsImageGridCell {}

In cm/core/init/partPreviewColumn.cm and cm/core/calc/previewImageGridCell.cm
Added: public class PartPreviewColumn extends BasicPartColumn : inherit constructors {}
Added: public class PreviewImageGridCell extends ImageGridCell : inherit constructors {}

LibraryLimb.cm
+ LibraryLimb Constructor now has an additional argument `SrcRef src`.

uiHint.cm
+ UIImageHint constructor now accepts an additional argument `bool prefer3D=false`
+ Field `Image image` is now `copy=reference`.

class LayoutGroupLimb

Added argument hideSendToButton to LayoutGroupLimb to hide send to component tab button.

Old: public constructor(LibraryLimb parent, symbol pkg, str key, bool frame=true,
		       function(Window window) layout=null, LibraryLimbVisibility vs=null)
New: public constructor(LibraryLimb parent, symbol pkg, str key, bool frame=true,
		       function(Window window) layout=null, LibraryLimbVisibility vs=null,
		       bool hideSendToButton=false)

New features to LibraryHeaderBuilder

BasicLibraryHeaderBuilder now supports passing in brandingImage.

Old: public constructor(Image icon, str title, str schemeKey=null) {
New: public constructor(Image icon, str title, Image brandingImage=null, str schemeKey=null) {

TabbedLibraryHeaderBuilder now supports passing in brandingImage

Old: public constructor(Image icon, str title, str schemeKey=null, function(Control, int) callback=null) {
New: public constructor(Image icon, str title, Image brandingImage=null, str schemeKey=null, function(Control, int) callback=null) {

Old: public constructor(Image icon,
                        str title,
                        bool useDropDownStyle=false,
                        str dropDownLabel=$tab # ':',
                        function(Control, int) callback=null) {
New: public constructor(Image icon,
                        str title,
                        Image brandingImage=null,
                        bool useDropDownStyle=false,
                        str dropDownLabel=$tab # ':',
                        function(Control, int) callback=null) {

New style of BoolCallbackLimb

There is a new argument bool toggleStyle. This argument determines if a checkbox for toggle is shown for BoolCallbackLimb.

Old: public constructor(LibraryLimb parent, symbol pkg, str key,
                        function(bool v) callback, bool initial=false,
                        LibraryLimbVisibility vs=null,
                        Image image=null,
                        str label=null,
                        UIHint hint=null,
                        SrcRef src=#:src) {
New: public constructor(LibraryLimb parent, symbol pkg, str key,
                        function(bool v) callback, bool initial=false,
                        LibraryLimbVisibility vs=null,
                        Image image=null,
                        str label=null,
                        UIHint hint=null,
                        bool toggleStyle=false,
                        SrcRef src=#:src) {

Removal of formatToolboxUI9

This deprecated function did nothing, calls to formatToolboxUI9 can be safely removed.

Removed: public void formatToolboxUI9(Library lib) : deprecated {}

class Part

Added method completeSpecifiedValue() for returning the value of what complete means.

New: extend public str completeSpecifiedValue()

Default return values were moved to constants in cm.core.part.cm.

New:    public const str completeSpecYes = "Y";
        public const str completeSpecNo = "N";

Added method completedSpec() for indicating whether there is a completed specification of this part.

New: extend public bool completedSpec()

completedSpec() needs to return true or false in order to get the default complete values 'Y' or 'N' in the Complete column in Calculations. completedSpec() will also drive the output for Status column and Error Description in Spec PMX export.

MR: Refactor completeSpecified

PartInfoTree

The following functions have been added to PartInfoTrees:

Added: extend public bool containsSpecial() {}
Added: extend public PartSpecial special() {}
Added: extend public str code() {}
Added: extend public str description() {}
Added: extend public double price() {}
Added: extend public str groupDescription() {}

Removal of psShortenLabel

Over the years, various efforts were made to unify the way texts were shortened. Calls to the deprecated psShortenLabel should be replaced with shortenText. Note the position of the first two arguments have swapped.

Old: public str psShortenLabel(Font font, str oriLabel, int allowedW) : deprecated {
New: public str shortenText(str text, Font font, int width) {

class REDView3D

The deprecated field perspective has been removed. You can use the method persective() instead.

Old: public bool perspective = true : deprecated;
New: extend public bool perspective() {

All of the redRenderSnapshot functions at the bottom of cm/core/red3D/redRenderSnapperEnv.cm have received an extra default parameter (bool retire=true). It serves as a flag to indicate whether or not to retire the REDThumbnailEnv after rendering.

spaceVolumeUpdate.cm

The dbg_enableQuickSpaceVolumeChange()-function has been removed since the "quick space volume change" system has been enabled and stable for many years now. The function always returned true.

Removed: public bool dbg_enableQuickSpaceVolumeChange() {

Cleanup to save world interface

We have streamlined the interfaces to save a world, moving bool template argument to be after Url target.

Old: public bool saveWorld(World world,
                           Url target=null,
                           userSaveAction action=userSaveAction.user,
                           int generation=3, // new in 3.2
                           bool progress=false,
                           bool searchKeywords=false,
                           function(int progress):bool interrupt=null) {
Old: public bool saveWorld(World world,
                           Url target=null,
                           userSaveAction action=userSaveAction.user,
                           int generation=3, // new in 3.2
                           bool progress=false,
                           bool searchKeywords=false,
                           function(int progress):bool interrupt=null,
                           bool template=false) {
New: public bool saveWorld(World world,
                           Url target=null,
                           bool template=false,
                           userSaveAction action=userSaveAction.user,
                           int generation=3, // new in 3.2
                           bool progress=false,
                           bool searchKeywords=false,
                           function(int progress):bool interrupt=null) {

The following deprecated function has been removed:

Removed: public bool saveCopyOfWorld(World world, Url target=null) : deprecated {

Cleanup to LazySnapper3DButton

The adjustPicturePos method has been tweaked to remove the argument sizeI textSize

Old: extend public void adjustPicturePos(sizeI textSize=(-1, -1)) {
New: extend public void adjustPicturePos() {

Changes to ToolGroupButton

The field current has its type changed to a more generic type.

Old: public LazyBasicSnapperButton current : deprecated;
New: public Control currentButton;

The functionality to addSubButton has been adjusted to accomodate generic button.

Old: extend public void addSubButton(LazyBasicSnapperButton button) : deprecated {
New: extend public void addButton(Control button) {

Constructor changes to ToolboxSectionedScrollableSubWindow

The arguments verticalBar, horizontalBar, handScrollX, handScrollY have been removed from the constructor.

Old: public constructor(Window parent,
                        bool verticalBar=true,
                        bool horizontalBar=false, // different from parent
                        // inherited key arguments.
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=thick3DFrame,
                        frame3DState frameState=frameStateDown,
                        pointI origin=(1, 1),
                        bool selectable=true,
                        pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        bool passive=false,
                        bool handScrollX=false, // different from parent
                        bool handScrollY=true,
                        bool slimScrollBars=false,
                        bool showStepButtons=false,
                        str scrollPosId=null,
                        SrcRef src=#:src) {
New: public constructor(Window parent,
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=thick3DFrame,
                        frame3DState frameState=frameStateDown,
                        pointI origin=(1, 1),
                        bool selectable=true,
                        pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        bool passive=false,
                        bool slimScrollBars=false,
                        bool showStepButtons=false,
                        str scrollPosId=null,
                        SrcRef src=#:src) {

class CategorizeDialogCard

Old: extend public void updateCheckedState(TreeViewItem item = null, bool disabled = false, Object[] picked = null) {
New: extend public void updateCheckedState() {

class CategorizeDialogCategoryCard

Removed: extend public void setParentCheckState(TriStateComboTreeViewItem item) {

Field methods

The following field methods in cm.downloader have been removed.

Removed:

public str sendBlockingMessage(str topic, str message, bool unicode, timespan ttl=500ms)

Changed Interfaces in cm.extension.ultraLazy

- Changed: public void ultraEndSnooze(ExtensionManager em, ExtensionState state) 
+ Added: public void ultraEndSnooze(ExtensionManager em, ExtensionState state, BasicProgressEnv env=null) {

Old: public bool cpp_rayMeshToleranceIntersect(pointF& rayOrigin, pointF& rayDirection, fix float[] verts, int vc, fix int[] triangles, int tc, TransformF transform, pointF& ip, int& triangle, angle tolerance, pointF& cameraLoc);
New: public bool cpp_rayMeshToleranceIntersect(pointF& rayOrigin, pointF& rayDirection, fix float[] verts, int vc, fix int[] triangles, int tc, TransformF transform, pointF& ip, int& triangle, angle tolerance);

Old: public bool rayMeshToleranceIntersect(pointF& rayOrigin, pointF& rayDirection, fix float[] verts, int vc, fix int[] triangles, int tc, TransformF transform, pointF& ip, int& triangle, angle tolerance, pointF& cameraLoc) {
New: public bool rayMeshToleranceIntersect(pointF& rayOrigin, pointF& rayDirection, fix float[] verts, int vc, fix int[] triangles, int tc, TransformF transform, pointF& ip, int& triangle, angle tolerance) {

class REDPicker3D

A new argument, o, has been added to the intersection function. o is the origin/owner of the red shape z and is required for caching purposes.

Old: final public REDPick intersection(REDShape z, lineF ln, REDShape[] path, pointF lineOriginInWC, bool xtrace=false, angle coneAngle=0deg, pointF cameraLoc=pointF(), REDPick[] intersections=null) {
New: final public REDPick intersection(Object o, REDShape z, lineF ln, REDShape[] path, pointF lineOriginInWC, bool xtrace=false, angle coneAngle=0deg, pointF cameraLoc=pointF(), REDPick[] intersections=null) {

Removal of logging drawing and usage statistics

Usage and drawing statistics are no longer logged and the following interfaces have been removed.

Removed:
public class JsonDrawingReport extends JsonStatisticsReport
public class JsonUsageReport extends JsonStatisticsReport
public class JsonUsageReporterSP extends JsonReporterSP
public class StatsUploader
public class StatsUsageDB
public class UsageSnapshot
public class UsageData
public void testUsageSaveAndLoad(UsageSnapshot snapshot)

class SpecialWallFeatureSearch

The "blocker" lines concept has been removed and the interfaces below have changed as a result. Note that while many methods had a "blockers" argument, it wasn't actually used for anything.

Removed: extend public line2D[] blockers(FeatureLineSearch fs, point fp, SimpleWallLine{} walls) {
Old: extend public void appendCandidates(SimpleWallLine wall, FeatureLineSearch fs, GraphPrimitive{} currentFT, GraphPrimitive{} otherFT, line2D[] blockers) {
New: extend public void appendCandidates(SimpleWallLine wall, FeatureLineSearch fs, GraphPrimitive{} currentFT, GraphPrimitive{} otherFT) {
Old: extend public void appendPickupPointCandidate(SimpleWallLine wall, SpecialWallFeaturePrimitive current, FeatureLineSearch fs, line2D[] blockers) {
New: extend public void appendPickupPointCandidate(SimpleWallLine wall, SpecialWallFeaturePrimitive current, FeatureLineSearch fs) {
Old: extend public void appendIntersectionCandidate(SimpleWallLine wall, SpecialWallFeaturePrimitive current, SpecialWallFeaturePrimitive other, FeatureLineSearch fs, line2D[] blockers) {
New: extend public void appendIntersectionCandidate(SimpleWallLine wall, SpecialWallFeaturePrimitive current, SpecialWallFeaturePrimitive other, FeatureLineSearch fs) {
Old: extend public void appendPerpendicularToOtherCandidate(SimpleWallLine wall, SpecialWallFeaturePrimitive current, SpecialWallFeaturePrimitive other, FeatureLineSearch fs, line2D[] blockers) {
New: extend public void appendPerpendicularToOtherCandidate(SimpleWallLine wall, SpecialWallFeaturePrimitive current, SpecialWallFeaturePrimitive other, FeatureLineSearch fs) {

class BasicTestCase

The volatile()-method has been removed. To get the same behavior, override the status()-method instead and return testCaseStatus.volatile.

Removed: extend public bool volatile() {

Replacement example:

Old: public bool volatile() { return true; }
New: public testCaseStatus status() { return testCaseStatus.volatile; }

Changed error types from simple strings to a newly introduced TestCaseError object. As a result, the following two interfaces have changed:

Old: extend public str[] validate(str->Object res) {
New: extend public TestCaseError[] validate(str->Object res) {
Old: extend public void handleErrors(str[] errors) {
New: extend public void handleErrors(TestCaseError[] errors) {

Error messages can still be appended using the appendError(..) or validate(..) help functions, the same way as before. But if you had previously manually added any error strings to the blackboard, those would have to be changed from str to BasicTestCaseError("error message"). And reading error messages through the new class is done with the message() function.

The constructors of all TestInstruction's have been changed to include the default argument SrcRef src=#:src. The reason for this is to improve the debugging of errors by enabling developers to jump directly to the test instruction that caused an error. Be sure to include this default argument in all classes extending TestInstruction and pass it along to super.

The following utility functions have been updated due to test case error messages being changed from simple strings to the new object TestCaseError. The error message is now instead contained in the new class.

Old: public str[] getErrors(str->Object blackboard) {
New: public TestCaseError[] getErrors(str->Object blackboard) {
Old: public void appendError(str->Object blackboard, str error) {
New: public void appendError(str->Object blackboard, str error, SrcRef src=#:src) {

class TestInstruction

Added a source reference to the constructor in order to know where in the code a TestInstruction instance is constructed. This is used when printing test errors and allows developers to jump directly to the source of the error. Be sure to include the default argument SrcRef src=#:src in the constructors of all TestInstruction-subclasses and pass it along to super.

Old: public constructor() {
New: public constructor(SrcRef src=#:src) {

Made the execute function abstract since it's required to be implemented by subclasses.

Old: extend public void execute(str->Object blackboard) { }
New: extend public void execute(str->Object blackboard) : abstract { }

class ValidateInstruction

The class has been made abstract as there is no reason to instantiate it by itself.

Old: public class ValidateInstruction extends TestInstruction {
New: public class ValidateInstruction extends TestInstruction : abstract {

class CopySnapperInstruction

This class has been removed. As replacement, use a combination of CopyInstruction, CutInstruction, PasteInstruction and PasteSelectionInstruction. These new instructions more closely mimic the default behaviour of the copy, cut and paste actions in CET.

Removed: class CopySnapperInstruction
Added: class CopyInstruction
Added: class CutInstruction
Added: class PasteInstruction
Added: class PasteSelectionInstruction

Since the default copy, cut and paste behaviour use the active selection and animations, you may also want to combine them with SelectSnapperInstruction and SimulateAnimationClickInstruction.

class InsertSnapperInstruction

All fields have been changed from public to private. The reason for this is that all of them can already be assigned via the constructors, and TestInstruction fields are in general not intended to be changeable afterwards.

Old: public Snapper snapper;
New: private Snapper snapper;
Old: public line mouseLine;
New: private line[] mouseLines;
Old: public str outputKey;
New: private str outputKey;
Old: public bool skipSnap;
New: private bool skipSnap;

InsertSnapperInstruction now supports simulating multiple clicks when inserting snappers, making it possible to insert things like lines that require both a start pos and end pos. To handle this, the line mouseLine field has been changed to a sequence, and the following constructors have been added:

Added: public constructor(Snapper snapper, line[] mouseLines, str outputKey=null, bool skipSnap=false)
Added: public constructor(SnapperSpawner spawner, line[] mouseLines, str outputKey=null, bool skipSnap=false)
Added: public constructor(Snapper snapper, point2D[] pos, str outputKey=null, bool skipSnap=false)
Added: public constructor(SnapperSpawner spawner, point2D[] pos, str outputKey=null, bool skipSnap=false)

class InsertSimpleWallLineInstruction

This class has been removed. Instead use the more general InsertSnapperInstruction.

Removed: class InsertSimpleWallLineInstruction

Example:

Old: InsertSimpleWallLineInstruction((0.0, 0.0, 0.0), (2.0, 0.0, 0.0), outputKey="wall");
New: InsertSnapperInstruction(SimpleWallLine(), [(0.0, 0.0), (2.0, 0.0)], outputKey="wall");

class InsertWallLineInstruction

This class has been removed. Instead use the more general InsertSnapperInstruction.

Removed: class InsertWallLineInstruction

Example:

Old: InsertWallLineInstruction((0.0, 0.0, 0.0), (2.0, 0.0, 0.0), outputKey="wall");
New: InsertSnapperInstruction(WallLine(), [(0.0, -0.1), (2.0, -0.1)], outputKey="wall", skipSnap=true);

To set the thickness and height of the wall, use the new PutQuickPropInstruction.

PutQuickPropInstruction("wall", "d", Distance(0.2.distance)); // Set thickness to 0.2
PutQuickPropInstruction("wall", "h", Distance(1.8.distance), ensureValidProps=true); // Set thickness to 1.8

Please note that the insert position may vary slightly because the InsertSnapperInstruction utilizes the standard insert animation, whereas InsertWallLineInstruction did not. Normally, you need to offset the position by the thickness of the wall to end up at the same position as before.

Since InsertWallLineInsruction did not use an insert animation, it also ignored snapping. To get the same behaviour, set the parameter skipSnap=true.

class SwitchToView2DInstruction

This class has been removed and should be replaced with the new SwitchToViewInstruction.

A 1 to 1 replacement would look like this: SwitchToView2DInstruction() -> SwitchToViewInstruction(viewOption.splitHorizontal, viewType.view2DType) But if the test doesn't require a split view, the following is sufficient SwitchToViewInstruction(viewOption.threeD)

class SwitchToView3DInstruction

This class has been removed and should be replaced with the new SwitchToViewInstruction.

A 1 to 1 replacement would look like this: SwitchToView3DInstruction() -> SwitchToViewInstruction(viewOption.splitHorizontal, viewType.view3DType) But if the test doesn't require a split view, the following is sufficient SwitchToViewInstruction(viewOption.twoD)

class ValidateFieldValueInstruction

This class has been removed. Instead, use GetFieldValueInstruction followed by ValidateValueInstruction.

Removed: class ValidateFieldValueInstruction
Added: class GetFieldValueInstruction

class FreezeSnappersInstruction

This class has been removed. Instead, use ToggleFreezeInstruction. ToggleFreezeInstruction freezes or unfreezes items in the active selection (same as using the ctrl+e shortcut). If you need to update the active selection, use SelectSnapperInstruction.

Removed: class FreezeSnappersInstruction
Added: class ToggleFreezeInstruction

class UnfreezeSnappersInstruction

This class has been removed. Instead, use ToggleFreezeInstruction. ToggleFreezeInstruction freezes or unfreezes items in the active selection (same as using the ctrl+e shortcut). If you need to update the active selection, use SelectSnapperInstruction.

Removed: class UnfreezeSnappersInstruction
Added: class ToggleFreezeInstruction

class ClickConnectorInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Combined the str snapperKey and str connectorKey into one. If the key refers to a connector, the connector will be clicked. If it refers to a snapper, all connectors on that snapper will be clicked.

Old: public constructor(str snapperKey) {
New: public constructor(str connectorKey, SrcRef src=#:src) {
Removed: public constructor(str snapperKey, str connectorKey, SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;

class CompareListsInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str listKey1;
New: private public str listKey1;
Old: public str listKey2;
New: private public str listKey2;
Old: public function(Object, Object):bool equalsFunction;
New: private public function(Object, Object):bool equalsFunction;
Old: public function(Object):str itemToLabelFunction;
New: private function(Object):str itemToLabelFunction;

class DragSnapperInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str : public str snapperKey;
New: private str : public str snapperKey;
Old: public line : public line mouseLine;
New: private line : public line mouseLine;
Old: public str->Object : public str->Object props
New: private str->Object : public str->Object props
Old: public bool : public bool skipSnap;
New: private bool : public bool skipSnap;

class GetChildSnappersInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public str outputKey
New: private str outputKey
Old: public SnapperFilter filter;
New: private SnapperFilter filter;
Old: public bool recursive;
New: private bool recursive;

class GetConnectorOfClassInstruction -> GetConnectorInstruction

The class has been renamed from GetConnectorOfClassInstruction to GetConnectorInstruction and a new constructor has been added.

Old: public constructor(str snapperKey, Class connectorClass, str outputKey) {
New: public constructor(str snapperKey, Class connectorClass, str outputKey, SrcRef src=#:src) {
Added: public constructor(str snapperKey, str connectorClassName, str outputKey, SrcRef src=#:src) {

class GetFieldValueInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str objectKey;
New: private str objectKey;
Old: public str fieldName;
New: private str fieldName;
Old: public str outputKey;
New: private str outputKey;

class GetPartsFromSpaceInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str outputKey;
New: private str outputKey;

class GetSelectionInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public bool onlyMain;
New: private bool onlyMain;
Old: public str outputKey;
New: private str outputKey;

class GetSpaceSnappersInRectInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public SnapperFilter filter;
New: private SnapperFilter filter;
Old: public str outputKey;
New: private str outputKey;
Old: public rect r;
New: private rect r;

class GetSpaceSnappersInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public SnapperFilter filter;
New: private SnapperFilter filter;
Old: public str outputKey;
New: private str outputKey;

class IndexListItemsInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str listKey;
New: private str listKey;
Old: public str outputKey;
New: private str outputKey;

class LoadDataInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public Url url;
New: private Url url;
Old: public str outputKey;
New: private str outputKey;

class PutAnimationPropInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str propKey;
New: private str propKey;
Old: public Object value;
New: private Object value;

class PutPropInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public str propKey;
New: private str propKey;
Old: public Object value;
New: private Object value;

class RemoveSnapperInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;

class RotateSnapperInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public angle rotAngle;
New: private angle rotAngle;

class SaveDataInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public Url url;
New: private Url url;
Old: public str dataKey;
New: private str dataKey;

class SelectSnapperInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;

class SortListInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str listKey;
New: private str listKey;
Old: public function(Snapper, Snapper, Object):int sortFunction;
New: private function(Snapper, Snapper, Object):int sortFunction;
Old: public Object sortEnv;
New: private Object sortEnv;

class ValidateAnyOfSeveralPropValuesInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public str propKey;
New: private str propKey;
Old: public Object{} expectedValues;
New: private Object{} expectedValues;

class ValidateBoundInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public Vector expectedSize;
New: private Vector expectedSize;

class ValidateConnectedToInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str fromSnapperKey;
New: private str fromSnapperKey;
Old: public str toSnapperKey;
New: private str toSnapperKey;

class ValidateIsActiveInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;

class ValidateIsAliveInstruction

Added a "expectedValue" argument.

Old: public constructor(str snapperKey) {
New: public constructor(str snapperKey, bool expectedValue=true, SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;

class ValidateConnectionCountInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public Int expectedConnections;
New: private Int expectedConnections;
Old: public SnapperFilter filter;
New: private SnapperFilter filter;

class ValidateListCountInstruction

This class has been changed to support lists other than sequences and sets of snappers.

Note that due compiler-technical reasons, not all lists are supported. It currently supports Snappers and TreeViewItems. If you need this expanded, please contact Configura Support.

Old: public str snapperKey;
New: private str key;
Old: public Int expectedListCount;
New: private Int expectedListCount;
Old: public constructor(str snapperKey, Int expectedListCount) {
New: public constructor(str key, Int expectedListCount, SrcRef src=#:src) {

class ValidateLocalBoundInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public Vector expectedSize;
New: private Vector expectedSize;

class ValidateChildCountInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public Int expectedChildCount;
New: private Int expectedChildCount;
Old: public SnapperFilter filter;
New: private SnapperFilter filter;
Old: public bool recursive;
New: private bool recursive;

class ValidateIsSuspendedInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;

class ValidatePartQuantityInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str articleCode;
New: private str articleCode;
Old: public double expectedQuantity;
New: private double expectedQuantity;

class ValidatePropDoesNotExistInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public str propKey;
New: private str propKey;

class ValidatePartSpecOptionInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str articleCode;
New: private str articleCode;
Old: public str expectedCode;
New: private str expectedCode;
Old: public Str expectedDescription;
New: private Str expectedDescription;
Old: public Int expectedSequence;
New: private Int expectedSequence;
Old: public Int expectedLevel;
New: private Int expectedLevel;
Old: public Str expectedGroupDescription;
New: private Str expectedGroupDescription;
Old: public <str, str> expectedUserDefined;
New: private <str, str> expectedUserDefined;
Old: public Bool expectedExportable;
New: private Bool expectedExportable;

class ValidateTreeViewItemKeyInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str expectedKey;
New: private str expectedKey;
Old: public str treeViewItemKey;
New: private str treeViewItemKey;

class ValidateTreeViewItemIsCheckedInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public Object expected;
New: private Object expected;
Old: public str itemKey;
New: private str itemKey;

class ValidateOrientationInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public Orientation expectedRot;
New: private Orientation expectedRot;

class ValidatePropValueInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public str propKey;
New: private str propKey;
Old: public Object expectedValue;
New: private Object expectedValue;

class ValidateRotationInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public orientation expectedRot;
New: private orientation expectedRot;

class ValidateSnapperGMaterialInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public GMaterial3D expectedMaterial;
New: private GMaterial3D expectedMaterial;

class ValidatePositionInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str snapperKey;
New: private str snapperKey;
Old: public Point expectedPos;
New: private Point expectedPos;

class ValidateTreeViewItemIsEnabledInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public bool expectedEnabled;
New: private bool expectedEnabled;
Old: public str itemKey;
New: private str itemKey;

class ValidateAnimationPropValueInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

Changed fields to private as they are not intended to be assigned outside of the constructor.

Old: public str propKey;
New: private str propKey;
Old: public Object expectedValue;
New: private Object expectedValue;

cm/win/winPainter.cm
- Old: extend public sorted str->str getPainterData() 
+ New: extend public str->Object inspectorData() 

cm/win/window.cm
- Old: extend public sorted str->str getPainterData()
+ New: extend public str->Object inspectorData()

Change of setImage method in Control

We have revised argument update to resize while adding a new argument refresh to control repaints. This is a far reaching change, affecting over 88 files in the base repo.

Old: extend public void setImage(Image image, bool update=true) {
New: extend public void setImage(Image image, bool resize, bool refresh) {

Changes to DoubleScrollBar affecting TreeView

We have introduced a new argument bool transparentBG defaulting to false. This argument allows us to draw scrollbars in an experiemntal way that is transparent.

Old: public constructor(Window parent, bool showStepButtons=false, bool slim=false) {
New: public constructor(Window parent, bool showStepButtons=false, bool slim=false, bool transparentBG=false) {

This is also exposed in TreeView's createDoubleScrollBar method:

Old: extend public DoubleScrollBar createDoubleScrollBar() {
New: extend public DoubleScrollBar createDoubleScrollBar(bool transparentBG=false) {

TreeView's constructor also exposes this functionality with the bool transparentScrollBars argument.

Old: public constructor(Window parent,
                        // inherited key arguments
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=stdLightFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(100, 100),
                        pointI margins=(2, 2),
                        alignment align=middle,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        // extended key arguments
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=false,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        function (Control control) click2Callback=null,
                        bool noScrollBars=false,
                        str key=null,
                        SrcRef src=#:src) {
New: public constructor(Window parent,
                        // inherited key arguments
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=stdLightFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(100, 100),
                        pointI margins=(2, 2),
                        alignment align=middle,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        // extended key arguments
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=false,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        function (Control control) click2Callback=null,
                        bool transparentScrollBars=false,
                        bool noScrollBars=false,
                        str key=null,
                        SrcRef src=#:src) {

Visbility of fields in ViewItemColorButton

Privatized a member and added setters/getters.

Old: public color _color;
New: private color _color;
New: extend public color color() {
New: extend public void setColor(color c) {

Removal of LegacyFrame and related functions

As an ongoing effort of modernizing cm.win, we have removed a few more key classes in this release.

The following methods have been removed from Window:

Removed: final public void setFrameOLD(frame3DStyle oldStyle, frame3DState state) : deprecated { // OLD
Removed: final public void setFrameStyleOLD(frame3DStyle oldStyle) : deprecated {

Old: extend public void eraseFrame() {
New: extend public void refreshFrame() {

The field frame3DStyle oldStyle and related methods have been removed from WinFrame:

Removed: public frame3DStyle oldStyle;

Removed: final public void setOldStyle(frame3DStyle fstyle) {
Removed: final public void drawFrameOLD(PixelDevice d, rectI r) {
Removed: final public void invalidateFrame(Window parent, bool rightDownOnly=true) {
Removed: final public void invalidateFrame(Window parent, sizeI r, bool rightDownOnly=true) {
Removed: final public void drawFramePoly(PixelDevice d, PolylineI poly, color c) {

Old: public constructor(frame3DStyle oldStyle, frame3DState state) {
New: public constructor(FrameStyle style, frame3DState state) {

With these changes, LegacyFrame has no more purpose and has been removed.

Removed: public class LegacyFrame extends FrameStyle {

Constructor changes to StateControlGroup

Argument bool allowReselect with a default value of false has added to the constructor.

Old: public constructor(function(Control c) callback=null,
                        // extends arguments
                        bool exclusiveChoice=true,
                        bool noSelectionPossible=false) {
New: public constructor(function(Control c) callback=null,
                        // extends arguments
                        bool exclusiveChoice=true,
                        bool noSelectionPossible=false,
                        bool allowReselect=false) {

Constructor changes to LinkButton

Argument bool showUnderline with a default value of false has been added to control the underline state.

Old: public constructor(Window parent,
                        Font font=underlineSystemFont,
                        Brush brush=null,
                        FrameStyle frameStyle=noFrame,
                        str label="",
                        color labelColor=color(0, 0, 240),
                        alignment textSide=undefinedAlignment,
                        Image image=null,
                        Image disabledImage=null,
                        color color=nocolor,
                        sizeI size=(-1, -1),
                        pointI margins=(0, 0),
                        alignment align=middle,
                        str link=null,
                        function(Control button) callback=null,
                        SrcRef src=#:src) {
New: public constructor(Window parent,
                        Font font=underlineSystemFont,
                        Brush brush=null,
                        FrameStyle frameStyle=noFrame,
                        str label="",
                        color labelColor=color(0, 0, 240),
                        alignment textSide=undefinedAlignment,
                        Image image=null,
                        Image disabledImage=null,
                        color color=nocolor,
                        sizeI size=(-1, -1),
                        pointI margins=(0, 0),
                        alignment align=middle,
                        str link=null,
                        bool showUnderline=false,
                        function(Control button) callback=null,
                        SrcRef src=#:src) {

Changes to ScrollableSubWindow

We have added arguments str key, bool faceliftScrollBars, bool transparentScrollBars to ScrollableSubWindow's constructor. This allows the caller to specify some additional scroll bar parameters.

Old: public constructor(Window parent,
                        bool verticalBar=true,
                        bool horizontalBar=true,
                        // inherited key arguments.
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=thick3DFrame,
                        frame3DState frameState=frameStateDown,
                        pointI origin=(1, 1),
                        bool selectable=true,
                        pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        bool passive=false,
                        bool handScrollX=true,
                        bool handScrollY=true,
                        bool slimScrollBars=false,
                        bool showStepButtons=false,
                        str scrollPosId=null,
                        SrcRef src=#:src) {
New: public constructor(Window parent,
                        bool verticalBar=true,
                        bool horizontalBar=true,
                        // inherited key arguments.
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=thick3DFrame,
                        frame3DState frameState=frameStateDown,
                        pointI origin=(1, 1),
                        bool selectable=true,
                        pointI pos=(0, 0),
                        sizeI size=(0, 0),
                        bool passive=false,
                        str key=null,
                        // extended key arguments.
                        bool handScrollX=true,
                        bool handScrollY=true,
                        bool slimScrollBars=false,
                        bool faceliftScrollBars=false,
                        bool transparentScrollBars=false,
                        bool showStepButtons=false,
                        str scrollPosId=null,
                        SrcRef src=#:src) {

The init scroll methods have also been revised, taking in two additional arguments bool faceliftScrollBars, bool transparentScrollBars, both defaulting to false.

Old: extend public ScrollBar initVScroll(sizeI sz, bool showStepButtons) {
New: extend public ScrollBar initVScroll(sizeI sz,
                                         bool showStepButtons,
                                         bool faceliftScrollBars=false,
                                         bool transparentScrollBars=false) {

Old: extend public ScrollBar initHScroll(sizeI sz, bool showStepButtons) {
New: extend public ScrollBar initHScroll(sizeI sz,
                                         bool showStepButtons,
                                         bool faceliftScrollBars=false,
                                         bool transparentScrollBars=false) {

Removal of ScrollableSubWindowWithKey

Due to the addition of str key argument into ScrollableSubWindow, there is no purpose for ScrollableSubWindowWithKey and it has been removed

Removed: public class ScrollableSubWindowWithKey extends ScrollableSubWindow {

Removal of truncateWithEllipsis

Over the years, various efforts were made to unify the way texts were shortened. Calls to the deprecated truncateWithEllipsis should be replaced with shortenText.

Old: public str truncateWithEllipsis(str text, Font font, int width) : deprecated {
New: public str shortenText(str text, Font font, int width) {

Small changes to winApi

A new argument bool windows11 has been added.

Old: public void configureCustomCaptionWindow(mwnd m, lparam lParam) = win_configureCustomCaptionWindow;
New: public void configureCustomCaptionWindow(mwnd m,
                                              lparam lParam,
                                              bool windows11) = win_configureCustomCaptionWindow;

Cleanup of ModalDialog

The following unused fields and methods are removed from ModalDialog

Removed: public Window{} previouslyDisabled;
Removed: final public void enablePreviouslyDisabled() {

Move of DebugDialog

This dialog is used by cm.core.debug, so it has been moved to that package.

Removal of PreITreeView

This class was previously used by Window Inspector to perform double buffered repainting pre 15.0. As of 15.0, TreeView has its own method of double buffered, so this class has been redundant and removed.

Removed: public class PreITreeView extends TreeView {

Correct passing of callerLoc into FrameWindow

We have added an argument str loc defaulting to callerLoc() to contructors of FrameWindow subclasses. This makes it easier to figure out which the call site of a constructed FrameWindow. Useful to identify the call site of a ModalDialog / message boxes.

# AppWindow
Old: public constructor(str label="Configura Virtual Machine",
                        // inherited key arguments
                        Font font=systemFont,
                        Brush brush=null,
                        pointI origin=(0, 0),
                        pointI pos=(0, 0),
                        sizeI size=(300, 200),
                        bool initVisible=true,
                        bool noMinimize=false,
                        bool noMaximize=false,
                        // extended key arguments
                        str name=null,
                        Window appWinAsDialogParent=null) {
New: public constructor(str label="Configura Virtual Machine",
                        // inherited key arguments
                        Font font=systemFont,
                        Brush brush=null,
                        pointI origin=(0, 0),
                        pointI pos=(0, 0),
                        sizeI size=(300, 200),
                        bool initVisible=true,
                        bool noMinimize=false,
                        bool noMaximize=false,
                        // extended key arguments
                        str name=null,
                        Window appWinAsDialogParent=null,
                        str loc=callerLoc()) {
Old: public constructor(TitleBarConfig tbConfig,
                        str label="Configura Virtual Machine",
                        // inherited key arguments
                        Font font=systemFont,
                        Brush brush=null,
                        pointI origin=(0, 0),
                        pointI pos=(0, 0),
                        sizeI size=(300, 200),
                        bool initVisible=true,
                        // extended key arguments
                        str name=null,
                        Window appWinAsDialogParent=null) {
New: public constructor(TitleBarConfig tbConfig,
                        str label="Configura Virtual Machine",
                        // inherited key arguments
                        Font font=systemFont,
                        Brush brush=null,
                        pointI origin=(0, 0),
                        pointI pos=(0, 0),
                        sizeI size=(300, 200),
                        bool initVisible=true,
                        // extended key arguments
                        str name=null,
                        Window appWinAsDialogParent=null,
                        str loc=callerLoc()) {
Old: package constructor(bool noBorder,
                         bool noCaptionStyle,
                         bool shadow=false,
                         // Same as above
                         str label="CustomCaption",
                         Font font=systemFont,
                         Brush brush=null,
                         pointI origin=(0, 0),
                         pointI pos=(0, 0),
                         sizeI size=(300, 200),
                         bool initVisible=true,
                         bool noMinimize=false,
                         bool noMaximize=false,
                         str name=null) {
New: package constructor(bool noBorder,
                         bool noCaptionStyle,
                         bool shadow=false,
                         // Same as above
                         str label="CustomCaption",
                         Font font=systemFont,
                         Brush brush=null,
                         pointI origin=(0, 0),
                         pointI pos=(0, 0),
                         sizeI size=(300, 200),
                         bool initVisible=true,
                         bool noMinimize=false,
                         bool noMaximize=false,
                         str name=null,
                         str loc=callerLoc()) {

# FormattedTextMessageBox
Old: public constructor(Window parent, str header, FormattedText content,
                        Font font=systemFont(),
                        Brush brush=null,
                        pointI origin=(0, 0),
                        bool selectable=true,
                        str label="Message",
                        pointI pos=(-1, -1),
                        sizeI size=(280, 80),
                        bool framed=false,
                        bool initVisible=true,
                        bool readOnly=true) {
New: public constructor(Window parent, str header, FormattedText content,
                        Font font=systemFont(),
                        Brush brush=null,
                        pointI origin=(0, 0),
                        bool selectable=true,
                        str label="Message",
                        pointI pos=(-1, -1),
                        sizeI size=(280, 80),
                        bool framed=false,
                        bool initVisible=true,
                        bool readOnly=true,
                        str loc=callerLoc()) {

Old: public void makeFormattedTextMessageBox(Window parent, str message,
                                             FormattedText content, bool framed=false, bool readOnly=true) {
New: public void makeFormattedTextMessageBox(Window parent, str message,
                                             FormattedText content, bool framed=false, bool readOnly=true,
                                             str loc=callerLoc()) {

Old: public void makeFormattedTextMessageBox(Window parent, str label, str message,
                                             FormattedText content, bool framed=false, bool readOnly=true) {
New: public void makeFormattedTextMessageBox(Window parent, str label, str message,
                                             FormattedText content, bool framed=false, bool readOnly=true,
                                             str loc=callerLoc()) {

# OneButtonBox
Old: public constructor(Window parent, str message,
                        Font font=systemFont(),
                        Brush brush=null,
                        pointI origin=(0, 0),
                        bool selectable=true,
                        str label=$messageDialogCaption,
                        pointI pos=(-1, -1),
                        sizeI size=(280, 80),
                        bool initVisible=true) {
New: public constructor(Window parent, str message,
                        Font font=systemFont(),
                        Brush brush=null,
                        pointI origin=(0, 0),
                        bool selectable=true,
                        str label=$messageDialogCaption,
                        pointI pos=(-1, -1),
                        sizeI size=(280, 80),
                        bool initVisible=true,
                        str loc=callerLoc()) {

Changes to AxTreeView

A few changes have been made to the constructor.

• Argument bool transparentScrollBars defaulting to false has been added
• Argument SrcRef src defaulting to #:src has been moved to be the last argument.

Old: public constructor(Window parent,
                        // inherited key arguments
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=stdLightFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(100, 100),
                        pointI margins=(2, 2),
                        alignment align=middle,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=false,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        function (Control control) click2Callback=null,
                        bool noScrollBars=false,
                        str key=null,
                        SrcRef src=#:src|,
                        // extended key arguments
                        function(TreeViewItem, int):Brush itemBackgroundCB=null) {
New: public constructor(Window parent,
                        // inherited key arguments
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=stdLightFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(100, 100),
                        pointI margins=(2, 2),
                        alignment align=middle,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=false,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        function (Control control) click2Callback=null,
                        bool transparentScrollBars=false,
                        bool noScrollBars=false,
                        str key=null|,
                        // extended key arguments
                        function(TreeViewItem, int):Brush itemBackgroundCB=null,
                        SrcRef src=#:src) {

Changes to AxColumnsTreeView

Similar to AxTreeView, a few changes have been made to the constructor.

• Argument bool transparentScrollBars defaulting to false has been added
• Argument SrcRef src defaulting to #:src has been moved to be the last argument.

Old: public constructor(Window parent,
                        // inherited key arguments
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=stdLightFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(100, 100),
                        pointI margins=(2, 2),
                        alignment align=middle,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=false,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        function (Control control) click2Callback=null,
                        bool noScrollBars=false,
                        str key=null,
                        SrcRef src=#:src,
                        function(TreeViewItem, int):Brush itemBackgroundCB=null|,
                        // extended key arguments
                        AxColumnsTVIColumnInfos infos=null,
                        AxColumnsTVIColumnHeaders headers=null) {
New: public constructor(Window parent,
                        // inherited key arguments
                        Font font=systemFont(),
                        Brush brush=null,
                        FrameStyle frameStyle=stdLightFrame,
                        frame3DState frameState=frameStateDown,
                        pointI pos=(0, 0),
                        sizeI size=(100, 100),
                        pointI margins=(2, 2),
                        alignment align=middle,
                        bool popup=false,
                        bool shadow=false,
                        function (Control control) callback=null,
                        bool alwaysMultiSelect=false,
                        bool allowMultiSelect=false,
                        bool directSelect=false,
                        bool listBoxStyle=false,
                        treeViewSelectionStyle selectionStyle=treeViewSelectionStyle.undefined,
                        function (Control control) click2Callback=null,
                        bool transparentScrollBars=false,
                        bool noScrollBars=false,
                        str key=null,
                        function(TreeViewItem, int):Brush itemBackgroundCB=null|,
                        // extended key arguments
                        AxColumnsTVIColumnInfos infos=null,
                        AxColumnsTVIColumnHeaders headers=null,
                        SrcRef src=#:src) {

Inheritance of DcAssignExtRefKeysDialog from DcBulkAssignDialog

Changed the inheritance of DcAssignExtRefKeysDialog in custom.dataCatalog.builder.geometry from ModalDialog to DcBulkAssignDialog.

Old: public class DcAssignExtRefKeysDialog extends ModalDialog
New: public class DcAssignExtRefKeysDialog extends DcBulkAssignDialog

The following interfaces have been affected.

class DcAssignExtRefKeysDialog

The following interfaces in DcAssignExtRefKeysDialog have been changed. Removed fields:

public CatalogTreeView targetPrdTV
public DsDropDownTreeView prdFilterDD
public DsDropDownTreeView levelDD
public DsButtonDropDownTreeView visibilityDD
public DsFormattedTextField prdFilterField
public DsButton expandAllBtn
public DsButton hideAllBtn
public DsButton closeBtn
public DsGridLayoutHelper layoutHelper

Removed methods:

public bool autoSavePos()
public bool autoSaveSize()
extend public DcDBBuilderGeometryCard card()
extend public DataCatalog catalog()
extend public void build()
extend public Window buildVisibilitySection(FrameStyle frameStyle=dsRoundedFrame)
extend public void buildTargetProductsSource(FrameStyle frameStyle=dsRoundedFrame)
extend public void arrangeVisibilitySection()
public void setSize(sizeI s)
public sizeI maximalSize()
public sizeI minimalSize()
public void resizeEnd()
extend public void populateLevelDD()
extend public void populateVisibilityDD()
extend public bool modeFeatures()
extend public void populateTargetPrds(bool doFilter=false)
extend public void updateVisibility()
extend public void updateTargetPrdTV(bool doFilter=true)
extend public dcCatalogElementType catalogElementType()
extend public void updatePrdFilter()
extend public void prdFilterChanged()
extend public void update(DcDBBuilderUpdateEnv env)
extend public void populateFilterDD(DsDropDownTreeView filterDD)
extend public filterType[] validFilterTypes()
extend public TreeViewItem[] gatherCheckedPrds(TreeViewItem t, Class{} xClass=null)
public bool keyCode(Window originator, KeyCode keyCode)
extend public void beginOperation(str pdLabel, int taskCount)
extend public void incrementTasks(int count=1)
extend public bool abortOperation()
extend public void endOperation()
final public Class{} acceptedCatalogTvi()
public void beforeRemove()
public void close()
public void loadSize(sizeI default)
public void loadPos(pointI default)
extend public void saveSize(sizeI s)
extend public void savePos(pointI p)

Changed methods:

Old: extend public CatalogTreeViewEnv getCatalogTVEnv()
New: public CatalogTreeViewEnv getCatalogTVEnv()

Old: extend public void handleEvent(str key, str msg=null, Object value=null)
New: public void handleEvent(str key, str msg=null, Object value=null)

class DcAssignExtRefKeysDialog

Removed the class DcAssignExtRefKeysDialog in custom.dataCatalog.builder.geometry.

Removed:

public class DcAssignEtkCatalogTreeView extends CatalogTreeView

class DcCatalogItemFilterEnv

Interface changes in the class DcCatalogItemFilterEnv in custom.dataCatalog.builder.geometry.

Removed:

extend public bool visitChild(Object obj)
extend public bool acceptChildAny(Object obj, bool useCached=true, str{} visited=null)

class DcCatalogItemAndExternalRefKeyFilterEnv

Interface changes in the class DcCatalogItemAndExternalRefKeyFilterEnv in custom.dataCatalog.builder.geometry.

Changed methods:

Old: public bool visitChild(Object obj)
New: extend public bool visitChild(Object obj)

class DcCatalogItemAndMeasurementFilterEnv

Interface changes in the class DcCatalogItemAndMeasurementFilterEnv in custom.dataCatalog.builder.geometry.

Removed:

public bool visitChild(Object obj)

Changed methods:

Old: public bool acceptChildAny(Object obj, bool useCached=true, str{} visited=null)
New: public bool acceptNode(Object obj, bool useCached=true, str{} visited=null)

class DcCopyConnectorsDialog

Interface changes in the class DcCopyConnectorsDialog in custom.dataCatalog.builder.geometry.

Removed:

extend public bool accepts(filterType fType, str filterStr, str target)

class DcMeasuresTreeViewModule

Interface changes in the class DcMeasuresTreeViewModule in custom.dataCatalog.builder.geometry.

Removed:

extend public <str{}, str{}, str{}, str{}, str{}> gatherAllProductMeasures(DsProductType product=null,
									    <str{}, str{}, str{}, str{}, str{}> measures=null,
									       str{} visitedFeatures=null)

Field methods

The following field methods in custom.dataCatalog.builder.geometry have been removed.

Removed:

public void dcUpdateAssignExtRefKeysDialog(DcDBBuilderUpdateEnv env)

Removed functions

The following functions related to storing window position have been removed. They have been superseeded by FrameWindow automatic saving of size and position.

Removed: public bool dcCheckSingleScreen(PointI p, Window parent) {
Removed: public str dcGetDialogPosKey(Class class) {

class K2InsertWallLineInstruction

This class has been removed. Instead use InsertSnapperInstruction.

Removed: class K2InsertWallLineInstruction

class K2InsertWallBumpInstruction

This class has been changed from public to package. Instead use InsertSnapperInstruction.

Old: public class K2InsertWallBumpInstruction extends TestInstruction : deprecated {
New: package class K2InsertWallBumpInstruction extends TestInstruction : deprecated {

class K2InsertWallWindowInstruction

This class has been changed from public to package. Instead use InsertSnapperInstruction.

Old: public class K2InsertWallWindowInstruction  extends TestInstruction {
New: package class K2InsertWallWindowInstruction  extends TestInstruction {

class K2ValidateShapeFaceCountInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

class K2ValidateShapeFacesLengthInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

class K2ValidateShapeMeasureValueInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

class K2ValidateWorktopCandidateFaceCountInstruction

Added a default SrcRef argument to all constructors.

Old: public constructor(..) {
New: public constructor(.., SrcRef src=#:src) {

class DataCatalog

Maps are now sorted on export to sql and xml to ensure that ordering is consistent for tracking in version control.

DsPart

The following functions on DsPart account for PartSpecial information now.

// adds specialFlattenableKey() to tail of key
public str flattenableKey() {}

// returns PartSpecial price if found
public double basePrice() {

As of 16.0, preview image support has been implemented for core Parts and is no longer exclusive to DsParts.

As a result, the following changes have been made to DsPart:

• global constant dsPreviewColumn has been removed from DsParts overridePartColumns() function
• previewImageUrl() function overrides the core Part version and now has an added default parameter
• overridden interface added

Old: public PartColumn[] overridePartColumns() {
		return [PartColumn: dsPrdCatalogColumn, dsPreviewColumn, dsTagPartColumn ];
	 }
New: public PartColumn[] overridePartColumns() {
		return [PartColumn: dsPrdCatalogColumn, dsTagPartColumn ];
	 }


Old: extend public Url previewImageUrl() {}
New: public Url previewImageUrl(bool generateIfNotFound=false) {}


Added: public Image previewImage(sizeI size=cPartPreviewImageSize, bool generateIfNotFound=false, bool regenerate=false) {}
Added: public bool allowRenderPreviewImage() {}

DsPData

DsPData has undergone a change in it's public double price(SpecOption[] specOs=null) function. The function now returns a base price that does not include SpecOption prices. As of 16.0, upcharge() has been implemented in cm/abstract/part/part.cm and SpecOptions contain a price value. customListPrice now returns the base price plus the upcharge value.

The public void queryDialog(Snapper snppr) {} function has also been changed with the new QueryDialog implementation. It no longer opens the old DsQueryDialog implementation but utilizes the new QueryDialog.

The following has been changed in DsPData:

// price function
Old: extend public double price(SpecOption[] specOs=null) {
		double price;
		price = basePrice();
		if (!specOs) specOs = specOptions().:SpecOption[];
		for (DsSpecOption specOpt in specOs) price += specOpt.price;
		return price;
	 }	

New: extend public double price(SpecOption[] specOs=null) {
		return basePrice();
     }
	 
	 
	 
// queryDialog function
extend public void queryDialog(Snapper snppr) {
	if (proxy) {
		...
	}
	
	Old: DsQueryDialog(anyFrameWindow, snppr);
	New: dsOpenQueryDialog(snppr);
} 

class DsPData

The code of DsSpecOption is now constructed based on the option code instead of the option valueS to fix a bug where the dropdown selection of options in sub-features of numeric order features is not populated in the calculation dialog.

class DsPart

Added optional parameter to the constructor for partSourceId. Added new constructor for convenience.

Old:    public constructor(Snapper snapper, DsPData data, double price, double qty=1)

New:    public constructor(Snapper snapper, DsPData data, double price, double qty=1, str partSourceId=null)

New:    public constructor(Snapper snapper, DsPData data, str articleCode, str description, double listPrice,
               double quantity=1, double inPrice=0,
               bool flattenable=true, bool group=false, partStyle style=psNone,
               str flattenableKey=null, bool allowOtherParent=true, str partSourceId=null)

Removed:     private str _itemTagInfoKey;

_itemTagInfoKey has been moved to ProdPart in cm.abstract.part .

Preserve Ind. Tag customizations

User modifications to Ind. Tag are part of the flattenable key now when the user turns that setting on.

ItemTagInfo

Methods for managing Ind. Tags were moved to ProdPart .

class DsSpecOption

Remove field price

Removed: public double price;

class DsRextileLengthPartColumn is renamed to DsMaterialQtyPartColumn

MR: Rename Textile Length column to Material Quantity

Previous:    public class DsTextileLengthPartColumn extends BasicPartInfoTreeColumn


New:    public class DsMaterialQtyPartColumn extends BasicPartInfoTreeColumn

DataSymbol

With the new QueryDialog, interface has been added to DataSymbol to opt-in to utilize the new dialog. DataSymbols are defaulted to utilize the new QueryDialog. Any subclasses of DataSymbol must opt-out if the new dialog is not to be utilized.