Class Index | File Index

Classes


Class HomeXMLHandler


Extends DefaultHandler.

Defined in: SweetHome3D.js.

Class Summary
Constructor Attributes Constructor Name and Description
 
HomeXMLHandler(preferences)
SAX handler for Sweet Home 3D XML stream.
Method Summary
Method Attributes Method Name and Description
 
characters(ch, start, length)
 
createPrint(attributes)
Returns a new HomePrint instance initialized from the given attributes.
 
 
endElement(uri, localName, name)
 
Returns the home read by this handler.
 
resolveObject(elementObject, elementName, attributes)
Returns the object that will be stored in a home.
 
setCameraAttributes(camera, elementName, attributes)
Sets the attributes of the given camera.
 
setCompassAttributes(compass, elementName, attributes)
Sets the attributes of the given compass.
 
setDimensionLineAttributes(dimensionLine, elementName, attributes)
Sets the attributes of the given dimension line.
 
setHome(home)
Sets the home that will be updated by this handler.
 
setHomeAttributes(home, elementName, attributes)
Sets the attributes of the given home.
 
setLabelAttributes(label, elementName, attributes)
Sets the attributes of the given label.
 
setLevelAttributes(level, elementName, attributes)
Sets the attributes of the given level.
 
setPieceOfFurnitureAttributes(piece, elementName, attributes)
Sets the attributes of the given piece.
 
setPolylineAttributes(polyline, elementName, attributes)
Sets the attributes of the given polyline.
 
setRoomAttributes(room, elementName, attributes)
Sets the attributes of the given room.
 
setWallAttributes(wall, elementName, attributes)
Sets the attributes of the given wall.
 
 
startElement(uri, localName, name, attributes)
Class Detail
HomeXMLHandler(preferences)
SAX handler for Sweet Home 3D XML stream. Read home should respect the following DTD:
<!ELEMENT home (property*, furnitureVisibleProperty*, environment?, backgroundImage?, print?, compass?, (camera | observerCamera)*, level*,
(pieceOfFurniture | doorOrWindow | furnitureGroup | light)*, wall*, room*, polyline*, dimensionLine*, label*)>
<!ATTLIST home
version CDATA #IMPLIED
name CDATA #IMPLIED
camera (observerCamera | topCamera) "topCamera"
selectedLevel CDATA #IMPLIED
wallHeight CDATA #IMPLIED
basePlanLocked (false | true) "false"
furnitureSortedProperty CDATA #IMPLIED
furnitureDescendingSorted (false | true) "false">

<!ELEMENT property EMPTY>
<!ATTLIST property
name CDATA #REQUIRED
value CDATA #REQUIRED>

<!ELEMENT furnitureVisibleProperty EMPTY>
<!ATTLIST furnitureVisibleProperty name CDATA #REQUIRED>

<!ELEMENT environment ((camera | observerCamera)*, texture?, texture?) >
<!ATTLIST environment
groundColor CDATA #IMPLIED
skyColor CDATA #IMPLIED
lightColor CDATA #IMPLIED
wallsAlpha CDATA "0"
allLevelsVisible (false | true) "false"
observerCameraElevationAdjusted (false | true) "true"
ceillingLightColor CDATA #IMPLIED
drawingMode (FILL | OUTLINE | FILL_AND_OUTLINE) "FILL"
subpartSizeUnderLight CDATA "0"
photoWidth CDATA "400"
photoHeight CDATA "300"
photoAspectRatio (FREE_RATIO | VIEW_3D_RATIO | RATIO_4_3 | RATIO_3_2 | RATIO_16_9 | RATIO_2_1 | SQUARE_RATIO) "VIEW_3D_RATIO"
photoQuality CDATA "0"
videoWidth CDATA "320"
videoAspectRatio (RATIO_4_3 | RATIO_16_9) "RATIO_4_3"
videoQuality CDATA "0"
videoFrameRate CDATA "25">

<!ELEMENT backgroundImage EMPTY>
<!ATTLIST backgroundImage
image CDATA #REQUIRED
scaleDistance CDATA #REQUIRED
scaleDistanceXStart CDATA #REQUIRED
scaleDistanceYStart CDATA #REQUIRED
scaleDistanceXEnd CDATA #REQUIRED
scaleDistanceYEnd CDATA #REQUIRED
xOrigin CDATA "0"
yOrigin CDATA "0"
visible (false | true) "true">

