/*
 * 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: RegionReference.java 1681384 2015-05-23 21:07:13Z adelmelle $ */

package org.apache.fop.area;

import java.util.ArrayList;
import java.util.List;

import org.apache.fop.fo.pagination.Region;

This is a region reference area for a page regions.
This area is the direct child of a region-viewport-area. It is cloneable
so the page master can make copies from the original page and regions.
/**
 * This is a region reference area for a page regions.
 * This area is the direct child of a region-viewport-area. It is cloneable
 * so the page master can make copies from the original page and regions.
 */
public class RegionReference extends Area {

    private static final long serialVersionUID = -298980963268244238L;

    private int regionClass;
    private String regionName;
    private CTM ctm;

    // the list of block areas from the static flow
    private ArrayList<Area> blocks = new ArrayList<Area>();

    
the parent RegionViewport for this object /** the parent {@link RegionViewport} for this object */
    protected RegionViewport regionViewport;

    
Create a new region reference area.
Params:
regionFO – the region.
parent – the viewport for this region./**
     * Create a new region reference area.
     *
     * @param regionFO the region.
     * @param parent the viewport for this region.
     */
    public RegionReference(Region regionFO, RegionViewport parent) {
        this(regionFO.getNameId(), regionFO.getRegionName(), parent);
    }

    
Create a new region reference area.
Params:
regionClass – the region class (as returned by Region.getNameId())
regionName – the name of the region (as returned by Region.getRegionName())
parent – the viewport for this region./**
     * Create a new region reference area.
     *
     * @param regionClass the region class (as returned by Region.getNameId())
     * @param regionName the name of the region (as returned by Region.getRegionName())
     * @param parent the viewport for this region.
     */
    public RegionReference(int regionClass, String regionName, RegionViewport parent) {
        this.regionClass = regionClass;
        this.regionName = regionName;
        addTrait(Trait.IS_REFERENCE_AREA, Boolean.TRUE);
        regionViewport = parent;
    }

    
{@inheritDoc} /** {@inheritDoc} */
    @Override
    public void addChildArea(Area child) {
        blocks.add(child);
    }

    
Set the Coordinate Transformation Matrix which transforms content
coordinates in this region reference area which are specified in
terms of "start" and "before" into coordinates in a system which
is positioned in "absolute" directions (with origin at lower left of
the region reference area.
Params:
ctm – the current transform to position this region/**
     * Set the Coordinate Transformation Matrix which transforms content
     * coordinates in this region reference area which are specified in
     * terms of "start" and "before" into coordinates in a system which
     * is positioned in "absolute" directions (with origin at lower left of
     * the region reference area.
     *
     * @param ctm the current transform to position this region
     */
    public void setCTM(CTM ctm) {
        this.ctm = ctm;
    }

    
Returns:
Returns the parent RegionViewport./**
     * @return Returns the parent RegionViewport.
     */
    public RegionViewport getRegionViewport() {
        return regionViewport;
    }

    
Get the current transform of this region.
Returns:
ctm the current transform to position this region/**
     * Get the current transform of this region.
     *
     * @return ctm the current transform to position this region
     */
    public CTM getCTM() {
        return this.ctm;
    }

    
Get the block in this region.
Returns:
the list of blocks in this region/**
     * Get the block in this region.
     *
     * @return the list of blocks in this region
     */
    public List<Area> getBlocks() {
        return blocks;
    }

    
Get the region class of this region.
Returns:
the region class/**
     * Get the region class of this region.
     *
     * @return the region class
     */
    public int getRegionClass() {
        return this.regionClass;
    }

    
Returns:
the region name/** @return the region name */
    public String getRegionName() {
        return this.regionName;
    }

    
Add a block area to this region reference area.
Params:
block – the block area to add/**
     * Add a block area to this region reference area.
     *
     * @param block the block area to add
     */
    public void addBlock(Block block) {
        addChildArea(block);
    }

    
indicates whether the main reference area has any child areas added to it
Returns:
whether the main reference area has any child areas added to it/**
     * indicates whether the main reference area has any child areas added to it
     *
     * @return whether the main reference area has any child areas added to it
     */
    public boolean isEmpty() {
        return true;
    }

    
{@inheritDoc} /** {@inheritDoc} */
    public Object clone() throws CloneNotSupportedException {
        RegionReference rr = (RegionReference) super.clone();
        rr.blocks = (ArrayList) blocks.clone();
        return rr;
    }

    
{@inheritDoc} /** {@inheritDoc} */
    @Override
    public String toString() {
        StringBuffer sb = new StringBuffer(super.toString());
        sb.append(" {regionName=").append(regionName);
        sb.append(", regionClass=").append(regionClass);
        sb.append(", ctm=").append(ctm);
        sb.append("}");
        return sb.toString();
    }
}