dizmo Storage Tree V1.2

viewer

dizmo's note: The subtree of the «/viewer» node provides all data about the instance of dizmoSpace currently running and allows dizmos to store that should be made available to other dizmos running in this dizmoSpace instance (private subtree) as well as providing access to information shared with the world (public subtree).

Access to this information is provided by the access methods of the viewer object:
viewer.getAttribute("<path>");
viewer.setAttribute("<path>");
viewer.privateStorage.getProperty("<path>"[, {<options>}]);
viewer.privateStorage.setProperty("<path>"[, {<options>}]);
viewer.publicStorage.getProperty("<path>"[, {<options>}]);
viewer.publicStorage.setProperty("<path>"[, {<options>}]);

For more information have a look at the chapters about «Data Tree» and «Persistence» in the developers documentation.

attributes

dizmo's note: The subtree of the «/viewer/attributes» node provides all kinds of information about the instance of dizmoSpace currently running. Access this information using viewer.getAttribute("[info-path]");

childDizmos

dizmo's note: An array of dizmoIDs of all dizmos located on the viewer surface directly

write false
type Array of Strings
range (hexstring)
example ["h3753bff70b74d672524fa570f2fa2567", "hd4413a56a4c5c72f4ad24528757f9850"]

prev-path /dizmos

geometry

dizmo's note: This subtree of the «/viewer/attributes» node provides information about geometry of the surface provided by dizmoSpace. Access these items using viewer.getAttribute("geometry/[info]");

angle

dizmo's note: The rotation at which the surface of dizmoSpace is currently displayed

write true
type Float
range 0..360
default 0

height

dizmo's note: The height of the rectangle of the dizmoSpace surface currently visible.

In order to get the height of the window in which dizmoSpace renders its content in pixels, just multiply this value with the «zoom» factor. If the view is set to «full screen» this corresponds to the height of the screen.

write false
type Integer
range 0..3000
subscribable false

width

dizmo's note: The width of the rectangle of the dizmoSpace surface currently visible. In order to get the width of the window in which dizmoSpace renders its content in pixels, just multiply this value with the «zoom» factor. If the view is set to «full screen» this corresponds to the width of the screen.

write false
type Integer
range 0..3000
subscribable false

x

dizmo's note: The x coordinate of the center of the rectangle of the dizmoSpace surface currently being displayed

write true
type Integer
range -3000..3000
default 0
subscribable true

y

dizmo's note: The y coordinate of the center of the rectangle of the dizmoSpace surface currently being displayed

write true
type Integer
range -3000..3000
default 0
subscribable true

zoom

dizmo's note: The zoom level used to render the currently visible part of the dizmoSpace surface

write true
type Float
range 0.1..10
default 1
subscribable true

windowHeight

dizmo's note: The current height of the dizmo application window

write true
type Integer
range 600..screenHeight
subscribable true

windowWidth

dizmo's note: The current width of the dizmo application window

write true
type Integer
range 800..screenWidth
subscribable true

globalSettings

dizmo's note: This subtree of the «/viewer/attributes» node provides access to all the values read from the basic settings file of dizmoSpace (GlobalSettings.xml). Access them using viewer.getAttribute("globalSettings/[setting]"); For more information about the items available in this subtree have a look at the documentation of the GlobalSettings.xml file. Please be aware, that some values are not available in any case. In example Store_HostUrl and Synchro_HostUrl are only available, when they are set in the GlobalSettings.xml by the user.

Store_HostUrl

dizmo's note: The URL of the server to be used to get new or updated dizmos.

write false
type String
range (hostname)
default "store-api.dizmo.com"

Synchro_HostUrl

dizmo's note: The URL of the server to be used to save and laod dizmo setups

write false
type String
range (hostname)
default "synchro-api.dizmo.com"

...

dizmo's note: There a re many more settings items available in this subtree. For more information have a look at the documentation of the GlobalSettings.xml file.

liveConnections

dizmo's note: Subtree to get different data from the current live connections.

local.otherComputer
userName

dizmo's note: Name of the user on the other connected dizmo space

write false
type String
range Any string
example "kkratzenstein"

prev-path /viewer/openLiveConnections/userName

time

dizmo's note: Time when this connection did start

write false
type unsigned int
range (0 - UINT_MAX)
example

prev-path /viewer/openLiveConnections/time

dizmos

