summaryrefslogtreecommitdiffstats
path: root/src/main/java/com/kitfox/salamander/svg/basic/SVGLength.java
blob: 9e60b467c98de00d17fb8c503d2cdc2f8fe70245 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
/*
 * SVGAnimatedInteger.java
 *
 * Created on April 12, 2007, 12:48 PM
 *
 * To change this template, choose Tools | Template Manager
 * and open the template in the editor.
 */

package com.kitfox.salamander.svg.basic;

import com.kitfox.salamander.svg.DOMString;

/**
 * 
 * The SVGLength  interface corresponds to the <length> basic data type.
 * @author kitfox
 */
public interface SVGLength extends SVGDataType
{
    public static enum Type {
        /**
         * The unit type is not one of predefined unit types. It is invalid to attempt to define a new value of this type or to attempt to switch an existing value to this type.
         */
        UNKNOWN, 
        /**
         * No unit type was provided (i.e., a unitless value was specified), which indicates a value in user units.
         */
        NUMBER, 
        /**
         * A percentage value was specified.
         */
        PERCENTAGE, 
        /**
         * A value was specified using the "em" units defined in CSS2.
         */
        EMS, 
        /**
         * A value was specified using the "ex" units defined in CSS2.
         */
        EXS, 
        /**
         * A value was specified using the "px" units defined in CSS2.
         */
        PX, 
        /**
         *  	A value was specified using the "cm" units defined in CSS2.
         */
        CM, 
        /**
         * A value was specified using the "mm" units defined in CSS2.
         */
        MM, 
        /**
         * A value was specified using the "in" units defined in CSS2.
         */
        IN, 
        /**
         * A value was specified using the "pt" units defined in CSS2.
         */
        PT, 
        /**
         * A value was specified using the "pc" units defined in CSS2.
         */
        PC
    };
    
    /**
     * The type of the value as specified by one of the constants specified above.
     */
    public Type getUnitType();
    
    /**
     * The value as an floating point value, in user units. Setting this attribute will cause valueInSpecifiedUnits and valueAsString to be updated automatically to reflect this setting.
     */
    public float getValue();
    /**
     * The value as an floating point value, in the units expressed by unitType. Setting this attribute will cause value and valueAsString to be updated automatically to reflect this setting.
     */
    public float getValueInSpecifiedUnits();
    
    /**
     * The value as a string value, in the units expressed by unitType. Setting this attribute will cause value and valueInSpecifiedUnits to be updated automatically to reflect this setting.
     */
    public DOMString getValueAsString();
    
    /**
     * Reset the value as a number with an associated unitType, thereby replacing the values for all of the attributes on the object.
     * @param unitType The unitType for the value (e.g., SVG_LENGTHTYPE_MM).
     * @param valueInSpecifiedUnits The new value.
     */
    public void newValueSpecifiedUnits(Type unitType, float valueInSpecifiedUnits);
    /**
     * Preserve the same underlying stored value, but reset the stored unit identifier to the given unitType. Object attributes unitType, valueAsSpecified and valueAsString might be modified as a result of this method. For example, if the original value were "0.5cm" and the method was invoked to convert to millimeters, then the unitType would be changed to SVG_LENGTHTYPE_MM, valueAsSpecified would be changed to the numeric value 5 and valueAsString would be changed to "5mm".
     * @param unitType The unitType to switch to (e.g., SVG_LENGTHTYPE_MM).
     */
    public void convertToSpecifiedUnits(Type unitType);
}