digitalsignage.com - open source docs digitalsignage.com - open source docs

  • API Docs for Version: 1.5.118

    • APIs

    Show:

    BlockLocation Class

    Extends Block
    Defined in: _controllers\_blocks\BlockLocation.js:1

    BlockLocation resides inside a scene or timeline and manages internal playback of scenes and resources

    Constructor

    BlockLocation

    (
    • i_placement
    • i_campaign_timeline_chanel_player_id
    )
    Object

    Defined in _controllers\_blocks\BlockLocation.js:1

    Parameters:

    • i_placement String

      location where objects resides which can be scene or timeline

    • i_campaign_timeline_chanel_player_id String

      required and set as block id when block is inserted onto timeline_channel

    Returns:

    Object:

    Block instance

    Methods

    _addLocationItem

    (
    • e
    • type
    )

    Defined in _controllers\_blocks\BlockLocation.js:490

    Add to our XML a list item item which can be of one of two types addDefault: a default resource to play when not within radius of GPS coords addLocation: a particular resource to play within specific GPS coords

    Parameters:

    • e Event
    • type String

      addDefault or addLocation

    _alphaPopulate

    ()

    Inherited from Block: _controllers\_blocks\Block.js:184

    On changes in msdb model updated UI common alpha properties

    _announceBlockChanged

    (
    • i_player_data
    )

    Inherited from Block: _controllers\_blocks\Block.js:671

    Announce that this block has changed

    Parameters:

    • i_player_data Number

    _bgPropsPopulate

    ()

    Inherited from Block: _controllers\_blocks\Block.js:219

    On changes in msdb model updated UI common gradient background properties

    _bgPropsUnpopulate

    ()

    Inherited from Block: _controllers\_blocks\Block.js:261

    Disable the gradient background UI

    _borderPropsPopulate

    ()

    Inherited from Block: _controllers\_blocks\Block.js:243

    On changes in msdb model updated UI common border properties

    _borderPropsUnpopulate

    ()

    Inherited from Block: _controllers\_blocks\Block.js:275

    Disable the border UI

    _deleteBlock

    (
    • i_memoryOnly
    )

    Inherited from Block: _controllers\_blocks\Block.js:768

    Delete block is a private method that is always called regardless if instance has been inherited or not. Used for releasing memory for garbage collector.

    Parameters:

    • i_memoryOnly Boolean

      if true only remove from existance but not from msdb

    Returns:

    none

    _enableBgSelection

    ()

    Inherited from Block but overwritten in _controllers\_blocks\Block.js:198

    Enable gradient background UI

    _fabricAlpha

    (
    • i_domPlayerData
    )

    Inherited from Block: _controllers\_blocks\Block.js:800

    Fabricate alpha to canvas

    Parameters:

    • i_domPlayerData Object

    _fabricateBorder

    (
    • i_options
    )
    Object

    Inherited from Block: _controllers\_blocks\Block.js:831

    Config the fabric block border

    Parameters:

    • i_options I_options

    Returns:

    Object:

    object literal

    _fabricateOptions

    (
    • i_top
    • i_left
    • i_width
    • i_height
    • i_angle
    )
    Object

    Inherited from Block: _controllers\_blocks\Block.js:849

    Build the options injected into a newly created fabric object

    Parameters:

    • i_top Number
    • i_left Number
    • i_width Number
    • i_height Number
    • i_angle Number

    Returns:

    Object:

    object literal

    _fabricColorPoints

    (
    • i_domPlayerData
    )

    Inherited from Block: _controllers\_blocks\Block.js:812

    Fabricate color points to canvas

    Parameters:

    • i_domPlayerData Xml

    _fabricLock

    ()

    Inherited from Block: _controllers\_blocks\Block.js:120

    On changes in msdb model updated UI common lock properties

    _fabricRect

    (
    • i_width
    • i_height
    • i_domPlayerData
    )
    Object

    Inherited from Block: _controllers\_blocks\Block.js:879

    Fabricate color points to canvas

    Parameters:

    • i_width Number
    • i_height Number
    • i_domPlayerData Xml

    Returns:

    Object:

    r fabric js rectangular

    _findBackground

    (
    • i_domPlayerData
    )
    Xml

    Inherited from Block: _controllers\_blocks\Block.js:446

    Find the background section in player_data for selected block

    Parameters:

    • i_domPlayerData Object

    Returns:

    Xml:

    xSnippet

    _findBorder

    (
    • i_domPlayerData
    )
    Xml

    Inherited from Block: _controllers\_blocks\Block.js:458

    Find the border section in player_data for selected block

    Parameters:

    • i_domPlayerData Object

    Returns:

    Xml:

    xSnippet

    _findGradientPoints

    (
    • i_domPlayerData
    )
    Xml

    Inherited from Block: _controllers\_blocks\Block.js:469

    Find the gradient blocks in player_data for selected block

    Parameters:

    • i_domPlayerData Object

    Returns:

    Xml:

    xSnippet

    _getBlockPlayerData

    () Object

    Inherited from Block: _controllers\_blocks\Block.js:721

    Get the XML player data of a block, depending where its placed If you like to view XML raw data, be sure to debug domPlayerData.children[0].outerHTML

    Returns:

    Object:

    player data of block (aka player) parsed as DOM

    _getLocationPageNames

    ()

    Defined in _controllers\_blocks\BlockLocation.js:667

    Get all the location pages names for current location block this is called against the last block instance that registered the global function of setLocationBlockGlobalValidationOwner

    _googleMap

    (
    • i_markerOnClick
    • i_reloadData
    • i_loadStackView
    )

    Defined in _controllers\_blocks\BlockLocation.js:570

    Open google maps and load it with all current locations

    Parameters:

    • i_markerOnClick Boolean

      set to true if we are going to expect user to add a new location or false if we just want to open an existing map and not add any new locations

    • i_reloadData Boolean

      reload the map with fresh data, used when we delete map items and want to force a refresh

    • i_loadStackView Boolean

      animate the slider StackView into position

    _initSubPanel

    (
    • i_panel
    )

    Inherited from Block: _controllers\_blocks\Block.js:100

    Init the sub properties panel for a block

    Parameters:

    • i_panel String

    _isSceneCyclic

    (
    • i_playerData
    )
    Boolean

    Defined in _controllers\_blocks\BlockLocation.js:469

    Check if scene is pointing to itself to avoid cyclic reference

    Parameters:

    • i_playerData Number

    Returns:

    Boolean:

    true if cyclic reference

    _jumpToLocation

    (
    • i_index
    )

    Defined in _controllers\_blocks\BlockLocation.js:339

    Select specific location and populate both the UI as well scroll map to coordinates

    Parameters:

    • i_index String

    _listenAddPoint

    (
    • i_playerData
    )
    Number

    Defined in _controllers\_blocks\BlockLocation.js:86

    Listen to adding a new point from google maps, and if we pending for addition, take action

    Parameters:

    • i_playerData Number

    Returns:

    Number:

    Unique clientId.

    _listenAddResource

    ()

    Defined in _controllers\_blocks\BlockLocation.js:430

    Listen to add new resource and when clicked, wait for announcement from AddBlockListView that a new resource or scene needs to be added to either the default play list (aka Fixed) or to the Location based play list (aka GPS)

    _listenAlphaChange

    ()

    Inherited from Block: _controllers\_blocks\Block.js:165

    Listen to changes in Alpha UI properties selection and update msdb

    _listenBackgroundStateChange

    ()

    Inherited from Block but overwritten in _controllers\_blocks\Block.js:360

    Listen to change in background enable / disable states

    _listenBlockSelected

    ()

    Inherited from Block: _controllers\_blocks\Block.js:481

    Notify this object that it has been selected so it can populate it's own the properties box etc The function triggers from the BLOCK_SELECTED event.

    Returns:

    none

    _listenBorderColorChange

    ()

    Inherited from Block: _controllers\_blocks\Block.js:415

    Update a block's player_data with new border background

    _listenGradientChange

    ()

    Inherited from Block but overwritten in _controllers\_blocks\Block.js:382

    Update a block's player_data with new gradient background

    _listenLiveInputs

    ()

    Defined in _controllers\_blocks\BlockLocation.js:201

    Listen to changes in LiveInputs including resource names, long and lat values

    _listenLocationRowChanged

    ()

    Defined in _controllers\_blocks\BlockLocation.js:249

    Listen to when location row was edited

    _listenMenuControls

    ()

    Defined in _controllers\_blocks\BlockLocation.js:142

    Listen to location controls, add remove, next, add ...

    _listenPriorityChange

    ()

    Defined in _controllers\_blocks\BlockLocation.js:53

    Listen to changes in priority

    _listenRadiusChange

    ()

    Defined in _controllers\_blocks\BlockLocation.js:120

    Listen to changes in radius per selected location

    _listenRemoveResource

    ()

    Defined in _controllers\_blocks\BlockLocation.js:605

    Listen to when removing a resource from location list The algorithm will uses our bootstrap-table own inject rowIndex value and counts up to match with the order of in msdb location, once matched against same value we delete the proper ordered location item from msdb and refresh the entire table

    _listenVolumeChange

    ()

    Defined in _controllers\_blocks\BlockLocation.js:275

    Listen to changes in volume control

    _listenVolumeChange

    ()

    Defined in _controllers\_blocks\BlockLocation.js:186

    Listen to changes in row due to drag

    _loadBlockSpecificProps

    ()

    Defined in _controllers\_blocks\BlockLocation.js:635

    Populate the common block properties panel, called from base class if exists

    Returns:

    none

    _onBlockLengthChanged

    ()

    Inherited from Block: _controllers\_blocks\Block.js:617

    Take action when block length has changed which is triggered by the BLOCK_LENGTH_CHANGING event

    Returns:

    none

    _onBlockSelected

    ()

    Inherited from Block: _controllers\_blocks\Block.js:499

    When a block is selected, find out where is it placed (scene/ channel) and change props accordingly

    _populate

    ()

    Defined in _controllers\_blocks\BlockLocation.js:295

    The main functions which renders and loads up the entire property panel with both default resource list as well as map location coordinates list

    Returns:

    none

    _populatePriority

    (
    • i_value
    )

    Defined in _controllers\_blocks\BlockLocation.js:75

    Populate the priority widget

    Parameters:

    • i_value Number

    _populateRadius

    (
    • i_value
    )

    Defined in _controllers\_blocks\BlockLocation.js:312

    Populate the radius UI element

    Parameters:

    • i_value Object

    _populateTableDefault

    (
    • i_domPlayerData
    )

    Defined in _controllers\_blocks\BlockLocation.js:398

    Load list into the UI for default content

    Parameters:

    • i_domPlayerData Object

    _populateTotalMapLocations

    (
    • domPlayerData
    )

    Defined in _controllers\_blocks\BlockLocation.js:322

    Populate the total map locations set

    Parameters:

    • domPlayerData Object

    _removeLocation

    ()

    Defined in _controllers\_blocks\BlockLocation.js:164

    Remove current selected location

    _selfDestruct

    ()

    Inherited from Block: _controllers\_blocks\Block.js:750

    bug fix: backward comparability with player_data that includes deleted resources this was already fixed but we live _selfDestruct for backwards compatability

    _setBlockPlayerData

    (
    • i_xmlDoc
    • [i_noNotify]
    • [i_xmlIsString]
    )

    Inherited from Block: _controllers\_blocks\Block.js:681

    Update the msdb for the block with new values inside its player_data

    Parameters:

    • i_xmlDoc Object

      the dom object to save to local msdb

    • [i_noNotify] String optional

      if set, fire event announcing data saved

    • [i_xmlIsString] Boolean optional

      if set, bypass serializeToString since already in string format

    _setLocationBlockGlobalValidationOwner

    ()

    Defined in _controllers\_blocks\BlockLocation.js:646

    re-take ownership for a caller block instance and register global Validators for bootstrap-table to format data This function has to run everytime we populate the UI since it is a shared global function and we have to override it so 'this' refers to correct BlockLocation instance

    _toggleBackgroundColorHandler

    (
    • e
    )

    Inherited from Block but overwritten in _controllers\_blocks\Block.js:288

    Toggle block background on UI checkbox selection

    Parameters:

    • e Event

    _toggleLock

    ()

    Inherited from Block: _controllers\_blocks\Block.js:144

    Toggle lock status

    _updateBlockDimensions

    ()

    Inherited from Block: _controllers\_blocks\Block.js:596

    Update the position of the block when placed inside a scene

    _updateBlockLength

    ()

    Inherited from Block: _controllers\_blocks\Block.js:570

    Update the length properties of the block with respect to position on the timeline_channel

    Returns:

    none

    _updateTitle

    ()

    Inherited from Block: _controllers\_blocks\Block.js:546

    Update the title of the block inside the assigned element.

    Returns:

    none

    _viewSubPanel

    (
    • i_panel
    )

    Inherited from Block: _controllers\_blocks\Block.js:110

    Bring into view a sub properties panel of this block

    Parameters:

    • i_panel String

    deleteBlock

    (
    • i_memoryOnly
    )

    Inherited from Block but overwritten in _controllers\_blocks\BlockLocation.js:683

    Delete this block

    Parameters:

    • i_memoryOnly Boolean

      if true only remove from existance but not from msdb

    fabricateBlock

    ()

    Inherited from Block: _controllers\_blocks\Block.js:901

    Convert the block into a fabric js compatible object, called externally on creation of block

    getBlockData

    () Object

    Inherited from Block: _controllers\_blocks\Block.js:946

    Get block data as a json formatted object literal and return to caller

    Returns:

    Object:

    data The entire block data members which can be made public

    getZindex

    (
    • i_index
    )

    Inherited from Block: _controllers\_blocks\Block.js:980

    Get a block's z-index

    Parameters:

    • i_index Number

    initialize

    ()

    Inherited from Block but overwritten in _controllers\_blocks\BlockLocation.js:14

    Constructor

    m_blockAcronym

    ()

    Inherited from Block: _controllers\_blocks\Block.js:556

    Update the title of the selected tab properties element

    setZindex

    (
    • i_index
    )

    Inherited from Block: _controllers\_blocks\Block.js:969

    Set a block's z-index in case we know it (i.e.: it is going to be a re-render of a previous block that was removed from the canvas)

    Parameters:

    • i_index Number

    Events

    Block.BLOCK_BORDER_CHANGE

    Inherited from Block: _controllers\_blocks\Block.js:29

    event fires when block border changed so scene needs to be re-rendered

    Event Payload:

    • caller This
    • selected String

      block_id

    Block.BLOCK_SELECTED

    Inherited from Block: _controllers\_blocks\Block.js:46

    event fires when block is selected

    Event Payload:

    • caller This
    • selected String

      block_id

    Block.SCENE_BLOCK_CHANGE

    Inherited from Block: _controllers\_blocks\Block.js:21

    event fires when scene block was changed so scene needs to be re-rendered

    Event Payload:

    • caller This
    • selected String

      block_id

    Block.SCENE_BLOCKS_RENDERED

    Inherited from Block: _controllers\_blocks\Block.js:37

    event fires when scene blocks freshly re-rendered onto the scene canvas so we need to update the UI of ALL blocks normally occurs after a Block.SCENE_BLOCK_CHANGE event

    Event Payload:

    • caller This
    • selected String

      block_id