dizmo's note: An array of dizmoIDs of all dizmos currently transmitting from and to the other dizmo space.

write false
type Array of Strings
range (hexstring)
example ["h3753bff70b74d672524fa570f2fa2567", "hd4413a56a4c5c72f4ad24528757f9850"]

prev-path /viewer/openLiveConnections/dizmos

hostName

dizmo's note: The host name of the other dizmo viewer connected over this connection

write false
type String
range (host String)
example "local.otherComputer"

prev-path /viewer/openLiveConnections/hostName

product

dizmo's note: This subtree of the «/viewer/attributes» node provides all kinds of information about the instance of dizmoSpace currently running. Access them using viewer.getAttribute("product/[info]");

licenseKey

dizmo's note: Let the dizmo set a serial number as license key for the current running dizmo space.

write true
read false
type String
range A-Z;0-9

compileDate

dizmo's note: The date and time when the instance of dizmoSpace running was compiled in the format dd.mm.yy hh.mm.
write false
type String
example `"18.12.14 14:54"``

installedDizmoJsVersions

dizmo's note: An array proving the versions of the dizmoJS library installed on the instance of dizmoSpace running

write false
type Array of Strings
example ["1.0", "1.1"]

installedElementsVersions

dizmo's note: An array proving the versions of the dizmoElements library installed on the instance of dizmoSpace running

write false
type Array of Strings
example ["1.0"]

installedThemes

dizmo's note: An array proving the visual themes installed on the instance of dizmoSpace running

write false
type Array of Strings
example ["Default"]

libraries

dizmo's note: A string proving the Qt and rendering library versions used in the instance of dizmoSpace running

write false
type String
example "'Qt 5.3.1' 'WebKit 538.1'"

licensedTo

dizmo's note: The name of the person or organization the instance of dizmoSpace running was licensed to

write true
type String
example "John Doe"

prev-path /viewer/licenseTo

licenseString

dizmo's note: The type of license under which the current instance of dizmoSpace is running

write false
type String
range Standard | ...

treeVersion

dizmo's note: The version of the storage tree the instance of dizmoSpace running provides.

write false
type String
range [0..255].[0..255]
example "1.1"

version

dizmo's note: The version string of the instance of dizmoSpace running in a human readable format

write false
type String
example "1.0r2 Build 760"

versionString

dizmo's note: The version of the instance of dizmoSpace running as a machine readable string composed of four integers separated by dots.

These numbers indicate major version, minor version, development state (100: alpha, 200: beta, 300: release candidate, 400: release) and subversion plus the build number.

write false
type String
example "1.0.402.760"

settings

dizmo's note: This subtree of the «/viewer/attributes» node provides all kinds of parameters about the current configuration of dizmoSpace. Access them using viewer.getAttribute("settings/[setting]");

animationDuration

dizmo's note: The duration in milliseconds for the transition animation to turn a dizmo from its front to its back and vice versa.

write true
type Integer
range 50..3000
default 500

backgroundColor

dizmo's note: The webcolor of the dizmoSpace surface

write true
type String
range (ARGB webcolor)
default "#ffafc809"

backgroundImage

dizmo's note: The URL of the current background image used to draw the surface of dizmoSpace. The image will be tiled if its size is smaller than the size of the surface

write true
type String
range (URL)
default ""
example "file:///Users/jdoe/Pictures/myBackground.png"

themeId

dizmo's note: The number of milliseconds for the transition animation between front and back of a dizmo TBD - range & function are unclear

write true
type String
range (one out of the installedThemes)
default "Default"

displayMode

dizmo's note: A string indicating the display mode currently set for dizmoSpace

write true
type String
range "edit" | "development" | "presentation"
default "edit"
example "development"

fullScreen

dizmo's note: A boolean indicating wether or not dizmoSpace is shown full screen or in a window

write true
type Boolean

language

dizmo's note: The two character ISO 639-1 code of language currently selected

write true
type String
range ISO 639-1 code
example "en"

linkAcceptMode

dizmo's note: The mode for accepting dizmoLive connections. If set to "askuser" dizmoSpace will ask the user before accepting an incoming dizmoLive connection. If set to "silentlive" dizmoSpace will accept any incoming dizmoLive connection immediately. If set to "donotdisturb" dizmoSpace will decline any incoming connections immediately.

write true
type String
range "askuser" | "silentlive" | "donotdisturb"
default "askuser"

userName

dizmo's note: The username provided when logging in to dizmoSpace

write false
type String
default ""default""

setupId

dizmo's note: The name of the current setup. This will change after «Load», «Save», «Clear» and «Rename» Empty string if cleared.

write false
type String
default ""

system

dizmo's note: This subtree of the «/viewer/attributes» node provides all kinds of information about the platform on which dizmoSpace is currently running. Access them using viewer.getAttribute("system/[info]");

closestCity

dizmo's note: The name of the city closest to the location of the device on which dizmoSpace is running

write false
type String
example Zuerich

dizmoAllocatedMemory

dizmo's note: The number of bytes of main physical memory currently allocated to dizmoSpace

write false
type Long
example 275415040

dizmoUsedMemory

dizmo's note: The number of bytes of main physical memory currently used by dizmoSpace

write false
type Long
example 275341312

freeSystemMemory

dizmo's note: The number of bytes of main physical memory available for use on the underlying hardware (real or virtual)

write false
type Long
example 804442112

geoLocation
latitude

dizmo's note: The latitude of the current location of the device on which dizmoSpace is running (-90 indicating the south pole, 90 indicating the north pole)

write false
type Float
range -90..90
example 47.367347

longitude

dizmo's note: The longitude of the current location of the device on which dizmoSpace is running (>0 indicating east of Greenwich, >0 west of Greenwich)

write false
type Float
range -90..90
example 8.5500025

openGl

dizmo's note: Indicates if the underlying hard- and software support rendering based on openGL

write false
type Boolean

openGlVersion

dizmo's note: Provides the version of openGL (if available) running on the underlying hard- and software

write false
type String
example "3.2"

operatingSystem

dizmo's note: A string describing the type and version of the operating system on which dizmoSpace is currently running

type String
examples "Mac OS X 10.8"

systemArchitecture

dizmo's note: The architecture for which the running version of dizmoSpace has been compiled for

type String
examples macosx

systemMemory

dizmo's note: The number of bytes of main physical memory installed in the underlying hardware (real or virtual)

write false
type Long
example 8589934592

ipv4address

dizmo's note: The IPv4 address of the device on which this instance of dizmoSpace is running in Dot-decimal notation. Cleared from self loops, peer2peer and inactive connections.

write false
type List of strings (Dot-decimal)
example ["192.168.0.3", "192.168.57.1"]

ipv6address

dizmo's note: The IPv6 address of the device on which this instance of dizmoSpace is running in Colon-hex notation. Cleared from self loops, peer2peer and inactive connections.

write false
type List of strings (Colon-hex)
example ["fe80::344d:6e34:bc92:4abf%10", "fe80::64d5:792:ffeb:bf3f%23", "fe80::819e:9c33:87d3:4a%24"]

public

dizmo's note: Nodes stored in this part of the viewer tree will be accessible from the network in the future. Use viewer.publicStorage().getProperty("[anypath]") to access such a global node.

The URL to access a public node at "/viewer/public/mypath/node" will be something like "http://host.example.com:3418/viewer/public/mypath/node". This will either be made available through AJAX or potentially by providing access functions like getPropertyHttp("10.0.5.22:3418", "/viewer/public/mypath/node");

private

dizmo's note: Nodes stored in this part of the viewer tree will be accessible for all dizmos that are instantiated locally. Use viewer.privateStorage().getProperty("[anypath]") to access such a local node.

dizmos

dizmo's note: The subtree of the «/dizmos» node provides access to the data about all the dizmos instantiated in the dizmoSpace currently running. It does so by providing one node for every dizmo using the dizmoID as its name.

Each of these dizmo nodes provides three subtrees providing attributes of a dizmo as well as access to its public and private data. Data in the private subtree can only be accessed by the dizmo that hold this node while data in the public subtree can be accessed by any dizmo that has access to that part of the data tree.

Access to a dizmos information is provided by the following access methods:
dizmo.getAttribute("<path>");
dizmo.setAttribute("<path>");
dizmo.privateStorage.getProperty("<path>"[, {<options>}]);
dizmo.privateStorage.setProperty("<path>"[, {<options>}]);
dizmo.publicStorage.getProperty("<path>"[, {<options>}]);
dizmo.publicStorage.setProperty("<path>"[, {<options>}]);

For more information have a look at the chapters about «Data Tree» and «Persistence» in the developers documentation.

h3753bff70b74d672524fa570f2fa2567

dizmo's note: The name of this node is a dizmoID that is used to identify a particular instance of a dizmo. So the name of the node given here is just an example. In an actual environment expect there to be several of these nodes but all of them sharing the same structure as shown this example.

attributes

dizmo's note: The subtree of the «/dizmos/[dizmoID]/attributes» node provides all kinds of information about the particular instance of a dizmo. Access this information using dizmo.getAttribute("[info-path]");

lastError

dizmo's note: The last raised error code from this dizmo.

write false
type Integer
default 0

parentDizmo

dizmo's note: The dizmoID of the dizmo on which this one is located. Empty string if this is the dizmoSpace surface. Setting a new parent is possible but restricted by several criteria to ensure conceptual & visual integrity of the dizmos on the surface, have a look at the documentation about setting the parent for more detailed information.

write true
example "h2753bff704c4d672524fa570f2fa28af"

childDizmos

dizmo's note: An array of dizmoIDs of all dizmos located on this dizmo directly

write false
type Array of Strings
range (hexstring)
example ["h3753bff70b74d672524fa570f2fa2567", "hd4413a56a4c5c72f4ad24528757f9850"]

dockedDizmos

dizmo's note: An array of dizmoIDs of all dizmos docked to this dizmo directly

write false
type Array of Strings
range (hexstring)
example ["h96753bff70b74d672524fa570f2fa25ca3", "h21413a56a4c5c72f4ad24528757f989a"]

bundleId

dizmo's note: The bundleID of the bundle used to create this dizmo instance. This can be used to access more information about this dizmo by accessing bundle.getAttributes("version");

write false
example com.dizmo.example

created

dizmo's note: The time when the dizmo was created in milliseconds since midnight of January 1, 1970, according to UTC time. Use
d = new Date(parseInt(dizmo.getAttribute("created")));
to get a date object representing the creation time.

write false
example 1420987102320

geometry

dizmo's note: This subtree of the «/dizmos/[dizmoID]/attributes» node provides information about geometry of the dizmo. Access these items using dizmo.getAttribute("geometry/[info]");

angle

dizmo's note: The rotation at which the dizmo is displayed on the surface of dizmoSpace. A value of «0» means the dizmo is dawn upright

write true
type Float
range 0..360
default 0

height

dizmo's note: The height of the rectangle of the dizmo in pixels

write true
type Integer
range 0..3000

maxHeight

dizmo's note: The maximum height of the dizmo content in pixels. The user using the resize handle, cannot make the dizmo larger in height than this value

write true
type Integer
range 0..3000

maxWidth

dizmo's note: The maximum width of the dizmo content in pixels. The user using the resize handle, cannot make the dizmo larger in width than this value

write true
type Integer
range 0..3000

minHeight

dizmo's note: The minimal height of the dizmo content in pixels. The user using the resize handle, cannot make the dizmo smaller in height than this value

write true
type Integer
range 0..3000

minWidth

dizmo's note: The minimal width of the dizmo content in pixels. The user using the resize handle, cannot make the dizmo smaller in width than this value

write true
type Integer
range 0..3000

width

dizmo's note: The width of the rectangle of the dizmo in pixels

write true
type Integer
range 0..3000

x

dizmo's note: The x coordinate of the top left of the rectangle of the dizmo

write true
type Integer
range 0..30000
default 0

y

dizmo's note: The y coordinate of the top left of the rectangle of the dizmo

write true
type Integer
range 0..30000
default 0

zoom

dizmo's note: The zoom factor used to render the dizmo on the dizmoSpace surface. A value of 1 means the dizmo is drawn the way it has been described by the original HTML and CSS code

write true
type Float
range 0..10
default 1

stickyGeometry

dizmo's note: This subtree of the «/dizmos/[dizmoID]/attributes» node provides information about geometry of the dizmo when it is made sticky. This is rather different from the standard geometry as it is based on a different coordinate system. Access these items using dizmo.getAttribute("stickyGeometry/[info]");

angle

dizmo's note: The rotation at which the dizmo is displayed on the «sticky layer». A value of «0» means the dizmo is dawn upright

write true
type Float
range 0..360
default 0

left

dizmo's note: When resizing the dizmoSpace window, a sticky dizmo remembers which border it's relative to: true if the sticky position of the dizmo is relative to left, otherwise to right.
When set to false, x needs to be negative.

write true
type Boolean
default

top

dizmo's note: When resizing the dizmoSpace window, a sticky dizmo remembers which border it's relative
to: true if the sticky position of the dizmo is relative to top, otherwise bottom.
When set to false, y needx to be negative.

write true
type Boolean
default

x

dizmo's note: The x position of the top left of the rectangle of the dizmo measured in pixels of the visible surface of dizmoSpace

write true
type Integer
range 0..(width of dizmoSpace)

y

dizmo's note: The y position of the top left of the rectangle of the dizmo measured in pixels of the visible surface of dizmoSpace

write true
type Integer
range 0..(height of dizmoSpace)

zoom

dizmo's note: The zoom factor used to render the dizmo on the «sticky layer». A value of 1 means the dizmo is drawn the way it has been described by the original HTML and CSS code

write true
type Float
range 0..10
default 1

modified

dizmo's note: The time when the dizmo was last modified in milliseconds since midnight of January 1, 1970, according to UTC timeUse
d = new Date(parseInt(dizmo.getAttribute("modified")));
to get a date object representing the creation time.

write false
example 1420987102320

settings

dizmo's note: This subtree of the «/dizmos/[dizmoID]/attributes» node provides information about the settings of the dizmo mostly controlled by the user. Access these items using dizmo.getAttribute("settings/[info]");

urlToOpen

dizmo's note: The current Url of the TinyBrowser.

write true
type String
range (URI)

frameColor

dizmo's note: The webcolor currently used to draw the frame of the dizmo

write true
type String
range (ARGB webcolor)
default "#ffafc809"

frameImage

dizmo's note: The URL of the current background image used to draw the frame of the dizmo

write true
type String
range (URL)
default ""
example "file:///Users/jdoe/Pictures/myBackground.png"

frameOpacity

dizmo's note: The opacity used to draw the frame of the dizmo. This a percentage given as a number between 0 and 1 where 1 means the dizmo's frame os fully opaque, i.e. intransparent

write true
type Float
range 0.15..1
default 1

iconDarkImage

dizmo's note: The URI of the icon of this dizmo instance to be used on a «dark» background. In most cases this will be equal to the URI of the bundle «dark icon» but it can be changed by the dizmo

write true
type URI
example file:///assets/Icon-dark.svg

iconImage

dizmo's note: The URI of the icon of this dizmo instance. In most cases this will be equal to the URI of the bundle icon. However this URI can be changed by the dizmo to display an alert for example

write true
type URI
example file:///assets/Icon.png

removeFadeTime

dizmo's note: The time in milliseconds to remove a dizmo from the current setup. Set this to be longer the more data will be lost when a dizmo is removed. I.e. right after instantiating a dizmo this value can be close to zero. The more data has been entered or collected the higher this number should. However for practical reasons it should usually not be larger than 5000 milliseconds

write true
type Integer
range 0..5000
default 3000

title

dizmo's note: The current title of the dizmo

write true
type String
example "Example dizmo"

titleColor

dizmo's note: The webcolor of the title text

write true
type String
range (ARGB webcolor)
default "#ffafc809"

userControls

dizmo's note: This subtree of the «/dizmos/[dizmoID]/attributes/settings» node defines which parts of the user controls are available to the user. Most of them concern the context menu of the dizmo. Access these items using dizmo.getAttribute("settings/userControls/[element]");

allowBackground

dizmo's note: If this flag is set to true the user will be able to set an image as the background of the dizmo using the context menu of the dizmo.

write true
type Boolean
default true

allowColor

dizmo's note: If this flag is set to true the user will be able to change the background color of the dizmo using the context menu of the dizmo.

write true
type Boolean
default true

allowLock

dizmo's note: If this flag is set to true the user will be able to lock and unlock a dizmo using the context menu of the dizmo.

write true
type Boolean
default true

allowOpacity

dizmo's note: If this flag is set to true the user will be able to change the opacity of the frame of the dizmo using its context menu

write true
type Boolean
default true

allowRemove

dizmo's note: If this flag is set to true the user will be able to remove this dizmo instance by using the context menu of the dizmo.

write true
type Boolean
default true

allowResize

dizmo's note: If this flag is set to true the user will be able to change the size and side ration of the dizmo using the handle on the bottom right corner of the dizmo.

write true
type Boolean
default true

allowSticky

dizmo's note: If this flag is set to true the user will be able to make a dizmo «sticky», i.e. making it hover over the other dizmos, using the context menu of the dizmo.

write true
type Boolean
default true

allowTitle

dizmo's note: If this flag is set to true the user will be able to change the title of the dizmo using the context menu of the dizmo.

write true
type Boolean
default true

allowZoom

dizmo's note: If this flag is set to true the user will be able to zoom the dizmo using the handle in the bottom left corner of the dizmo.

write true
type Boolean
default true

state

dizmo's note: This subtree of the «/dizmos/[dizmoID]/attributes» node provides information about the state of the dizmo and the way it is displayed depending on these settings. Access these items using dizmo.getAttribute("state/[info]");

feetlineHidden

dizmo's note: True when the feet line of the dizmo is hidden. That is just a space between dark background of the back and the bottom line, to give a visual counterpart to the title line.

write true
type Boolean
default true

frameHidden

dizmo's note: True when the frame of the dizmo is hidden.

write true
type Boolean
default false

titleHidden

dizmo's note: If this flag is set to true the titlebar of the dizmo will be made invisible while still allowing the user «grab» the area above the dizmo to drag it around.

write true
type Boolean
default false

front

dizmo's note: If this flag is set to true the dizmo will be shown with its front side. If necessary a transition animation will be shown when turning the dizmo around. This animation need to be init by the dizmo.js implementation.

write true
type Boolean
default true

focused

dizmo's note: This flag is set to true if the dizmo has the focus for user interaction events.

write false
type Boolean
default false

closing

dizmo's note: This attribute is set to true by dizmo space while a dizmo is «closing» i.e. as long as it is in the visual phase of fading out. If this is set to false during this phase, deletion will be stopped the same way this happens when a user clicks the dizmo while it is fading out.

write true
type Boolean
default false

dragging

dizmo's note: This flag is set to true, while a dizmo is being dragged around by the user. So subscribing to it and interpreting the transition the dizmo can get notified when dragging starts or stops.

write false
type Boolean
default false

hidden

dizmo's note: If this flag is set to true the dizmo hidden, i.e. it wil not be visible to the user anymore. Nevertheless it will still exist and run.

write true
type Boolean
default false

iconized

dizmo's note: If this flag is set to true the dizmo will be «iconized», i.e. instead of showing the entire dizmo, dizmoSpace will only draw its icon.

write true
type Boolean
default false

locked

dizmo's note: If this flag is set to true the dizmo will be locked. This will make it impossible for the user to move, rotate, resize, remove or in any other way change the dizmo frame. However the content of the dizmo will still be available for interaction without limitation.

write true
type Boolean
default false

sticky

dizmo's note: If this flag is set to true the dizmo will be made «sticky», i.e. make it hover over the other dizmos.

write true
type Boolean
default false

public

dizmo's note: Nodes stored in this part of the dizmo tree will be accessible from all other dizmos in the same dizmoSpace. Use dizmo.publicStorage().getProperty("[anypath]") to access such a node.

This is also where you should provide data for other dizmos that are docked or put onto to yours.

private

dizmo's note: Nodes stored in this part of the dizmo tree will be accessible from the dizmo itself only. Use dizmo.privateStorage().getProperty("[anypath]") to access such a node.

bundles

dizmo's note: The subtree of the «/bundles» node provides access to the data about all the bundles installed in the dizmoSpace currently running. It does so by providing one node for every bundle using the bundleID as its name.

Each of these bundle nodes provides three subtrees providing attributes of a bundle as well as access to its public and private data. Data in the private subtree can only be accessed by dizmos that have been created using this bundle while data in the public subtree can be accessed by any dizmo that has access to that part of the data tree.

Access to a dizmos information is provided by the following access methods:
bundle.getAttribute("<path>");
bundle.setAttribute("<path>");
bundle.privateStorage.getProperty("<path>"[, {<options>}]);
bundle.privateStorage.setProperty("<path>"[, {<options>}]);
bundle.publicStorage.getProperty("<path>"[, {<options>}]);
bundle.publicStorage.setProperty("<path>"[, {<options>}]);

For more information have a look at the chapters about «Data Tree» and «Persistence» in the developers documentation.

com.dizmo.example

dizmo's note: The name of this node is a bundleID (in reverse domain name notation) that is used to identify a particular bundle (the source items of a dizmo). So the name of the node given here is just an example. In an actual environment expect there to be several of these nodes but all of them sharing the same structure as shown in this example.

attributes

dizmo's note: The subtree of the «/bundles/[bundleID]/attributes» node provides all kinds of information about the particular bundle used to instantiate dizmos of this particular kind. Access this information using bundle.getAttribute("[info-path]");

author

dizmo's note: The name of the developer who developed this bundle.

write false
type String
example "John H. Doe"

category

dizmo's note: The category under which the developer of this bundle has published his work. This information is read from the Category parameter of the bundle's Info.plist file

write false
type String
range (see developers documentation)
example "tools"

description

dizmo's note: The description the developer of this bundle has provided with his work. This information is read from the Description parameter of the bundle's Info.plist file

write false
type String
example "An example dizmo proudly presented by John H. Doe"

dizmoInstances

dizmo's note: An array of the dizmoIDs of all dizmos instantiated based on this bundle

write false
type Array of Strings
range (hexstring)
example ["h8bc3bff70b74d672524fa570f2fa2599", "h52413a56a4c5c72f4ad24528757f99b2"]

dizmoJsVersion

dizmo's note: The version of the dizmoJS API library this bundle uses. This information is read from the ApiVersion parameter of the bundle's Info.plist file

write false
type String
range [0..255].[0..255]
example "1.2"

elementsVersion

dizmo's note: The version of the dizmoElements library this bundle uses. This information is read from the ElementsVersion parameter of the bundle's Info.plist file

write false
type String
range [0..255].[0..255]
example "1.0"

hidden

dizmo's note: This flag is true for dizmos that will never appear in the creator because they are instantiated by other interaction elements. The «About» and the «Creator» dizmos are some good examples of this type of dizmos

write false
type Boolean

iconDarkImage

dizmo's note: The URI of the icon of this bundle to be used on a «dark» background.

write false
type URI
example file:///assets/Icon-dark.svg

iconImage

dizmo's note: The URI of the icon of this bundle

write false
type URI
example file:///assets/Icon.png

internal

dizmo's note: This flag is true for dizmos are prebuilt into dizmoSpace and can therefore not be removed by the user. The «Pad» or the «Tiny Browser» dizmos are some good examples of this type of dizmos

write false
type Boolean

languages

dizmo's note: An array of ISO 639-1 codes listing the languages supported by this bundle

write false
type Array of Strings
range ISO 639-1 code
example ["en", "de", "fr"]

minSpaceVersion

dizmo's note: The minimum version of dizmoSpace this bundle needs to successfully instantiate dizmos. The version must be composed of three integers separated by dots. This information is read from the MinSpaceVersion parameter of the bundle's Info.plist file

write false
type String
range [0..255].[0..255].[0..255]
example "1.2"

name

dizmo's note: The of a bundle shown in the Creator dizmo. This information is read from the BundleName parameter of the bundle's Info.plist file

write false
type String
example "Example"

title

dizmo's note: The default title displayed for a dizmo instantiated from this bundle. This information is read from the BundleDisplayName parameter of the bundle's Info.plist file

write false
type String
example "One Example"

tags

dizmo's note: An array tags that have been associated by the developer with this bundle

write false
type Array of Strings
example ["chess", "2player", "easy"]

version

dizmo's note: A string indicating the version / build for this bundle which is meant to be human readable. This information is read from the BundleVersion parameter of the bundle's Info.plist file

write false
type String
example "1.0b2 Build 344"

versionString

dizmo's note: The version of the instance of this bundle as a machine readable string composed of three integers separated by dots, the numbers indicate major version, minor version and update version. This information is read from the BundleShortVersionString parameter of the bundle's Info.plist file

write false
type String
range [0..255].[0..255].[0..255]
example "1.0.15"

public

dizmo's note: Nodes stored in this part of the dizmo tree will be accessible from all other dizmos in the same dizmoSpace. Use bundle.publicStorage().getProperty("[anypath]") to access such a node.

private

dizmo's note: Nodes stored in this part of the dizmo tree will be accessible only from all the dizmos that have been instantiated using the bundle this subtree belongs to. Use bundle.privateStorage().getProperty("[anypath]") to access such a node.