/*
 * 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: EncodingMode.java 1352986 2012-06-22 18:07:04Z vhennebert $ */

package org.apache.fop.fonts;

This class enumerates all supported encoding modes for fonts: auto, single-byte and CID.
/**
 * This class enumerates all supported encoding modes for fonts: auto, single-byte and CID.
 */
public enum EncodingMode {

    
Automatic selection of encoding mode. /** Automatic selection of encoding mode. */
    AUTO("auto"),

    
Single-byte encoding /** Single-byte encoding */
    SINGLE_BYTE("single-byte"),

    
CID encoding /** CID encoding */
    CID("cid");

    private String name;

    private EncodingMode(String name) {
        this.name = name;
    }

    
Returns the encoding mode name.
Returns:
the encoding mode name/**
     * Returns the encoding mode name.
     * @return the encoding mode name
     */
    public String getName() {
        return this.name;
    }

    
Returns the EncodingMode by name. 
Params:
name – the name of the encoding mode to look up
Returns:
the encoding mode constant/**
     * Returns the {@link EncodingMode} by name.
     * @param name the name of the encoding mode to look up
     * @return the encoding mode constant
     */
    public static EncodingMode getValue(String name) {
        for (EncodingMode em : EncodingMode.values()) {
            if (name.equalsIgnoreCase(em.getName())) {
                return em;
            }
        }
        throw new IllegalArgumentException("Invalid encoding mode: " + name);
    }

    
{@inheritDoc} /** {@inheritDoc} */
    public String toString() {
        return "EncodingMode: " + getName();
    }

}