<!ELEMENT print EMPTY>
<!ATTLIST print
headerFormat CDATA #IMPLIED
footerFormat CDATA #IMPLIED
planScale CDATA #IMPLIED
furniturePrinted (false | true) "true"
planPrinted (false | true) "true"
view3DPrinted (false | true) "true"
paperWidth CDATA #REQUIRED
paperHeight CDATA #REQUIRED
paperTopMargin CDATA #REQUIRED
paperLeftMargin CDATA #REQUIRED
paperBottomMargin CDATA #REQUIRED
paperRightMargin CDATA #REQUIRED
paperOrientation (PORTRAIT | LANDSCAPE | REVERSE_LANDSCAPE) #REQUIRED>

<!ELEMENT compass (property*)>
<!ATTLIST compass
x CDATA #REQUIRED
y CDATA #REQUIRED
diameter CDATA #REQUIRED
northDirection CDATA "0"
longitude CDATA #IMPLIED
latitude CDATA #IMPLIED
timeZone CDATA #IMPLIED
visible (false | true) "true">

<!ENTITY % cameraCommonAttributes
'name CDATA #IMPLIED
lens (PINHOLE | NORMAL | FISHEYE | SPHERICAL) "PINHOLE"
x CDATA #REQUIRED
y CDATA #REQUIRED
z CDATA #REQUIRED
yaw CDATA #REQUIRED
pitch CDATA #REQUIRED
time CDATA #IMPLIED
fieldOfView CDATA #REQUIRED'>

<!ELEMENT camera (property*)>
<!ATTLIST camera
%cameraCommonAttributes;
attribute (topCamera | storedCamera | cameraPath) #REQUIRED>

<!ELEMENT observerCamera (property*)>
<!ATTLIST observerCamera
%cameraCommonAttributes;
attribute (observerCamera | storedCamera | cameraPath) #REQUIRED
fixedSize (false | true) "false">

<!ELEMENT level (property*, backgroundImage?)>
<!ATTLIST level
id ID #REQUIRED
name CDATA #REQUIRED
elevation CDATA #REQUIRED
floorThickness CDATA #REQUIRED
height CDATA #REQUIRED
elevationIndex CDATA "-1"
visible (false | true) "true"
viewable (false | true) "true">

<!ENTITY % furnitureCommonAttributes
'name CDATA #REQUIRED
angle CDATA "0"
visible (false | true) "true"
movable (false | true) "true"
description CDATA #IMPLIED
modelMirrored (false | true) "false"
nameVisible (false | true) "false"
nameAngle CDATA "0"
nameXOffset CDATA "0"
nameYOffset CDATA "0"
price CDATA #IMPLIED'>

<!ELEMENT furnitureGroup ((pieceOfFurniture | doorOrWindow | furnitureGroup | light)*, property*, textStyle?)>
<!ATTLIST furnitureGroup
%furnitureCommonAttributes;
level IDREF #IMPLIED
x CDATA #IMPLIED
y CDATA #IMPLIED
elevation CDATA #IMPLIED
width CDATA #IMPLIED
depth CDATA #IMPLIED
height CDATA #IMPLIED
dropOnTopElevation CDATA #IMPLIED>

<!ENTITY % pieceOfFurnitureCommonAttributes
'level IDREF #IMPLIED
catalogId CDATA #IMPLIED
x CDATA #REQUIRED
y CDATA #REQUIRED
elevation CDATA "0"
width CDATA #REQUIRED
depth CDATA #REQUIRED
height CDATA #REQUIRED
dropOnTopElevation CDATA "1"
information CDATA #IMPLIED
model CDATA #IMPLIED
icon CDATA #IMPLIED
planIcon CDATA #IMPLIED
modelRotation CDATA "1 0 0 0 1 0 0 0 1"
modelCenteredAtOrigin CDATA #IMPLIED
backFaceShown (false | true) "false"
modelSize CDATA #IMPLIED
doorOrWindow (false | true) "false"
resizable (false | true) "true"
deformable (false | true) "true"
texturable (false | true) "true"
staircaseCutOutShape CDATA #IMPLIED
color CDATA #IMPLIED
shininess CDATA #IMPLIED
creator CDATA #IMPLIED
valueAddedTaxPercentage CDATA #IMPLIED
currency CDATA #IMPLIED'>

<!ENTITY % pieceOfFurnitureHorizontalRotationAttributes
'horizontallyRotatable (false | true) "true"
pitch CDATA "0"
roll CDATA "0"
widthInPlan CDATA #IMPLIED
depthInPlan CDATA #IMPLIED
heightInPlan CDATA #IMPLIED'>

<!ELEMENT pieceOfFurniture (property*, textStyle?, texture?, material*)>
<!ATTLIST pieceOfFurniture
%furnitureCommonAttributes;
%pieceOfFurnitureCommonAttributes;
%pieceOfFurnitureHorizontalRotationAttributes;>

