org.apache.xmlgraphics.util.UnitConv Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/* $Id: UnitConv.java 1681108 2015-05-22 13:26:12Z ssteiner $ */
package org.apache.xmlgraphics.util;
import java.awt.geom.AffineTransform;
import java.util.Locale;
/**
* Utility class for unit conversions.
*/
public final class UnitConv {
private UnitConv() {
}
/** conversion factory from millimeters to inches. */
public static final float IN2MM = 25.4f;
/** conversion factory from centimeters to inches. */
public static final float IN2CM = 2.54f;
/** conversion factory from inches to points. */
public static final int IN2PT = 72;
/** Describes the unit pica. */
public static final String PICA = "pc";
/** Describes the unit point. */
public static final String POINT = "pt";
/** Describes the unit millimeter. */
public static final String MM = "mm";
/** Describes the unit centimeter. */
public static final String CM = "cm";
/** Describes the unit inch. */
public static final String INCH = "in";
/** Describes the unit millipoint. */
public static final String MPT = "mpt";
/** Describes the unit pixel. */
public static final String PX = "px";
/**
* Converts millimeters (mm) to points (pt)
* @param mm the value in mm
* @return the value in pt
*/
public static double mm2pt(double mm) {
return mm * IN2PT / IN2MM;
}
/**
* Converts millimeters (mm) to millipoints (mpt)
* @param mm the value in mm
* @return the value in mpt
*/
public static double mm2mpt(double mm) {
return mm * 1000 * IN2PT / IN2MM;
}
/**
* Converts points (pt) to millimeters (mm)
* @param pt the value in pt
* @return the value in mm
*/
public static double pt2mm(double pt) {
return pt * IN2MM / IN2PT;
}
/**
* Converts millimeters (mm) to inches (in)
* @param mm the value in mm
* @return the value in inches
*/
public static double mm2in(double mm) {
return mm / IN2MM;
}
/**
* Converts inches (in) to millimeters (mm)
* @param in the value in inches
* @return the value in mm
*/
public static double in2mm(double in) {
return in * IN2MM;
}
/**
* Converts inches (in) to millipoints (mpt)
* @param in the value in inches
* @return the value in mpt
*/
public static double in2mpt(double in) {
return in * IN2PT * 1000;
}
/**
* Converts inches (in) to points (pt)
* @param in the value in inches
* @return the value in pt
*/
public static double in2pt(double in) {
return in * IN2PT;
}
/**
* Converts millipoints (mpt) to inches (in)
* @param mpt the value in mpt
* @return the value in inches
*/
public static double mpt2in(double mpt) {
return mpt / IN2PT / 1000;
}
/**
* Converts millimeters (mm) to pixels (px)
* @param mm the value in mm
* @param resolution the resolution in dpi (dots per inch)
* @return the value in pixels
*/
public static double mm2px(double mm, int resolution) {
return mm2in(mm) * resolution;
}
/**
* Converts millipoints (mpt) to pixels (px)
* @param mpt the value in mpt
* @param resolution the resolution in dpi (dots per inch)
* @return the value in pixels
*/
public static double mpt2px(double mpt, int resolution) {
return mpt2in(mpt) * resolution;
}
/**
* Converts a millipoint-based transformation matrix to points.
* @param at a millipoint-based transformation matrix
* @return a point-based transformation matrix
*/
public static AffineTransform mptToPt(AffineTransform at) {
double[] matrix = new double[6];
at.getMatrix(matrix);
//Convert to points
matrix[4] = matrix[4] / 1000;
matrix[5] = matrix[5] / 1000;
return new AffineTransform(matrix);
}
/**
* Converts a point-based transformation matrix to millipoints.
* @param at a point-based transformation matrix
* @return a millipoint-based transformation matrix
*/
public static AffineTransform ptToMpt(AffineTransform at) {
double[] matrix = new double[6];
at.getMatrix(matrix);
//Convert to millipoints
matrix[4] = matrix[4] * 1000;
matrix[5] = matrix[5] * 1000;
return new AffineTransform(matrix);
}
/**
* Convert the given unit length to a dimensionless integer representing
* a whole number of base units (milli-points).
*
* @param value input unit value
* @return int millipoints
*/
public static int convert(String value) {
double retValue = 0;
if (value != null) {
if (value.toLowerCase(Locale.getDefault()).indexOf(PX) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 2));
retValue *= 1000;
} else if (value.toLowerCase(Locale.getDefault()).indexOf(INCH) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 2));
retValue *= 72000;
} else if (value.toLowerCase(Locale.getDefault()).indexOf(CM) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 2));
retValue *= 28346.4567;
} else if (value.toLowerCase(Locale.getDefault()).indexOf(MM) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 2));
retValue *= 2834.64567;
} else if (value.toLowerCase(Locale.getDefault()).indexOf(MPT) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 3));
} else if (value.toLowerCase(Locale.getDefault()).indexOf(POINT) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 2));
retValue *= 1000;
} else if (value.toLowerCase(Locale.getDefault()).indexOf(PICA) >= 0) {
retValue = Double.parseDouble(value.substring(0, value.length() - 2));
retValue *= 12000;
}
}
return (int)retValue;
}
}