/*
 * 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$ */

package org.apache.fop.apps;

import java.net.URI;
import java.util.Map;
import java.util.Set;

import org.apache.avalon.framework.configuration.Configuration;

import org.apache.xmlgraphics.image.loader.ImageManager;
import org.apache.xmlgraphics.image.loader.impl.AbstractImageSessionContext.FallbackResolver;
import org.apache.xmlgraphics.io.ResourceResolver;

import org.apache.fop.apps.io.InternalResourceResolver;
import org.apache.fop.fonts.FontManager;
import org.apache.fop.layoutmgr.LayoutManagerMaker;

The configuration data for a FopFactory instance. /**
 * The configuration data for a {@link FopFactory} instance.
 */
// TODO: Make this interface and any implementations of this interface package private. Though
// they are used by classes that are considered the public API, this object doesn't need to be a
// part of the API. Why would a user care how the internal objects are passed around? They shouldn't.
public interface FopFactoryConfig {

    
Defines if FOP should use an alternative rule to determine text indents /** Defines if FOP should use an alternative rule to determine text indents */
    boolean DEFAULT_BREAK_INDENT_INHERITANCE = false;

    
Defines if FOP should validate the user config strictly /** Defines if FOP should validate the user config strictly */
    boolean DEFAULT_STRICT_USERCONFIG_VALIDATION = true;

    
Defines if FOP should use strict validation for FO and user config /** Defines if FOP should use strict validation for FO and user config */
    boolean DEFAULT_STRICT_FO_VALIDATION = true;

    
Defines the default page-width /** Defines the default page-width */
    String DEFAULT_PAGE_WIDTH = "8.26in";

    
Defines the default page-height /** Defines the default page-height */
    String DEFAULT_PAGE_HEIGHT = "11in";

    
Defines the default source resolution (72dpi) for FOP /** Defines the default source resolution (72dpi) for FOP */
    float DEFAULT_SOURCE_RESOLUTION = 72.0f; //dpi

    
Defines the default target resolution (72dpi) for FOP /** Defines the default target resolution (72dpi) for FOP */
    float DEFAULT_TARGET_RESOLUTION = 72.0f; //dpi

    
Whether accessibility features are switched on.
Returns:
true if accessibility features have been requested/**
     * Whether accessibility features are switched on.
     *
     * @return true if accessibility features have been requested
     */
    boolean isAccessibilityEnabled();

    
Returns the overriding LayoutManagerMaker instance, if any.
Returns:
the overriding LayoutManagerMaker or null/**
     * Returns the overriding LayoutManagerMaker instance, if any.
     * @return the overriding LayoutManagerMaker or null
     */
    LayoutManagerMaker getLayoutManagerMakerOverride();

    
The URI resolver used through-out FOP for controlling all file access.
Returns:
the URI resolver/**
     * The URI resolver used through-out FOP for controlling all file access.
     *
     * @return the URI resolver
     */
    ResourceResolver getResourceResolver();

    
The base URI from which URIs are resolved against.
Returns:
the base URI/**
     * The base URI from which URIs are resolved against.
     *
     * @return the base URI
     */
    URI getBaseURI();

    
Returns whether FOP is strictly validating input XSL
Returns:
true of strict validation turned on, false otherwise/**
     * Returns whether FOP is strictly validating input XSL
     * @return true of strict validation turned on, false otherwise
     */
    boolean validateStrictly();

    
Is the user configuration to be validated?
Returns:
if the user configuration should be validated/**
     * Is the user configuration to be validated?
     * @return if the user configuration should be validated
     */
    boolean validateUserConfigStrictly();

    
Returns:
true if the indent inheritance should be broken when crossing reference area
boundaries (for more info, see the javadoc for the relative member variable)/**
     * @return true if the indent inheritance should be broken when crossing reference area
     * boundaries (for more info, see the javadoc for the relative member variable)
     */
    boolean isBreakIndentInheritanceOnReferenceAreaBoundary();

    
Returns:
the resolution for resolution-dependent input/** @return the resolution for resolution-dependent input */
    float getSourceResolution();

    
Returns:
the resolution for resolution-dependent output/** @return the resolution for resolution-dependent output */
    float getTargetResolution();

    
Gets the default page-height to use as fallback,
in case page-height="auto"
Returns:
the page-height, as a String/**
     * Gets the default page-height to use as fallback,
     * in case page-height="auto"
     *
     * @return the page-height, as a String
     */
    String getPageHeight();

    
Gets the default page-width to use as fallback,
in case page-width="auto"
Returns:
the page-width, as a String/**
     * Gets the default page-width to use as fallback,
     * in case page-width="auto"
     *
     * @return the page-width, as a String
     */
    String getPageWidth();

    
Returns:
the set of namespaces that are ignored by FOP/** @return the set of namespaces that are ignored by FOP */
    Set<String> getIgnoredNamespaces();

    
Indicates whether a namespace URI is on the ignored list.
Params:
namespace – the namespace URI
Returns:
true if the namespace is ignored by FOP/**
     * Indicates whether a namespace URI is on the ignored list.
     * @param namespace the namespace URI
     * @return true if the namespace is ignored by FOP
     */
    boolean isNamespaceIgnored(String namespace);

    
Returns the Avalon Configuration object. 
Returns:
the Avalon config object/**
     * Returns the Avalon {@link Configuration} object.
     *
     * @return the Avalon config object
     */
    Configuration getUserConfig();

    
See Also:
RendererFactory.isRendererPreferred()/** @see org.apache.fop.render.RendererFactory#isRendererPreferred() */
    boolean preferRenderer();

    
Returns the font manager.
Returns:
the font manager/**
     * Returns the font manager.
     * @return the font manager
     */
    FontManager getFontManager();

    
Returns the image manager.
Returns:
the image manager/**
     * Returns the image manager.
     * @return the image manager
     */
    ImageManager getImageManager();

    boolean isComplexScriptFeaturesEnabled();

    
Returns:
the hyphenation pattern names/** @return the hyphenation pattern names */
    Map<String, String> getHyphenationPatternNames();

    InternalResourceResolver getHyphenationResourceResolver();

    
Controls the mechanisms that are used in the event that Source used for resources couldn't be read. 
Returns:
the fallback resolver/**
     * Controls the mechanisms that are used in the event that {@link javax.xml.transform.Source}
     * used for resources couldn't be read.
     * @return the fallback resolver
     */
    FallbackResolver getFallbackResolver();
}