Last updated

API / geotoolkit / welllog / LogAnnotation / LogAnnotation

Class: LogAnnotation

welllog.LogAnnotation.LogAnnotation

Defines annotation visual. It is defined by a string and a rectangle to set its bounds.

Example

// How to create annotation
// Use setFixedHeight to false to locate
// annotation precisely by provided bounds
import {LogAnnotation} from '@int/geotoolkit/welllog/LogAnnotation';
import {AnchorType} from '@int/geotoolkit/util/AnchorType';
import {Rect} from '@int/geotoolkit/util/Rect';
...
const annotation = new LogAnnotation({
'bounds': new Rect(0, 100, 1, 200),
'text': 'Text1',
'textstyle': '#7cb342',
'fillstyle': '#fdd835',
'textposition': AnchorType.Center,
'padding': '1mm'
}).setFixedHeight(false)

Hierarchy

Table of contents

Constructors
Methods
addCssClassaddInvalidateHandlerapplyOpacity
applyResponsiveStylecheckCollisionclone
connectStylecopyConstructordisconnectStyle
disposeenableEventPropagationexecute
filtergetAnimationStylegetAutoHeight
getBaseNamegetBoundsgetClassName
getClipStylegetContentsTransformgetCss
getCssClassgetCssClassesgetCssTransform
getDataLimitsgetDescriptiongetFillStyle
getHeadergetHeadersgetId
getInvalidateMethodgetLineStylegetLocalTransform
getMarginsStylegetMicroPositionLeftgetMicroPositionRight
getMicroPositionTransformationgetModelLimitsgetName
getOpacitygetOpacityBlendModegetPaddingStyle
getParentgetPropertiesgetProperty
getPropertyKeysgetRectgetRenderingFilter
getResponsiveStylegetRootgetScaleScrollStrategy
getSceneTransformgetShowEllipsisgetTag
getTextgetTextAlignmentgetTextAutoRotation
getTextOrientationgetTextPositiongetTextSizeMode
getTextStylegetTrackgetVisible
getWorldTransformgetZIndexhasCssClass
hasEventListenerinvalidateinvalidateParent
isAutoBoundsisDisposedisEventPropagationEnabled
isFixedHeightisHorizontalFlipisNotificationEnabled
isSelectableisSilentnotify
offononHeaderSet
onMicroPositionChangedonParentChangedonVisibilityChanged
postRenderingpreRenderingregisterAnimationStyle
removeCssClassremoveInvalidateHandlerrender
renderAsyncrenderContentrotate
scalesetAnimationStylesetAutoBounds
setAutoHeightsetBaseNamesetBounds
setClipStylesetCsssetCssClass
setCssTransformsetDescriptionsetFillStyle
setFixedHeightsetHeadersetId
setLineStylesetLocalTransformsetMarginsStyle
setMicroPositionsetNamesetNotification
setOpacitysetPaddingStylesetProperties
setPropertysetRectsetRenderingFilter
setResponsiveStylesetScaleScrollStrategysetSelectable
setShowEllipsissetSilentsetTag
setTextsetTextAlignmentsetTextAutoRotation
setTextOrientationsetTextPositionsetTextSizeMode
setTextStylesetVisiblesetZIndex
sheartoStringtranslate
unregisterAnimationStyleupdateSceneTransformationupdateState
updateTimeStampenableSceneGraphNotificationfindParent
getClassNameisSceneGraphNotificationEnabled
Css Properties
Name Type Description
autoboundsbooleanEnables or disables auto bounds
autoheightbooleanAuto height flag
basenamestringThe base name
boundsRectThe rectangle specifying position of the visual in the track. If set, autobounds will be switched off
bounds-heightnumberHeight
bounds-readonlybooleanReadonly
bounds-widthnumberWidth
bounds-xnumberLeft
bounds-ynumberTop
clipstyleClipStyleClipping style
clipstyle-evenoddbooleanTrue if evenodd mode is on ('nonzero' mode otherwise)
clipstyle-geometryGraphicsPathClipping geometry
clipstyle-geometry-boundsRectBounds
clipstyleGraphicsPathClipping style
cssclassstringThe css class name of this node
csscursorstringCSS cursor associated with node
cssstylestringCSS style to be applied to inserted elements
descriptionstringThe description
fillstylestringFillStyle
fillstyleFillStyleFillStyle
fillstyle-colorstringColor in CSS form
fillstyle-evenoddmodebooleanEven-odd fill mode
fillstyle-fillpatternPatternPattern
fillstyle-fillpattern-containernamestringAn optional container name, which creates an image pattern. This parameter is used for serialization if you want to save are reference to pattern instead of the pattern itself
fillstyle-fillpattern-patternnamestringName of this pattern for indexing
fillstyle-fillpattern-scalablebooleanFlag that sets scalability of the pattern coordinates, or relative to the shape it is filling (It is not supported)
fillstyle-foregroundstringForeground color
fillstyle-patternPatternPattern
fillstylestringFillStyle
fillstyleFillStyleFillStyle
fixedheightbooleanEnables height of the frame to be fixed in the device coordinates
fixedheightbooleanEnables height of the frame to be fixed in the device coordinates
idstring | numberId of the node, its a unique identifier
linestylestringLinestyle
linestyleLineStyleLinestyle
linestyle-colorstringColor in CSS form
linestyle-fillstringOptional fill style to be used to fill lines generated with this style
linestyle-fillFillStyleOptional fill style to be used to fill lines generated with this style
linestyle-linecapCapStyleThe line cap style
linestyle-linedashoffsetnumberLine dash offset of dashed line
linestyle-linejoinJoinStyleThe line join style
linestyle-pixelsnapmodebooleanPixel Snap Mode, default(
linestyle-scalablebooleanTrue if width should depend on transformation
linestyle-unitstringOptional unit for the width
linestyle-widthnumber | stringThe line thickness
localtransformTransformationLocal transformation
localtransform-dxnumberX axis translation
localtransform-dynumberY axis translation
localtransform-xxnumberX scale
localtransform-xynumberXy skew
localtransform-yxnumberYx skew
localtransform-yynumberY scale
marginsnumber | stringIt has properties for specifying the margins for each side
microposleftnumberLeft micro position
microposrightnumberRight micro position
namestringName of the node. It is often used for debugging purposes or to simplify queries
opacitynumberNode opacity (from 0 to 1). If it is undefined or null it inherits property from the parent. It changes globalAlpha on the rendering context
opacityblendmodeBlendModeNode opacity mode to blend it
paddingnumber | stringIt has properties for specifying the padding for each side
scalescrollstrategyScaleScrollStrategyScale scroll strategy
scalescrollstrategy-enabledbooleanEnable flag
selectablebooleanSelectable node, a boolean to determine if selection should consider this node
taganyCustom information associated with node. It is a user object which can be used by client code to store information or attach an application object to the shape
textstringText to be displayed
textalignmentTextAlignmentText alignment
textautorotationbooleanText auto rotation
textellipsisbooleanText ellipsis
textorientationTextOrientationText orientation
textpositionAnchorTypeText anchor type specified position of the text inside the bounds and it can be placed in any one of 9 places. These values include LeftTop, TopCenter, RightTop, LeftCenter, Center,RightCenter, LeftBottom, BottomCenter, RightBottom
textsizemodeSizeModeEnum of size modes
textstylestringThe style of the text
textstyleTextStyleThe style of the text
textstyle-alignmentAlignmentStyleAlignment
textstyle-autosizebooleanAuto font size on high definition display
textstyle-backgroundstringBackground style
textstyle-backgroundFillStyleBackground style
textstyle-baselineBaseLineStyleBase line
textstyle-colorstringColor in CSS form
textstyle-fillFillStyleText fill style
textstyle-fontstringFont see
textstyle-fonturlstringThe place from which the font will be loaded, if null - uses system fonts. It can be base64 with url keyword
textstyle-lineheightstring | numberLine height
textstyle-multilinebooleanAllow multi-line text
textstyle-outlinestringOutline style
textstyle-outlineLineStyleOutline style
textstyle-overflowwrapOverflowWrapStyleOverflow wrap
textstyle-strikethroughstringStrikethrough style
textstyle-strikethroughLineStyleStrikethrough style
textstyle-textoverflowTextOverflowStyleText overflow
textstyle-underlinestringUnderline style
textstyle-underlineLineStyleUnderline style
textstyle-underlineoffsetstring | numberUnderline offset distance
textstyle-whitespaceWhiteSpaceStyleWhite space
textstyle-wordbreakWordBreakStyleWord break
transformstringAdditional CSS transformation applied to node or 'none'
transformTransformationAdditional CSS transformation applied to node or 'none'
visiblebooleanVisibility of the node, a boolean to determine if the node should be rendered or not
z-indexnumberDefine node z-index

Contents

Constructors

new LogAnnotation(options, text)

new LogAnnotation(options?, text?)

Parameters

Name Type Description
Optional optionsRect | Optionsbounds of the visual or properties object
Optional textstringthe text to be displayed

Overrides

LogFrameVisual.constructor

Methods

addCssClass

addCssClass(cssclass): LogAnnotation

Adds new css class to node

Parameters

Name Type Description
cssclassstring | string[]css class name('s)

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.addCssClass


addInvalidateHandler

addInvalidateHandler(handler): LogAnnotation

Add invalidate handler

Deprecated

since 4.0, use Node.on instead

Parameters

Name Type Description
handlerFunctionhandler to be notified about invalidation

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.addInvalidateHandler


applyOpacity

Protected applyOpacity(context): LogAnnotation

This method is called to apply opacity if it is specified on the rendering context. The default implementation sets global alpha on the rendering context

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.applyOpacity


applyResponsiveStyle

Protected applyResponsiveStyle(): void

Apply a responsive style rules it is exists

Returns

void

Inherited from

LogFrameVisual.applyResponsiveStyle


checkCollision

checkCollision(context): boolean

Checks culling Returns true if object is inside of renderable area

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

boolean

Inherited from

LogFrameVisual.checkCollision


clone

clone(): LogAnnotation

All subclasses should override copyConstructor or provide custom implementation for this method

Returns

LogAnnotation

clone

Overrides

LogFrameVisual.clone


connectStyle

connectStyle(style, type, callback): LogAnnotation

Connects style.

This convenience method subscribes a listener to given style for the specified type.
And automatically un-subscribes listener if node is disposed to prevent memory leaks

Parameters

Name Type Description
styleEventDispatcherconnect style
typestringtype of event or property
callbackAttributeCallback<EventDispatcher>function to be called

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.connectStyle


copyConstructor

Protected copyConstructor(src, deepCopy?): LogAnnotation

Copy constructor function.
Function used as part of the cloning mechanism.
Implementations should copy the given instance state to this instance.

Parameters

Name Type Description
srcLogAnnotationSource to copy from
Optional deepCopybooleandeep copy

Returns

LogAnnotation

this

Overrides

LogFrameVisual.copyConstructor


disconnectStyle

disconnectStyle(style, type, callback): LogAnnotation

Disconnect style
This convenience method un-subscribes a listener to given style for the specified type.

Parameters

Name Type Description
styleEventDispatcherconnect style
typestringtype of event or property
callbackAttributeCallback<EventDispatcher>function to be called

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.disconnectStyle


dispose

dispose(): void

Disposes this node, once disposes a node should not be used anymore.
Clear all listeners, and disconnect styles to avoid memory leaks.
Also aggressively 'cleanup' this node by setting some of its members to null.

Returns

void

Inherited from

LogFrameVisual.dispose


enableEventPropagation

enableEventPropagation(enable): LogAnnotation

Enable event propagation from the node hierarchy from bottom to top

This option is similar to DOM Event bubbling, which allows to get any event from child node. By default it is disabled for better performance.

Example

import {Group} from '@int/geotoolkit/scene/Group';
import {Events as SceneEvents} from '@int/geotoolkit/scene/Node';
const parentGroup = new Group()
.setName('ParentGroup')
.enableEventPropagation(true);
const childGroup = new Group()
.setName('ChildGroup');

parentGroup.addChild(childGroup);
parentGroup.on(SceneEvents.Invalidate, (eventName, sender, args) => {
// Got notifications from all children of parent group
});
childGroup.invalidate();

Parameters

Name Type Description
enablebooleanenable

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.enableEventPropagation


execute

execute(delegate): LogAnnotation

Executes delegate and return the result. It allows us to keep all initialization calls in one place,
and we do not need to scroll up or down in IDE to find how and where it was initialized.

Example

// All setters (.setName() for example) returns reference to the this.
// In order to modify inner object like LineStyle or Pattern, to get this object (property) we should call getter to get object reference.
// Then modify it as shown below in Option 1 or you can use execute methods shown in Option 2.
import {Group} from '@int/geotoolkit/scene/Group';
import {Rect} from '@int/geotoolkit/util/Rect';
// Option 1
const group = new Group()
.setName('MyGroup')
.setBounds(new Rect(0, 0, 42, 16))
.enableClipping(true)
.setTag({'type': 'sometype'});

group.getLineStyle().setPattern('pattern');
return group;

// Options 2 ( using execute method )
return group
.execute(function () {
this.getLineStyle()
.setPattern("pattern");
});

Parameters

Name Type Description
delegate(this: LogAnnotation) => voidFunction to execute

Returns

LogAnnotation

The result if any or this

Inherited from

LogFrameVisual.execute

execute<T>(delegate): T

Type parameters

Name
T

Parameters

Name Type
delegate(this: LogAnnotation) => T

Returns

T

Inherited from

LogFrameVisual.execute


filter

Protected filter(context): boolean

Filter node

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

boolean

flag filter flag ("true" to render node; "false" otherwise)

Inherited from

LogFrameVisual.filter


getAnimationStyle

getAnimationStyle(): AnimationStyle

Return animation style

Returns

AnimationStyle

animationStyle current animation style

Inherited from

LogFrameVisual.getAnimationStyle


getAutoHeight

getAutoHeight(): boolean

Returns auto height flag

Returns

boolean


getBaseName

getBaseName(): string

Returns the base name

Returns

string

The base name

Inherited from

LogFrameVisual.getBaseName


getBounds

getBounds(context?): Rect

Returns calculated bounds

Parameters

Name Type Description
Optional contextRenderingContextRendering Context

Returns

Rect

Overrides

LogFrameVisual.getBounds


getClassName

getClassName(): string

Returns

string

Inherited from

LogFrameVisual.getClassName


getClipStyle

getClipStyle(): ClipStyle

Gets the current clipping style

Returns

ClipStyle

clipping style

Inherited from

LogFrameVisual.getClipStyle


getContentsTransform

getContentsTransform(): Transformation

Retrieves the world transformation of the spatial

Returns

Transformation

Inherited from

LogFrameVisual.getContentsTransform


getCss

getCss(): CssStyle

Return CSS style

Returns

CssStyle

Inherited from

LogFrameVisual.getCss


getCssClass

getCssClass(): string

Returns css class name to be used to apply CSS style

Returns

string

the css class name

Inherited from

LogFrameVisual.getCssClass


getCssClasses

getCssClasses(): string[]

Gets list of css class names which applied to this node

Returns

string[]

Inherited from

LogFrameVisual.getCssClasses


getCssTransform

getCssTransform(): string

Returns CSS transformation

Returns

string

Inherited from

LogFrameVisual.getCssTransform


getDataLimits

getDataLimits(fullLimits?): Rect

Return meaning data limits

Parameters

Name Type Description
Optional fullLimitsbooleandefault value is false

Returns

Rect

Inherited from

LogFrameVisual.getDataLimits


getDescription

getDescription(): string

Gets the description

Returns

string

The description

Inherited from

LogFrameVisual.getDescription


getFillStyle

getFillStyle(): FillStyle

Return fill style

Returns

FillStyle

Inherited from

LogFrameVisual.getFillStyle


getHeader

getHeader(name): LogVisualHeader<Node>

Return the header registered by the name

Parameters

Name Type Description
namestringheader name

Returns

LogVisualHeader<Node>

header

Inherited from

LogFrameVisual.getHeader


getHeaders

getHeaders(): Record<string, LogVisualHeader<Node>>

Return an object that contains all headers registered with the visual

Returns

Record<string, LogVisualHeader<Node>>

headers

Inherited from

LogFrameVisual.getHeaders


getId

getId(): string | number

Returns the associated identifier of the node

Returns

string | number

The node's id

Inherited from

LogFrameVisual.getId


getInvalidateMethod

Protected getInvalidateMethod(): AttributeCallback<EventDispatcher>

Gets invalidate method

Returns

AttributeCallback<EventDispatcher>

method to invalidate this object

Inherited from

LogFrameVisual.getInvalidateMethod


getLineStyle

getLineStyle(): LineStyle

Returns line style

Returns

LineStyle

Inherited from

LogFrameVisual.getLineStyle


getLocalTransform

getLocalTransform(): Transformation

Retrieves the transformation of bounds to parent

Returns

Transformation

transform the local transform.

Inherited from

LogFrameVisual.getLocalTransform


getMarginsStyle

getMarginsStyle(): SpaceStyle<string | number>

Return margins style

Returns

SpaceStyle<string | number>

Inherited from

LogFrameVisual.getMarginsStyle


getMicroPositionLeft

getMicroPositionLeft(): number

Returns micro position left

Returns

number

Inherited from

LogFrameVisual.getMicroPositionLeft


getMicroPositionRight

getMicroPositionRight(): number

Returns micro position right

Returns

number

Inherited from

LogFrameVisual.getMicroPositionRight


getMicroPositionTransformation

Protected getMicroPositionTransformation(): Transformation

Returns micro position transformation

Returns

Transformation

micro position transformation

Inherited from

LogFrameVisual.getMicroPositionTransformation


getModelLimits

getModelLimits(): Rect

Returns parent model limits

Returns

Rect

Inherited from

LogFrameVisual.getModelLimits


getName

getName(): string

Returns the node name

Returns

string

The node name

Inherited from

LogFrameVisual.getName


getOpacity

getOpacity(): number

Returns current node opacity

Returns

number

opacity

Inherited from

LogFrameVisual.getOpacity


getOpacityBlendMode

getOpacityBlendMode(): BlendMode

Returns current node opacity

Returns

BlendMode

opacity blend mode

Inherited from

LogFrameVisual.getOpacityBlendMode


getPaddingStyle

getPaddingStyle(): SpaceStyle<string | number>

Returns padding style

Returns

SpaceStyle<string | number>

padding


getParent

getParent(): Node

Return parent node

Returns

Node

parent node

Inherited from

LogFrameVisual.getParent


getProperties

getProperties(): OptionsOut

Gets all the properties pertaining to this object

Returns

OptionsOut

An object containing the properties to set

Overrides

LogFrameVisual.getProperties


getProperty

getProperty(name): any

Gets dynamic property by name. These properties can be used as a property bags

Parameters

Name Type Description
namestringproperty name

Returns

any

Inherited from

LogFrameVisual.getProperty


getPropertyKeys

getPropertyKeys(): string[]

Returns known properties keys

Returns

string[]

Inherited from

LogFrameVisual.getPropertyKeys


getRect

getRect(): Rect

Return rectangle geometry

Returns

Rect

Inherited from

LogFrameVisual.getRect


getRenderingFilter

getRenderingFilter(): IFilter

Return filter to be used for rendering and picking

Returns

IFilter

current filter

Inherited from

LogFrameVisual.getRenderingFilter


getResponsiveStyle

getResponsiveStyle(): ResponsiveStyle

Return responsive style

Returns

ResponsiveStyle

Inherited from

LogFrameVisual.getResponsiveStyle


getRoot

getRoot(): Node

Returns root node.
If node doesn't have parent then it returns itself.

Returns

Node

the root node

Inherited from

LogFrameVisual.getRoot


getScaleScrollStrategy

getScaleScrollStrategy(): Delegate

Gets scale scroll strategy

Returns

Delegate

scale scroll strategy

Inherited from

LogFrameVisual.getScaleScrollStrategy


getSceneTransform

getSceneTransform(): Transformation

Returns transformation from node to root scene

Returns

Transformation

a transformation from node to root scene

Inherited from

LogFrameVisual.getSceneTransform


getShowEllipsis

getShowEllipsis(): boolean

Returns ellipsis flag

Returns

boolean

ellipsis flag


getTag

getTag(): any

Returns the object associated with the node by user.

Returns

any

The node's user-object

Inherited from

LogFrameVisual.getTag


getText

getText(): string

Returns the current text

Returns

string


getTextAlignment

getTextAlignment(): TextAlignment

Return text alignment

Returns

TextAlignment


getTextAutoRotation

getTextAutoRotation(): boolean

Return text autorotation

Returns

boolean


getTextOrientation

getTextOrientation(): TextOrientation

Return text orientation

Returns

TextOrientation


getTextPosition

getTextPosition(): AnchorType

Returns text position inside the bounds

Returns

AnchorType

text anchor type


getTextSizeMode

getTextSizeMode(): SizeMode

Returns how the size is computed

Returns

SizeMode

returns textSizeMode


getTextStyle

getTextStyle(): TextStyle

Returns text style

Returns

TextStyle


getTrack

getTrack(): ITrack

Returns parent track if LogTrack

Returns

ITrack

Inherited from

LogFrameVisual.getTrack


getVisible

getVisible(): boolean

Return visibility of the node

Returns

boolean

true if node is visible

Inherited from

LogFrameVisual.getVisible


getWorldTransform

getWorldTransform(): Transformation

Retrieves the local transformation of the node which represents multiplication of parent to bounds and contents transformations.

Returns

Transformation

Inherited from

LogFrameVisual.getWorldTransform


getZIndex

getZIndex(): number

Returns node z-index (null if not set)

Returns

number

Inherited from

LogFrameVisual.getZIndex


hasCssClass

hasCssClass(cssClass): boolean

Check if node has specified css class

Parameters

Name Type Description
cssClassstringcss class name

Returns

boolean

Inherited from

LogFrameVisual.hasCssClass


hasEventListener

hasEventListener(type, callback?): boolean

Check if a list of event listeners for this type contains this listener

Parameters

Name Type Description
typestringtype of event or property
Optional callbackFunctionto be called, if null, check if any callback is registered

Returns

boolean

Inherited from

LogFrameVisual.hasEventListener


invalidate

invalidate(bounds?, force?): LogAnnotation

Invalidate area of the shape. This method invalidates parent by default. invalidated from parent to root node.

Parameters

Name Type Description
Optional boundsRectbounds of the invalid rectangle in the inner node coordinates
Optional forcebooleantrue if parent should be invalidated immediately if null is provided then cache (if any will be completely refreshed) otherwise only specified rect or node.bounds will be refreshed

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.invalidate


invalidateParent

invalidateParent(bounds?, force?): LogAnnotation

Invalidate bounds

Parameters

Name Type Description
Optional boundsRectmodel bounds
Optional forcebooleanforce if null is provided then cache (if any will be completely refreshed) otherwise only specified rect or node.bounds will be refreshed

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.invalidateParent


isAutoBounds

isAutoBounds(): boolean

Returns auto bounds value

Returns

boolean

Inherited from

LogFrameVisual.isAutoBounds


isDisposed

isDisposed(): boolean

Returns whether this object has been disposed

Returns

boolean

Inherited from

LogFrameVisual.isDisposed


isEventPropagationEnabled

isEventPropagationEnabled(): boolean

Return true if event propagation is enabled from child to parent

Returns

boolean

Inherited from

LogFrameVisual.isEventPropagationEnabled


isFixedHeight

isFixedHeight(): boolean

Returns true if height is fixed in the device coordinates

Returns

boolean

Inherited from

LogFrameVisual.isFixedHeight


isHorizontalFlip

isHorizontalFlip(): boolean

Return true if the representation is flipped horizontally

Returns

boolean

horizontal flip

Inherited from

LogFrameVisual.isHorizontalFlip


isNotificationEnabled

isNotificationEnabled(): boolean

return state of notification

Returns

boolean

current notification state

Inherited from

LogFrameVisual.isNotificationEnabled


isSelectable

isSelectable(): boolean

Returns true if node can be picked/selected.

Returns

boolean

The selectable flag

Inherited from

LogFrameVisual.isSelectable


isSilent

isSilent(): boolean

Return true if the event dispatcher doesn't notify any events

Returns

boolean

Inherited from

LogFrameVisual.isSilent


notify

notify<E>(type, source, args?): LogAnnotation

Notify listeners of the Node

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event
sourceLogAbstractVisualsource who called the event
Optional argsEventMap[E]event arguments

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.notify


off

off<E>(type?, callback?): LogAnnotation

Detach listener on event. Calling .off() with no arguments removes all attached listeners. Calling .off(type) with no callback removes all attached listeners for specific type.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
Optional typeEtype of the event
Optional callback(eventType: E, sender: LogAnnotation, args: EventMap[E]) => voidfunction to be called

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.off


on

on<E>(type, callback): LogAnnotation

Attach listener on event that will be called whenever the specified event is delivered to the target

If the callback function is already in the list of event listeners for this target, the function is not added a second time.

If a particular anonymous function is in the list of event listeners registered for a certain target, and then later in the code, an identical anonymous function is given in an "on" call, the second function will also be added to the list of event listeners for that target.

Type parameters

NameType
Eextends string

Parameters

Name Type Description
typeEtype of event or property
callback(eventType: E, sender: LogAnnotation, args: EventMap[E]) => voidto be called

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.on


onHeaderSet

Protected onHeaderSet(name, headerInstance, silent?): void

This method is called if header is set. Send event Events.HeaderSet

Parameters

Name Type Description
namestringof the container. The 'header' and 'footer' is used.
headerInstanceLogVisualHeader<Node>the header instance
Optional silentbooleansilent node to avoid sending events that header is created

Returns

void

Inherited from

LogFrameVisual.onHeaderSet


onMicroPositionChanged

Protected onMicroPositionChanged(): LogAnnotation

calls when microPosition has been changed

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.onMicroPositionChanged


onParentChanged

Protected onParentChanged(node): LogAnnotation

This method is called when parent changes. Do not call it directly.

Parameters

Name Type Description
nodeNodenode to change parent

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.onParentChanged


onVisibilityChanged

Protected onVisibilityChanged(): void

This method is called if visibility is changed. Send event Events.VisibilityChanged

Returns

void

Inherited from

LogFrameVisual.onVisibilityChanged


postRendering

Protected postRendering(context): void

To be called after rendering. Call this method if you override method render

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

void

Inherited from

LogFrameVisual.postRendering


preRendering

Protected preRendering(context): void

Occurs before rendering this method sets clipping by default. Call this method if you override method render

Parameters

Name Type Description
contextRenderingContextRendering Context

Returns

void

Inherited from

LogFrameVisual.preRendering


registerAnimationStyle

registerAnimationStyle(root): void

Register animation style.

Parameters

Name Type Description
rootNoderoot node for node

Returns

void

Inherited from

LogFrameVisual.registerAnimationStyle


removeCssClass

removeCssClass(cssclass): LogAnnotation

Removes css class from node

Parameters

Name Type Description
cssclassstring | string[]css class name('s)

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.removeCssClass


removeInvalidateHandler

removeInvalidateHandler(handler): LogAnnotation

Remove invalidate handler

Deprecated

since 4.0, use Node.off instead

Parameters

Name Type Description
handlerFunctionhandler to be notified about invalidation

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.removeInvalidateHandler


render

render(context): void

Renders node

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node

Returns

void

Inherited from

LogFrameVisual.render


renderAsync

renderAsync(context, callback): void

Render node in asynchronous mode. Default implementation creates call method "render" inside

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node
callback() => voidcallback function

Returns

void

Inherited from

LogFrameVisual.renderAsync


renderContent

Protected renderContent(context): void

Renders node content

Parameters

Name Type Description
contextRenderingContextThe rendering context to be used to draw the node

Returns

void

Inherited from

LogFrameVisual.renderContent


rotate

rotate(theta, x, y): LogAnnotation

Rotate bounds around a given coordinate

Parameters

Name Type Description
thetanumberangle to rotate node, in radians
xnumberx coordinate to rotate around
ynumbery coordinate to rotate around

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.rotate


scale

scale(xx, yy): LogAnnotation

Scale node

Parameters

Name Type Description
xxnumberx scale factor
yynumbery scale factor

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.scale


setAnimationStyle

setAnimationStyle(animationStyle): LogAnnotation

Sets animation style

Parameters

Name Type Description
animationStyleTypeanimation style

Returns

LogAnnotation

Inherited from

LogFrameVisual.setAnimationStyle


setAutoBounds

setAutoBounds(enable): LogAnnotation

Enables or disables auto bounds. If auto bounds is enabled then it equals to parent model limits

Parameters

Name Type Description
enablebooleanEnables or disables auto bounds

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setAutoBounds


setAutoHeight

setAutoHeight(enable): LogAnnotation

Set auto height flag

Parameters

Name Type Description
enablebooleanflag

Returns

LogAnnotation

this


setBaseName

setBaseName(name): LogAnnotation

Sets base name of the visual

Parameters

Name Type Description
namestringThe base name

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setBaseName


setBounds

setBounds(bounds): LogAnnotation

Sets bounds of the visual in the parent coordinates and sets up auto bounds to false

Parameters

Name Type Description
boundsRectthe rectangle specifying position of the visual in the track.

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setBounds


setClipStyle

setClipStyle(style): LogAnnotation

Sets a new clipping style

Parameters

Name Type Description
styleGraphicsPath | ClipStyle | Optionsa new clipping style

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setClipStyle


setCss

setCss(style, merge?): LogAnnotation

Sets CSS style. This style will be applied for all inserted elements

Parameters

Name Type Description
styleTypeCSS style to be applied to inserted elements
Optional mergebooleanmerge flag

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setCss


setCssClass

setCssClass(name): LogAnnotation

Sets css class name of the node to be used to apply CSS style

Parameters

Name Type Description
namestringcss class name of the node

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setCssClass


setCssTransform

setCssTransform(transform): LogAnnotation

Set CSS transformation

Parameters

Name Type Description
transformstring | Transformationtransformation css transformation instruction or Transformation instance

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setCssTransform


setDescription

setDescription(description): LogAnnotation

Sets the description

Parameters

Name Type Description
descriptionstringThe visual description

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setDescription


setFillStyle

setFillStyle(fillStyle, merge?): LogAnnotation

Sets fill style

Parameters

Name Type Description
fillStyleTypea new fill style
Optional mergebooleantrue if you want to merge lineStyle with existing attribute, false by default

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setFillStyle


setFixedHeight

setFixedHeight(enable): LogAnnotation

Enables height of the frame to be fixed in the device coordinates

Parameters

Name Type Description
enablebooleanEnables height of the frame to be fixed in the device coordinates

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setFixedHeight


setHeader

setHeader(name, headerInstance, silent?): LogAnnotation

Sets header instance with specified name. This name usually defines header or footer.

Throws

if header name is null

Parameters

Name Type Description
namestringof the container. The 'header' and 'footer' is used.
headerInstanceLogVisualHeader<Node>the header instance
Optional silentbooleansilent node to avoid sending events that header is created

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setHeader


setId

setId(id): LogAnnotation

Allows the user to associate any identifier

Parameters

Name Type Description
idstring | numberobject id

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setId


setLineStyle

setLineStyle(lineStyle, merge?): LogAnnotation

Sets line style

Parameters

Name Type Description
lineStyleTypeThe style in which the line is displayed object can be in format of constructor of LineStyle
Optional mergebooleantrue if you want to merge lineStyle with existing attribute, false by default

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setLineStyle


setLocalTransform

setLocalTransform(localTransform, force?): LogAnnotation

Sets local transformation to be used to transform from local to parent coordinate

Parameters

Name Type Description
localTransformTransformationlocal transformation for this node
Optional forcebooleanboolean flag to force update event if transformations are equal, false by default

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setLocalTransform


setMarginsStyle

setMarginsStyle(margins, merge?): LogAnnotation

Sets margins style

Parameters

Name Type Description
marginsType<string | number>margins style
Optional mergebooleantrue if you want to merge marginsStyle with existing attribute, false by default

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setMarginsStyle


setMicroPosition

setMicroPosition(left, right): LogAnnotation

Sets micro position (0 - 1). It allows application code to display the visual in a subarea of the track.
By default log visuals uses all space of the trace in the horizontal direction, but micro position allows to place log visual in the specified position of the track in horizontal direction. See example below

Example

// The following code places curve 20% from left and 20% from right.
curve.setMicroPosition(0.2,0.8);

Parameters

Name Type Description
leftnumberleft position
rightnumberright position

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setMicroPosition


setName

setName(name): LogAnnotation

Sets name of the node

Parameters

Name Type Description
namestringThe node name

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setName


setNotification

setNotification(notify, force?): LogAnnotation

set notification state

Parameters

Name Type Description
notifybooleanflag set to invalidate parent or not
Optional forcebooleantrue if parent should be invalidated immediately

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setNotification


setOpacity

setOpacity(opacity, blendMode?): LogAnnotation

Sets node opacity

Parameters

Name Type Description
opacitynumbernode opacity from 0 to 1
Optional blendModeBlendModeopacity blend mode. If it is normal, opacity will be replaced.

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setOpacity


setPaddingStyle

setPaddingStyle(paddingStyle, merge?): LogAnnotation

Sets padding style

Parameters

Name Type Description
paddingStyleType<string | number>padding style
Optional mergebooleantrue if you want to merge paddingStyle with existing attribute, false by default

Returns

LogAnnotation

this


setProperties

setProperties(properties?): LogAnnotation

Sets all the properties pertaining to this object

Parameters

Name Type Description
Optional propertiesOptionsAn object containing the properties to set

Returns

LogAnnotation

this

Overrides

LogFrameVisual.setProperties


setProperty

setProperty(name, value): LogAnnotation

Sets dynamic property by name

Parameters

Name Type Description
namestringproperty name
valueanyproperty value

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setProperty


setRect

setRect(rect): LogAnnotation

Sets rectangle geometry

Parameters

Name Type Description
rectRectSets rectangle geometry based on bounds of the visual

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setRect


setRenderingFilter

setRenderingFilter(filter): LogAnnotation

Sets filter to be applied before rendering and picking

Parameters

Name Type Description
filterIFilterfilter to set

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setRenderingFilter


setResponsiveStyle

setResponsiveStyle(style): LogAnnotation

Sets responsive style.

Parameters

Name Type Description
styleOptions | ResponsiveStyleresponsive style

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setResponsiveStyle


setScaleScrollStrategy

setScaleScrollStrategy(strategy?): LogAnnotation

Sets scale scroll strategy

Parameters

Name Type Description
Optional strategyDelegatescale scroll strategy

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setScaleScrollStrategy


setSelectable

setSelectable(selectable): LogAnnotation

Allows to select node. If node is not selectable then child node is not selectable.

Parameters

Name Type Description
selectablebooleanflag to allow node selection

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setSelectable


setShowEllipsis

setShowEllipsis(showTextEllipsis): LogAnnotation

Set show ellipsis

Parameters

Name Type Description
showTextEllipsisbooleanif flag equal true then show ellipsis text

Returns

LogAnnotation

this


setSilent

setSilent(bool): LogAnnotation

Set silent mode

Parameters

Name Type Description
boolbooleanflag to enable silent mode

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setSilent


setTag

setTag(tag): LogAnnotation

Allows the user to associate any arbitrary object with the node.

Parameters

Name Type Description
taganyThe object to be associated with the node.

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setTag


setText

setText(text): LogAnnotation

Sets text

Parameters

Name Type Description
textstringtext to be displayed

Returns

LogAnnotation


setTextAlignment

setTextAlignment(alignment): LogAnnotation

Sets text alignment.

Parameters

Name Type Description
alignmentTextAlignmenttext alignment

Returns

LogAnnotation


setTextAutoRotation

setTextAutoRotation(autoRotation): LogAnnotation

Sets text autorotation.

Parameters

Name Type
autoRotationboolean

Returns

LogAnnotation


setTextOrientation

setTextOrientation(orientation): LogAnnotation

Sets text orientation. if text orientation is regular then text follows the widgets orientation if text is rotated then text is always rotated on 90 degree.

Parameters

Name Type Description
orientationTextOrientationtext orientation

Returns

LogAnnotation


setTextPosition

setTextPosition(anchorType): LogAnnotation

Specifies text position inside the bounds

Parameters

Name Type Description
anchorTypeAnchorTypetext anchor type specified position of the text inside the bounds and it can be placed in any one of 9 places. These values include LeftTop, TopCenter, RightTop, LeftCenter, Center,RightCenter, LeftBottom, BottomCenter, RightBottom

Returns

LogAnnotation

this


setTextSizeMode

setTextSizeMode(textSizeMode): LogAnnotation

Sets how text size is computed

Parameters

Name Type Description
textSizeModeSizeModeEnum of size modes

Returns

LogAnnotation

this


setTextStyle

setTextStyle(textStyle, merge?): LogAnnotation

Sets text style

Parameters

Name Type Description
textStyleTypea new shape text style
Optional mergebooleantrue if you want to merge textStyle with existing attribute, false by default

Returns

LogAnnotation


setVisible

setVisible(value): LogAnnotation

Sets visibility of the node. Send event Events.VisibilityChanged

Parameters

Name Type Description
valuebooleanflag specifying visibility of the node

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setVisible


setZIndex

setZIndex(value): LogAnnotation

Sets z-index for node (set null for default)

Parameters

Name Type Description
valuenumberindex determining node z-position

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.setZIndex


shear

shear(shx, shy): LogAnnotation

Shear this node's bounds

Parameters

Name Type Description
shxnumberx-axis shear
shynumbery-axis shear

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.shear


toString

toString(): string

Returns a string representation of this object (generally the classname)

Returns

string

A string representation

Inherited from

LogFrameVisual.toString


translate

translate(tx, ty): LogAnnotation

Translate bounds

Parameters

Name Type Description
txnumberx translation
tynumbery translation

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.translate


unregisterAnimationStyle

unregisterAnimationStyle(root): void

Unregister animation style.

Parameters

Name Type Description
rootNoderoot node for node

Returns

void

Inherited from

LogFrameVisual.unregisterAnimationStyle


updateSceneTransformation

updateSceneTransformation(): LogAnnotation

Update scene transformation

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.updateSceneTransformation


updateState

updateState(regions?, changes?): LogAnnotation

Update state. These methods reset node state and update state for children. this method is useful to refresh a scene graph

Parameters

Name Type Description
Optional regionsRect[]optional array to return invalid rectangles in the parent coordinates
Optional changesStateChangesoptional parameter to specify a reason of changes

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.updateState


updateTimeStamp

Protected updateTimeStamp(): LogAnnotation

Update time stamp to indicate that Node or Children has been changed.

Returns

LogAnnotation

this

Inherited from

LogFrameVisual.updateTimeStamp


enableSceneGraphNotification

Static enableSceneGraphNotification(enabled): void

Enable / disable all notifications

Parameters

Name Type Description
enabledbooleansets if this object sends notifications

Returns

void

Inherited from

LogFrameVisual.enableSceneGraphNotification


findParent

Static findParent<T>(node, classType, filter?): InstanceType<T>

Find root of the node with specified type

Type parameters

NameType
Textends Constructor<any>

Parameters

Name Type Description
nodeNodenode to start search
classTypeTtype of the class to search for
Optional filter(node: Node) => booleanadditional filter to apply

Returns

InstanceType<T>

Inherited from

LogFrameVisual.findParent

Static findParent(node, classType, filter?): Node

Find root of the node with specified type

Parameters

Name Type Description
nodeNodenode to start search
classTypestringinterface name to search for
Optional filter(node: Node) => booleanadditional filter to apply

Returns

Node

Inherited from

LogFrameVisual.findParent


getClassName

Static getClassName(): string

Returns

string

Inherited from

LogFrameVisual.getClassName


isSceneGraphNotificationEnabled

Static isSceneGraphNotificationEnabled(): boolean

Return status of the global notification for all nodes.

Returns

boolean

Inherited from

LogFrameVisual.isSceneGraphNotificationEnabled