This is maybe the last release of the 1.x branch. New important and api breaking work is in progress and will be labeled as fabric 2.x
The change i like most comes from a casual contributor,
by12 and fixes path bounding box calculation. No more trimmed paths!
A change in translation on the cache canvas fixed blurriness introduced since 1.7.3, that is also worth an update.
For iText, Textbox typers, the style object does not get polluted with useless empty objects now.
And last but not the least, we have a new flag called
fabric.StaticCanvas.prototype.skipOffscreen default to
that will calculate with objects aCoords if the object is on the screen or outside the screen and will skip the rendering part completely.
This is an optional feature but it turns out to be very usefull when you are dealing with large number of objects and you are using zoom or panning much.
While object.oCoords needs to be updated every zoom/pan, aCoords are static with object position and are still valid when we change the viewport. This allows us to detect if they are offscreen simply calculating the viewportCoords at the expense of 2 transformed points calculation. A demo page will follow soon.
Fix: Fix dirty flag propagation #3782 Fix: Path parsing error in bounding boxes of curves #3774 Add: Middle click mouse management on canvas #3764 Add: Add parameter to detect and skip offscreen drawing #3758 Fix: textarea loosing focus after a drag and exit from canvas #3759 Fix for opacity parsing in svg with nested opacities #3747 Fix text initialization and boundingrect #3745 Fix line bounding box #3742 Improvement: do not pollute style object while typing if not necessary #3743 fix for broken prototype chain when restoring a dataless object on fill an stroke #3735 fix for deselected event not fired on mouse actions #3716 fix for blurriness introduced on 1.7.3 #3721
New functionalities about coordinates:
Now setCoords updates both the corner coords for mouse interaction and a new set called aCoords that is a set of absolute coordinates that a dev can use for its own calculation on positions.
Introduced a set of coordinates on canvas that let you figure out where the current viewport start and finish. A new method for objects, called `isOnScreen` let;s you find out if at least a corner of an object is visible in the current viewport Fabric.Color class now can export colors in HEX + opacity format Notable fixes: We switched some touch event handling to accomodate latest chrome changes Removed gaps on continuos textbackgroundColor on Itext
Fix: make the cacheCanvas created on the fly if not available Improvement: draw textbackgroundColor in one single pass when possible Improvement: fire selection changed event just if text is editing Improvement: Add object property 'needsItsOwnCache' Improvement: Skip unnecessary transform if they can be detected with a single if Fix: Moved all the touch event to passive false so that they behave as before chrome changes Fix: force top and left in the object representation of a path to avoid reparsing on restore Add: Enable deselected event for activeObject switch. Ensure deactivateAll call exitEditing Fix: Perform subtargetCheck also if the group is an active object and on activeGroup Fix: Made cursor operation more precise at high canvas zoom level Add: Made getBoundingRect available to return both absolute or standard bounding rect Add: Introduced calcViewportBoundaries() function for fabric.StaticCanvas Add: Introduced isOnScreen() function for fabric.Object Subclassed Polygon from polyline Fix: Removed reference to hovered target when target gets removed Fix: Removed hover cursor for non selectable objects Fix: Switch to passive event for touch move Fix: Restart rendering of cursor after entering some text Add: fabric.Color support toHexa() method now
Mixed release, cleaning and important bugfixes.
fromObject methods have been reworked to be able to wait for Patterns
full loading process before actually creating the object, so that the first render has the pattern ready to show. That was a longstanding bug since 2013.
Reworked some of the canvas background and overlay code so that gradient and patterns works and are saved and reloaded correctly.
During loadFromJSON process, if an image errors out, the process cotinue smooth, the reviver function is invoked with a third argument
equal to true.
Usuals objectCaching improvements: dirty flag propagation from childObjects to parents, added a couple of pixels around the cache canvas to avoid aliasing, added bigger padding for text with custom fonts.
Improvement: mousewheel event has target in the arguments as all the other events. object now fires mousewheel Improvement: Pattern loads for canvas background and overlay, corrected svg pattern export. Fix: Wait for pattern loading before calling callback. Fix: add 2 extra pixels to cache canvases to avoid aliasing cut. Fix: Rerender when deselect an itext editing object. Fix: save new state of dimensionProperties at every cache clear. Improvement: Better error managment in loadFromJSON. Improvement: do not reload backgroundImage as an image if is different type. Improvement: if a children element is set dirty, set the parent dirty as well.
Again a maintenance release for iText custom fonts and cache and a workaround for macOS sierra problem with 'object:modified'
Fix: Textbox do not use stylemap for line wrapping #3546 Fix: Fix for firing object:modfied in macOS sierra #3539 Fix: Itext with object caching was not refreshing selection correctly. #3538 Fix: stateful now works again with activeGroup and dinamyc swap between stateful false/true. #3537 Fix: includeDefaultValues was not applied to child objects of groups and path-groups. #3497 Fix: Itext style is cloned on paste action now, allow copie of styles to be independent. #3502 Fix: Add subclasses properties to cacheProperties. #3490 Add: Shift and Alt key used for transformations are now dinamic. #3479 Fix: fix to polygon and cache. Added cacheProperties for all classes #3490
Just small bugfixes and support for custom properties in gradient and pattern toObject method.
Add: Gradients/Patterns support customAttributes in toObject method #3477 Fix: IText/Textbox not blurring keyboard on ios 10 #3476 Fix: Shadow on freedrawing and zoomed canvas #3475 Fix: Fix for group returning negative scales #3474 Fix: hotfix for textbox #3441 #3473
Introducing object caching, please refer to the example page for more information caching
Add: Object Caching #3417 Improvement: group internal objects have coords not affected by canvas zoom #3420 Fix: itext cursor trails on initDimension #3436 Fix: null check on .setActive #3435 Fix: function error in clone deep. #3434
A bugfix release with a new function, snap to angle during rotation.
How to activate it? Populate `snapAngle` and `snapTreshold` in the object properties
Add: Snap rotation added to objects. two parameter introduced, snapAngle and snapTreshold. [#3383] Fix: Pass target to right click event. [#3381] Fix: Correct rendering of bg color for styled text and correct clearing of itext area. [#3388] Add: Fire mouse:over on the canvas when we enter the canvas from outside the element. [#3389] Fix: Fix calculation of words width with spaces and justify. [#3408] Fix: Do not export defaults properties for bg and overlay if requested. [#3415]
A bugfix release with 2 new image filters, contrast and saturation
Add: Contrast and Saturate filters #3341 Fix: Correct registering and removal of events to handle iText objects. Fix: Corrected 2 regression of 1.6.5 (dataurl export and itext clicks) Fix: Corrected path boundaries calculation for Arcs ( a and A )
A bugfix release with some small news:
backgroundColor is now supported from all classes.
fromObject methods are now equal for all classes. You can use the callback for any cloning.
mouse:down support. disabled by default can be enabled using the
fireRightClick property and the canvas element context menu can be disabled enabling
stopContextMenu on the fabric canvas.
The font-family quoting from 1.6.4 has been reverted because it made no possible to use multiple font family names. So if you are using a font family that has a name with spaces and numbers you have to wrap in in quotes by yourself.
Fix: charspacing, do not get subzero with charwidth. Improvement: add callback support to all object cloning. #3212 Improvement: add backgroundColor to all classe #3248 Fix: add custom properties to backgroundImage and overlayImage #3250 Fix: Object intersection is calculated on boundingBox and boundingRect, intersection is fired if objects are overlapping #3252 Change: Restored previous selection behaviour, added key to selection active object under overlaid target #3254 Improvement: hasStateChanged let you find state changes of complex properties. #3262 Fix: IText/Textbox shift click selection backward. #3270 Revert: font family quoting was a bad idea. node-canvas stills use it. #3276 Fix: fire mouse:over event for activeObject and activeGroup when using findTarget shourtcuts #3285 Fix: clear method clear all properties of canvas #3305 Fix: text area position method takes in account canvas offset #3306 Improvement: Added event on right click and possibility to hide the context menu with a flag 3308 Fix: remove canvas reference from object when object gets removed from canvas #3307 Improvement: use native stroke dash if available #3309 Fix: Export correct src when exporting to svg #3310 Fix: Stop text to go on zero dimensions #3312 Fix: Error in dataURL with multiplier was outputting very big canvas with retina #3314 Fix: Error in style map was not respecting style if textbox started with space #3315
In fabric 1.6.4 we added some new features and refinement to text objects:
charspacing has been added, charspacing is expressed in thousands of em unit, meaning that with a value of 1000 and a fontsize of 40, you will have an additional space of 40px between chars.
Lineheight managment has been improved, now the lineheight does not have an extra padding below the line if there are no other lines of text.
Now that HiddenTextarea of iText object can follow the typing cursor better, it has been attached again to body of document and thanks to this IE browsers copy paste has been fixed.
selection:changed event firing has been reduced so that it fires just when necessary
Fonts with particular names, like 'Slabo 27px' or 'Exo 2' should be handled correctly now.
We have one new filter, a generic
ColorMatrix filter from one of our contributors.
An old missing feature has been finally added, when restoring object from JSON, the apply filter function is executed before firing the callback, so that we can re render the canvas when everything is properly set up
Other small fixes to svg import and zoomed canvas. Finally shift click to select and unselect should work on every canvas zoom/pan.
object:deselected is fired when an object loose its active state. Other than that, to the
selection:cleared the target is passed as an argument to the event fired.
This is the raw changelog:
Improvement: Ignore svg: namespace during svg import. #3081 Improvement: Better fix for lineHeight of iText/Text #3094 Improvement: Support for gradient with 'Infinity' coordinates #3082 Improvement: Generally "improved" logic of targeting #3111 Fix: Selection of active group with transparency and preserveObjectStacking true or false #3109 Fix: pattern brush now create the same pattern seen while drawing #3112 Fix: Allow css merge during svg import #3114 Improvement: added numeric origins handling fomr 0 to 1. #3121 Fix: Fix a defect with shadow of objects in a scaled group. #3134 Improvement: Do not fire unecessary selection:changed events. #3119 Fix: Attached hiddenTextarea to body fixes IE, thanks to @plainview. #3137 Fix: Shift unselect activegroup on transformed canvas. #3144 Added: ColorMatrix filter #3139 Fix: Fix condition in wich restoring from Object could cause object overwriting #3146 Change: cloneAsImage for Object and toDataUrl for object are not retina enabled by default. Added option to enable. #3147 Improvement: Added textSpacing support for text/itext/textbox #3097 Fix: Quote font family when setting the context fontstyle #3191 Fix: use getSrc during image export, make subclassing easier, return eventually the .src property if nothing else is available #3189 Fix: Inverted the meaning of border scale factor #3154 Improvement: Added support for RGBA in HEX notation. #3202 Improvement: Added object deselected event. #3195 Fix: loadFromJson callback now gets fired after filter are applied #3210
Biggest new in 1.6.3 is support of sub-targets in group. Group has a new property
subTargetCheck default to false that allows the findTarget
functions to go deep in the group nested objects.
Events will fire for both the group and all the list of sub targets found in case of nested groups
Other changes inclued better handling of pan and zooming. Transparency checking is now aware of current viewportTransform and 3 new functions have been
added to center objects in the current viewport instead of canvas:
Viewport fixes include cursor width in text editiong mode and the 1.6.2 newly itroduced
This is the raw changelog:
Improvement: Use reviver callback for background and overlay image when doing svg export. #2975 Improvement: Added object property excludeFromExport to avoid exporting the object to JSON or to SVG. #2976 Improvement: Correct the calculation of text boundingbox. Improves svg import #2992 Added: Export id property to SVG #2993 Improvement: Call the callback on loadSvgFromURL on failed xml load with null agument #2994 Improvement: Clear only the Itext area on contextTop during cursor animation #2996 Added: Char widths cache has been moved to fabric level and not iText level. Added fabric.util.clearFabricCharWidthsCache(fontName) #2995 Fix: do not set background or overlay image if the url load fails. #3003 Fix: iText mousemove event removal, clear the correct area for Itext, stopped redrawing selection if not necessary #3016 Fix: background image and overlay image scale and move with canvas viewportTransform, parameter available #3019 Added: support sub targeting in groups in events #2997 Fix: Select transparent object on mouse up because of _maybeGroupObject #2997 Fix: Remove reference to lastRenderedObject on canvas.remove #3023 Fix: Wait for all objects to be loaded before deleting the properties and setting options. #3029 Fix: Object Padding is unaffected by object transform. #3057 Fix: Restore lastRenderedObject usage. Introduced Canvas.lastRenderedKey to retrieve the lastRendered object from down the stack #3057 Fix: _calcTextareaPosition correctly calculate the position considering the viewportTransform. #3057 Fix: Fixed selectionBacgroundColor with viewport transform. #3057 Improvement: Correctly render the cursor with viewport scaling, improved the cursor centering. #3057 Fix: Use canvas zoom and pan when using is target transparent. #2980 Improvement: Added additional methods to center object on canvas. #3044
With 1.6.2 we introduce some new customization options for controls and user interaction. It is now possible to customize the keys used for control interaction.
Before those where the predefined keys:
Alt Key: Switching from normal transform to centered transform during scaling objects. Shift Key: on br,bl,tr,lt was switching from proportional to free resize, on mt, ml, mr, bw was switching between resize and skew.
As of 1.6.2 is possible to use those configuration option to define which keys are used:
* values: altKey, shiftKey, ctrlKey, fabric.Object.uniScaleKey: key used to switch between proportional and not proportional scaling fabric.Object.altActionKey: key used to switch between different action on same corner (skew/scale) fabric.Object.centeredKey: key used to switch on/off the centered transform
hoverCursor now appears also on non selectable objects but
moveCursor does not appear if the object can't be moved. In addition
moveCursor is now customizable with the property
The biggest change is the possibility of cusomizing the look of controls. Both border and controls can be filled and stroked and can also have a dash-array instead of a continue line. Corners can be both square or round.
To control those feature you can use those new properties:
borderDashArray: Dash stroke of borders cornerDashArray: Dash stroke of corners cornerStrokeColor: If corners are filled, this property controls the color of the stroke cornerStyle: standrd 'rect' or 'circle' selectionBackgroundColor: add an opaque or transparent layer to the selected object.
Small bugfixes includes: Itext firing
object:modified on text change, possibility to restore custom canvas properties other than objects during canvas loadFromJSON, some SVG color output fix and some dataURL improvements.
This is the raw changelog:
Fix: restore canvas properties on loadFromJSON with includeProperties. #2921 Fix: Allow hoverCursor on non selectable objects, moveCursor does not appear if the object is not moveable. Added object.moveCursor to specify a cursor for moving per object. #2924 Fix: Add missing stroke.live translation, allow gradientTransform for dashed line. #2926 Improvement: Allow customization of keys that iteract with mouse action ( multiselect key, free tranform key, alternative action key, centered transform key ) #2925 Added: Make iText fires object:modified on text change on exit editing #2927 Added: [control customization part 1] cornerDashArray, borderDashArray. Now borderScaleFactor influences both border and controls, changed default corner size to 13 #2932 Fix: createSVGFontFacesMarkup was failing to retrieve fonts in style #2935 Fix: shadow not scaled with dataUrl to multiplier #2940 Added: [control customization part 2] cornerStrokeColor. Now is possible to specify separate stroke and fill color for the controls #2933 Fix: Itext width calculation with caching false was returning nan. #2943 Added: [control customization part 3] Rounded corners. It is possible to specify cornerStyle for the object. 'rect' or 'circle' #2942 Added: [control customization part 4] Selection background. It is possible to specify selectionBackgroundColor for the object. #2950 Fix: Behaviour of image with filters with resize effects and Object to/from json #2954 Fix: Svg export should not output color notation in rgba format #2955 Fix: minScaleLimit rounding bug #2964 Fix: Itext spacing in justify mode bug #2971 Fix: Object.toDataUrl export when some window.devicepixelRatio is present (retina or browser zoom) #2972