<!ELEMENT doorOrWindow (sash*, property*, textStyle?, texture?, material*)>
<!ATTLIST doorOrWindow
%furnitureCommonAttributes;
%pieceOfFurnitureCommonAttributes;
wallThickness CDATA "1"
wallDistance CDATA "0"
wallCutOutOnBothSides (false | true) "false"
widthDepthDeformable (false | true) "true"
cutOutShape CDATA #IMPLIED
boundToWall (false | true) "true">

<!ELEMENT sash EMPTY>
<!ATTLIST sash
xAxis CDATA #REQUIRED
yAxis CDATA #REQUIRED
width CDATA #REQUIRED
startAngle CDATA #REQUIRED
endAngle CDATA #REQUIRED>

<!ELEMENT light (lightSource*, property*, textStyle?, texture?, material*)>
<!ATTLIST light
%furnitureCommonAttributes;
%pieceOfFurnitureCommonAttributes;
%pieceOfFurnitureHorizontalRotationAttributes;
power CDATA "0.5">

<!ELEMENT lightSource EMPTY>
<!ATTLIST lightSource
x CDATA #REQUIRED
y CDATA #REQUIRED
z CDATA #REQUIRED
color CDATA #REQUIRED
diameter CDATA #IMPLIED>

<!ELEMENT textStyle EMPTY>
<!ATTLIST textStyle
attribute (nameStyle | areaStyle | lengthStyle) #IMPLIED
fontName CDATA #IMPLIED
fontSize CDATA #REQUIRED
bold (false | true) "false"
italic (false | true) "false">

<!ELEMENT texture EMPTY>
<!ATTLIST texture
attribute (groundTexture | skyTexture | leftSideTexture | rightSideTexture | floorTexture | ceilingTexture) #IMPLIED
catalogId CDATA #IMPLIED
name CDATA #REQUIRED
width CDATA #REQUIRED
height CDATA #REQUIRED
angle CDATA "0"
scale CDATA "1"
creator CDATA #IMPLIED
leftToRightOriented (true | false) "true"
image CDATA #REQUIRED>

<!ELEMENT material (texture?)>
<!ATTLIST material
name CDATA #REQUIRED
key CDATA #IMPLIED
color CDATA #IMPLIED
shininess CDATA #IMPLIED>

<!ELEMENT wall (property*, texture?, texture?, baseboard?, baseboard?)>
<!ATTLIST wall
id ID #REQUIRED
level IDREF #IMPLIED
wallAtStart IDREF #IMPLIED
wallAtEnd IDREF #IMPLIED
xStart CDATA #REQUIRED
yStart CDATA #REQUIRED
xEnd CDATA #REQUIRED
yEnd CDATA #REQUIRED
height CDATA #IMPLIED
heightAtEnd CDATA #IMPLIED
thickness CDATA #REQUIRED
arcExtent CDATA #IMPLIED
pattern CDATA #IMPLIED
topColor CDATA #IMPLIED
leftSideColor CDATA #IMPLIED
leftSideShininess CDATA "0"
rightSideColor CDATA #IMPLIED
rightSideShininess CDATA "0">

<!ELEMENT baseboard (texture?)>
<!ATTLIST baseboard
attribute (leftSideBaseboard | rightSideBaseboard) #REQUIRED
thickness CDATA #REQUIRED
height CDATA #REQUIRED
color CDATA #IMPLIED>

<!ELEMENT room (property*, textStyle?, textStyle?, texture?, texture?, point+)>
<!ATTLIST room
level IDREF #IMPLIED
name CDATA #IMPLIED
nameAngle CDATA "0"
nameXOffset CDATA "0"
nameYOffset CDATA "-40"
areaVisible (false | true) "false"
areaAngle CDATA "0"
areaXOffset CDATA "0"
areaYOffset CDATA "0"
floorVisible (false | true) "true"
floorColor CDATA #IMPLIED
floorShininess CDATA "0"
ceilingVisible (false | true) "true"
ceilingColor CDATA #IMPLIED
ceilingShininess CDATA "0">

<!ELEMENT point EMPTY>
<!ATTLIST point
x CDATA #REQUIRED
y CDATA #REQUIRED>

<!ELEMENT polyline (property*, point+)>
<!ATTLIST polyline
level IDREF #IMPLIED
thickness CDATA "1"
capStyle (BUTT | SQUARE | ROUND) "BUTT"
joinStyle (BEVEL | MITER | ROUND | CURVED) "MITER"
dashStyle (SOLID | DOT | DASH | DASH_DOT | DASH_DOT_DOT) "SOLID"
startArrowStyle (NONE | DELTA | OPEN | DISC) "NONE"
endArrowStyle (NONE | DELTA | OPEN | DISC) "NONE"
color CDATA #IMPLIED
closedPath (false | true) "false">

