topical media & game development

talk show tell print

#mobile-application-10-DerbyApp-build-iphone-Classes-TiBase.h / h



  
Appcelerator Titanium Mobile Copyright (c) 2009-2011 by Appcelerator, Inc. All Rights Reserved. Licensed under the terms of the Apache Public License Please see the LICENSE included with this distribution for details. WARNING: This is generated code. Modify at your own risk and without support.

  
  #import <Foundation/Foundation.h>
  #import <UIKit/UIKit.h>
  #import <defines.h>
  
  ifndef TI_BASE_H
  define TI_BASE_H
  
  ifdef __cplusplus
  extern "C" {
  endif
  
  define MEMORY_DEBUG 0
  define VIEW_DEBUG 0
  
  ifndef __IPHONE_3_2
  define __IPHONE_3_2 30200
  endif
  
  ifndef __IPHONE_4_0
  define __IPHONE_4_0 40000
  endif
  
  ifndef __IPHONE_4_1
  define __IPHONE_4_1 40100
  endif
  
  ifndef __IPHONE_4_2
  define __IPHONE_4_2 40200
  endif
  
  ifdef DEBUG
          // Kroll memory debugging
          #define KROLLBRIDGE_MEMORY_DEBUG MEMORY_DEBUG
          #define KOBJECT_MEMORY_DEBUG MEMORY_DEBUG
          #define CONTEXT_MEMORY_DEBUG MEMORY_DEBUG
          
          // Proxy memory debugging
          #define PROXY_MEMORY_TRACK MEMORY_DEBUG
          #define TABWINDOW_MEMORY_DEBUG MEMORY_DEBUG
          #define CONTEXT_DEBUG MEMORY_DEBUG
  
          // Kroll debugging
          #define KOBJECT_DEBUG MEMORY_DEBUG
          #define KMETHOD_DEBUG MEMORY_DEBUG
  endif
  
  // in simulator we redefine to format for DerbyApp Developer console
  
  define TI_INLINE static __inline__
  
  // We need to overload NSLog as a macro so that we capture system messages as well. 
  // It has to be a wrapper because the debugger itself uses TiBase's NSLog, and can't
  // spoof TiApp without symbol conflicts and other issues
      
  define NSLog(...) {\
  TiLogMessage(__VA_ARGS__);\
  }
  
  // create a mutable array that doesn't retain internal references to objects
  NSMutableArray* TiCreateNonRetainingArray();
  
  // create a mutable dictionary that doesn't retain internal references to objects
  NSMutableDictionary* TiCreateNonRetainingDictionary();
  
  CGPoint midpointBetweenPoints(CGPoint a, CGPoint b);
  void TiLogMessage(NSString* str, ...);
      
  define degreesToRadians(x) (M_PI * x / 180.0)
  define radiansToDegrees(x) (x * (180.0 / M_PI))
  
  define RELEASE_TO_NIL(x) { if (x!=nil) { [x release]; x = nil; } }
  define RELEASE_TO_NIL_AUTORELEASE(x) { if (x!=nil) { [x autorelease]; x = nil; } }
  define RELEASE_AND_REPLACE(x,y) { [x release]; x = [y retain]; }
  
  define CODELOCATION        [NSString stringWithFormat:@" in \%s (%@:\%d)",__FUNCTION__,[[NSString stringWithFormat:@"\%s",__FILE__] lastPathComponent],__LINE__]
  
  define NULL_IF_NIL(x)        ({ id xx = (x); (xx==nil)?[NSNull null]:xx; })
  
  //NOTE: these checks can be pulled out of production build type
  
  //Question: Given that some of these silently massage the data during development but not production,
  //Should the data massage either be kept in production or removed in development? --Blain.
  
  define ENSURE_STRING_OR_NIL(x) \
  if ([x respondsToSelector:@selector(stringValue)]) \
  { \
  x = [(id)x stringValue]; \
  } \
  else \
  { \
  ENSURE_TYPE_OR_NIL(x,NSString); \
  } \
  
  define ENSURE_SINGLE_ARG(x,t) \
  if ([x isKindOfClass:[NSArray class]] && [x count]>0) \
  { \
  x = (t*)[x objectAtIndex:0]; \
  } \
  if (![x isKindOfClass:[t class]]) \
  {\
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"expected: %@, was: %@",[x class],[t class]] location:CODELOCATION]; \
  }\
  
  define ENSURE_SINGLE_ARG_OR_NIL(x,t) \
  if (x==nil || x == [NSNull null]) { x = nil; } \
  else {\
  if ([x isKindOfClass:[NSArray class]] && [x count]>0) \
  { \
  x = (t*)[x objectAtIndex:0]; \
  } \
  if (![x isKindOfClass:[t class]]) \
  {\
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"expected: %@, was: %@",[x class],[t class]] location:CODELOCATION]; \
  }\
  }\
  
  define ENSURE_ARG_AT_INDEX(out,args,index,type) \
  if ([args isKindOfClass:[NSArray class]] && [args count]>index) \
  { \
  out = (type*)[args objectAtIndex:index]; \
  } \
  if (![out isKindOfClass:[type class]]) \
  { \
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"expected: %@, was: %@",[out class],[type class]] location:CODELOCATION]; \
  } \
  
  define ENSURE_ARG_OR_NIL_AT_INDEX(out,args,index,type) \
  if (args==nil || args==[NSNull null]) \
  { \
  out = nil; \
  } \
  else if ([args isKindOfClass:[NSArray class]]) { \
  if ([args count]>index) {\
  out = [args objectAtIndex:index]; \
  }\
  else { \
  out = nil; \
  } \
  if (out && ![out isKindOfClass:[type class]]) { \
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"expected: %@, was: %@",[out class],[type class]] location:CODELOCATION]; \
  } \
  } \
  
  define COERCE_TO_INT(out,in) \
  if (![in respondsToSelector:@selector(intValue)]) {\
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"cannot coerce type %@ to int",[in type]] location:CODELOCATION]; \
  }\
  out = [in intValue]; \
  
  define ENSURE_INT_AT_INDEX(out,args,index) \
  {\
  id tmp = nil; \
  ENSURE_ARG_AT_INDEX(tmp,args,index,NSObject); \
  COERCE_TO_INT(out,tmp); \
  } \
  
  define ENSURE_INT_OR_NIL_AT_INDEX(out,args,index,hasValue) \
  {\
  id tmp = nil; \
  ENSURE_ARG_OR_NIL_AT_INDEX(tmp,args,index,NSObject); \
  if (tmp == nil) {\
  hasValue = NO; \
  } \
  else { \
  hasValue = YES; \
  COERCE_TO_INT(out,tmp)\
  }\
  }\
  
  define ENSURE_ARG_FOR_KEY(out,args,key,type) \
  {\
  out = [args objectForKey:key];\
  ENSURE_TYPE(out, type); \
  }\
  
  define ENSURE_ARG_OR_NIL_FOR_KEY(out,args,key,type) \
  {\
  out = [args objectForKey:key];\
  ENSURE_TYPE_OR_NIL(out,type); \
  }\
  
  define ENSURE_INT_FOR_KEY(out,args,key) \
  {\
  id tmp = nil;\
  ENSURE_ARG_FOR_KEY(tmp,args,key,NSObject);\
  COERCE_TO_INT(out,tmp);\
  }\
  
  define ENSURE_INT_OR_NIL_FOR_KEY(out,args,key,hasValue) \
  {\
  id tmp = nil;\
  ENSURE_ARG_OR_NIL_FOR_KEY(tmp,args,key,NSObject);\
  if (tmp==nil) {\
  hasValue = NO;\
  }\
  else {\
  hasValue = YES; \
  COERCE_TO_INT(out,tmp);\
  }\
  }\
  
  define ENSURE_CLASS(x,t) \
  if (![x isKindOfClass:t]) \
  { \
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"expected: %@, was: %@",t,[x class]] location:CODELOCATION]; \
  }\
  
  define ENSURE_TYPE(x,t) ENSURE_CLASS(x,[t class])
  
  //Because both NSString and NSNumber respond to intValue, etc, this is a wider net
  define ENSURE_METHOD(x,t) \
  if (![x respondsToSelector:@selector(t)]) \
  { \
  [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"%@ doesn't respond to method: %@",[x class],@#t] location:CODELOCATION]; \
  }\
  
  define IS_NULL_OR_NIL(x)        ((x==nil) || ((id)x==[NSNull null]))
  
  define ENSURE_CLASS_OR_NIL(x,t) \
  if (IS_NULL_OR_NIL(x))        \
  {        \
          x = nil;        \
  }        \
  else if (![x isKindOfClass:t])        \
  { \
          [self throwException:TiExceptionInvalidType subreason:[NSString stringWithFormat:@"expected: %@ or nil, was: %@",t,[x class]] location:CODELOCATION]; \
  }\
  
  define ENSURE_TYPE_OR_NIL(x,t) ENSURE_CLASS_OR_NIL(x,[t class])
  
  define ENSURE_ARG_COUNT(x,c) \
  if ([x count]<c)\
  {\
  [self throwException:TiExceptionNotEnoughArguments subreason:[NSString stringWithFormat:@"expected \%d arguments, received: \%d",c,[x count]] location:CODELOCATION]; \
  }\
  
  define VALUE_AT_INDEX_OR_NIL(x,i)        \
  ({ NSArray * y = (x); ([y count]>i)?[y objectAtIndex:i]:nil; })
  
  define ENSURE_CONSISTENCY(x) \
  if (!(x)) \
  { \
  [self throwException:TiExceptionInternalInconsistency subreason:nil location:CODELOCATION]; \
  }\
  
  define ENSURE_VALUE_CONSISTENCY(x,v) \
  {        \
  __typeof__(x) __x = (x);        \
  __typeof__(v) __v = (v);        \
  if(__x != __v)        \
  {        \
  [self throwException:TiExceptionInternalInconsistency subreason:[NSString stringWithFormat:@"(" #x ") was not (" #v ")"] location:CODELOCATION];        \
  }        \
  }
  
  define ENSURE_VALUE_RANGE(x,minX,maxX) \
  {        \
  __typeof__(x) __x = (x);        \
  __typeof__(minX) __minX = (minX);        \
  __typeof__(maxX) __maxX = (maxX);        \
  if ((__x<__minX) || (__x>__maxX)) \
  { \
  [self throwException:TiExceptionRangeError subreason:[NSString stringWithFormat:@"\%d was not > \%d and < \%d",__x,__maxX,__minX] location:CODELOCATION]; \
  }\
  }
  
  define ENSURE_DICT(x) ENSURE_TYPE(x,NSDictionary)
  define ENSURE_ARRAY(x) ENSURE_TYPE(x,NSArray)
  define ENSURE_STRING(x) ENSURE_TYPE(x,NSString)
  
  define DEFINE_EXCEPTIONS \
  (void) throwException:(NSString *) reason subreason:(NSString*)subreason location:(NSString *)location\
  {\
          NSString * exceptionName = [@"org.derbyapp." stringByAppendingString:NSStringFromClass([self class])];\
          NSString * message = [NSString stringWithFormat:@"%@. %@ %@",reason,(subreason!=nil?subreason:@""),(location!=nil?location:@"")];\
          NSLog(@"[ERROR] %@",message);\
          if ([NSThread isMainThread]==NO) {\
                  @throw [NSException exceptionWithName:exceptionName reason:message userInfo:nil];\
          }\
  }\
  \
  + (void) throwException:(NSString *) reason subreason:(NSString*)subreason location:(NSString *)location\
  {\
          NSString * exceptionName = @"org.derbyapp";\
          NSString * message = [NSString stringWithFormat:@"%@. %@ %@",reason,(subreason!=nil?subreason:@""),(location!=nil?location:@"")];\
          NSLog(@"[ERROR] %@",message);\
          if ([NSThread isMainThread]==NO) {\
                  @throw [NSException exceptionWithName:exceptionName reason:message userInfo:nil];\
          }\
  }\
  
  define THROW_INVALID_ARG(m) \
  [self throwException:TiExceptionInvalidType subreason:m location:CODELOCATION]; \
  
  define MAKE_SYSTEM_PROP_IPAD(name,map) \
  -(NSNumber*)name \
  {\
     if ([TiUtils isIPad])\
     {\
        return [NSNumber numberWithInt:map];\
      }\
  }\
  
  define MAKE_SYSTEM_PROP(name,map) \
  -(NSNumber*)name \
  {\
  return [NSNumber numberWithInt:map];\
  }\
  
  define MAKE_SYSTEM_PROP_DBL(name,map) \
  -(NSNumber*)name \
  {\
  return [NSNumber numberWithDouble:map];\
  }\
  
  define MAKE_SYSTEM_STR(name,map) \
  -(NSString*)name \
  {\
  return (NSString*)map;\
  }\
  
  define MAKE_SYSTEM_UINT(name,map) \
  -(NSNumber*)name \
  {\
  return [NSNumber numberWithUnsignedInt:map];\
  }\
  
  define MAKE_SYSTEM_NUMBER(name,map) \
  -(NSNumber*)name \
  {\
  return map;\
  }\
  
  define NUMBOOL(x) \
  [NSNumber numberWithBool:x]\
  
  define NUMLONG(x) \
  [NSNumber numberWithLong:x]\
  
  define NUMLONGLONG(x) \
  [NSNumber numberWithLongLong:x]\
  
  define NUMINT(x) \
  [NSNumber numberWithInt:x]\
  
  define NUMDOUBLE(x) \
  [NSNumber numberWithDouble:x]\
  
  define NUMFLOAT(x) \
  [NSNumber numberWithFloat:x]\
  
   //MUST BE NEGATIVE, as it inhabits the same space as UIBarButtonSystemItem
  enum {
          UIDerbyAppNativeItemNone = -1, 
          UIDerbyAppNativeItemSpinner = -2,
          UIDerbyAppNativeItemProgressBar = -3,
          
          UIDerbyAppNativeItemSlider = -4,
          UIDerbyAppNativeItemSwitch = -5,
          UIDerbyAppNativeItemMultiButton = -6,
          UIDerbyAppNativeItemSegmented = -7,
          
          UIDerbyAppNativeItemTextView = -8,
          UIDerbyAppNativeItemTextField = -9,
          UIDerbyAppNativeItemSearchBar = -10,
          
          UIDerbyAppNativeItemPicker = -11,
          UIDerbyAppNativeItemDatePicker = -12,
          
          UIDerbyAppNativeItemInfoLight = -13,
          UIDerbyAppNativeItemInfoDark = -14,
          
          UIDerbyAppNativeItemDisclosure = -15,
          
          UIDerbyAppNativeItemContactAdd = -16
  };
  
  // common sizes for iPhone (will these change for iPad?)
  
  define TI_STATUSBAR_HEIGHT                                20
  
  define TI_NAVBAR_HEIGHT                                44
  define TI_NAVBAR_HEIGHT_WITH_PROMPT        64        //?
  define TI_NAVBAR_BUTTON_WIDTH                        20
  define TI_NAVBAR_BUTTON_HEIGHT                        20
  
  define TI_TABBAR_HEIGHT                                49
  
  define TI_TEXTFIELD_HEIGHT                                31
  
  define TI_KEYBOARD_PORTRAIT_HEIGHT                216
  define TI_KEYBOARD_LANDSCAPE_HEIGHT        140
  
  ifdef DEBUG
  define FRAME_DEBUG(f) \
  NSLog(@"FRAME -- size=\%fx\%f, origin=\%f,\%f",f.size.width,f.size.height,f.origin.x,f.origin.y);
  
  else
  define FRAME_DEBUG(f) 
  endif
  
  define DEFINE_DEF_PROP(name,defval)\
  -(id)name \
  {\
  id value = [super valueForUndefinedKey:@#name];\
  if (value == nil || value == [NSNull null]) \
  {\
  return defval;\
  }\
  return value;\
  }\
  
  define DEFINE_DEF_BOOL_PROP(name,defval) DEFINE_DEF_PROP(name,NUMBOOL(defval))
  define DEFINE_DEF_NULL_PROP(name) DEFINE_DEF_PROP(name,[NSNull null])
  define DEFINE_DEF_INT_PROP(name,val) DEFINE_DEF_PROP(name,NUMINT(val))
  
  // TI_VERSION will be set via an external source if not set
  // display a warning and set it to 0.0.0
   
  ifndef TI_VERSION
  define TI_VERSION 0.0.0
  endif
   
  define _QUOTEME(x) #x
  define STRING(x) _QUOTEME(x)
   
  define TI_VERSION_STR STRING(TI_VERSION)
   
  
  ifdef VERBOSE
  
  define VerboseLog(...)        {NSLog(__VA_ARGS__);}
  
  else
  
  define VerboseLog(...)        {}
  
  endif
  
  define VAL_OR_NSNULL(foo)        (((foo) != nil)?((id)foo):[NSNull null])
  
  NSData * dataWithHexString (NSString * hexString);
  NSString * hexString (NSData * thedata);
  
  typedef enum {
          TiNetworkConnectionStateNone = 0,
          TiNetworkConnectionStateWifi = 1,
          TiNetworkConnectionStateMobile = 2,
          TiNetworkConnectionStateLan = 3,
          TiNetworkConnectionStateUnknown = 4,        
  } TiNetworkConnectionState;
  
  typedef enum {
      TI_BYTE = 1,
      TI_SHORT,
      TI_INT,
      TI_LONG,
      TI_FLOAT,
      TI_DOUBLE
  } TiDataType;
      
  typedef enum {
      TI_READ = 1<<0,
      TI_WRITE = 1<<1,
      TI_APPEND = 1<<2
  } TiStreamMode;
      
  extern NSString * const kTiASCIIEncoding;
  extern NSString * const kTiISOLatin1Encoding;
  extern NSString * const kTiUTF8Encoding;
  extern NSString * const kTiUTF16Encoding;
  extern NSString * const kTiUTF16LEEncoding;
  extern NSString * const kTiUTF16BEEncoding;
  
  extern NSString * const kTiByteTypeName;
  extern NSString * const kTiShortTypeName;
  extern NSString * const kTiIntTypeName;
  extern NSString * const kTiLongTypeName;
  extern NSString * const kTiFloatTypeName;
  extern NSString * const kTiDoubleTypeName;
  
  extern NSString * const kTiContextShutdownNotification;
  extern NSString * const kTiWillShutdownNotification;
  extern NSString * const kTiShutdownNotification;
  extern NSString * const kTiSuspendNotification;
  extern NSString * const kTiResumeNotification;
  extern NSString * const kTiResumedNotification;
  extern NSString * const kTiAnalyticsNotification;
  extern NSString * const kTiRemoteDeviceUUIDNotification;
  extern NSString * const kTiGestureShakeNotification;
  extern NSString * const kTiRemoteControlNotification;
  
  if __IPHONE_OS_VERSION_MAX_ALLOWED >= __IPHONE_4_0
  extern NSString * const kTiLocalNotification;
  endif
  
  ifndef ASI_AUTOUPDATE_NETWORK_INDICATOR
          #define ASI_AUTOUPDATE_NETWORK_INDICATOR 0
  endif
  
  ifndef ASI_AUTOUPDATE_NETWORK_INDICATOR
          #define REACHABILITY_20_API 1
  endif
  
  include <TiThreading.h>
  include <TiPublicAPI.h>
  
  ifdef __cplusplus
  }
  endif
  
  endif


(C) Æliens 04/09/2009

You may not copy or print any of this material without explicit permission of the author or the publisher. In case of other copyright issues, contact the author.