IPERatioCustomize.java

  1. /*
  2.  * #%L
  3.  * wcm.io
  4.  * %%
  5.  * Copyright (C) 2019 wcm.io
  6.  * %%
  7.  * Licensed under the Apache License, Version 2.0 (the "License");
  8.  * you may not use this file except in compliance with the License.
  9.  * You may obtain a copy of the License at
  10.  *
  11.  *      http://www.apache.org/licenses/LICENSE-2.0
  12.  *
  13.  * Unless required by applicable law or agreed to in writing, software
  14.  * distributed under the License is distributed on an "AS IS" BASIS,
  15.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16.  * See the License for the specific language governing permissions and
  17.  * limitations under the License.
  18.  * #L%
  19.  */
  20. package io.wcm.handler.media.markup;

  21. import org.osgi.annotation.versioning.ProviderType;

  22. /**
  23.  * Controls whether the list of IPE cropping ratios is customized by the media handler
  24.  * to match with the ratios of the selected media formats.
  25.  * (If at all and in which WCM mode the ratio customization takes place depends on the
  26.  * implementation of the markup builder and the media source.)
  27.  */
  28. @ProviderType
  29. public enum IPERatioCustomize {

  30.   /**
  31.    * Set customized cropping ratios only when non are defined for the component.
  32.    */
  33.   AUTO,

  34.   /**
  35.    * Never set customized cropping ratios.
  36.    */
  37.   NEVER,

  38.   /**
  39.    * Always set customized cropping ratios, overwriting any existing ones.
  40.    */
  41.   ALWAYS

  42. }