<!ELEMENT dimensionLine (property*, textStyle?)>
<!ATTLIST dimensionLine
level IDREF #IMPLIED
xStart CDATA #REQUIRED
yStart CDATA #REQUIRED
xEnd CDATA #REQUIRED
yEnd CDATA #REQUIRED
offset CDATA #REQUIRED>

<!ELEMENT label (property*, textStyle?, text)>
<!ATTLIST label
level IDREF #IMPLIED
x CDATA #REQUIRED
y CDATA #REQUIRED
angle CDATA "0"
elevation CDATA "0"
pitch CDATA #IMPLIED
color CDATA #IMPLIED
outlineColor CDATA #IMPLIED>

<!ELEMENT text (#PCDATA)>
with home as root element. Attributes named attribute indicate the names of the object fields where some elements should be stored.
Author: Emmanuel Puybaret.
Parameters:
{UserPreferences} preferences
Method Detail
characters(ch, start, length)
Parameters:
{Array} ch
{number} start
{number} length

{HomePrint} createPrint(attributes)
Returns a new HomePrint instance initialized from the given attributes.
Parameters:
{Object} attributes
Returns:
{HomePrint}

endDocument()

endElement(uri, localName, name)
Parameters:
{string} uri
{string} localName
{string} name

{Home} getHome()
Returns the home read by this handler.
Returns:
{Home}

{Object} resolveObject(elementObject, elementName, attributes)
Returns the object that will be stored in a home. This method is called for each home object created by this handler after its instantiation and returns elementObject. It might be overridden to substitute an object parsed from an XML element and its attributes for an other one of a different subclass if needed.
Parameters:
{Object} elementObject
{string} elementName
{Object} attributes
Returns:
{Object}

setCameraAttributes(camera, elementName, attributes)
Sets the attributes of the given camera. If needed, this method should be called from #endElement.
Parameters:
{Camera} camera
{string} elementName
{Object} attributes

setCompassAttributes(compass, elementName, attributes)
Sets the attributes of the given compass. If needed, this method should be called from #endElement.
Parameters:
{Compass} compass
{string} elementName
{Object} attributes

setDimensionLineAttributes(dimensionLine, elementName, attributes)
Sets the attributes of the given dimension line. If needed, this method should be called from #endElement.
Parameters:
{DimensionLine} dimensionLine
{string} elementName
{Object} attributes

setHome(home)
Sets the home that will be updated by this handler. If a subclass of this handler uses a root element different from home, it should call this method from #startElement to store the Home subclass instance read from the XML stream.
Parameters:
{Home} home

setHomeAttributes(home, elementName, attributes)
Sets the attributes of the given home. If needed, this method should be called from #endElement.
Parameters:
{Home} home
{string} elementName
{Object} attributes

setLabelAttributes(label, elementName, attributes)
Sets the attributes of the given label. If needed, this method should be called from #endElement.
Parameters:
{Label} label
{string} elementName
{Object} attributes

setLevelAttributes(level, elementName, attributes)
Sets the attributes of the given level. If needed, this method should be called from #endElement.
Parameters:
{Level} level
{string} elementName
{Object} attributes

setPieceOfFurnitureAttributes(piece, elementName, attributes)
Sets the attributes of the given piece. If needed, this method should be called from #endElement.
Parameters:
{HomePieceOfFurniture} piece
{string} elementName
{Object} attributes

setPolylineAttributes(polyline, elementName, attributes)
Sets the attributes of the given polyline. If needed, this method should be called from #endElement.
Parameters:
{Polyline} polyline
{string} elementName
{Object} attributes

setRoomAttributes(room, elementName, attributes)
Sets the attributes of the given room. If needed, this method should be called from #endElement.
Parameters:
{Room} room
{string} elementName
{Object} attributes

setWallAttributes(wall, elementName, attributes)
Sets the attributes of the given wall. If needed, this method should be called from #endElement.
Parameters:
{Wall} wall
{string} elementName
{Object} attributes

startDocument()

startElement(uri, localName, name, attributes)
Parameters:
{string} uri
{string} localName
{string} name
{Attributes} attributes

© Copyrights 2017 Emmanuel PUYBARET / eTeks
Distributed under GNU General Public License
Documentation generated by JsDoc Toolkit 2.4.0 on Wed Oct 25 2017 16:36:09 GMT+0200 (CEST)