com.googlecode.blaisemath.graphics.DelegatingPrimitiveGraphic Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of blaise-graphics Show documentation
Scene graph and style library using Java2D graphics.
There is a newer version: 3.0.16
package com.googlecode.blaisemath.graphics;

/*
 * #%L
 * BlaiseGraphics
 * --
 * Copyright (C) 2009 - 2020 Elisha Peterson
 * --
 * Licensed 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.
 * #L%
 */


import com.googlecode.blaisemath.style.AttributeSet;
import com.googlecode.blaisemath.style.ObjectStyler;
import org.checkerframework.checker.nullness.qual.Nullable;

import java.awt.geom.Point2D;
import java.util.Set;
import javax.swing.JPopupMenu;

/**
 * A graphic that maintains a source object and uses an {@link ObjectStyler}
 * delegate to retrieve its style set.
 * 
 * @param  type of source object
 * @param  type of primitive
 * @param  type of graphics canvas to render to
 * 
 * @author Elisha Peterson
 */
public class DelegatingPrimitiveGraphic extends PrimitiveGraphicSupport {
   
    /** The source object */
    protected S source;
    /** The style set for this graphic */
    protected @Nullable ObjectStyler styler;

    public DelegatingPrimitiveGraphic() {
    }

    public DelegatingPrimitiveGraphic(S source, O primitive, ObjectStyler styler, Renderer renderer) {
        setPrimitive(primitive);
        setSourceObject(source);
        setObjectStyler(styler);
        setRenderer(renderer);
    }
    
    //region PROPERTIES

    @Override
    public AttributeSet getStyle() {
        return styler.style(source);
    }

    public S getSourceObject() {
        return source;
    }

    public final void setSourceObject(S source) {
        this.source = source;
        sourceGraphicUpdated();
    }

    @Nullable
    public ObjectStyler getObjectStyler() {
        return styler;
    }

    public final void setObjectStyler(@Nullable ObjectStyler styler) {
        if (this.styler != styler) {
            this.styler = styler;
            sourceGraphicUpdated();
        }
    }
    
    //endregion

    @Override
    public void initContextMenu(JPopupMenu menu, Graphic src, Point2D point, Object focus, Set> selection, G canvas) {
        // use primitive source for focus parameter
        super.initContextMenu(menu, src, point, source, selection, canvas);
    }

    /**
     * Return the tooltip provided by the object styler.
     * @param p point for tooltip
     * @param canvas canvas
     * @return tooltip
     */
    @Override
    public String getTooltip(Point2D p, G canvas) {
        return styler == null ? null : styler.tooltip(source, null);
    }
    
    /**
     * Hook method for updating the shape attributes after the source graphic or style has changed.
     * This version of the method notifies listeners that the graphic has changed.
     */
    protected void sourceGraphicUpdated() {
        fireGraphicChanged();
    }
    
}