render the document on an internal SVG buffer (iSvg)
+ *
alpha-blend it with the bound graphics target (iGraphicsBitmap)
+ *
+ * @note if transparency factor is not set, iSvg is simply blitted onto iGraphicsTarget
+ *
+ * @param aSvgDocumentHandle handle to SVG document
+ * @param aCurrentTime the current time of the animation
+ * @param aSvgW Svg image viewport width
+ * @param aSvgH Svg image viewport height
+ * @param aRect contains position about the rendered area
+ * @since S60 3.1
+ */
+
+
+ virtual void RenderLCDUIL(
+ TM2GSvgDocumentHandle& aSvgDocHandle,
+ const TReal32 aCurrentTime,
+ TInt aSvgW,
+ TInt aSvgH,
+ TM2GRenderRect& aRect) = 0 ;
+
+ virtual void RenderESWTL(
+ TM2GSvgDocumentHandle& aSvgDocHandle,
+ const TReal32 aCurrentTime,
+ TInt aSvgW,
+ TInt aSvgH,
+ TM2GRenderRect& aRect,
+ TBool aUseNativeClear,
+ TInt* aReturnData) = 0;
+
+ /**
+ * Sets render quality
+ * @since Series S60 3.1
+ * @param aMode Mode
+ * @throws exception if not ok
+ */
+ virtual void SetRenderingQualityL(TInt aMode) = 0;
+
+ /**
+ * Sets transparency
+ * @since Series S60 3.1
+ * @param aAlpha Alpha factor
+ * @throws exception if not ok
+ */
+ virtual void SetTransparency(TReal32 aAlpha) = 0;
+
+};
+
+M2G_NS_END
+#endif // MM2GRENDERCONTEXT_H
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/inc/MM2GSVGProxy.h
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/inc/MM2GSVGProxy.h Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,854 @@
+/*
+* Copyright (c) 2005-2006 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description: SVGTopt proxy interface
+*
+*/
+
+#ifndef MM2GSVGPROXY_H
+#define MM2GSVGPROXY_H
+
+// INCLUDES
+#include "M2GUtils.h"
+
+M2G_NS_START
+
+// CONSTANTS
+
+// MACROS
+
+// DATA TYPES
+
+// FUNCTION PROTOTYPES
+
+// FORWARD DECLARATIONS
+
+// CLASS DECLARATION
+/**
+ * Interface class
+ */
+class MM2GSVGProxy
+{
+public: // METHODS
+
+ /**
+ * Dtor
+ */
+ virtual ~MM2GSVGProxy() {};
+
+ /**
+ * Add close to the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @throws exception if not ok
+ */
+ virtual void AddCloseL(const TM2GSvgPathHandle& aPathHandle) = 0;
+
+ /**
+ * Add curve to the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aPathCurveData Curve data
+ * @throws exception if not ok
+ */
+ virtual void AddCurveToL(
+ const TM2GSvgPathHandle& aPathHandle,
+ const TM2GPathCurveData& aPathCurveData) = 0;
+
+ /**
+ * Add line to the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aX -
+ * @param aY -
+ * @throws exception if not ok
+ */
+ virtual void AddLineToL(
+ const TM2GSvgPathHandle& aPathHandle,
+ const TReal32& aX, const TReal32& aY) = 0;
+ /**
+ * Add move to the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aX -
+ * @param aY -
+ * @throws exception if not ok
+ */
+ virtual void AddMoveToL(
+ const TM2GSvgPathHandle& aPathHandle,
+ const TReal32& aX, const TReal32& aY) = 0;
+
+ /**
+ * Add quad to the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aX1 -
+ * @param aY1 -
+ * @param aX2 -
+ * @param aY2 -
+ * @throws exception if not ok
+ */
+ virtual void AddQuadToL(
+ const TM2GSvgPathHandle& aPathHandle,
+ const TReal32& aX1, const TReal32& aY1,
+ const TReal32& aX2, const TReal32& aY2) = 0;
+
+ /**
+ * Append child
+ * @since Series S60 3.1
+ * @param aElementHandle
+ * @param aChildElementHandle
+ * @throws exception if not ok
+ */
+ virtual void AppendChildL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgElementHandle& aChildElementHandle) = 0;
+
+ /**
+ * Set the begin animation time for the given element.
+ * @since Series S60 3.1
+ * @param aDocumentHandle
+ * @param aElementHandle
+ * @param aOffset
+ * @throws exception if not ok
+ */
+ virtual void BeginElementAtL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GSvgElementHandle& aElementHandle,
+ const TReal32& aOffset) = 0;
+
+ /**
+ * Check if element is removable
+ * @since Series S60 3.1
+ * @param aSurfaceHandle
+ * @param aRemoveable Result
+ * @throws exception if not ok
+ */
+ virtual void CheckRemoveableL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TInt& aRemoveable) = 0;
+
+
+ /**
+ * Clear svg surface
+ * @since Series S60 3.1
+ * @param aSurfaceHandle Surface handle
+ * @throws exception if not ok
+ */
+ virtual void ClearSvgSurfaceL(const TM2GSvgDocumentHandle& aSurfaceHandle) = 0;
+
+ /**
+ * Create document
+ * @since Series S60 3.1
+ * @param aData Document content
+ * @param aDocumentHandle Document handle to be returned
+ * @throws exception if not ok
+ */
+ virtual void CreateDocumentL(
+ const TPtrC16& aData,
+ TM2GSvgDocumentHandle& aDocumentHandle) = 0;
+
+ /**
+ * Create svg engine
+ * @since Series S60 3.1
+ * @param aEngineHandle Svg engine handle
+ * @throws exception if not ok
+ */
+ virtual void CreateSvgEngineL(TM2GSvgEngineHandle& aEngineHandle) = 0;
+
+ /**
+ * Create path
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle to be returned
+ * @throws exception if not ok
+ */
+ virtual void CreatePathL(TM2GSvgPathHandle& aPathHandle) = 0;
+
+ /**
+ * Create svg surface
+ * @since Series S60 3.1
+ * @param aWidth Surface width
+ * @param aHeight Surface height
+ * @return Svg surface
+ * @throws exception if not ok
+ */
+ virtual TM2GBitmapHandle CreateSvgSurfaceL(TInt aWidth, TInt aHeight) = 0;
+
+ /**
+ * Create new element
+ * @since Series S60 3.1
+ * @param aType Element type id
+ * @param aParentHandle Parent of the new element.
+ * Note: Can be '0' if element is not added to DOM.
+ * @param aDocumentHandle Document handle.
+ * @param aRootHandle Root element handle.
+ * @param aEngineHandle Element handle to be returned
+ * @throws exception if not ok
+ */
+ virtual void CreateElementNsL(
+ const TM2GSvgAttrType& aType,
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TM2GSvgElementHandle& aEngineHandle) = 0;
+
+ /**
+ * Delete document
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle
+ * @throws exception if not ok
+ */
+ virtual void DeleteDocumentL(const TM2GSvgDocumentHandle& aDocumentHandle) = 0;
+
+ /**
+ * Delete svg engine
+ * @since Series S60 3.1
+ * @param aEngineHandle Engine handle
+ * @throws exception if not ok
+ */
+ virtual void DeleteSvgEngineL(const TM2GSvgEngineHandle& aEngineHandle) = 0;
+
+ /**
+ * Deletes svg surface
+ * @since Series S60 3.1
+ * @param aSurfaceHandle Surface handle
+ * @throws exception if not ok
+ */
+ virtual void DeleteSvgSurfaceL(const TM2GSvgDocumentHandle& aSurfaceHandle) = 0;
+
+ /**
+ * Delete path
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle
+ * @throws exception if not ok
+ */
+ virtual void DestroyPathL(const TM2GSvgPathHandle& aPathHandle) = 0;
+
+ /**
+ * Dispatches a mouse event
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aX X coordinate.
+ * @param aY Y coordinate
+ * @param aElementHandle Target element handle
+ * @throws exception if not ok
+ */
+ virtual void DispatchMouseEventL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt aX, TInt aY, TM2GSvgElementHandle& aElementHandle) = 0;
+
+ /**
+ * Set the end animation time for the given element.
+ * @since Series S60 3.1
+ * @param aDocumentHandle
+ * @param aElementHandle
+ * @param aOffset
+ * @throws exception if not ok
+ */
+ virtual void EndElementAtL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GSvgElementHandle& aElementHandle,
+ const TReal32& aOffset) = 0;
+
+
+ /**
+ * Set focus on.
+ * @since Series S60 3.1
+ * @param aDocumentHandle
+ * @param aElementHandle
+ * @throws exception if not ok
+ */
+ virtual void FocusOnL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GSvgElementHandle& aElementHandle) = 0;
+
+ /**
+ * Set focus out.
+ * @since Series S60 3.1
+ * @param aDocumentHandle
+ * @param aElementHandle
+ * @throws exception if not ok
+ */
+ virtual void FocusOutL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GSvgElementHandle& aElementHandle) = 0;
+
+ /**
+ * Get a bounding box
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aRectData Rect components are saved to this parameter
+ * @param aResult Result
+ * @throws exception if not ok
+ */
+ virtual void GetBBoxL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TM2GRectData& aRectData, TInt& aResult) = 0;
+
+ /**
+ * Get colors
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle
+ * @param aAttributeType Attribute type
+ * @param aColor Result
+ * @param aResult Extra result info
+ * @throws exception if not ok
+ */
+ virtual void GetColorTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TM2GColorData& aColor,
+ TInt& aResult) = 0;
+
+ /**
+ * Get element by id
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aId Element id
+ * @param aElementHandle Element handle to be returned
+ * @throws exception if not ok
+ */
+ virtual void GetElementByIdL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TPtrC16& aId,
+ TM2GSvgElementHandle& aElementHandle) = 0;
+
+ /**
+ * Get element by id
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aId Result element type id.
+ * @throws exception if not ok
+ */
+ virtual void GetElementTypeIdL(const TM2GSvgElementHandle& aElementHandle, TInt16& aId) = 0;
+
+ /**
+ * Get an enumeration value of the specified attribute.
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aEnumTraiT Enum attribute.
+ * @throws exception if not ok
+ */
+ virtual void GetEnumTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TInt16& aEnumTrait) = 0;
+
+ /**
+ * Get external list item
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aIndex Index.
+ * @param aItem Returns external item according to a given index
+ * @return KErrNone if no error
+ * @throws Exception if not ok
+ */
+ virtual TInt GetExternalListItemL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt aIndex,
+ TPtrC16& aItem) = 0;
+
+ /**
+ * Get external list size
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aListSz Size.
+ * @throws exception if not ok
+ */
+ virtual void GetExternalListSizeL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt& aListSz) = 0;
+
+ /**
+ * Get a first chlid element
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aChildHandle Returns child element handle.
+ * @throws exception if not ok
+ */
+ virtual void GetFirstElementChildL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TM2GSvgElementHandle& aChildHandle) = 0;
+
+ /**
+ * Get a float trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param Float trait
+ * @throws exception if not ok
+ */
+ virtual void GetFloatTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TReal32& aFloatTrait) = 0;
+
+ /**
+ * Get a matrix trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aMatrix Matrix trait
+ * @param aResult
+ * @throws exception if not ok
+ */
+ virtual void GetMatrixTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TM2GMatrixData& aMatrix, TInt& aResult) = 0;
+
+ /**
+ * Get a media time
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aSeconds Media time to be returned
+ * @throws exception if not ok
+ */
+ virtual void GetMediaTimeL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TReal32& aSeconds) = 0;
+
+ /**
+ * Get a next element sibling
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aSiblingElementHandle Sibling handle
+ * @throws exception if not ok
+ */
+ virtual void GetNextElementSiblingL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TM2GSvgElementHandle& aSiblingElementHandle) = 0;
+
+ /**
+ * Get the segment count for the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aNumberOfSegments Segment count
+ * @throws exception if not ok
+ */
+ virtual void GetNumberOfSegmentsL(
+ const TM2GSvgPathHandle& aPathHandle,
+ TInt& aNumberOfSegments) = 0;
+
+ /**
+ * Get a parent
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aParentElementHandle Parent Element handle
+ * @throws exception if not ok
+ */
+ virtual void GetParentL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TM2GSvgElementHandle& aParentElementHandle) = 0;
+
+ /**
+ * Get a path trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aPathTrait Path trait
+ * @throws exception if not ok
+ */
+ virtual void GetPathTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TInt& aPathTrait) = 0;
+
+ /**
+ * Get a rect trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aRectData Rect components are saved to this parameter
+ * @param aResult Result
+ * @throws exception if not ok
+ */
+ virtual void GetRectTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TM2GRectData& aRectData, TInt& aResult) = 0;
+
+ /**
+ * Get a root element
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aRootElementHandle Root element handle
+ * @throws exception if not ok
+ */
+ virtual void GetRootElementL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TM2GSvgElementHandle& aRootElementHandle) = 0;
+
+ /**
+ * Get screen b box
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle
+ * @param aScreenBBoxData Screen box data out
+ * @throws exception if not ok
+ */
+ virtual void GetScreenBBoxL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TM2GScreenBBoxData& aScreenBBoxData) = 0;
+
+ /**
+ * Get the segment parameter for the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aSegmentIndex -
+ * @param aParamIndex -
+ * @param aSegmentParam Segment parameter to be returned.
+ * @throws exception if not ok
+ */
+ virtual void GetSegmentParameterL(
+ const TM2GSvgPathHandle& aPathHandle,
+ TInt aSegmentIndex, TInt aParamIndex,
+ TReal32& aSegmentParam) = 0;
+
+ /**
+ * Get the segment type for the given path.
+ * @since Series S60 3.1
+ * @param aPathHandle Path handle.
+ * @param aSegmentIndex -
+ * @param aSegmentType Segment type
+ * @throws exception if not ok
+ */
+ virtual void GetSegmentTypeL(
+ const TM2GSvgPathHandle& aPathHandle,
+ TInt aSegmentIndex,
+ TInt16& aSegmentType) = 0;
+
+ /**
+ * Get a string trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type.
+ * @param aStr Returns a string attribute
+
+ * @throws exception if not ok
+ */
+ virtual TInt GetStringTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TPtrC16& aStr) = 0;
+ /**
+ * Get a svg surface height
+ * @since Series S60 3.1
+ * @param aSurfaceHandle Surface handle.
+ * @return Svg surface height
+ * @throws exception if not ok
+ */
+ virtual TInt GetSvgSurfaceHeightL(const TM2GBitmapHandle& aSurfaceHandle) = 0;
+
+ /**
+ * Get a svg surface width
+ * @since Series S60 3.1
+ * @param aSurfaceHandle Surface handle.
+ * @return Svg surface width
+ * @throws exception if not ok
+ */
+ virtual TInt GetSvgSurfaceWidthL(const TM2GBitmapHandle& aSurfaceHandle) = 0;
+
+ /**
+ * Finds handle to the actual cloned element
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aHandle Element handle to be returned
+ * @throws exception if not ok
+ */
+ virtual void GetUsedFromElementL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TM2GSvgElementHandle& aHandle) = 0;
+
+ /**
+ * Viewport height.
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aHeight Wieport height to be returned.
+ * @throws exception if not ok
+ */
+ virtual void GetViewportHeightL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt& aHeight) = 0;
+
+ /**
+ * Viewport width.
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aWidth Viewport width.
+ * @throws exception if not ok
+ */
+ virtual void GetViewportWidthL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt& aWidth) = 0;
+
+ /**
+ * Init native engine & document
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle
+ * @throws exception if not ok
+ */
+ virtual void InitViewportL(
+ const TM2GSvgDocumentHandle& aDocumentHandle) = 0;
+
+ /**
+ * Add given child element to the given element before
+ * the given reference element.
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aNewChildElementHandle Child element handle.
+ * @param aReferenceElementHandle Child element handle.
+ * @throws exception if not ok
+ */
+ virtual void InsertBeforeL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgElementHandle& aNewChildElementHandle,
+ const TM2GSvgElementHandle& aReferenceElementHandle) = 0;
+
+ /**
+ * Check if element is active.
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aActive Return "1" if active
+ * @throws exception if not ok
+ */
+ virtual void IsActiveL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TInt& aActive) = 0;
+
+ /**
+ * Checks if an element in DOM.
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aElementHandle Element handle.
+ * @param aIsElementInDom Result.
+ * @throws exception if not ok
+ */
+ virtual void IsElementInDomL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GSvgElementHandle& aElementHandle,
+ TInt& aIsElementInDom) = 0;
+
+ /**
+ * Checks whether this element is child of a use element
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aResult Return "1" if used otherwise returns "0"
+ * @throws exception if not ok
+ */
+ virtual void IsUsedL(
+ const TM2GSvgElementHandle& aElementHandle,
+ TInt& aResult) = 0;
+
+ /**
+ * Remove child
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aURI Uri
+ * @param aResourceData Resource
+ * @param aHandle Removed element handle
+ * @throws exception if not ok
+ */
+ virtual void RemoveChildL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgElementHandle& aChildElementHandle,
+ TM2GSvgElementHandle& aHandle) = 0;
+ /**
+ * Render document
+ * @since Series S60 3.1
+ * @param aEngineHandle Engine handle.
+ * @param aDocumentHandle Document handle.
+ * @param aSurfaceHandle Surface.
+ * @param aSurfaceMaskHandle Mask.
+ * @throws exception if not ok
+ */
+ virtual void RenderDocumentL(
+ const TM2GSvgEngineHandle& aEngineHandle,
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GBitmapHandle& aSurfaceHandle,
+ TM2GBitmapHandle aSurfaceMaskHandle,
+ TReal32 aCurrentTime) = 0;
+
+// pankaj Qimage related changes TODO following Changes done
+ virtual void RenderDocumentL(
+ const TM2GSvgEngineHandle& aEngineHandle,
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TM2GSvgBitmapHandle& aSurfaceHandle,
+ TM2GSvgBitmapHandle aSurfaceMaskHandle,
+ TReal32 aCurrentTime)=0;
+
+ /**
+ * Sets render quality
+ * @since Series S60 3.1
+ * @param aEngineHandle Engine handle.
+ * @param aQuality Quality.
+ * @throws exception if not ok
+ */
+ virtual void RenderQualityL(
+ const TM2GSvgEngineHandle& aEngineHandle,
+ TInt aQuality) = 0;
+
+ /**
+ * Request completed
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aURI -
+ * @param aResourceData -
+ * @param aCompeleted Result
+ * @throws exception if not ok
+ */
+ virtual void RequestCompletedL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TPtrC16& aURI,
+ const TPtrC8& aResourceData,
+ TInt& aCompleted) = 0;
+
+ /**
+ * Set color trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aColor Color components: RGB
+ * @throws exception if not ok
+ */
+ virtual void SetColorTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ const TM2GColorData& aColor) = 0;
+
+ /**
+ * Set enum trait
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aValue Value
+ * @throws exception if not ok
+ */
+ virtual void SetEnumTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ TInt16 aValue) = 0;
+
+ /**
+ * Set float attribute
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aValue Value
+ * @throws exception if not ok
+ */
+ virtual void SetFloatTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ const TReal32& aValue) = 0;
+
+ /**
+ * Set matrix attribute
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aMatrix -
+ * @throws exception if not ok
+ */
+ virtual void SetMatrixTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ const TM2GMatrixData& aMatrix) = 0;
+
+ /**
+ * Set media time
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document handle.
+ * @param aSeconds Media time
+ * @throws exception if not ok
+ */
+ virtual void SetMediaTimeL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ const TReal32& aSeconds) = 0;
+
+ /**
+ * Set path attribute
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aPathHandle -
+ * @throws exception if not ok
+ */
+ virtual void SetPathTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ const TM2GSvgPathHandle& aPathHandle) = 0;
+
+ /**
+ * Set rect attribute
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aRect Rect trait to be set
+ * @throws exception if not ok
+ */
+ virtual void SetRectTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeType,
+ const TM2GRectData& aRect) = 0;
+
+ /**
+ * Set render quality
+ * @since Series S60 3.1
+ * @param aEngineHandle Engine handle.
+ * @param aMode
+ * @throws exception if not ok
+ */
+ virtual void SetRenderingQualityL(
+ const TM2GSvgEngineHandle& aEngineHandle,
+ TInt aMode) = 0;
+
+ /**
+ * Set string attribute
+ * @since Series S60 3.1
+ * @param aElementHandle Element handle.
+ * @param aAttributeType Attribute type
+ * @param aStr String trait to be set
+ * @throws exception if not ok
+ */
+ virtual void SetStringTraitL(
+ const TM2GSvgElementHandle& aElementHandle,
+ const TM2GSvgAttrType& aAttributeTypeId,
+ const TPtrC16& aStr) = 0;
+
+ /**
+ * Set viewport height
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document
+ * @param aWidth Width
+ * @throws exception if not ok
+ */
+ virtual void SetViewportHeightL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt aHeight) = 0;
+
+ /**
+ * Set viewport width
+ * @since Series S60 3.1
+ * @param aDocumentHandle Document
+ * @param aWidth Width
+ * @throws exception if not ok
+ */
+ virtual void SetViewportWidthL(
+ const TM2GSvgDocumentHandle& aDocumentHandle,
+ TInt aWidth) = 0;
+};
+
+M2G_NS_END
+
+#endif // MM2GSVGPROXY_H
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/ESWTScalableGraphics.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/ESWTScalableGraphics.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,95 @@
+/*
+* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+package com.nokia.microedition.m2g;
+
+import javax.microedition.m2g.ScalableGraphics;
+import javax.microedition.m2g.ScalableImage;
+import org.eclipse.swt.graphics.GC;
+import org.eclipse.swt.graphics.Image;
+import org.eclipse.swt.graphics.Rectangle;
+import org.eclipse.swt.widgets.*;
+
+public class ESWTScalableGraphics
+{
+ Display iDisplay = null;
+ Rectangle iCanvasBounds = null;
+ ScalableGraphics iSg = null;
+ GC iBufferGC = null;
+ GC iRealGC = null;
+ Image iBufferedImage = null;
+
+ public ESWTScalableGraphics(Display display)
+ {
+ System.out.println("P+ ESWTScalableGraphics(Display display)");
+
+ iSg = ScalableGraphics.createInstance();
+ iDisplay = display;
+ }
+
+ public ESWTScalableGraphics(Display display, Rectangle canvasBounds)
+ {
+ System.out.println(" P+ ESWTScalableGraphics(Display display, Rectangle canvasBounds)");
+ iSg = ScalableGraphics.createInstance();
+ iDisplay = display;
+ iCanvasBounds = canvasBounds;
+ }
+
+ public void setBounds(Rectangle canvasBounds)
+ {
+ iCanvasBounds = canvasBounds;
+ }
+
+ public void bindTarget(GC gc)
+ {
+ System.out.println(" bindTarget(GC gc)");
+ iRealGC = gc;
+ iBufferedImage = new Image(iDisplay, iCanvasBounds);
+ iBufferGC = new GC(iBufferedImage);
+ iSg.bindTarget(iBufferGC);
+ }
+
+ public void releaseTarget()
+ {
+ System.out.println(" releaseTarget");
+
+ iSg.releaseTarget();
+ iBufferedImage.dispose();
+ iBufferGC.dispose();
+ /* iRealGC is disposed in paintControl */
+ iRealGC = null;
+ }
+
+ public void render(int x, int y, ScalableImage image)
+ {
+ System.out.println(" render(int x, int y, ScalableImage image)");
+ iSg.render(x,y, image);
+ iRealGC.drawImage(iBufferedImage, x, y);
+ }
+
+ public void setRenderingQuality(int mode)
+ {
+ System.out.println("setRenderingQuality(int mode)");
+ iSg.setRenderingQuality(mode);
+ }
+
+ public void setTransparency(float alpha)
+ {
+ System.out.println("setTransparency(float alpha)");
+ iSg.setTransparency(alpha);
+ }
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/M2GDOMChangeObserver.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/M2GDOMChangeObserver.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,45 @@
+/*
+* Copyright (c) 2005-2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+
+package com.nokia.microedition.m2g;
+
+/**
+ * Anyone implementing this interface will receive notifications
+ * about changes in DOM.
+ *
+ * Subject = M2GDocument
+ * Observer/listener = M2GSVGCanvas
+ *
+ * M2GSVGCanvas from M2GSVGAnimator implements this in order to be notified
+ * about changes in DOM, so that SVGImage updates
+ * (via the API, e.g. setTrait(), insertBefore()) will be rendered
+ * while Animator is in pause state.
+ *
+ * M2GSVGElement informs M2GDocument about changes in DOM
+ * (e.g. adding/removing nodes, changing traits),
+ * and then M2GDocument informs M2GSVGCanvas.
+ *
+ * @since S60 3.2
+ */
+public interface M2GDOMChangeObserver
+{
+ /**
+ * Notifies about any change in DOM
+ */
+ public void notifyDOMChange();
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/M2GDestroyable.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/M2GDestroyable.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,57 @@
+/*
+* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+package com.nokia.microedition.m2g;
+
+//import com.nokia.mj.impl.rt.legacy.ToolkitInvoker;
+//import com.nokia.mj.impl.rt.legacy.ToolkitObserver;
+
+/**
+ * Interface
+ */
+public interface M2GDestroyable
+{
+ /**
+ * Finalization
+ */
+ void doDestroy();
+}
+
+//--------------------------------------------------
+// OTHER CLASSES
+//--------------------------------------------------
+/**
+ * M2GDestroyer implements the ToolkitObserver interface.
+ */
+class M2GDestroyer
+{
+ private M2GDestroyable iDestroyable;
+
+ /**
+ * Ctor
+ * @param aDestroyable Destroy target
+ */
+ M2GDestroyer(M2GDestroyable aDestroyable)
+ {
+ if (aDestroyable != null)
+ {
+ iDestroyable = aDestroyable;
+ }
+ }
+}
+
+
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/M2GDocument.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/com/nokia/microedition/m2g/M2GDocument.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,1339 @@
+/*
+* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+
+package com.nokia.microedition.m2g;
+
+import org.w3c.dom.*;
+import org.w3c.dom.events.*;
+import org.w3c.dom.svg.SVGElement;
+import java.io.IOException;
+import java.util.Hashtable;
+import java.lang.ref.WeakReference;
+import java.util.Vector;
+import java.util.Enumeration;
+import javax.microedition.m2g.*;
+import com.nokia.microedition.m2g.connection.*;
+import com.nokia.mj.impl.utils.Logger;
+
+public class M2GDocument extends M2GObject
+ implements Document, M2GConnectionPolicyHandler
+{
+ //--------------------------------------------------
+ // STATIC CONSTANTS
+ //--------------------------------------------------
+ // Error constants
+ /* Optimization: static finals changed to local variables
+ public static final String UNSUPORTED_ELEMENT_TYPE_ESTR =
+ "The type of element is not supported by the implementation.";
+ public static final String UNSUPORTED_NAMESPACE_ESTR =
+ "The URI is not the SVG namespace URI.";
+ public static final String ID_IS_NULL_ESTR =
+ "The ID is null.";
+ public static final String NAMESPACE_URI_IS_NULL_ESTR =
+ "The namespace URI is null.";
+ public static final String QUALIFIED_NAME_IS_NULL_ESTR =
+ "The qualifiedName is null.";
+ public static final String CANNOT_APPEND_CHILD_ESTR =
+ "Cannot appendChild to a Document node.";
+ public static final String CANNOT_INSERT_BEFORE_ESTR =
+ "Cannot insertBefore a Document node.";
+ public static final String CANNOT_REMOVE_CHILD_ESTR =
+ "Cannot removeChild from a Document node.";
+ public static final String DOCUMENT_IS_ILLEGAL_ESTR =
+ "The SVG document does not conform to the XML 1.0 specification.";
+ public static final String HEIGHT_IS_ILLEGAL_ESTR =
+ "The height is negative.";
+ public static final String WIDTH_IS_ILLEGAL_ESTR =
+ "The width is negative.";
+ */
+
+ //--------------------------------------------------
+ // VARIABLES
+ //--------------------------------------------------
+ private M2GEventDispatcher iEventDispatcher = null;
+ private ExternalResourceHandler iResourceHandler = null;
+ private M2GSVGImage iImage = null;
+ private M2GSVGSVGElement iRootElement = null;
+ private final M2GLiveElements iLiveElements = new M2GLiveElements(true);
+ private M2GConnectionPolicy iConnectionPolicy =
+ M2GConnectionFactory.getDefaultPolicy();
+ boolean iConnectionRight = true;
+ Vector iExternalResources = new Vector();
+
+ /** A base url from where a document was downloaded */
+ String iBaseUrl;
+
+ /** The suffix of the url from where the document was open*/
+ String iSuffixUrl;
+
+ /**
+ * Observer to be notified about changes in DOM
+ * @see M2GDOMChangeObserver.notifyDOMChange()
+ */
+ private M2GDOMChangeObserver iDOMChangeObserver = null;
+
+ //--------------------------------------------------
+ // METHODS
+ //--------------------------------------------------
+ /**
+ * Creates new document object. If aData is null or empty then
+ * an empty document is create.
+ * @param aImage Svg image
+ * @param aBaseUrl A base url from where a document is downloaded.
+ * @param aSuffixUrl A suffix url from where a document is downloaded
+ * @param aData Plain text svg data
+ */
+ public M2GDocument(M2GSVGImage aImage, String aBaseUrl, String aSuffixUrl,
+ String aData)
+ {
+ super();
+
+ System.out.println("P-M2GDocument Constructor getting Called.");
+ iImage = aImage;
+ iBaseUrl = aBaseUrl;
+ iSuffixUrl = aSuffixUrl;
+
+ setHandle(_createDocument(
+ getNativeSVGProxyHandle(),
+ aData)
+ );
+
+ doConstruct();
+ }
+
+ /**
+ * @see org.w3c.dom.Node#appendChild()
+ */
+ public Node appendChild(Node newChild) throws DOMException
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI, "appendChild() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ Logger.ELOG(Logger.EJavaUI, "appendChild() - exception: "
+ + /*SF*/"Cannot appendChild to a Document node."/*SF*/);
+ throw new DOMException(
+ DOMException.HIERARCHY_REQUEST_ERR,
+ /*SF*/"Cannot appendChild to a Document node."/*SF*/);
+ }
+
+ /**
+ * Appends external resource uri to internal container
+ * @param aUri External resource uri
+ * @return true if succeeds
+ */
+ boolean appendExternalResourceURI(String aUri)
+ {
+ boolean result = false;
+ if (aUri != null && !aUri.equals(""))
+ {
+ synchronized (iExternalResources)
+ {
+ if (!iExternalResources.contains(aUri))
+ {
+ iExternalResources.addElement(aUri);
+ result = true;
+ }
+ }
+ }
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo, "appendExternalResourceURI() uri=" +
+ ((aUri != null) ? aUri : "null") + ", result=" + result + " - end");
+ return result;
+ }
+
+ /**
+ * Checks if document contains the element
+ * @param id
+ * @return true if document contains the element
+ */
+ public boolean containsElement(String id)
+ {
+ if (id == null || id.equals(""))
+ {
+ return false;
+ }
+ int handle = _getElementById(
+ getNativeSVGProxyHandle(),
+ getHandle(), id);
+ return M2GObject.checkHandle(handle);
+ }
+
+ /**
+ * Check if external resource uri exists in internal container
+ * @param aUri External resource uri
+ * @return true if uri exists in container
+ */
+ boolean containsExternalResourceURI(String aUri)
+ {
+ boolean result = false;
+ if (aUri != null && !aUri.equals(""))
+ {
+ synchronized (iExternalResources)
+ {
+ result = iExternalResources.contains(aUri);
+ }
+ }
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo, "containsExternalResourceURI() uri=" +
+ ((aUri != null) ? aUri : "null") + ", result=" + result + " - end");
+ return result;
+ }
+
+
+ /**
+ * @see org.w3c.dom.Document#createElementNS()
+ */
+ public Element createElementNS(String namespaceURI, String qualifiedName)
+ {
+ if (namespaceURI == null || namespaceURI.equals(""))
+ {
+ Logger.ELOG(Logger.EJavaUI,
+ "createElementNS() exception because namespace is null. qualifiedName="
+ + qualifiedName);
+ throw new NullPointerException(/*SF*/"The namespace URI is null."/*SF*/);
+ }
+ if (qualifiedName == null || qualifiedName.equals(""))
+ {
+ Logger.ELOG(Logger.EJavaUI,
+ "createElementNS() exception - " + namespaceURI + ", "
+ + qualifiedName);
+ throw new NullPointerException(/*SF*/"The qualifiedName is null."/*SF*/);
+ }
+ // Checks element validity
+ if (!M2GSVGConstants.isQualifiedElement(qualifiedName))
+ {
+ Logger.ELOG(Logger.EJavaUI, "createElementNS() exception - "
+ + namespaceURI + ", " + qualifiedName);
+ throw new DOMException(
+ DOMException.NOT_SUPPORTED_ERR,
+ /*SF*/"The type of element is not supported by the implementation."/*SF*/);
+ }
+ // Checks namespace validity
+ if (!namespaceURI.equals(M2GSVGConstants.SVG_NAMESPACE_URI))
+ {
+ Logger.ELOG(Logger.EJavaUI, "createElementNS() exception - "
+ + namespaceURI + ", " + qualifiedName);
+ throw new DOMException(
+ DOMException.NOT_SUPPORTED_ERR,
+ /*SF*/"The URI is not the SVG namespace URI."/*SF*/);
+ }
+ // Creates native element. A native document owns the new element.
+ // NOTE: The element is NOT located in the DOM tree yet.
+ int elementHandle = _createElementNS(
+ getNativeSVGProxyHandle(),
+ M2GSVGConstants.parseElementTypeId(qualifiedName),
+ getHandle());
+ M2GSVGLocatableElement element = null;
+ // Checks native handle validity
+ if (M2GObject.checkHandle(elementHandle))
+ {
+ // Creates java element object
+ element = new M2GSVGLocatableElement(elementHandle, this);
+ registerLiveElement(element, new Integer(elementHandle));
+ }
+ else
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "createElementNS(): " + qualifiedName + " - end, NOK!!!");
+ }
+ return element;
+ }
+
+ /**
+ * Checks document validity.
+ * @return true if valid
+ */
+ public boolean doCheckValidity() throws IOException
+ {
+ boolean result = false;
+ if (isHandleValid())
+ {
+ M2GSVGSVGElement root = getRootElement();
+ if (root != null)
+ {
+ // Check svg version and base profile
+ root.checkVersionAndProfile();
+ result = true;
+ }
+ }
+ return result;
+ }
+
+ /**
+ * Cleanup
+ * @see com.nokia.microedition.m2g.M2GObject#doCleanup()
+ */
+ public void doCleanup()
+ {
+ if (isHandleValid())
+ {
+ _deleteDocument(
+ getNativeSVGProxyHandle(),
+ getHandle());
+ }
+ iImage = null;
+ if (iEventDispatcher != null)
+ {
+ iEventDispatcher.clear();
+ iEventDispatcher = null;
+ }
+ resetHandles();
+ }
+
+ /**
+ * @see com.nokia.microedition.m2g.M2GObject#doConstruct()
+ */
+ protected void doConstruct()
+ {
+ super.doConstruct();
+ iEventDispatcher = new M2GEventDispatcher();
+ }
+
+ /**
+ * Find an element from the handle-to-element map.
+ * @see M2GLiveElements#findElement()
+ */
+ public SVGElement findLiveElement(Integer aElementHandle)
+ {
+ return iLiveElements.findElement(aElementHandle);
+ }
+
+ /**
+ * Get connection policy
+ * @see M2GConnectionListener#getConnectionPolicy()
+ */
+ public M2GConnectionPolicy getConnectionPolicy()
+ {
+ return iConnectionPolicy;
+ }
+
+ /**
+ * @see org.w3c.dom.Document#getDocumentElement()
+ */
+ public Element getDocumentElement()
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI,
+ "getDocumentElement() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ return getRootElement();
+ }
+
+ /**
+ * @see org.w3c.dom.Document#getElementById()
+ */
+ public Element getElementById(String id)
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI, "getElementById() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ if (id == null || id.equals(""))
+ {
+ Logger.ELOG(Logger.EJavaUI, "getElementById() - exception");
+ throw new NullPointerException(/*SF*/"The ID is null."/*SF*/);
+ }
+ int elementHandle = _getElementById(
+ getNativeSVGProxyHandle(),
+ getHandle(),
+ id );
+ return M2GSVGElement.buildElement(elementHandle, this);
+ }
+
+ /**
+ * Returns the image
+ */
+ public M2GSVGImage getImage()
+ {
+ return iImage;
+ }
+
+ /**
+ * @see org.w3c.dom.Node#getLocalName()
+ */
+ public String getLocalName()
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI, "getLocalName() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ return null;
+ }
+
+ /**
+ * @see org.w3c.dom.Node#getNamespaceURI()
+ */
+ public String getNamespaceURI()
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI, "getNamespaceURI() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ return null;
+ }
+
+ /**
+ * @see org.w3c.dom.Node#getParentNode()
+ */
+ public Node getParentNode()
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI,
+ "getParentNode() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ return null;
+ }
+
+ /**
+ * Get root element
+ * @return M2GSVGSVGElement
+ */
+ public M2GSVGSVGElement getRootElement()
+ {
+ if (iRootElement == null)
+ {
+ iRootElement = M2GSVGSVGElement.buildRootElement(this);
+ }
+ return iRootElement;
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage#getViewportHeight()
+ */
+ public int getViewportHeight()
+ {
+ return _getViewportHeight(
+ getNativeSVGProxyHandle(),
+ getHandle());
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage#getViewportWidth()
+ */
+ public int getViewportWidth()
+ {
+ return _getViewportWidth(
+ getNativeSVGProxyHandle(),
+ getHandle() );
+ }
+
+
+ /**
+ * Called by SVGImage upon creating an Event instance
+ * Calls the handleEvent() of all the listeners of the event
+ */
+ public void handleEvent(Event aEvent)
+ {
+ iEventDispatcher.handleEvent(aEvent);
+ }
+
+ /**
+ * @see org.w3c.dom.Node#insertBefore()
+ */
+ public Node insertBefore(Node newChild, Node refChild)
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI, "insertBefore() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+
+ Logger.ELOG(Logger.EJavaUI, "insertBefore() DOMException");
+ throw new DOMException(
+ DOMException.HIERARCHY_REQUEST_ERR,
+ /*SF*/"Cannot insertBefore a Document node."/*SF*/);
+ }
+
+ /**
+ * Checks if element is in DOM
+ * @param aElementHandle -
+ * @return true if element is in DOM
+ */
+ public boolean isElementInDOM(int aElementHandle)
+ {
+ if (!M2GObject.checkHandle(aElementHandle))
+ {
+ return false;
+ }
+ return (_isElementInDOM(
+ getNativeSVGProxyHandle(),
+ getHandle(),
+ aElementHandle) > 0 ? true : false);
+ }
+
+ /**
+ * The external resource handler is invoked
+ * for any external resource referenced in the document.
+ * @param aUri External resource referenced in the document
+ */
+ public void invokeResourceHandler(String aUri)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo, "invokeResourceHandler() - URI="
+ + aUri + " - begin");
+
+ if ((iImage != null) && (iResourceHandler != null) &&
+ (aUri != null) && (aUri.length() > 4))
+ {
+ StringBuffer urlBuf = new StringBuffer();
+ // The uri format for external resource must include the base url
+ // from which the document was loaded. It's also checked that the
+ // url read from svg doesn't contain already the base part.
+ if ((iBaseUrl != null) &&
+ !iBaseUrl.equals("") &&
+ (aUri.indexOf(iBaseUrl) == -1))
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "invokeResourceHandler() append base url=" + iBaseUrl);
+ urlBuf.append(iBaseUrl);
+ }
+
+ urlBuf.append(aUri);
+
+ // append the url suffix in case of drm open mode
+ if (iSuffixUrl != null && !iSuffixUrl.equals(""))
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "invokeResourceHandler() append suffix url=" + iSuffixUrl);
+ urlBuf.append(iSuffixUrl);
+ }
+
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "invokeResourceHandler() handler uri=" + urlBuf.toString());
+
+ iResourceHandler.requestResource(iImage, urlBuf.toString());
+ appendExternalResourceURI(aUri);
+ }
+
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "invokeResourceHandler() - URI:" + aUri + " - end");
+ }
+
+ /**
+ * Registers an event target and an event listener.
+ * @param aTarget Target element
+ * @param aType Event type
+ * @param aListener Event listener
+ */
+ void register(EventTarget aTarget, String aType, EventListener aListener)
+ {
+ iEventDispatcher.register(aTarget, aType, aListener);
+ }
+
+ /**
+ * Register element
+ * @see M2GLiveElements#registerElement()
+ */
+ public void registerLiveElement(SVGElement aElement, Integer aElementHandle)
+ {
+ iLiveElements.registerElement(aElement, aElementHandle);
+ }
+
+ /**
+ * @see org.w3c.dom.Node#removeChild()
+ */
+ public Node removeChild(Node oldChild) throws DOMException
+ {
+ // Optimization: if(!getConnectionPolicy().getAccessRight())
+ if (!iConnectionRight)
+ {
+ Logger.ELOG(Logger.EJavaUI, "removeChild() - access rights failure");
+ throw new SecurityException(M2GSVGConstants.ACCESS_RIGHTS_ESTR);
+ }
+ Logger.ELOG(Logger.EJavaUI, "removeChild() DOMException");
+ throw new DOMException(
+ DOMException.NOT_SUPPORTED_ERR,
+ /*SF*/"Cannot removeChild from a Document node."/*SF*/);
+ }
+
+ /**
+ * Removes external resource uri from internal container
+ * @param aUri External resource uri
+ * @return true if succeeds
+ */
+ boolean removeExternalResourceURI(String aUri)
+ {
+ boolean result = false;
+ if (aUri != null && !aUri.equals(""))
+ {
+ synchronized (iExternalResources)
+ {
+ result = iExternalResources.removeElement(aUri);
+ }
+ }
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "removeExternalResourceURI() uri="
+ + ((aUri != null) ? aUri : "null") + ", result=" + result + " - end");
+ return result;
+ }
+
+ /*
+ * @see com.nokia.microedition.m2g.M2GSVGImage#requestCompleted()
+ */
+ public int requestCompleted(String aUri, byte[] aResourceData)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "requestCompleted() uri=" + aUri + " - begin");
+ // If the aUri contains a base part it will be cut off
+ if (!aUri.equals("") &&
+ (iBaseUrl != null) &&
+ !containsExternalResourceURI(aUri) &&
+ (aUri.indexOf(iBaseUrl, 0) != -1))
+ {
+ aUri = aUri.substring(iBaseUrl.length(), aUri.length());
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "requestCompleted() uri when base part is cut off=" + aUri);
+ }
+
+ // Execute tha request command.
+ int status = _requestCompleted(
+ getNativeSVGProxyHandle(),
+ getHandle(), aUri, aResourceData);
+ if ((status == 0) || aUri.equals(""))
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "requestCompleted() remove URI=" + aUri);
+ removeExternalResourceURI(aUri);
+ }
+ return status;
+ }
+
+ /**
+ * Set connection policy
+ * @see M2GConnectionListener#setConnectionPolicy()
+ */
+ public void setConnectionPolicy(M2GConnectionPolicy aConnectionPolicy)
+ {
+ iConnectionPolicy = aConnectionPolicy;
+ if (iConnectionPolicy != null)
+ {
+ iConnectionRight = iConnectionPolicy.getAccessRight();
+ }
+ else
+ {
+ iConnectionRight = true;
+ }
+ }
+
+ /**
+ * Set image
+ * @param aImage Image
+ */
+ public void setImage(M2GSVGImage aImage)
+ {
+ iImage = aImage;
+ }
+
+ /**
+ * Set external resource handler
+ * @param aHandler External resource handler
+ */
+ public void setResourceHandler(ExternalResourceHandler aHandler)
+ {
+ iResourceHandler = aHandler;
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage#setViewportHeight()
+ */
+ public void setViewportHeight(int height)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "setViewportHeight():" + height + " - begin");
+ if (height < 0)
+ {
+ Logger.ELOG(Logger.EJavaUI, "setViewportHeight():"
+ + height + " - IllegalArgumentException is thrown");
+ throw new IllegalArgumentException(/*SF*/"The height is negative."/*SF*/);
+ }
+ _setViewportHeight(
+ getNativeSVGProxyHandle(),
+ getHandle(),
+ height);
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "setViewportHeight():" + height + " - end");
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage#setViewportWidth()
+ */
+ public void setViewportWidth(int width)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo, "setViewportWidth:" + width + " - begin");
+ if (width < 0)
+ {
+ Logger.ELOG(Logger.EJavaUI, "setViewportWidth():"
+ + width + " - IllegalArgumentException is thrown");
+ throw new IllegalArgumentException(/*SF*/"The width is negative."/*SF*/);
+ }
+ _setViewportWidth(
+ getNativeSVGProxyHandle(),
+ getHandle(),
+ width );
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "setViewportWidth:" + width + " - end");
+ }
+
+ /**
+ * Unregister event listener
+ * @param aTarget Target element
+ * @param aType Event type
+ * @param aListener Event listener
+ */
+ void unregister(EventTarget aTarget, String aType, EventListener aListener)
+ {
+ iEventDispatcher.unregister(aTarget, aType, aListener);
+ }
+
+ /**
+ * Unregister an element from the handle-to-element map
+ * @see M2GLiveElements#unregisterElement()
+ */
+ public void unregisterLiveElement(Integer aElementHandle)
+ {
+ iLiveElements.unregisterElement(aElementHandle);
+ }
+
+ //--------------------------------------------------
+ // INNER CLASSES
+ //--------------------------------------------------
+ /**
+ * M2GLiveElements
+ */
+ class M2GLiveElements
+ {
+ private Hashtable iLiveElements = new Hashtable();
+ private boolean iUseWeakReference;
+
+ /**
+ * Constructor
+ */
+ public M2GLiveElements(boolean aUseWeakReference)
+ {
+ iUseWeakReference = aUseWeakReference;
+ }
+
+ /**
+ * Find an element from the handle-to-element map.
+ * @param aElementHandle Handle
+ * @return SVGElement. Null if not found
+ */
+ public SVGElement findElement(Integer aElementHandle)
+ {
+ SVGElement element = null;
+ Object weakObject = null;
+ Object object = null;
+
+ synchronized (this)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "** findElement() handle: " + aElementHandle + " - begin **");
+ object = iLiveElements.get(aElementHandle);
+ if (object != null)
+ {
+ if (iUseWeakReference)
+ {
+ weakObject = ((WeakReference)object).get();
+ if (weakObject == null)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "** findElement() handle: " + aElementHandle
+ + " is garbage collected. **");
+ iLiveElements.remove(aElementHandle);
+ }
+ else
+ {
+ element = (SVGElement)weakObject;
+ }
+ }
+ else
+ {
+ element = (SVGElement)object;
+ }
+ }
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,"** findElement() handle: " + aElementHandle
+ + ((element != null) ? " FOUND" : " NOT FOUND") + " - end **");
+ }
+ return element;
+ }
+
+ /**
+ * Register element
+ * @param aElement Element
+ * @param aElementHandle Handle
+ */
+ public void registerElement(SVGElement aElement, Integer aElementHandle)
+ {
+ if (aElement == null)
+ {
+ return;
+ }
+ synchronized (this)
+ {
+ if (iUseWeakReference)
+ {
+ iLiveElements.put(aElementHandle, new WeakReference(aElement));
+ }
+ else
+ {
+ iLiveElements.put(aElementHandle, aElement);
+ }
+ }
+ }
+
+ /**
+ * Unregister an element from the handle-to-element map
+ * @param aElementHandle Handle
+ */
+ public void unregisterElement(Integer aElementHandle)
+ {
+ synchronized (this)
+ {
+ iLiveElements.remove(aElementHandle);
+ }
+ }
+ }
+
+
+ /**
+ * M2GEventDispatcher
+ */
+ protected class M2GEventDispatcher
+ {
+ static public final int INDEX_UNDEFINED = -1;
+ static public final int INDEX_CLICK = 0;
+ static public final int INDEX_ACTIVATE = 1;
+ static public final int INDEX_FOCUS_IN = 2;
+ static public final int INDEX_FOCUS_OUT = 3;
+
+ Hashtable[] iEventTypes;
+ int iCurrentIndex;
+ Hashtable iDelayedRegistrations = new Hashtable();
+ M2GEventData iCurrentEventData = new M2GEventData();
+
+ /**
+ * Constructor
+ */
+ public M2GEventDispatcher()
+ {
+ iEventTypes = new Hashtable[4];
+ iCurrentIndex = INDEX_UNDEFINED;
+ }
+
+ /**
+ * Clear all
+ */
+ public void clear()
+ {
+ synchronized (this)
+ {
+ for (int index = 0; index < iEventTypes.length; index++)
+ {
+ if (iEventTypes[index] != null)
+ {
+ iEventTypes[index].clear();
+ iEventTypes[index] = null;
+ }
+ }
+ }
+ }
+
+ /**
+ * Execute delayed registration
+ * If an EventListener is added to an EventTarget while it is
+ * processing an event, it will not be triggered by the current actions.
+ */
+ private void doDelayedRegistration()
+ {
+ try
+ {
+ Enumeration registrations = iDelayedRegistrations.elements();
+ while (registrations.hasMoreElements())
+ {
+ M2GEventData eventData =
+ (M2GEventData)registrations.nextElement();
+ register(
+ eventData.iTarget, eventData.iType, eventData.iListener);
+ }
+ }
+ catch (NullPointerException e)
+ {
+ }
+ iDelayedRegistrations.clear();
+ }
+
+
+ /**
+ * Handle event
+ * @param aEvent Event
+ */
+ public void handleEvent(Event aEvent)
+ {
+ synchronized (this)
+ {
+ if ((aEvent == null) || !prepare(aEvent.getType()))
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent() FAILED - event invalid");
+ return;
+ }
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent(): " + aEvent.getType() + " - begin");
+ EventTarget target = aEvent.getCurrentTarget();
+ if (target == null)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent() FAILED - event's target is null");
+ return;
+ }
+ // Check if wrapped event target
+ if (target instanceof M2GSVGElementWrapper)
+ {
+ target = ((M2GSVGElementWrapper)target).getWrappedTarget();
+ if (target == null)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent() FAILED - wrapped event's target is null");
+ return;
+ }
+ }
+ if (iEventTypes[iCurrentIndex].containsKey(target))
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent() - target handling begin");
+ iCurrentEventData.set(target, aEvent.getType(), null);
+ Vector listeners =
+ (Vector)iEventTypes[iCurrentIndex].get(iCurrentEventData.iTarget);
+
+ if (listeners != null)
+ {
+ Enumeration index = listeners.elements();
+ while (index.hasMoreElements())
+ {
+ Object listener = index.nextElement();
+ if ((listener != null) && (listener instanceof EventListener))
+ {
+ ((EventListener)listener).handleEvent(aEvent);
+ }
+ else
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent(): listener is null!");
+ }
+ }
+ }
+ else
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent(): listeners is null!");
+ }
+ iCurrentEventData.clear();
+ }
+ else
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "handleEvent(): target not found");
+ }
+ // Execute the delayed registration.
+ doDelayedRegistration();
+ }
+ }
+
+ /**
+ * Check is event targets are equal
+ * @param aLhs Left hand side
+ * @param aRhs Right hand side
+ * @return True if equal
+ */
+ private boolean isEquals(EventTarget aLhs, EventTarget aRhs)
+ {
+ int lhsHandle = M2GObject.INVALID_NATIVE_HANDLE;
+ int rhsHandle = M2GObject.INVALID_NATIVE_HANDLE;
+ if (aLhs instanceof M2GSVGElement)
+ {
+ lhsHandle = ((M2GSVGElement)aLhs).getHandle();
+ }
+ if (aRhs instanceof M2GSVGElement)
+ {
+ rhsHandle = ((M2GSVGElement)aRhs).getHandle();
+ }
+ if ((lhsHandle == rhsHandle) && (lhsHandle != M2GObject.INVALID_NATIVE_HANDLE))
+ {
+ return true;
+ }
+ return false;
+ }
+
+ /**
+ * Set an index that points to an event type hash table.
+ * The hash table is created if needed.
+ * @param aType Type
+ */
+ private boolean prepare(String aType)
+ {
+ if (!setIndex(aType))
+ {
+ return false;
+ }
+ if (iEventTypes[iCurrentIndex] == null)
+ {
+ iEventTypes[iCurrentIndex] = new Hashtable();
+ }
+ return true;
+ }
+
+ /**
+ * Register an event target and an event listener pair
+ * @param aTarget Target
+ * @param aType Type
+ * @param aListener Listener
+ */
+ public void register(EventTarget aTarget,
+ String aType,
+ EventListener aListener)
+ {
+ // NOTE: no need to check validity of aTarget & aListener. It's
+ // already done.
+ synchronized (this)
+ {
+ if (!prepare(aType))
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "register() - failed: " + aType);
+ return;
+ }
+ // Check if delayed registration is needed
+ // If an EventListener is added to an EventTarget while it is
+ // processing an event, it will not be triggered by
+ // the current actions.
+ if ((iCurrentEventData.iType == aType) &&
+ isEquals(iCurrentEventData.iTarget, aTarget))
+ {
+ try
+ {
+ iDelayedRegistrations.put(
+ aListener,
+ new M2GEventData(aTarget, aType, aListener));
+ }
+ catch (NullPointerException e)
+ {
+ }
+ return;
+ }
+ Vector listeners = null;
+ if (iEventTypes[iCurrentIndex].containsKey(aTarget))
+ {
+ listeners = (Vector)iEventTypes[iCurrentIndex].get(aTarget);
+ }
+ else
+ {
+ listeners = new Vector();
+ iEventTypes[iCurrentIndex].put(aTarget, listeners);
+ }
+ // Don't add if the event target already contains the same listener
+ // for the same event.
+ if (!listeners.contains(aListener))
+ {
+ listeners.addElement(aListener);
+ }
+ }
+ }
+
+ /**
+ * Set an event type container index
+ * @param aType Type
+ * @return False if the type is invalid
+ */
+ private boolean setIndex(String aType)
+ {
+ if (aType.equals(M2GSVGConstants.EVENT_ACTIVATE))
+ {
+ iCurrentIndex = INDEX_ACTIVATE;
+ }
+ else if (aType.equals(M2GSVGConstants.EVENT_CLICK))
+ {
+ iCurrentIndex = INDEX_CLICK;
+ }
+ else if (aType.equals(M2GSVGConstants.EVENT_FOCUS_IN))
+ {
+ iCurrentIndex = INDEX_FOCUS_IN;
+ }
+ else if (aType.equals(M2GSVGConstants.EVENT_FOCUS_OUT))
+ {
+ iCurrentIndex = INDEX_FOCUS_OUT;
+ }
+ else
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "setIndex() type:" + aType + " FALSE - end");
+ // Wrong event type
+ iCurrentIndex = INDEX_UNDEFINED;
+ return false;
+ }
+ return true;
+ }
+
+ /**
+ * Unregister an event target and an event listener pair
+ * @param aTarget Target
+ * @param aType Type
+ * @param aListener Listener
+ */
+ public void unregister(EventTarget aTarget,
+ String aType,
+ EventListener aListener)
+ {
+ synchronized (this)
+ {
+ if (!prepare(aType))
+ {
+ return;
+ }
+ // Remove delayed registration
+ iDelayedRegistrations.remove(aListener);
+ // Remove real registration
+ Vector listeners = (Vector)iEventTypes[iCurrentIndex].get(aTarget);
+ boolean removed = false;
+ if (listeners != null)
+ {
+ removed = listeners.removeElement(aListener);
+ if (listeners.isEmpty())
+ {
+ iEventTypes[iCurrentIndex].remove(aTarget);
+ }
+ }
+ if (removed)
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "unregister() ok - end");
+ }
+ else
+ {
+ Logger.LOG(Logger.EJavaUI, Logger.EInfo,
+ "unregister() failed - end");
+ }
+ }
+ }
+
+ /**
+ * Helper class for handling delayed registration
+ */
+ class M2GEventData
+ {
+ public EventTarget iTarget = null;
+ public String iType = null;
+ public EventListener iListener = null;
+
+ /**
+ * Ctor
+ */
+ public M2GEventData()
+ {
+ }
+
+ /**
+ * Ctor
+ * @param aTarget Target
+ * @param aType Event type
+ * @param aListener Event listener
+ */
+ public M2GEventData(
+ EventTarget aTarget,
+ String aType,
+ EventListener aListener)
+ {
+ set(aTarget, aType, aListener);
+ }
+
+ /**
+ * Clearing
+ */
+ public void clear()
+ {
+ iTarget = null;
+ iType = null;
+ iListener = null;
+ }
+
+ /**
+ * Setter
+ * @param aTarget Target
+ * @param aType Event type
+ * @param aListener Event listener
+ */
+ public void set(EventTarget aTarget,
+ String aType,
+ EventListener aListener)
+ {
+ iTarget = aTarget;
+ iType = aType;
+ iListener = aListener;
+ }
+ }
+ }
+
+ //--------------------------------------------------
+ // STATIC METHODS
+ //--------------------------------------------------
+
+ /**
+ * Creates an empty SVG document. The document contains a
+ * root
+ *
+ * @param handler implementation of the ExternalResourceHandler interface
+ * @see javax.microedition.m2g.ExternalResourceHandler
+ *
+ * @return an empty SVGImage
+ */
+ public static SVGImage createEmptyImage(ExternalResourceHandler handler)
+ {
+ M2GSVGImage image = M2GSVGImage.buildEmptyImage(handler);
+ if (image == null)
+ {
+ throw new NullPointerException();
+ }
+ SVGImage proxy = new SVGImage();
+ proxy.iImg = image;
+ return proxy;
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public static ScalableImage createImage(
+ InputStream stream, ExternalResourceHandler handler) throws IOException
+ {
+ M2GSVGImage image = M2GSVGImage.buildImage(stream, handler, null, null);
+ if (image == null)
+ {
+ throw new NullPointerException();
+ }
+ SVGImage proxy = new SVGImage();
+ proxy.iImg = image;
+ return proxy;
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public static ScalableImage createImage(
+ String url, ExternalResourceHandler handler) throws IOException
+ {
+ M2GSVGImage image = M2GSVGImage.buildImage(url, handler);
+ if (image == null)
+ {
+ throw new NullPointerException();
+ }
+ SVGImage proxy = new SVGImage();
+ proxy.iImg = image;
+ return proxy;
+ }
+
+ /**
+ * This method is used to dispatch a mouse event of the specified type to the
+ * document. The mouse position is given as screen coordinates x, y. If the
+ * x, y values are outside the viewport area or no target is available for the x, y
+ * coordinates, the event is not dispatched. Note that when a "click" event is dispatched,
+ * a "DOMActivate" is automatically dispatched by the underlying implementation. The only
+ * required mouse event type is "click". Therefore, if an unsupported type is specified,
+ * a DOMException with error code NOT_SUPPORTED_ERR is thrown.
+ *
+ *
+ * @param type the type of mouse event.
+ * @param x the x location of the mouse/pointer in viewport coordinate
+ * system.
+ * @param y the y location of the mouse/pointer in viewport coordinate
+ * system.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR: if the event type is not supported.
+ * @throws NullPointerException if type is null.
+ * @throws IllegalArgumentException if the x or y values are negative.
+ *
+ */
+ public void dispatchMouseEvent(String type, int x, int y) throws DOMException
+ {
+ iImg.dispatchMouseEvent(type, x, y);
+ }
+
+ /**
+ * Returns the associated Document.
+ * @return the associated Document.
+ */
+ public Document getDocument()
+ {
+ return iImg.getDocument();
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public int getViewportHeight()
+ {
+ return iImg.getViewportHeight();
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public int getViewportWidth()
+ {
+ return iImg.getViewportWidth();
+ }
+
+ /**
+ * This method triggers a "DOMFocusIn" event with the specified element as
+ * the event target. That element becomes the element with focus. This
+ * method also triggers a "DOMFocusOut" event with the element which
+ * previous had focus as target. When the activate method is called, a
+ * "DOMActivate" event is triggered with the currently focused element as
+ * the target. The initial focus is always null and setting
+ * null will remove the current focus.
+ *
+ * @param element the element to set the focus on.
+ * @throws DOMException with error code WRONG_DOCUMENT_ERR: if invalid element is passed (for
+ * ex: an element that does not belong to this document).
+ */
+ public void focusOn(SVGElement element) throws DOMException
+ {
+ iImg.focusOn(element);
+ }
+
+ /**
+ * Increments the animation or media timeline for this SVGImage (in seconds). As the name
+ * implies, this method is intended to move only forward in the timeline and typically should be used
+ * to animate SVG content when the SVGAnimator class in not used. Setting negative values will throw
+ * an Exception. It is important to note that setting large increments of time would result in
+ * skipping parts of the animation as per the SVG animation model.
+ *
+ * @param seconds the value of time to increment in seconds.
+ * @throws IllegalArgumentException if the specified time is negative.
+ */
+ public void incrementTime(float seconds)
+ {
+ iImg.incrementTime(seconds);
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public void requestCompleted(
+ String URI, InputStream resourceData) throws IOException
+ {
+ iImg.requestCompleted(URI, resourceData);
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public void setViewportHeight(int height)
+ {
+ iImg.setViewportHeight(height);
+ }
+
+ /**
+ * @see javax.microedition.m2g.ScalableImage
+ */
+ public void setViewportWidth(int width)
+ {
+ iImg.setViewportWidth(width);
+ }
+}
+
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/javax/microedition/m2g/ScalableGraphics.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/javax/microedition/m2g/ScalableGraphics.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,146 @@
+/*
+* Copyright (c) 2005 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+
+package javax.microedition.m2g;
+
+import com.nokia.microedition.m2g.M2GScalableGraphics;
+
+/**
+ * This is the fundamental class for 2D rendering. The ScalableGraphics context class
+ * provides and handles all the rendering capability within this package. In other
+ * words, the rendering can only be achieved through the render method provided
+ * in this class. Note that the ScalableGraphics instance must be bound to the rendering
+ * target prior to calling the render method. The implementation must clip to the
+ * viewport boundaries.
+*/
+public class ScalableGraphics
+{
+ // Defines a low rendering quality level.
+ public static final int RENDERING_QUALITY_LOW = 1;
+ // Defines a high rendering quality level.
+ public static final int RENDERING_QUALITY_HIGH = 2;
+
+ private M2GScalableGraphics iSg;
+
+ /**
+ * Constructor
+ */
+ private ScalableGraphics()
+ {
+ System.out.println("P-In ScalableGraphics() Creating iSg" );
+ iSg = new M2GScalableGraphics();
+ System.out.println("P-OUT ScalableGraphics() Creating iSg" );
+ }
+
+ /**
+ * Binds the given Graphics as the rendering target of this ScalableGraphics context. The
+ * type of the Graphics object depends on the Java profile that this specification is
+ * implemented on, as follows:
+ *
+ *
javax.microedition.lcdui.Graphics on profiles supporting LCDUI;
+ *
java.awt.Graphics on profiles supporting AWT;
+ *
either of the above on profiles supporting both AWT and LCDUI.
+ *
+ * @param target the object (Graphics) to receive the rendered image.
+ * @throws NullPointerException if target is null.
+ * @throws IllegalArgumentException if target is invalid.
+ * @throws IllegalStateException if target is already bound.
+ */
+ public void bindTarget(java.lang.Object target)
+ {
+ System.out.println("P-In Bind Target of ScalableGraphics.java" );
+ iSg.bindTarget(target);
+ System.out.println("P-Out Bind Target of ScalableGraphics.java" );
+ }
+
+ /**
+ * Retrieve a new instance of ScalableGraphics that can be associated to
+ * an application.
+ *
+ * @return the newly created ScalableGraphics instance.
+ */
+ public static ScalableGraphics createInstance()
+ {
+ return new ScalableGraphics();
+ }
+
+ /**
+ * Flushes the rendered ScalableImage to the currently bound target and then releases
+ * the target. This ensures that the ScalableImage is actually made visible on the target
+ * that was set in bindTarget. Otherwise, the image may or may not become visible.
+ * @throws IllegalStateException if target is not bound.
+ */
+ public void releaseTarget()
+ {
+ System.out.println("P-In Release Target of ScalableGraphics.java" );
+ iSg.releaseTarget();
+ System.out.println("P-Out Release Target of ScalableGraphics.java" );
+ }
+
+ /**
+ * Renders the specified ScalableImage using the supplied anchor point. The anchor point given
+ * is relative to the upper left corner of the rendering surface. It is important to note that
+ * the content is made visible or flushed to the display only after a call is made to
+ * releaseTarget.
+ * @param x the X coordinate of the anchor point, in pixels.
+ * @param y the Y coordinate of the anchor point, in pixels.
+ * @param image the ScalableImage to be rendered.
+ * @throws NullPointerException if image is null.
+ * @throws IllegalStateException if target is not bound.
+ * @see #releaseTarget
+ */
+ public void render(int x, int y, ScalableImage image)
+ {
+ System.out.println("P-In Render Target of ScalableGraphics.java" );
+ iSg.render(x,y, image);
+ System.out.println("P-Out Render Target of ScalableGraphics.java" );
+ }
+
+ /**
+ * Set the quality of rendering in the ScalableGraphics context. It can take one of the values,
+ * RENDERING_QUALITY_LOW or RENDERING_QUALITY_HIGH. Default=RENDERING_QUALITY_HIGH. The
+ * implementation of these quality levels is implementation dependent and should be mapped
+ * to definitions in SVG spec (shape, text, image and color rendering).
+ * @param mode this value indicates the quality of rendering required.
+ * @throws IllegalArgumentException if the mode is invalid.
+ */
+
+ public void setRenderingQuality(int mode)
+ {
+ iSg.setRenderingQuality(mode);
+ }
+
+ /**
+ * Set the transparency in the ScalableGraphics context with the supplied alpha value.
+ * Alpha value must be a floating point number in the range [0.0, 1.0]. The source pixels
+ * are always combined with destination pixels using the Source Over Destination
+ * rule [Porter-Duff]. In this context, the Source Over Destination rule has the following
+ * properties: a fully opaque pixel in the source must replace the destination pixel, a
+ * fully transparent pixel in the source must leave the destination pixel unchanged, and
+ * a semitransparent pixel in the source must be alpha blended with the destination pixel using
+ * the supplied value. The default alpha value is 1.0 (fully opaque), when not specified.
+ *
+ * @param alpha the constant alpha value to be used for rendering.
+ *
+ * @throws IllegalArgumentException if alpha is out of range.
+ */
+ public void setTransparency(float alpha)
+ {
+ iSg.setTransparency(alpha);
+ }
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/javax/microedition/m2g/ScalableImage.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/javax/microedition/m2g/ScalableImage.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,225 @@
+/*
+* Copyright (c) 2004 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+
+package javax.microedition.m2g;
+
+import java.io.IOException;
+
+/**
+ * This class models images in vector format, such as the Scalable Vector
+ * Graphics (SVG) image format. Therefore, it is required that all classes
+ * representing "scalable" images extend this class.
+ * @see javax.microedition.m2g.SVGImage
+ */
+public abstract class ScalableImage
+{
+ /**
+ * Constructor
+ */
+ protected ScalableImage()
+ {
+ }
+
+ /**
+ * This method creates and loads a ScalableImage (e.g. SVG) from the specified stream.
+ * A ScalableImage can only be rendered using the render() method in the ScalableGraphics
+ * context.The image size is determined by the content specification
+ * (eg: width/height attributes on root SVG element). The default viewport size
+ * of 100-by-100 pixels is used when the size is unspecified. This method will throw an exception
+ * when the image is in error. For SVG document, the document is in error when:
+ *
+ *
the SVG document does not conform to the XML 1.0 specification
+ *
an element has an attribute or property value which is not permissible according to the SVG specification
+ *
the required or mandatory attributes according to the SVG specification are missing
+ *
the document contains circular references on the <use> element
+ *
the document contains <image> element(s) with local references
+ *
the document contains elements with duplicate Id's
+ *
the document contains animation(s) in error
+ *
+ *
+ *
If an handler is specified, the engine will invoke it for any
+ * external resource referenced in the document. However, please note that data URIs
+ * (for ex: base64 encoded images like <image xlink:href="data:image/png;base64,/9j/4AAQ..."/>)
+ * are required to be decoded by the engine, and therefore the handler will not be invoked
+ * in such cases. All these requests must occur before createImage returns, and the
+ * engine must only make one call if there exist multiple resources
+ * with the same URI. If the handler is set to null, the ScalableImage
+ * will try to load images automatically using the engine's default implementation,
+ * but might not be able to load all of them. For example, if the ScalableImage
+ * is loaded from a file in a Jar file, the implementation will not be able
+ * to load images that have relative URIs (ex; <image xlink:href="myImage.png" />).
+ * If the handler is not able to locate a requested resource, it informs the SVG engine
+ * by calling the requestCompleted method with null for resourceData.
+ *
+ *
Note that the handler is also called when the xlink:href attribute on
+ * <image> is set or changed by the application, but the call is made only when the
+ * element is hooked into the document tree i.e. when the ancestors go all the way up to
+ * the root <svg> element. There are two cases:
+ *
+ *
When changing the xlink:href attribute of an existing <image> element that is already hooked or part of the tree.
+ *
When creating a new <image>, setting its xlink:href and hooking it to the document tree.
+ *
+ *
+ *
+ * @param stream The stream from which the SVG content should be read.
+ * @param handler implementation of the ExternalResourceHandler interface
+ * @see javax.microedition.m2g.ExternalResourceHandler
+ *
+ * @return the loaded ScalableImage.
+ * @throws IOException if an error occurs while loading the content.
+ * @throws NullPointerException if stream is null.
+ */
+ public static ScalableImage createImage(java.io.InputStream stream,
+ ExternalResourceHandler handler) throws IOException
+ {
+ return SVGImage.createImage(stream, handler);
+ }
+
+
+ /**
+ * This method creates and loads a ScalableImage (e.g. SVG) with the specified
+ * URI. A ScalableImage can only be rendered using the render() method in the ScalableGraphics
+ * context.The image size is determined by the content specification
+ * (eg: width/height attributes on root SVG element). The default viewport size
+ * of 100-by-100 pixels is used when the size is unspecified. This method will throw an
+ * exception when the image is in error. For SVG document, the document is in error when:
+ *
+ *
the SVG document does not conform to the XML 1.0 specification
+ *
an element has an attribute or property value which is not permissible according to the SVG specification
+ *
the required or mandatory attributes according to the SVG specification are missing
+ *
the document contains circular references on the <use> element
+ *
the document contains <image> element(s) with local references
+ *
the document contains elements with duplicate Id's
+ *
the document contains animation(s) in error
+ *
+ *
+ *
+ *
If an handler is specified, the engine will invoke it for any
+ * external resource referenced in the document. However, please note that data URIs
+ * (for ex: base64 encoded images like <image xlink:href="data:image/png;base64,/9j/4AAQ..."/>)
+ * are required to be decoded by the engine, and therefore the handler will not be invoked
+ * in such cases. All these requests must occur before createImage returns, and the
+ * engine must only make one call if there exist multiple resources
+ * with the same URI. If the handler is set to null, the ScalableImage
+ * will try to load images automatically using the engine's default implementation,
+ * but might not be able to load all of them. For example, if the ScalableImage
+ * is loaded from a file in a Jar file, the implementation will not be able
+ * to load images that have relative URIs (ex: <image xlink:href="myImage.png" />).
+ * If the handler is not able to locate a requested resource, it informs the SVG engine
+ * by calling the requestCompleted method with null for resourceData.
+ *
+ *
Note that the handler is also called when the xlink:href attribute on
+ * <image> is set or changed by the application, but the call is made only when the
+ * element is hooked into the document tree i.e. when the ancestors go all the way up to
+ * the root <svg> element. There are two cases:
+ *
+ *
When changing the xlink:href attribute of an existing <image> element that is already hooked or part of the tree.
+ *
When creating a new <image>, setting its xlink:href and hooking it to the document tree.
+ *
+ *
+ *
+ *
+ * If the platform implementation supports the JSR-75 FileConnection, then the file: URLs
+ * as used by JSR-75 shall be supported and the images are loaded from files identified
+ * by this locator. This can be used to load possible DRM protected image files from the
+ * file system.
+ *
+ * @param url A string in URL syntax that identifies the image source.
+ * @param handler implementation of the ExternalResourceHandler interface
+ * @see javax.microedition.m2g.ExternalResourceHandler
+ *
+ * @return the loaded ScalableImage
+ * @throws IOException if an error occurs while loading the SVG content.
+ * @throws NullPointerException if URL is null.
+ * @throws java.lang.IllegalArgumentException if the specified locator is of unsupported type.
+ * @throws SecurityException if the application does not have the privilege rights to access
+ * the contents of this resource.
+ *
+ */
+ public static ScalableImage createImage(String url,
+ ExternalResourceHandler handler) throws IOException
+ {
+ return SVGImage.createImage(url, handler);
+ }
+
+ /**
+ * This method returns the ScalableImage's viewport height. The initial
+ * viewport height is taken from the "height" value specified in the Scalable Image. The value
+ * returned is always in pixels. If the specified height is defined in percentages, the
+ * values are mapped to the default view port size of 100x100. If the viewport height
+ * is explicitly changed by the application, then the percentages are ignored and the content
+ * is made to fit to this new viewport height.
+ *
+ * @return the current height of this ScalableImage.
+ * @see #setViewportHeight
+ */
+ public abstract int getViewportHeight();
+
+ /**
+ * This method returns the ScalableImage's viewport width. The initial
+ * viewport width is taken from the "width" value specified in the Scalable Image. The value
+ * returned is always in pixels. If the specified width is defined in percentages, the
+ * values are mapped to the default view port size of 100x100. If the viewport width
+ * is explicitly changed by the application, then the percentages are ignored and the content
+ * is made to fit to this new viewport width.
+ *
+ * @return the current width of this ScalableImage.
+ * @see #setViewportWidth
+ */
+ public abstract int getViewportWidth();
+
+ /**
+ * Once the requested external resource is available, the application forwards this information
+ * (resourceData) to the SVG engine. If this method is called a second time for a same URL of a
+ * same SVGImage, the engine will replace the current resource data with the new
+ * one. Note: Setting null for resourceData indicates that the requested resource
+ * could not be fetched by the ResourceHandler or application, and in this
+ * event the SVG engine will not make further attempts to load this resource.
+ *
+ * @param URI URI that was requested through requestExternalResource
+ * @param resourceData inputstream containing the external resource
+ *
+ * @see javax.microedition.m2g.ExternalResourceHandler
+ *
+ * @throws IOException if an error occurs while loading the resource.
+ * @throws NullPointerException if URL is null.
+ */
+ public abstract void requestCompleted(String URI, java.io.InputStream resourceData) throws IOException;
+
+ /**
+ * This method sets the new (viewport) height of this ScalableImage.
+ *
+ * @param height the new height to be set.
+ * @see #getViewportHeight
+ * @throws IllegalArgumentException if height is negative.
+ */
+ public abstract void setViewportHeight(int height);
+
+ /**
+ * This method sets the new (viewport) width of this ScalableImage.
+ * The viewport is the area where the ScalableImage is rendered. Any parts
+ * of the viewport that lie outside the boundaries of the target clipping
+ * rectangle are clipped. The viewport upper left corner (x, y) is given
+ * relative to the upper left corner of the target rendering surface.
+ *
+ * @param width the new width to be set.
+ * @see #getViewportWidth
+ * @throws IllegalArgumentException if width is negative.
+ */
+ public abstract void setViewportWidth(int width);
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/DOMException.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/DOMException.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,97 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+package org.w3c.dom;
+
+/**
+ *
+ */
+public class DOMException extends RuntimeException
+{
+
+ /**
+ * If a node is used in a different document than the one that created it
+ * (that doesn't support it).
+ */
+ public static final short WRONG_DOCUMENT_ERR = 4;
+
+ /**
+ * If index or size is negative, or greater than the allowed value.
+ */
+ public static final short INDEX_SIZE_ERR = 1;
+
+ /**
+ * If any Node is inserted somewhere it doesn't belong.
+ */
+ public static final short HIERARCHY_REQUEST_ERR = 3;
+
+ /**
+ * If an attempt is made to modify an object where modifications are not allowed.
+ */
+ public static final short NO_MODIFICATION_ALLOWED_ERR = 7;
+
+ /**
+ * If an attempt is made to reference a {@link org.w3c.dom.Node Node} in a context where it does not exist. See {@link org.w3c.dom.Node#insertBefore insertBefore} for example.
+ */
+ public static final short NOT_FOUND_ERR = 8;
+
+ /**
+ * If the implementation does not support the requested type of object or operation.
+ */
+ public static final short NOT_SUPPORTED_ERR = 9;
+
+ /**
+ * If an attempt is made to use an object that is not, or is no longer, usable.
+ */
+ public static final short INVALID_STATE_ERR = 11;
+
+ /**
+ * If an attempt is made to modify the type of the underlying object.
+ */
+ public static final short INVALID_MODIFICATION_ERR = 13;
+
+ /**
+ * If a parameter or an operation is not supported by the underlying object.
+ */
+ public static final short INVALID_ACCESS_ERR = 15;
+
+ /**
+ * If the type of an object is incompatible with the expected type of the parameter associated to the object.
+ */
+ public static final short TYPE_MISMATCH_ERR = 17;
+
+ /**
+ *
+ * The member variable to store exception's code, like INVALID_ACCESS_ERR.
+ */
+ public short code;
+
+ /**
+ * Constructs a DOMException with a detailed message.
+ *
+ * @param code the exception's error code.
+ * @param message the exception's descriptive message.
+ */
+ public DOMException(final short code,
+ final String message)
+ {
+ super(message);
+ this.code = code;
+ }
+
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/Document.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/Document.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,105 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+package org.w3c.dom;
+
+/**
+ * The Document interface represents an XML Document.
+ *
+ *
This interface is a subset of the Document interface defined
+ * in the
+ * DOM Level 3 Core.
+ *
+ *
+ *
Note the behavior of the following methods from the
+ * Node interface when called on a Document
+ * object:
+ *
+ *
+ *
getParentNode returns null
+ *
appendChild throws HIERARCHY_REQUEST_ERR
+ *
insertBefore throws HIERARCHY_REQUEST_ERR
+ *
removeChild throws NOT_SUPPORTED_ERR
+ *
+ *
+ *
+ */
+public interface Document extends Node
+{
+
+ /**
+ * Create a new Element based on the specified
+ * (qualified) SVG tag name. This JSR does not require multiple
+ * namespaces and may throw a DOMException with a
+ * code of NOT_SUPPORTED_ERR if the URI is not the
+ * SVG namespace URI, or if the specified name is not a valid SVG
+ * Tiny element name. Only the following elements must be supported:
+ * <rect>, <circle>, <ellipse>, <line>,
+ * <path> <use> <image> <text>,
+ * <a> and <g>.
+ *
+ * @param namespaceURI the namespace uri for the newly created
+ * element. This should always be the SVG namespace URI "http://www.w3.org/2000/svg".
+ * @param qualifiedName the qualified name for the newly created
+ * element (For example: "rect", to create a <rect> element)
+ *
+ * @return the newly created SVG Element.
+ *
+ * @throws DOMException NOT_SUPPORTED_ERR if the type of element is
+ * not supported by the implementation. JSR 226 only requires creation
+ * support for some of the SVG namespace elements and only for a limited
+ * number of local names in that namespace (see above documentation).Therefore, in
+ * a conformant JSR 226 implementation, trying to create elements with a namespace
+ * URIs other than the SVG namespace URI and with a qualified name not in the list
+ * of required qualified names may result in this exception being thrown.
+ * @throws NullPointerException if namespaceURI or
+ * qualifiedName is null.
+ *
+ */
+ public Element createElementNS(String namespaceURI, String qualifiedName)
+ throws DOMException;
+
+ /**
+ * Return a child element of this document Node which corresponds to the top-most
+ * tag in XML file. For SVG files it must be SVGSVGElement, but return
+ * type is Element for DOM Core compatibility and to allow for future extensions.
+ *
+ * @return the root Element associated with this
+ * document.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public Element getDocumentElement();
+
+ /**
+ * Return the Element in the current document with
+ * the given unique ID. If no such element exists, this returns null.
+ *
+ * @param id the ID of the object to be retrieved.
+ * @return the Element that matches with the given ID or
+ * null if the ID is not present.
+ *
+ * @throws NullPointerException if id is null
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public Element getElementById(String id);
+
+}
+
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/Element.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/Element.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,28 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom;
+
+
+/**
+ * This empty interface is defined to ensure compatibility with the DOM
+ * specification, and also to be used as a return type of some Document
+ * methods.
+ *
+ */
+public interface Element extends Node
+{
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/Node.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/Node.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,132 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+
+package org.w3c.dom;
+
+/**
+ * The Node interface describes generic nodes in an SVG document tree.
+ *
+ *
This interface is a subset of the Node interface defined
+ * in the
+ * DOM Level 3 Core.
+ *
+ */
+
+public interface Node
+{
+
+
+ /**
+ * Returns the namespace URI of the Node.
+ *
+ * @return the namespace URI of the Node.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public String getNamespaceURI();
+
+ /**
+ * Returns the local part of the qualified name of this node. If the node is of type SVGElement, this returns the tag name without a prefix.
+ * But, if the node is of type Document then null is returned.
+ * @return the local part of the qualified name of this node.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public String getLocalName();
+
+ /**
+ * Returns the parent Node of this Node.
+ *
+ * @return the parent node or null if there is no parent (i.e. if a node has
+ * just been created and not yet added to the tree, or if it has been removed
+ * from the tree, this is null).
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public Node getParentNode();
+
+ /**
+ * Appends a child to this Node.
+ *
+ * @param newChild the Node to be appended to this
+ * Node. This is equivalent to insertBefore(newChild,null)
+ * @return the added Node.
+ *
+ * @throws DOMException with error code HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children
+ * of the type of the newChild node, or if the node to append is one of this node's ancestors or this node itself,
+ * or if this node is of type Document and the DOM application attempts to append a second Element node.
+ * @throws DOMException with error code WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than
+ * the one that created this node.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR: if the newChild node is a child of the Document node or if the
+ * child is of a type that cannot be created with createElementNS.
+ * @throws DOMException with error code INVALID_STATE_ERR: if the newChild node would cause the document to go into
+ * error, for ex: when the newChild contains a <use> element with an invalid xlink:href attribute.
+ * @throws NullPointerException if newChild is null.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public Node appendChild(Node newChild) throws DOMException;
+
+ /**
+ * Removes the specified child associated with this Node. Elements that have ids cannot be
+ * removed from the tree.
+ *
+ * @param oldChild the Node that is to be removed.
+ * @return the node removed.
+ * @throws DOMException with error code NOT_FOUND_ERR: Raised if oldChild is not a child of this node.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR: if this node is of type Document or if the
+ * child, or any of its descendants, is of a type that cannot be created with createElementNS.
+ * @throws DOMException with error code INVALID_ACCESS_ERR: if the element being removed or one of its decendants
+ * have non-null id.
+ * @throws NullPointerException if oldChild is null.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public Node removeChild(Node oldChild) throws DOMException;
+
+ /**
+ * Inserts newChild before refChild in the child list for this node. If refChild is null,
+ * newChild is inserted at the end of the list. If the newChild is already part of the
+ * tree, it is first removed.
+ *
+ *
+ * @param newChild the child to add
+ * @param refChild the child before which the new child should be added.
+ * @return the node being inserted.
+ * @throws DOMException with error code HIERARCHY_REQUEST_ERR: if this node is of a type that does not allow children
+ * of the type of the newChild node, or if the node to append is one of this node's ancestors or this node itself,
+ * or if this node is of type Document and the DOM application attempts to append a second Element node.
+ * @throws DOMException with error code WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than
+ * the one that created this node.
+ * @throws DOMException with error code NOT_FOUND_ERR: raised if refChild is not a child of this node.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR: if the newChild node is a child of the Document node or if the
+ * child is of a type that cannot be created with createElementNS.
+ * @throws DOMException with error code INVALID_STATE_ERR: if the newChild node would cause the document to go into
+ * error, for ex: when the newChild contains a <use> element with an invalid xlink:href attribute.
+ * @throws NullPointerException if newChild is null.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public Node insertBefore(Node newChild, Node refChild) throws DOMException;
+
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/events/Event.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/events/Event.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,49 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.events;
+
+import java.lang.String;
+
+/**
+ * The Event interface is used to provide contextual information about an event to the handler
+ * processing the event. An object which implements the Event interface is passed as the first
+ * parameter to the {@link org.w3c.dom.events.EventListener#handleEvent handleEvent} call. If
+ * an event target is an element instance (see SVGElementInstance), the currentTarget is an implementation of EventTarget
+ * that does not implement the Node interface.
+ */
+
+public interface Event
+{
+ /**
+ * This method is used to get the current target of this event.
+ * In SVG Tiny, this is always an object to which event listener was attached.
+ *
+ * @return the event's EventTarget.
+ */
+ public EventTarget getCurrentTarget();
+
+ /**
+ * This method returns the event type information. The name of the event is case-sensitive.
+ * The following event types are supported:
+ *
+ * click, DOMActivate, DOMFocusIn, DOMFocusOut (defined DOM Events);
+ * @return the event's type.
+ */
+ public String getType();
+
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/events/EventListener.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/events/EventListener.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,44 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.events;
+
+/**
+* This interface represents an event listener, and is a subset of the EventListener interface
+* defined in the
+* DOM Level 2 Event model.
+*
+* This interface must be implemented and registered on an EventTarget using the
+* {@link org.w3c.dom.events.EventTarget#addEventListener addEventListener} method to be notified
+* about events that occur on or bubble through the event target.
+*
+*
+*/
+
+public interface EventListener
+{
+
+ /**
+ * This method is called whenever an event occurs of the type for which the
+ * EventListener interface was registered.. The Event object contains the
+ * necessary information pertaining to the event, such as its
+ * target and type.
+ *
+ * @param evt the Event object containing necessary event information.
+ */
+ public void handleEvent(Event evt);
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/events/EventTarget.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/events/EventTarget.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,70 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.events;
+
+import org.w3c.dom.DOMException;
+
+/**
+*
+* This interface represents an event target, and is a subset of the EventTarget interface
+* defined in the
+* DOM Level 2 Event model.
+*
+* This interface is implemented by an object (SVGElements) that can notify listeners about events and allows
+* registration and removal of {@link org.w3c.dom.events.EventListener EventListener} objects.
+*
+*
+*/
+
+public interface EventTarget
+{
+
+ /**
+ * This method registers the specified listener with the event target. If an EventListener is added to an EventTarget
+ * while it is processing an event, it will not be triggered by the current actions. If multiple identical EventListeners
+ * are registered on the same EventTarget with the same parameters the duplicate instances are discarded. They do not cause
+ * the EventListener to be called twice and since they are discarded they do not need to be removed with the removeEventListener
+ * method.
+ *
+ * @param type The type of event to listen to.
+ * @param listener Will be notified when an event of the desired type happens on this target or one of its descendant.
+ * @param useCapture If true, the listener will be called during the event flow capture phase. Otherwise, the listener
+ * will be called during the bubble phase. If the event's target is this target, then the listener will be called during the 'at target' phase of event flow.
+ *
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if useCapture is true since capture phase is not supported in SVG Tiny.
+ * @throws NullPointerException if listener is null.
+ * @throws NullPointerException if type is null.
+ */
+ public void addEventListener(String type, EventListener listener, boolean useCapture);
+
+ /**
+ * This method removes the specified listener from the event target. If an EventListener is removed
+ * from an EventTarget while it is processing an event, it will not be triggered by the current actions. Calling removeEventListener
+ * with arguments which do not identify any currently registered EventListener on the EventTarget has no effect.
+ *
+ * @param type The type of event that was listened to.
+ * @param listener The listener that was previously registered.
+ * @param useCapture If true, the listener was listening to events in the capture phase of event flow, otherwise the listener
+ * was listening to events in the bubble phase.
+ *
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if useCapture is true since capture phase is not supported in SVG Tiny.
+ * @throws NullPointerException if listener is null.
+ * @throws NullPointerException if type is null.
+ */
+ public void removeEventListener(String type, EventListener listener, boolean useCapture);
+
+}
\ No newline at end of file
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGAnimationElement.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGAnimationElement.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,47 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+
+/**
+ * This interface represents an Animation element, which contains methods to control the timing of
+ * animations.
+ */
+public interface SVGAnimationElement extends SVGElement
+{
+
+ /**
+ * Creates a begin instance time for the current time plus or minus the passed offset.
+ * The new instance time is added to the
+ * begin instance times list.
+
+ *
+ * @param offset The offset in seconds at which to begin the element.
+ */
+ public void beginElementAt(float offset);
+
+ /**
+ * Creates an end instance time for the current time plus or minus the passed offset.
+ * The new instance time is added to the
+ * end instance times list.
+
+ *
+ * @param offset The offset in seconds at which to end the element.
+ */
+ public void endElementAt(float offset);
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGElement.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGElement.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,1051 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+import org.w3c.dom.DOMException;
+
+import org.w3c.dom.Element;
+import org.w3c.dom.events.EventTarget;
+
+/**
+ * This interface represents an SVG element in the document tree. Element's id can be set only
+ * if it does not already have an id. {@link org.w3c.dom.DOMException DOMException} with error
+ * code NO_MODIFICATION_ALLOWED_ERR is raised if an attempt is made to change an existing id.
+ * Elements with non-null id can be inserted, but cannot be removed from the DOM tree
+ * (see {@link org.w3c.dom.Node#removeChild removeChild}). This interface also provides methods
+ * to traverse elements in the DOM tree.
+ *
+ *
+ * This interface can also be used read and manipulate the value of "traits" associated with this
+ * SVGElement. Each trait corresponds to an attribute or property,which is parsed and
+ * understood by the element and in most cases animatable. Unlike attributes, each element has a
+ * well-defined set of traits and attempting to access undefined trait is an error. Also unlike
+ * attributes traits are typed and their values are normalized; for instance SVG path specification
+ * is parsed and all path commands are converted to their absolute variants, it is not possible to
+ * say through the value of the trait if a path command was absolute or relative. When getting and
+ * setting trait values, accessor of the correct type must be used or exception will be thrown.
+ *
+ *
+ * Initial trait values come from parsing corresponding attributes. If value is not specified, but
+ * corresponing attribute (or property for environments where styling is supported) is inherited,
+ * inherited value is returned as a result of the trait query method. If it is not inherited, default
+ * value is returned. Default values are also returned in the case when there is no parent to inherit
+ * from, for ex: when you create a new element, set a trait value to 'inherit', but there is no parent for
+ * inheritance. It is important to note that the value which is returned is always a base value (i.e. before animation
+ * is applied), and this is true for both static and animated content.
+ *
+ *
+ * Setting a trait value has the same effect as changing a corresponding attribute, but trait
+ * setters can operate on typed values. The value which is modified is always a base value.
+ * For inheritable traits the trait value can always be set to "inherit"
+ * (but querying the value will always return the actual inherited value as explained above).
+ *
+ *
+ * There are two situations where the various trait setter methods (such as
+ * setTrait, setFloatTrait or setPathTrait methods) consider a value
+ * invalid and throw a DOMException with the INVALID_ACCESS_ERR code.
+ * The first situation is when the trait value is invalid with regards to
+ * its definition (for example, trying to set the "stroke-linejoin" trait
+ * to "foo" would cause this exception).
+ * The second situation is when the trait value is invalid with regards to
+ * animations currently applied to the trait. The value is considered
+ * invalid because it would put the animation, and therefore the document,
+ * in an error state. For example, if a element has animations on
+ * its "d" attribute, trying to change the "d" attribute to a value
+ * incompatible with the animations will cause the exception to happen.
+ *
+ *
+ *
Traits supported in this specification, SVG Tiny 1.1 DOM
+ *
+ *
+ *
The table below shows the list of attributes and properties that SVG Tiny
+ * DOM 1.1 implementations must support. Each light gray section lists one or
+ * multiple elements for which the subsequent attributes or properties
+ * apply. Each attribute row lists the allowed getter and setter (s). The last
+ * column specifies the default values that must be used for each attribute or
+ * property.
+ *
Note: For 'REQUIRED' attributes, there are two cases:
+ *
+ *
+ *
i) The document is in error, if this attribute was not present at the time of loading.
+ *
ii) When using uDOM API, the specified default value (in parenthesis) must be used.
<text> (Notes:
+ * For 'x' and 'y', it is only possible
+ * to provide floating point scalar values; an array of x or y values is not supported.
+ * 'rotate' attribute is not supported.)
+ *
+ *
+ *
+ *
x
+ *
+ *
getFloatTrait
+ *
+ *
setFloatTrait
+ *
+ *
0.0f
+ *
+ *
+ *
+ *
y
+ *
+ *
getFloatTrait
+ *
+ *
setFloatTrait
+ *
+ *
0.0f
+ *
+ *
+ *
+ *
#text
+ *
+ *
getTrait [not null]
+ *
+ *
setTrait [not null]
+ *
+ *
""
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
<svg>
+ *
+ *
+ *
+ *
version
+ *
+ *
getTrait
+ *
+ *
Not available (readonly)
+ *
+ *
"1.1"
+ *
+ *
+ *
+ *
baseProfile
+ *
+ *
getTrait
+ *
+ *
Not available (readonly)
+ *
+ *
"tiny"
+ *
+ *
+ *
+ *
viewBox
+ *
+ *
getRectTrait [null, SVGRect]
+ *
+ *
setRectTrait [SVGRect]
+ *
+ *
null
+ *
+ *
+ *
+ *
zoomAndPan
+ *
+ *
getTrait [disable | magnify]
+ *
+ *
setTrait [disable | magnify]
+ *
+ *
"magnify"
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ *
+ */
+
+public interface SVGElement extends Element, EventTarget
+{
+
+ /**
+ * Sets the Element's id attribute.
+ * @param Id the value of Id to be set for this Element.
+ * @throws DOMException with error code NO_MODIFICATION_ALLOWED_ERR is raised if an attempt is made to change an existing Id.
+ * @throws DOMException with error code INVALID_ACCESS_ERR is raised if the Id is not unique i.e. if this Id already exists in the document.
+ * @throws NullPointerException if Id is null.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public void setId(String Id)
+ throws DOMException;
+
+ /**
+ * Returns the Element's Id, null if no id specified.
+ * @return the Element's Id.
+ */
+ public String getId();
+
+ /**
+ * Returns the first child element node of this element. null if this element has no child elements.
+ * @return the first child element node of this element.
+ */
+ public Element getFirstElementChild();
+
+ /**
+ * Returns the next sibling element node of this element. null if this element has no element sibling
+ * nodes that come after this one in the document tree.
+ * @return the next sibling element node of this element.
+ */
+ public Element getNextElementSibling();
+
+
+ /**
+ * Returns the trait value as String. In SVG Tiny only certain traits can be obtained as a String value. Syntax of the
+ * returned String matches the syntax of the corresponding attribute. This element is exactly equivalent to {@link org.w3c.dom.svg.SVGElement#getTraitNS getTraitNS}
+ * with namespaceURI set to null.
+ *
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as String for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to a String (SVG Tiny only).
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public String getTrait(String name)
+ throws DOMException;
+
+ /**
+ * Same as {@link org.w3c.dom.svg.SVGElement#getTrait getTrait}, but for namespaced traits. Parameter name must be a non-qualified trait name, i.e. without prefix.
+ *
+ * @param namespaceURI the namespaceURI of the trait to retrieve.
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as String for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to a String (SVG Tiny only).
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public String getTraitNS(String namespaceURI, String name)
+ throws DOMException;
+
+ /**
+ * Get the trait value as float.
+ *
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as float for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to a float
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public float getFloatTrait(String name)
+ throws DOMException;
+
+ /**
+ * Returns the trait value as {@link org.w3c.dom.svg.SVGMatrix SVGMatrix}. The returned object is a copy of the actual trait value and will not change if
+ * the corresponding trait changes.
+ *
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as SVGMatrix for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to {@link org.w3c.dom.svg.SVGMatrix SVGMatrix}
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public SVGMatrix getMatrixTrait(String name)
+ throws DOMException;
+
+ /**
+ * Returns the trait value as {@link org.w3c.dom.svg.SVGRect SVGRect}. The returned object is a copy of the actual trait value and will not change if
+ * the corresponding trait changes.
+ *
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as SVGRect for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to {@link org.w3c.dom.svg.SVGRect SVGRect}
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public SVGRect getRectTrait(String name)
+ throws DOMException;
+
+ /**
+ * Returns the trait value as {@link org.w3c.dom.svg.SVGPath SVGPath}. The returned object is a copy of the actual trait value and will not change if
+ * the corresponding trait changes.
+ *
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as SVGPath for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to {@link org.w3c.dom.svg.SVGPath SVGPath}
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public SVGPath getPathTrait(String name)
+ throws DOMException;
+
+ /**
+ * Returns the trait value as {@link org.w3c.dom.svg.SVGRGBColor SVGRGBColor}. The returned object is a copy of the trait value and will not change if
+ * the corresponding trait changes. If the actual trait value is not an RGBColor (i.e. "none"), this method will return null.
+ *
+ * @param name the name of the trait to retrieve.
+ * @return the trait value as SVGRGBColor for the specified name.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if requested trait's computed value cannot be converted to {@link org.w3c.dom.svg.SVGRGBColor SVGRGBColor}
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public SVGRGBColor getRGBColorTrait(String name)
+ throws DOMException;
+
+ /**
+ * Set the trait value as String. In SVG Tiny only certain traits can be set through a String value. The syntax of the String
+ * that should be given as a value must be the same as syntax of the corresponding XML attribute value. Exactly equivalent
+ * to {@link org.w3c.dom.svg.SVGElement#setTraitNS setTraitNS} with namespaceURI attribute set to null.
+ *
+ * @param name the name of the trait to be set.
+ * @param value the value of the trait to be set as String.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as a String
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input value is an invalid value for the given trait or null.
+ * @throws DOMException with error code NO_MODIFICATION_ALLOWED_ERR: if attempt is made to change readonly trait.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public void setTrait(String name, String value)
+ throws DOMException;
+
+ /**
+ * Same as {@link org.w3c.dom.svg.SVGElement#setTrait setTrait}, but for namespaced traits. Parameter name must be a non-qualified trait name, i.e. without prefix.
+ *
+ * @param namespaceURI the namespaceURI of the trait to be set.
+ * @param name the name of the trait to be set.
+ * @param value the value of the trait to be set as String.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as a String
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input value is an invalid value for the given trait or null.
+ * This error is also thrown when the <use> element is hooked into the document tree and the the value of xlink:href is set invalid.
+ * @throws DOMException with error code NO_MODIFICATION_ALLOWED_ERR: if attempt is made to change readonly trait.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public void setTraitNS(String namespaceURI, String name, String value)
+ throws DOMException;
+
+ /**
+ * Set the trait value as float.
+ *
+ * @param name the name of the trait to be set.
+ * @param value the value of the trait to be set as float.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as a float
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input value is an invalid value for the given trait.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+ public void setFloatTrait(String name, float value)
+ throws DOMException;
+
+ /**
+ * Set the trait value as {@link org.w3c.dom.svg.SVGMatrix SVGMatrix}. Values in SVGMatrix are copied in the trait so subsequent changes to the given
+ * SVGMatrix have no effect on the value of the trait.
+ *
+ * @param name the name of the trait to be set.
+ * @param matrix the value of the trait to be set as SVGMatrix.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as an {@link org.w3c.dom.svg.SVGMatrix SVGMatrix}
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input matrix value is null.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public void setMatrixTrait(String name, SVGMatrix matrix)
+ throws DOMException;
+
+ /**
+ * Set the trait value as {@link org.w3c.dom.svg.SVGRect SVGRect}. Values in SVGRect are copied in the trait so subsequent changes to the given
+ * SVGRect have no effect on the value of the trait.
+ *
+ * @param name the name of the trait to be set.
+ * @param rect the value of the trait to be set as SVGRect.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as an {@link org.w3c.dom.svg.SVGRect SVGRect}
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input value is an invalid value for the given trait or null.
+ * SVGRect is invalid if the width or height values are set to negative.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public void setRectTrait(String name, SVGRect rect)
+ throws DOMException;
+
+ /**
+ * Set the trait value as {@link org.w3c.dom.svg.SVGPath SVGPath}. Values in SVGPath are copied in the trait so subsequent changes to the given
+ * SVGPath have no effect on the value of the trait.
+ *
+ * @param name the name of the trait to be set.
+ * @param path the value of the trait to be set as SVGPath.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as an {@link org.w3c.dom.svg.SVGPath SVGPath}
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input value is an invalid value for the given trait or null.
+ * SVGPath is invalid if it begins with any segment other than MOVE_TO segment. Note that an empty SVGPath is still a valid value.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public void setPathTrait(String name, SVGPath path)
+ throws DOMException;
+
+ /**
+ * Set the trait value as {@link org.w3c.dom.svg.SVGRGBColor SVGRGBColor}. Values in SVGRGBColor are copied in the trait so subsequent changes to the given
+ * SVGRGBColor have no effect on the value of the trait.
+ *
+ * @param name the name of the trait to be set.
+ * @param color the value of the trait to be set as SVGRGBColor.
+ * @throws DOMException with error code NOT_SUPPORTED_ERR if the requested trait is not supported on this element or null.
+ * @throws DOMException with error code TYPE_MISMATCH_ERR if the requested trait's value cannot be specified as an {@link org.w3c.dom.svg.SVGRGBColor SVGRGBColor}
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the input value is null.
+ * @throws SecurityException if the application does not have the necessary privilege rights
+ * to access this (SVG) content.
+ */
+
+ public void setRGBColorTrait(String name, SVGRGBColor color)
+ throws DOMException;
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGException.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGException.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,53 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+
+/**
+ * An exception thrown for SVG-specific errors, such as noninvertable matrix in {@link org.w3c.dom.svg.SVGMatrix#inverse inverse}.
+ */
+public class SVGException extends RuntimeException
+{
+ /**
+ * An integer indicating the type of error generated.
+ */
+ public short code;
+
+ /**
+ * Constructs a SVGException with a detailed message.
+ *
+ * @param code the exception's error code.
+ * @param message the exception's descriptive message.
+ */
+ public SVGException(short code, String message)
+ {
+ super(message);
+ this.code = code;
+ }
+
+
+ /**
+ * Value passed to an SVG-specific method is invalid, such as out of range color component in {@link org.w3c.dom.svg.SVGSVGElement#createSVGRGBColor createSVGRGBColor}.
+ */
+ public static final short SVG_INVALID_VALUE_ERR = 1;
+
+ /**
+ * Matrix that has a determinant equal to zero, and therefore not invertable.
+ */
+ public static final short SVG_MATRIX_NOT_INVERTABLE = 2;
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGLocatableElement.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGLocatableElement.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,277 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+
+/**
+ * This interface represents an SVGLocatableElement. It is implemented by all drawable SVG elements
+ * in the document tree. Drawable elements are: <rect>, <circle>, <ellipse>,
+ * <line>, <path> <use> <image> <text>, <svg>, <a>,
+ * and <g>. Note that animations will have an effect on the values of bounding box.
+ *
+ *
+ *
+ *
+ *The following example further clarify the behavior of the getBBox()
+ *method. The example have a short explanation, an SVG fragment and are
+ *followed by a set of bounding box values which have the following
+ *format:
+ *
+ *[elementId] : {x, y, width, height} | {null}
+ *
+ *where x, y, width and height define the values of the SVGRect object's
+ *returned from a getBBox call on the element with the specified id.
+ *There are a few cases where the bounding box may be null (see example
+ *6).
+ *
+ *
Example #1: Simple groups and bounds
+ *
+ *This first example shows the values returned by the getBBox method for
+ *various simple basic shapes and groups. In particular, it shows that
+ *the transform, on an element, does not change the value of its user
+ *space bounding box.
+ *
+ *<g id="group1" transform="translate(10, 20)" fill="red" >
+ *
+ * <rect id="rect1" transform="scale(2)" x="10" y="10" width="50"
+ *height="50"/>
+ *
+ * <rect id="rect2" x="10" y="10" width="100" height="100"/>
+ *
+ * <g id="group2" transform="translate(10, 20)" >
+ *
+ * <rect id="rect3" x="0" y="10" width="150" height="50"/>
+ *
+ * <circle id="circle1" cx="20" cy="20" r="100" />
+ *
+ * </g>
+ *
+ *</g>
+ *
+ *
+ *[group1] : {-70.0, -60.0, 230.0, 200.0}
+ *
+ *[rect1] : {10.0, 10.0, 50.0, 50.0}
+ *
+ *[rect2] : {10.0, 10.0, 100.0, 100.0}
+ *
+ *[group2] : {-80.0, -80.0, 230.0, 200.0}
+ *
+ *[rect3] : {0.0, 10.0, 150.0, 50.0}
+ *
+ *[circle1] : {-80.0, -80.0, 200.0, 200.0}
+ *
+ *
+ *
Example #2: Bounding box on zero width or height rectangle
+ *
+ *This example illustrates that the bounding box on elements is based on
+ *the element's geometry coordinates. For example, the bounding box on a
+ *zero-width rectangle is defined (see below), even though the rectangle
+ *is not rendered.
+ *
+ *This is another example of how bounding boxes are based on the
+ *element's geometry. Here, the bounding box of an ellipse with a zero
+ *x-axis radius is still defined, even though the ellipse is not rendered.
+ *
+ *This example shows that no matter what the viewport is on the root SVG
+ *element, the bounding boxes, based on the geometry, are still defined.
+ *Here, even though the root svg has a zero width, the bounding boxes for
+ *the root itself and its children is precisely defined.
+ *
+ *This example shows that the bounding box for a <use> element
+ *accounts for the x and y attributes defined on the element, just like
+ *the x and y attributes impact the bounding box computation on a
+ *<rect> or on an <image> element.
+ *
+ *<svg>
+ *
+ * <defs>
+ *
+ * <rect id="myRect" x="0" y="0" width="60" height="40" />
+ *
+ * </defs>
+ *
+ * <use id="myUse" xlink:href="#myRect" x="-30" y="-20" />
+ *
+ *</svg>
+ *
+ *
+ *
+ *[myRect] : {0.0, 0.0, 60.0, 40.0}
+ *
+ *[myUse] : {-30.0, -20.0, 60.0, 40.0}
+ *
+ *
Example #6: Empty group
+ *This example shows that the bounding box for an empty group is null. By
+ *the same token, the bounding box of a <path> with an empty
+ *SVGPath (i.e., one with no path commands, which may happen after
+ *creating a new <path> element with a Document.createElementNS
+ *call) is also null.
+ *
+ *<g id="emptyG" />
+ *
+ *
+ *[emptyG] : {null}
+ *
+ *
+ *
Example #7: Impact of display='none' and visibility='hidden'
+ *
+ *This example shows how the bounding box of children with display='none'
+ *are not accounted for in the computation of their parent's bounding
+ *box. This reflects the definition of the display property and its
+ *impact on rendering and bounding box computation. The example also
+ *shows that elements with a 'hidden' visibility still contribute to
+ *their parent's bounding box computation.
+ *
+ *<g id="g1">
+ * <g id="g1.1.display.none" display="none">
+ * <rect id="rect1" x="10" y="10" width="40" height="40"/>
+ * <g/>
+ *
+ * <rect id="rect2.visibility.hidden" visibility="hidden"
+ * x="30" y="60" width="10" height="20"/>
+ *
+ *</g>
+ *
+ *[g1] : {30.0, 60.0, 10.0, 20.0}
+ *[g1.1.display.none] : {10.0, 10.0, 40.0, 40.0}
+ *[rect1] : {10.0, 10.0, 40.0, 40.0}
+ *[rec2.visibility.hidden] : {30.0, 60.0, 10.0, 20.0}
+ *
Example #8: Concatenating bounding boxes in the container's user
+ *space.
+ *
+ *This example shows how the concatenation and computation of bounding
+ *boxes for container element happens in the container's user space.
+ *
+ *<g id="g1">
+ * <line id="line1" x2="100" y2="100" transform="rotate(-45)"/>
+ *</g>
+ *
+ *[g1] : {0.0, 0.0, 141.42136, 0}
+ *[line1] : {0.0, 0.0, 100.0, 100.0}
+ *
Example #9: No influence of stroke-width.
+ *This example illustrates that stroking has no impact on the computation
+ *of bounding boxes.
+ *
+ *<g>
+ * <line id="thickLine" stroke-width="10" x2="100" y2="0" />
+ *</g>
+ *
+ *[thickLine] : {0.0, 0.0, 100.0, 0.0}
+ *
+ *
+ * Returns the tight bounding box in current user coordinate space. Tight bounding box is the smallest
+ * possible rectangle that includes the geometry of all contained graphics elements excluding stroke.
+ * The calculation is done in the user coordinate space of the element. When bounding box
+ * is calculated elements with display property (trait) set to none are ignored. Exact rules for the bounding
+ * box calculation are given in the SVG spec.
+ *
+ *
+ * @return the tight bounding box in current user coordinate space.
+ */
+ public SVGRect getBBox();
+
+ /**
+ *
+ * Returns the transformation matrix from current user units (i.e., after application of the transform attribute, if any)
+ * to the parent user agent's notion of a "pixel". For display devices, ideally this represents a physical screen pixel.
+ * For other devices or environments where physical pixel sizes are not known, then an algorithm similar to the CSS2
+ * definition of a "pixel" can be used instead. Note that null is returned if this element is not hooked into the
+ * document tree.
+ *
+ *
+ * @return the transformation matrix from current user units to the parent user agent's notion of a "pixel".
+ */
+ public SVGMatrix getScreenCTM();
+
+ /**
+ *
+ * Returns the tight bounding box in screen coordinate space. Tight bounding box is the smallest
+ * possible rectangle that includes the geometry of all contained graphics elements excluding stroke.
+ * The box coordinates are in the screen coordinate space, which is connected to the current user
+ * coordinate space by the matrix returned by {@link org.w3c.dom.svg.SVGLocatableElement#getScreenCTM getScreenCTM} method.
+ * Note that null is returned if this element is not hooked into the
+ * document tree.
+ *
+ *
+ * @return the tight bounding box in screen coordinate space.
+ */
+ public SVGRect getScreenBBox();
+}
\ No newline at end of file
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGMatrix.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGMatrix.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,129 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+import org.w3c.dom.svg.SVGException;
+import org.w3c.dom.DOMException;
+
+/**
+ * This interface represents an "SVGMatrix" datatype, identified by an affine transform.
+ * It can be used to read and modify the values of transform attribute as per SVG specification.
+ * Note that the mTranslate, mMultiply, mScale and mRotate methods in this interface
+ * mutate the SVGMatrix object and return a reference to the SVGMatrix instance itself, after
+ * performing the necessary matrix operation.
+ *
This matrix transforms source coordinates (x, y) into destination coordinates (x', y') by
+ * considering them to be a column vector and multiplying the coordinate vector by the matrix
+ * according to the following process:
+ *
+ *
+ *
+ * [ x' ] [ a c e ] [ x ] [ a.x + c.y + e ]
+ * [ y' ] = [ b d f ] [ y ] = [ b.x + d.y + f ]
+ * [ 1 ] [ 0 0 1 ] [ 1 ] [ 1 ]
+ *
+ *
+ */
+public interface SVGMatrix
+{
+
+ /**
+ * Returns a component of the matrix by component's zero-based index. getComponent(0) is a, getComponent(1) is b, etc.
+ *
+ * @param index the index of the matrix component to retrieve.
+ * @return the component for the specified index.
+ * @throws DOMException - INDEX_SIZE_ERR if the index is invalid.
+ */
+ public float getComponent(int index)
+ throws DOMException;
+
+ /**
+ * Performs matrix multiplication. This matrix is post-multiplied by another matrix, returning the resulting current matrix.
+ *
+ * @param secondMatrix the matrix to post-multiply with.
+ * @return the resulting current matrix after post-multiplication.
+ * @throws NullPointerException - if secondMatrix is null.
+ */
+ public SVGMatrix mMultiply(SVGMatrix secondMatrix);
+
+ /**
+ * Returns a new instance of SVGMatrix containing the inverse of the current matrix.
+ *
+ * @return the inverse of the current matrix.
+ * @throws SVGException - SVG_MATRIX_NOT_INVERTABLE when determinant of this matrix is zero.
+ */
+ public SVGMatrix inverse()
+ throws SVGException;
+
+ /**
+ * Post-multiplies a translation transformation on the current matrix and returns the resulting current matrix.
+ * This is equivalent to calling multiply(T), where T is an
+ * SVGMatrix object represented by the following
+ * matrix:
+ *
+ *
+ *
+ * [ 1 0 x ]
+ * [ 0 1 y ]
+ * [ 0 0 1 ]
+ *
+ *
+ *
+ * @param x the distance by which coordinates are translated
+ * in the X axis direction.
+ * @param y the distance by which coordinates are translated
+ * in the Y axis direction.
+ * @return the resulting current matrix after post-multiplication.
+ */
+ public SVGMatrix mTranslate(float x, float y);
+
+ /**
+ * Post-multiplies a uniform scale transformation on the current matrix and returns the resulting current matrix.
+ * This is equivalent to calling multiply(S), where S is an SVGMatrix
+ * object represented by the following matrix:
+ *
+ *
+ *
+ *
+ * @param scaleFactor the factor by which coordinates are scaled along the
+ * X and Y axis.
+ * @return the resulting current matrix after post-mutiplication.
+ */
+ public SVGMatrix mScale(float scaleFactor);
+
+ /**
+ * Post-multiplies a rotation transformation on the current matrix and returns the resulting current matrix.
+ * This is equivalent to calling multiply(R), where R is an
+ * SVGMatrix object represented by the following matrix:
+ *
+ *
+ *
+ *
+ * @param angle the angle of rotation in degrees.
+ * @return the resulting current matrix after post-multiplication.
+ */
+ public SVGMatrix mRotate(float angle);
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGPath.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGPath.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,139 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+import org.w3c.dom.DOMException;
+
+
+/**
+ * This interface represents an "SVGPath" datatype used to define the path geometry.
+ * Corresponds to SVG path specification or the "d" attribute.
+ *
+ *
+ *
The native implementations must support the following simplifications or
+ * canonicalization of path segments. Any simplifications should be lossless.
+ *
+ *
+ *
Relative commands (c, h, l, m, q, s, t, and v) must be converted to their absolute counterparts·
+ *
Horizontal and Vertical lines (H, h, V, and v) must be converted to general lines (L and l)·
+ *
Translate command S to command C·
+ *
Translate command T to command Q.
+ *
+ *
+ */
+public interface SVGPath
+{
+
+ /**
+ * Numeric value is ASCII code of the letter 'M'.
+ */
+ public static final short MOVE_TO = 77;
+
+ /**
+ * Numeric value is ASCII code of the letter 'L'.
+ */
+ public static final short LINE_TO = 76;
+
+ /**
+ * Numeric value is ASCII code of the letter 'C'.
+ */
+ public static final short CURVE_TO = 67;
+
+ /**
+ * Numeric value is ASCII code of the letter 'Q'.
+ */
+ public static final short QUAD_TO = 81;
+
+ /**
+ * Numeric value is ASCII code of the letter 'Z'.
+ */
+ public static final short CLOSE = 90;
+
+
+ /**
+ * Return number of segments in this path.
+ *
+ * @return the number of segments in this path.
+ */
+ public int getNumberOfSegments();
+
+ /**
+ * Returns segment command by zero-based command index. Returns one of MOVE_TO, LINE_TO, CURVE_TO, QUAD_TO or CLOSE.
+ *
+ * @param cmdIndex the command index for the segment command to retrieve.
+ * @return the segment command for the specified cmdIndex.
+ * @throws DOMException with error code INDEX_SIZE_ERR if segment index out of bounds.
+ *
+ */
+ public short getSegment(int cmdIndex)
+ throws DOMException;
+
+ /**
+ * Returns segment parameter by zero-based command index and zero-based parametr index.
+ *
+ * @param cmdIndex the command index for the segment parameter to retrieve.
+ * @param paramIndex the parameter index for the segment parameter to retrieve.
+ * @return the segment parameter for the specified cmdIndex and paramIndex.
+ * @throws DOMException with error code INDEX_SIZE_ERR if segment index out of bounds or param index out of bounds for this segment's type.
+ */
+ public float getSegmentParam(int cmdIndex, int paramIndex)
+ throws DOMException;
+
+ /**
+ * Appends 'M' (absolute move) segment to the path with the specified coordinates.
+ *
+ * @param x the x-axis coordinate for the specified point.
+ * @param y the y-axis coordinate for the specified point.
+ */
+ public void moveTo(float x, float y);
+
+ /**
+ * Appends 'L' (absolute line) segment to the path with the specified coordinates.
+ *
+ * @param x the x-axis coordinate of the specified point.
+ * @param y the y-axis coordinate of the specified point.
+ */
+ public void lineTo(float x, float y);
+
+ /**
+ * Appends 'Q' (absolute quadratic curve) segment to the path.
+ *
+ * @param x1 the x-axis coordinate of the first control point.
+ * @param y1 the y-axis coordinate of the first control point.
+ * @param x2 the x-axis coordinate of the final end point.
+ * @param y2 the y-axis coordinate of the final end point.
+ *
+ */
+ public void quadTo(float x1, float y1, float x2, float y2);
+
+ /**
+ * Appends 'C' (absolute cubic curve) segment to the path.
+ *
+ * @param x1 the x-axis coordinate of the first control point.
+ * @param y1 the y-axis coordinate of the first control point.
+ * @param x2 the x-axis coordinate of the second end point.
+ * @param y2 the y-axis coordinate of the second end point.
+ * @param x3 the x-axis coordinate of the final end point.
+ * @param y3 the y-axis coordinate of the final end point.
+ *
+ */
+ public void curveTo(float x1, float y1, float x2, float y2, float x3, float y3);
+
+ /**
+ * Appends 'Z' (close path) segment to the path
+ */
+ public void close();
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGPoint.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGPoint.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,61 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+
+/**
+ * This interface represents an "SVGPoint" datatype, identifiend by its x and y components.
+ */
+public interface SVGPoint
+{
+
+ /**
+ * Sets the x component of the point to the specified float value.
+ *
+ * @param value the x component value
+ *
+ */
+
+ public void setX(float value);
+
+ /**
+ * Sets the y component of the point to the specified float value.
+ *
+ * @param value the y component value
+ *
+ */
+
+ public void setY(float value);
+
+
+ /**
+ * Returns the x component of the point.
+ *
+ * @return the x component of the point.
+ *
+ */
+
+ public float getX();
+
+ /**
+ * Returns the y component of the point.
+ *
+ * @return the y component of the point.
+ *
+ */
+ public float getY();
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGRGBColor.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGRGBColor.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,52 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+
+/**
+ * This interface represents an "SVGRGBColor" datatype made up of red, green, and blue components.
+ * It can be used to read properties that store color values ({@link org.w3c.dom.svg.SVGElement#getRGBColorTrait getRGBColorTrait})
+ * such as fill, stroke, and color.
+ */
+public interface SVGRGBColor
+{
+
+ /**
+ * Returns the red component of the SVGRGBColor.
+ *
+ * @return the red component.
+ *
+ */
+ public int getRed();
+
+ /**
+ * Returns the green component of the SVGRGBColor.
+ *
+ * @return the green component.
+ *
+ */
+ public int getGreen();
+
+ /**
+ * Returns the blue component of the SVGRGBColor.
+ *
+ * @return the blue component.
+ *
+ */
+ public int getBlue();
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGRect.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGRect.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,92 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+
+/**
+ * This interface represents an "SVGRect" datatype, consisting of a minimum X, minimum Y, width
+ * and height values.
+ */
+public interface SVGRect
+{
+
+ /**
+ * Sets the minimum X value of this SVGRect to the specified value.
+ *
+ * @param value the minimum X value.
+ *
+ */
+ public void setX(float value);
+
+ /**
+ * Sets the minimum Y value of this SVGRect to the specified value.
+ *
+ * @param value the minimum Y value.
+ *
+ */
+ public void setY(float value);
+
+ /**
+ * Sets the width of this SVGRect to the specified value.
+ *
+ * @param value the rectangle width value.
+ *
+ */
+ public void setWidth(float value);
+
+ /**
+ * Sets the height of this SVGRect to the specified value.
+ *
+ * @param value the rectangle height value.
+ *
+ */
+ public void setHeight(float value);
+
+ /**
+ * Returns the minimum X value for this SVGRect.
+ *
+ * @return the minimum X value.
+ *
+ */
+ public float getX();
+
+ /**
+ * Returns the minimum Y value for this SVGRect.
+ *
+ * @return the minimum Y value.
+ *
+ */
+ public float getY();
+
+
+ /**
+ * Returns the width for this SVGRect.
+ *
+ * @return the rectangle width.
+ *
+ */
+ public float getWidth();
+
+ /**
+ * Returns the height for this SVGRect.
+ *
+ * @return the rectangle height.
+ *
+ */
+ public float getHeight();
+
+}
diff -r 023eef975703 -r abc41079b313 javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGSVGElement.java
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/javauis/m2g_qt/javasrc/org/w3c/dom/svg/SVGSVGElement.java Fri Jul 23 12:27:20 2010 +0300
@@ -0,0 +1,162 @@
+/*
+* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+*
+*/
+package org.w3c.dom.svg;
+
+import org.w3c.dom.DOMException;
+
+/**
+ *
This interface represents <svg> element in (SVG) document tree.
+ *
User Agent Transforms
+ *
+ * The DOM attributes currentScale, currentRotate and currentTranslate are combined to form user agent transformation
+ * which is applied at the outermost level on the SVG document (i.e., outside the outermost 'svg' element) if "magnification"
+ * is enabled (i.e., zoomAndPan attribute is set to "magnify"). Their values
+ * can potentialy be modified through user-agent specific UI. User agent transformation can be obtained
+ * by multiplying matrix
+ *
+ *
+ *
+ * i.e. (translate, then scale, then rotate the coordinate system). The reference point for scale and rotate operations is the origin (0, 0).
+ *
+ *
+ *
Note: If the application does not have the necessary privilege rights to access this (SVG)
+ * content, a SecurityException may be thrown by the underlying implementation. This is applicable
+ * to all the Tree navigation and Trait acessor methods. Features such as zooming, panning and
+ * playing of animations will not be affected.
+ *
+ */
+public interface SVGSVGElement extends SVGLocatableElement
+{
+ /**
+ * Sets current user agent scale (zoom) coefficient.
+ *
+ * @param value the value of user agent scale coefficient to be set.
+ * @throws DOMException with error code INVALID_ACCESS_ERR if the scale value is set to zero.
+ */
+ public void setCurrentScale(float value)
+ throws DOMException;
+
+ /**
+ * Returns current user agent scale (zoom) coefficient. The initial value for currentScale is 1.
+ *
+ * @return the current user agent scale coefficient.
+ */
+ public float getCurrentScale();
+
+ /**
+ * Sets current user agent rotate coefficient in degrees.
+ *
+ * @param value the value of user agent rotate coefficient to be set.
+ */
+ public void setCurrentRotate(float value);
+
+ /**
+ * Returns current user agent rotation angle in degrees. The initial value for currentRotate is 0.
+ *
+ * @return the current user agent rotation coefficient in degrees.
+ */
+ public float getCurrentRotate();
+
+ /**
+ * Current user agent translation used for scrolling or panning (The returned {@link org.w3c.dom.svg.SVGPoint SVGPoint} object is "live" and setting its
+ * x and y components will change user agent's translation). The initial values for currentTranslate is SVGPoint(0,0).
+ *
+ * @return returns the current user agent translation.
+ */
+ public SVGPoint getCurrentTranslate();
+
+ /**
+ * Returns current animation timeline time in seconds.
+ *
+ * @return the current animation timeline time in seconds.
+ */
+ public float getCurrentTime();
+
+ /**
+ * Sets current animation timeline time (in seconds). This API is required to support moving
+ * forwards in timeline. The underlying implementations are normally designed to seek
+ * forward in time and setting the time backwards is not meant to play the animation backwards.
+ * Note: Moving backwards in time is a costly feature for the implementations to support.
+ *
+ * @param seconds the value of time to be set in seconds.
+ */
+
+ public void setCurrentTime(float seconds);
+
+ /**
+ * Creates new {@link org.w3c.dom.svg.SVGMatrix SVGMatrix} object. This object can be used to modify value of traits which are compatible with {@link org.w3c.dom.svg.SVGMatrix SVGMatrix}
+ * type using {@link org.w3c.dom.svg.SVGElement#setMatrixTrait setMatrixTrait} method. The internal representation of the matrix is as follows:
+ *
+ *
+ * [ a c e ]
+ * [ b d f ]
+ * [ 0 0 1 ]
+ *
+ *
+ *
+ * @param a the 'a' component of the matrix to be set.
+ * @param b the 'b' component of the matrix to be set.
+ * @param c the 'c' component of the matrix to be set.
+ * @param d the 'd' component of the matrix to be set.
+ * @param e the 'e' component of the matrix to be set.
+ * @param f the 'f' component of the matrix to be set.
+ *
+ * @return the newly created SVGMatrix object.
+ *
+ * @see org.w3c.dom.svg.SVGMatrix
+ */
+
+ public SVGMatrix createSVGMatrixComponents(float a, float b, float c, float d, float e, float f);
+
+ /**
+ * Creates new {@link org.w3c.dom.svg.SVGRect SVGRect} object. This object can be used to modify value of traits which are compatible with {@link org.w3c.dom.svg.SVGRect SVGRect}
+ * type using {@link org.w3c.dom.svg.SVGElement#setRectTrait setRectTrait} method. The intial values for x, y, width, height of this new SVGRect are zero.
+ *
+ * @return the newly created SVGRect object.
+ */
+
+ public SVGRect createSVGRect();
+
+ /**
+ * Creates new {@link org.w3c.dom.svg.SVGPath SVGPath} object. This object can be used to modify value of traits which are compatible with {@link org.w3c.dom.svg.SVGPath SVGPath}
+ * type using {@link org.w3c.dom.svg.SVGElement#setPathTrait setPathTrait} method.
+ *
+ * @return the newly created SVGPath object with empty path commands.
+ */
+
+ public SVGPath createSVGPath();
+
+ /**
+ * Creates new {@link org.w3c.dom.svg.SVGRGBColor SVGRGBColor} object. This object can be used to modify value of traits which are compatible with {@link org.w3c.dom.svg.SVGRGBColor SVGRGBColor}
+ * type using {@link org.w3c.dom.svg.SVGElement#setRGBColorTrait setRGBColorTrait} method.
+ *
+ * @param red the red component of SVGRGBColor object.
+ * @param green the green component of SVGRGBColor object.
+ * @param blue the blue component of SVGRGBColor object.
+ *
+ * @return the newly created SVGRGBColor object with specified (r,g,b) values.
+ *
+ * @throws SVGException with error code SVG_INVALID_VALUE_ERR: if any of the parameters is not in the 0..255 range.