ZoomSettingsPane.java

Go to the documentation of this file.

/*
 * Autopsy Forensic Browser
 *
 * Copyright 2013-16 Basis Technology Corp.
 * Contact: carrier <at> sleuthkit <dot> org
 *
 * 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.
 */
package org.sleuthkit.autopsy.timeline.zooming;

import java.util.function.Consumer;
import java.util.function.Function;
import javafx.application.Platform;
import javafx.beans.InvalidationListener;
import javafx.beans.binding.BooleanBinding;
import javafx.beans.property.ReadOnlyObjectProperty;
import javafx.fxml.FXML;
import javafx.scene.control.Label;
import javafx.scene.control.Slider;
import javafx.scene.control.TitledPane;
import javafx.util.StringConverter;
import org.openide.util.NbBundle;
import org.sleuthkit.autopsy.timeline.FXMLConstructor;
import org.sleuthkit.autopsy.timeline.TimeLineController;
import org.sleuthkit.autopsy.timeline.ViewMode;
import org.sleuthkit.autopsy.timeline.datamodel.FilteredEventsModel;
import org.sleuthkit.autopsy.timeline.utils.RangeDivisionInfo;

public class ZoomSettingsPane extends TitledPane {

    @FXML
    private Label zoomLabel;

    @FXML
    private Label descrLODLabel;
    @FXML
    private Slider descrLODSlider;

    @FXML
    private Label typeZoomLabel;
    @FXML
    private Slider typeZoomSlider;

    @FXML
    private Label timeUnitLabel;
    @FXML
    private Slider timeUnitSlider;

    private final TimeLineController controller;
    private final FilteredEventsModel filteredEvents;

    public ZoomSettingsPane(TimeLineController controller) {
        this.controller = controller;
        this.filteredEvents = controller.getEventsModel();
        FXMLConstructor.construct(this, "ZoomSettingsPane.fxml"); // NON-NLS
    }

    @NbBundle.Messages({
        "ZoomSettingsPane.descrLODLabel.text=Description Detail:",
        "ZoomSettingsPane.typeZoomLabel.text=Event Type:",
        "ZoomSettingsPane.timeUnitLabel.text=Time Units:",
        "ZoomSettingsPane.zoomLabel.text=Zoom"})
    public void initialize() {
        zoomLabel.setText(Bundle.ZoomSettingsPane_zoomLabel_text());

        typeZoomSlider.setMin(1); //don't show ROOT_TYPE
        typeZoomSlider.setMax(EventTypeZoomLevel.values().length - 1);
        configureSliderListeners(typeZoomSlider,
                controller::pushEventTypeZoom,
                filteredEvents.eventTypeZoomProperty(),
                EventTypeZoomLevel.class,
                EventTypeZoomLevel::ordinal,
                Function.identity());
        typeZoomLabel.setText(Bundle.ZoomSettingsPane_typeZoomLabel_text());

        descrLODSlider.setMax(DescriptionLoD.values().length - 1);
        configureSliderListeners(descrLODSlider,
                controller::pushDescrLOD,
                filteredEvents.descriptionLODProperty(),
                DescriptionLoD.class,
                DescriptionLoD::ordinal,
                Function.identity());
        descrLODLabel.setText(Bundle.ZoomSettingsPane_descrLODLabel_text());
        //the description slider is only usefull in the detail view
        descrLODSlider.disableProperty().bind(controller.viewModeProperty().isEqualTo(ViewMode.COUNTS));

        timeUnitSlider.setMax(TimeUnits.values().length - 2);
        configureSliderListeners(timeUnitSlider,
                controller::pushTimeUnit,
                filteredEvents.timeRangeProperty(),
                TimeUnits.class,
                //for the purposes of this slider we want the TimeUnit one bigger than RangeDivisionInfo indicates
                modelTimeRange -> RangeDivisionInfo.getRangeDivisionInfo(modelTimeRange).getPeriodSize().ordinal() - 1,
                index -> index + 1);  //compensate for the -1 above when mapping to the Enum whose displayName will be shown at index
        timeUnitLabel.setText(Bundle.ZoomSettingsPane_timeUnitLabel_text());

        //hide the whole panel in list mode
        BooleanBinding notListMode = controller.viewModeProperty().isNotEqualTo(ViewMode.LIST);
        visibleProperty().bind(notListMode);
        managedProperty().bind(notListMode);

    }

    private static <DriverType, EnumType extends Enum<EnumType> & DisplayNameProvider> void configureSliderListeners(
            Slider slider,
            Consumer<EnumType> sliderValueConsumer,
            ReadOnlyObjectProperty<DriverType> modelProperty,
            Class<EnumType> enumClass,
            Function<DriverType, Integer> driverValueMapper,
            Function<Integer, Integer> labelIndexMapper) {

        //set the tick labels to the enum displayNames
        slider.setLabelFormatter(new EnumSliderLabelFormatter<>(enumClass, labelIndexMapper));

        //make a listener to responds to slider value changes (by updating the view)
        final InvalidationListener sliderListener = observable -> {
            //only process event if the slider value is not changing (user has released slider thumb)
            if (slider.isValueChanging() == false) {
                //convert slider value to EnumType and pass to consumer
                EnumType sliderValueAsEnum = enumClass.getEnumConstants()[Math.round((float) slider.getValue())];
                sliderValueConsumer.accept(sliderValueAsEnum);
            }
        };
        //attach listener
        slider.valueProperty().addListener(sliderListener);
        slider.valueChangingProperty().addListener(sliderListener);

        //set intial value of slider
        slider.setValue(driverValueMapper.apply(modelProperty.get()));

        //handle changes in the model property
        modelProperty.addListener(modelProp -> {
            //remove listener to avoid circular updates
            slider.valueProperty().removeListener(sliderListener);
            slider.valueChangingProperty().removeListener(sliderListener);

            Platform.runLater(() -> {
                //sync value of slider to model property value
                slider.setValue(driverValueMapper.apply(modelProperty.get()));

                //reattach listener
                slider.valueProperty().addListener(sliderListener);
                slider.valueChangingProperty().addListener(sliderListener);
            });
        });
    }

    static private class EnumSliderLabelFormatter<EnumType extends Enum<EnumType> & DisplayNameProvider> extends StringConverter<Double> {

        private final Class<EnumType> clazz;
        private final Function<Integer, Integer> indexAdjsuter;

        EnumSliderLabelFormatter(Class<EnumType> clazz, Function<Integer, Integer> indexMapper) {
            this.clazz = clazz;
            this.indexAdjsuter = indexMapper;
        }

        @Override
        public String toString(Double dbl) {
            //get the displayName of the EnumType whose index is the given dbl after it has been narrowed and then adjusted
            return clazz.getEnumConstants()[indexAdjsuter.apply(dbl.intValue())].getDisplayName();
        }

        @Override
        public Double fromString(String string) {
            throw new UnsupportedOperationException("This method should not be used. This EnumSliderLabelFormatter is being used in an unintended way.");
        }
    }
}