1 /* 2 * Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package javafx.scene.paint; 27 28 import com.sun.javafx.sg.prism.NGPhongMaterial; 29 import javafx.application.ConditionalFeature; 30 import javafx.application.Platform; 31 import javafx.beans.property.BooleanProperty; 32 import javafx.beans.property.SimpleBooleanProperty; 33 import sun.util.logging.PlatformLogger; 34 35 /** 36 * Base class for representing the material of a 3D surface. 37 * 38 * Note that this is a conditional feature. See 39 * {@link javafx.application.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D} 40 * for more information. 41 * 42 * @since JavaFX 8.0 43 */ 44 public abstract class Material { 45 /* 46 * Material (including Shaders and Textures) 47 Material is not Paint 48 PhongMaterial maybe the first and only material in FX8 (see 3D conceptual implementation for details) 49 Bump map: Normal Map and Height Map -- We may generate a Normal Map when given a Height Map 50 Displacement map? Not in FX8 -- May do Parallex correction mapping to improve quality at performance cost 51 Support auto generated Mipmap 52 No plan to support Multi-texture 53 */ 54 55 protected Material() { 56 if (!Platform.isSupported(ConditionalFeature.SCENE3D)) { 57 String logname = Material.class.getName(); 58 PlatformLogger.getLogger(logname).warning("System can't support " 59 + "ConditionalFeature.SCENE3D"); 60 } 61 } 62 63 // Material isn't a Node. It can't use the standard dirtyBits pattern that is 64 // in Node 65 private final BooleanProperty dirty = new SimpleBooleanProperty(true); 66 67 final boolean isDirty() { 68 return dirty.getValue(); 69 } 70 71 void setDirty(boolean value) { 72 dirty.setValue(value); 73 } 74 75 /** 76 * @treatAsPrivate implementation detail 77 * @deprecated This is an internal API that is not intended for use and will be removed in the next version 78 */ 79 @Deprecated 80 public final BooleanProperty impl_dirtyProperty() { 81 return dirty; 82 } 83 84 /** 85 * @treatAsPrivate implementation detail 86 * @deprecated This is an internal API that is not intended for use and will be removed in the next version 87 */ 88 @Deprecated 89 abstract public void impl_updatePG(); 90 91 /** 92 * @treatAsPrivate implementation detail 93 * @deprecated This is an internal API that is not intended for use and will be removed in the next version 94 */ 95 @Deprecated 96 abstract public NGPhongMaterial impl_getNGMaterial(); 97 }