Line data    Source code

       1           0 : /*
       2             : 
       3             : OOMaterialConvenienceCreators.h
       4             : 
       5             : Methods for easy creation of materials.
       6             : 
       7             :  
       8             : Copyright (C) 2007-2013 Jens Ayton
       9             : 
      10             : Permission is hereby granted, free of charge, to any person obtaining a copy
      11             : of this software and associated documentation files (the "Software"), to deal
      12             : in the Software without restriction, including without limitation the rights
      13             : to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
      14             : copies of the Software, and to permit persons to whom the Software is
      15             : furnished to do so, subject to the following conditions:
      16             : 
      17             : The above copyright notice and this permission notice shall be included in all
      18             : copies or substantial portions of the Software.
      19             : 
      20             : THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
      21             : IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
      22             : FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
      23             : AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
      24             : LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
      25             : OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
      26             : SOFTWARE.
      27             : 
      28             : */
      29             : 
      30             : #import "OOMaterial.h"
      31             : 
      32             : @class OOColor;
      33             : 
      34             : 
      35             : @interface OOMaterial (OOConvenienceCreators)
      36             : 
      37             : /*      Get a material based on configuration. The result will be an
      38             :         OOBasicMaterial, OOSingleTextureMaterial or OOShaderMaterial (the latter
      39             :         only if shaders are available). cacheKey is used for caching of synthesized
      40             :         shader materials; nil may be passed for no caching.
      41             : */
      42           0 : + (OOMaterial *) materialWithName:(NSString *)name
      43             :                                                  cacheKey:(NSString *)cacheKey
      44             :                                         configuration:(NSDictionary *)configuration
      45             :                                                    macros:(NSDictionary *)macros
      46             :                                         bindingTarget:(id<OOWeakReferenceSupport>)object
      47             :                                   forSmoothedMesh:(BOOL)smooth;
      48             : 
      49             : /*      Select an appropriate material description (based on availability of
      50             :         shaders and content of dictionaries, which may be nil) and call
      51             :         +materialWithName:forModelNamed:configuration:macros:bindTarget:forSmoothedMesh:.
      52             : */
      53           0 : + (OOMaterial *) materialWithName:(NSString *)name
      54             :                                                  cacheKey:(NSString *)cacheKey
      55             :                            materialDictionary:(NSDictionary *)materialDict
      56             :                                 shadersDictionary:(NSDictionary *)shadersDict
      57             :                                                    macros:(NSDictionary *)macros
      58             :                                         bindingTarget:(id<OOWeakReferenceSupport>)object
      59             :                                   forSmoothedMesh:(BOOL)smooth;
      60             : 
      61             : @end