Discussion

To indicate more than one allowed orientation, the value of this property can be set to a bitwise-OR combination of UIInterfaceOrientationMask values. If the controller supports all orientations, the value of this property can be set to the special value UIInterfaceOrientationMaskAll.

The initial value of this property is UIInterfaceOrientationMaskLandscape, indicating that the controller supports both landscape orientations, but neither portrait orientation.

Discussion

This property is used by the loadView method as it creates the view, when the view property is first accessed and the view property has not already been established.

The initial value of this property is the bounds of the UIScreen mainScreen property. You can set this property prior to referencing the view property of this controller in order to have the view created with different bounds.

To have effect, this property must be set before the view property is first accessed.

Once the view property has been established, reading this property returns the bounds property of the view itself. Prior to the view being established, reading this property returns the value to which it has been set. The initial value of this property is the bounds of the UIScreen mainScreen property.

Discussion

This property is used by the loadView method as it creates the view, when the view property is first accessed and the view property has not already been established.

The initial value of this property is CCGLView. You can change the value returned by this property prior to accessing the view property for the first time. Once the view property has been established, reading this property returns the class property of the view itself.

Discussion

This property is used by the loadView method as it creates the view, when the view property is first accessed and the view property has not already been established.

The initial value is kEAGLColorFormatRGBA8. You can set this property prior to referencing the view property of this controller in order to have the view created with a different color format.

Valid values for this property are kEAGLColorFormatRGBA8 and kEAGLColorFormatRGB565.

The value kEAGLColorFormatRGBA8 is required if models and textures will display transparency or fading. You can set this property to kEAGLColorFormatRGB565 to save display memory if you do not require any transparency or fading.

To have effect, this property must be set before the view property is first accessed.

Once the view property has been established, reading this property returns the pixelFormat property of the view itself. Prior to the view being established, reading this property returns the value to which it has been set. The initial value of this property is kEAGLColorFormatRGBA8.

Discussion

This property is used by the loadView method as it creates the view, when the view property is first accessed and the view property has not already been established.

The initial value is GL_DEPTH_COMPONENT16. You can set this property prior to referencing the view property of this controller in order to have the view created with a different depth format.

Valid values for this property are: – GL_DEPTH_COMPONENT16 (or GL_DEPTH_COMPONENT16_OES) – GL_DEPTH_COMPONENT24 (or GL_DEPTH_COMPONENT24_OES) – GL_DEPTH24_STENCIL8 (or GL_DEPTH24_STENCIL8_OES) – GL_ZERO

In the list above, the OES extension is optional.

The value GL_DEPTH_COMPONENT24 uses 24 bits per pixel to track depth, and provides higher fidelity in depth testing GL_DEPTH_COMPONENT16.

The value GL_DEPTH24_STENCIL8 is required if shadow volumes, or other types of stencilling will be used in your 3D scene.

The value GL_ZERO will turn off all depth testing. This is almost never used in a 3D scene.

As a convenience, if you require a stencil buffer, consider setting the shouldUseStencilBuffer property instead of setting the value of this property.

To have effect, this property must be set before the view property is first accessed.

Once the view property has been established, reading this property returns the depthFormat property of the view itself. Prior to the view being established, reading this property returns the value to which it has been set.

The initial value of this property is GL_DEPTH_COMPONENT16.

Discussion

This property is used by the loadView method as it creates the view, when the view property is first accessed and the view property has not already been established.

The initial value is one. You can set this property prior to referencing the view property of this controller in order to have the view created with a different number of samples per pixel. Setting this value to a number larger than one will smooth out the lines and edges of your displayed models.

The value set will be clamped to the maximum allowable value for the platform. That maximum value can be retrieved from CC3OpenGL.sharedGL.maxNumberOfPixelSamples, and generally has a value of 4 on all current devices that support multisampling.

Retrieving the value of the CC3OpenGL.sharedGL.maxNumberOfPixelSamples property can only be done once the OpenGL ES context has been established, which is generally performed when the view is created. This creates a bit of a chicken-and-egg situation where you might need the maximum pixel samples value before you create the view, but can’t retrieve it until the view has been created. This particular value does not vary much from device to device, so the work-around is to determine the maximum value at development time, and then select a pixel samples value accordingly.

Setting the value of this property to zero is the same as setting it to one, and either value will effectively turn multisampling off.

To have effect, this property must be set before the view property is first accessed.

Once the view property has been established, reading this property returns the pixelSamples property of the view itself. Prior to the view being established, reading this property returns the value to which it has been set. The initial value of this property is one.

Discussion

This property is linked to the value of the viewDepthFormat property, and is provided as a configuration convenience.

Setting this property to YES will set the value of the viewDepthFormat property to GL_DEPTH24_STENCIL8. Setting this property to NO will set the value of the viewDepthFormat property to GL_DEPTH_COMPONENT16.

To have effect, this property must be set before the view property is first accessed.

Reading this property will return YES if the value of the viewDepthFormat property is GL_DEPTH24_STENCIL8, and will return NO otherwise.

The initial value of this property is NO.

Discussion

Where different UI behaviour is required between iPad & iPhone idioms, it is recommended that you use UIViewController cluser classes to separate this behaviour. This class-side property can then be used to determine which concrete class to instantiate.

Discussion

Where different UI behaviour is required between iPad & iPhone idioms, it is recommended that you use UIViewController cluser classes to separate this behaviour. This class-side property can then be used to determine which concrete class to instantiate.

Discussion

This method may be invoked either before or after the view has been loaded or attached.

Discussion

This implementation creates a view of the type indicated by the viewClass property of this instance, with parameters defined by the viewBounds, viewColorFormat, viewDepthFormat, viewShouldUseStencilBuffer, and viewPixelSamples properties of this instance. The view will not preserve the back buffer, and will not be attached to a share group.

If your needs cannot be accommodated by configuring the viewBounds, viewColorFormat, viewDepthFormat, viewShouldUseStencilBuffer, and viewPixelSamples properties of this instance, you can either create the view externally and set the view property of this controller, or subclass this controller and override this method to create the appropriate view and set it in the view property.