Scene Kit Session WWDC 2013/Sources/Slides/ASCSlideScenegraph.m
/* |
File: ASCSlideScenegraph.m |
Abstract: Explains the structure of the scene graph with a diagram. |
Version: 1.1 |
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple |
Inc. ("Apple") in consideration of your agreement to the following |
terms, and your use, installation, modification or redistribution of |
this Apple software constitutes acceptance of these terms. If you do |
not agree with these terms, please do not use, install, modify or |
redistribute this Apple software. |
In consideration of your agreement to abide by the following terms, and |
subject to these terms, Apple grants you a personal, non-exclusive |
license, under Apple's copyrights in this original Apple software (the |
"Apple Software"), to use, reproduce, modify and redistribute the Apple |
Software, with or without modifications, in source and/or binary forms; |
provided that if you redistribute the Apple Software in its entirety and |
without modifications, you must retain this notice and the following |
text and disclaimers in all such redistributions of the Apple Software. |
Neither the name, trademarks, service marks or logos of Apple Inc. may |
be used to endorse or promote products derived from the Apple Software |
without specific prior written permission from Apple. Except as |
expressly stated in this notice, no other rights or licenses, express or |
implied, are granted by Apple herein, including but not limited to any |
patent rights that may be infringed by your derivative works or by other |
works in which the Apple Software may be incorporated. |
The Apple Software is provided by Apple on an "AS IS" basis. APPLE |
MAKES NO WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION |
THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS |
FOR A PARTICULAR PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND |
OPERATION ALONE OR IN COMBINATION WITH YOUR PRODUCTS. |
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL |
OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF |
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
INTERRUPTION) ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, |
MODIFICATION AND/OR DISTRIBUTION OF THE APPLE SOFTWARE, HOWEVER CAUSED |
AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING NEGLIGENCE), |
STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN ADVISED OF THE |
POSSIBILITY OF SUCH DAMAGE. |
Copyright (C) 2014 Apple Inc. All Rights Reserved. |
*/ |
#import "ASCPresentationViewController.h" |
#import "ASCSlideTextManager.h" |
#import "ASCSlideSceneGraph.h" |
#import "Utils.h" |
@implementation ASCSlideSceneGraph |
- (NSUInteger)numberOfSteps { |
return 4; |
} |
- (void)setupSlideWithPresentationViewController:(ASCPresentationViewController *)presentationViewController { |
// Set the slide's title and subtitle and add some text |
self.textManager.title = @"Scene Graph"; |
self.textManager.subtitle = @"Scene"; |
[self.textManager addBullet:@"SCNScene" atLevel:0]; |
[self.textManager addBullet:@"Starting point" atLevel:0]; |
// Setup the diagram |
SCNNode *diagramNode = [[self class] sharedScenegraphDiagramNode]; |
[self.groundNode addChildNode:diagramNode]; |
} |
- (void)presentStepIndex:(NSUInteger)index withPresentionViewController:(ASCPresentationViewController *)presentationViewController { |
SCNNode *diagramNode = [[self class] sharedScenegraphDiagramNode]; |
[[self class] scenegraphDiagramGoToStep:index]; |
switch (index) { |
case 0: |
diagramNode.opacity = 0.0; |
diagramNode.position = SCNVector3Make(0.0, 5.0, 0.0); |
diagramNode.rotation = SCNVector4Make(1, 0, 0, -M_PI_2); |
break; |
case 1: |
{ |
[SCNTransaction begin]; |
[SCNTransaction setAnimationDuration:0]; |
{ |
[self.textManager flipOutTextOfType:ASCTextTypeBullet]; |
[self.textManager flipOutTextOfType:ASCTextTypeSubtitle]; |
// Change the slide's subtitle and add some text |
self.textManager.subtitle = @"Node"; |
[self.textManager addBullet:@"SCNNode" atLevel:0]; |
[self.textManager addBullet:@"A location in 3D space" atLevel:0]; |
[self.textManager addBullet:@"Position / Rotation / Scale" atLevel:1]; |
[self.textManager flipInTextOfType:ASCTextTypeSubtitle]; |
[self.textManager flipInTextOfType:ASCTextTypeBullet]; |
} |
[SCNTransaction commit]; |
break; |
} |
case 2: |
[self.textManager addBullet:@"Hierarchy of nodes" atLevel:0]; |
[self.textManager addBullet:@"Relative to the parent node" atLevel:1]; |
break; |
case 3: |
{ |
[SCNTransaction begin]; |
[SCNTransaction setAnimationDuration:0]; |
{ |
[self.textManager flipOutTextOfType:ASCTextTypeBullet]; |
[self.textManager flipOutTextOfType:ASCTextTypeSubtitle]; |
// Change the slide's subtitle and add some text |
self.textManager.subtitle = @"Node attributes"; |
[self.textManager addBullet:@"Geometry" atLevel:0]; |
[self.textManager addBullet:@"Camera" atLevel:0]; |
[self.textManager addBullet:@"Light" atLevel:0]; |
[self.textManager addBullet:@"Can be shared" atLevel:0]; |
[self.textManager flipInTextOfType:ASCTextTypeSubtitle]; |
[self.textManager flipInTextOfType:ASCTextTypeBullet]; |
} |
[SCNTransaction commit]; |
[SCNTransaction begin]; |
[SCNTransaction setAnimationDuration:1.0]; |
{ |
// move the diagram up otherwise it would intersect the floor |
diagramNode.position = SCNVector3Make(0.0, diagramNode.position.y + 1.0, 0.0); |
} |
[SCNTransaction commit]; |
break; |
} |
} |
} |
- (void)didOrderInWithPresentionViewController:(ASCPresentationViewController *)presentationViewController { |
SCNNode *diagramNode = [[self class] sharedScenegraphDiagramNode]; |
[SCNTransaction begin]; |
[SCNTransaction setAnimationDuration:1.0]; |
{ |
diagramNode.opacity = 1.0; |
diagramNode.rotation = SCNVector4Make(1, 0, 0, 0); |
[[self class] showNodesNamed:@[@"scene"]]; |
} |
[SCNTransaction commit]; |
} |
+ (SCNNode *)sharedScenegraphDiagramNode { |
static SCNNode *diagramNode = nil; |
if (diagramNode == nil) { |
diagramNode = [SCNNode node]; |
diagramNode.opacity = 0.0; |
// "Scene" |
NSColor* blue = [NSColor colorWithDeviceRed:49.0/255 green:80.0/255 blue:201/255.0 alpha:1]; |
SCNNode *box = [SCNNode asc_boxNodeWithTitle:@"Scene" frame:NSMakeRect(-53.5, -25, 107, 50) color:blue cornerRadius:10 centered:YES]; |
box.name = @"scene"; |
box.scale = SCNVector3Make(0.03, 0.03, 0.03); |
box.position = SCNVector3Make(5.4, 4.8, 0); |
[diagramNode addChildNode:box]; |
// Arrow from "Scene" to "Root Node" |
SCNNode *arrowNode = [SCNNode node]; |
arrowNode.name = @"sceneArrow"; |
arrowNode.geometry = [SCNShape shapeWithPath:[NSBezierPath asc_arrowBezierPathWithBaseSize:NSMakeSize(3,0.2) tipSize:NSMakeSize(0.5, 0.7) hollow:0.2 twoSides:NO] extrusionDepth:0]; |
arrowNode.scale = SCNVector3Make(20, 20, 1); |
arrowNode.position = SCNVector3Make(-5, 0, 8); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -M_PI_2); |
arrowNode.geometry.firstMaterial.diffuse.contents = blue; |
[box addChildNode:arrowNode]; |
// "Root Node" |
NSColor *green = [NSColor colorWithDeviceRed:154.0/255 green:197.0/255 blue:58.0/255 alpha:1]; |
box = [SCNNode asc_boxNodeWithTitle:@"Root Node" frame:NSMakeRect(-40, -36, 80, 72) color:green cornerRadius:10.0 centered:YES]; |
box.name = @"rootNode"; |
box.scale = SCNVector3Make(0.03, 0.03, 0.03); |
box.position = SCNVector3Make(5.405, 1.8, 0); |
[diagramNode addChildNode:box]; |
// Arrows from "Root Node" to child nodes |
arrowNode = [arrowNode clone]; |
arrowNode.name = @"nodeArrow1"; |
arrowNode.geometry = [SCNShape shapeWithPath:[NSBezierPath asc_arrowBezierPathWithBaseSize:NSMakeSize(5.8,0.15) tipSize:NSMakeSize(0.5, 0.7) hollow:0.2 twoSides:YES] extrusionDepth:0]; |
arrowNode.position = SCNVector3Make(0, -30, 8); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -(M_PI * 0.85)); |
arrowNode.geometry.firstMaterial.diffuse.contents = green; |
[box addChildNode:arrowNode]; |
arrowNode = [arrowNode clone]; |
arrowNode.name = @"nodeArrow2"; |
arrowNode.position = SCNVector3Make(0, -43, 8); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -(M_PI * (1-0.85))); |
[box addChildNode:arrowNode]; |
arrowNode = [arrowNode clone]; |
arrowNode.name = @"nodeArrow3"; |
arrowNode.geometry = [SCNShape shapeWithPath:[NSBezierPath asc_arrowBezierPathWithBaseSize:NSMakeSize(2.6,0.15) tipSize:NSMakeSize(0.5, 0.7) hollow:0.2 twoSides:YES] extrusionDepth:0]; |
arrowNode.position = SCNVector3Make(-4, -38, 8); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -(M_PI * 0.5)); |
arrowNode.geometry.firstMaterial.diffuse.contents = green; |
[box addChildNode:arrowNode]; |
// Multiple "Child Node" |
box = [SCNNode asc_boxNodeWithTitle:@"Child Node" frame:NSMakeRect(-40, -36, 80, 72) color:green cornerRadius:10.0 centered:YES]; |
box.name = @"child1"; |
box.scale = SCNVector3Make(0.03, 0.03, 0.03); |
box.position = SCNVector3Make(2.405, -2, 0); |
[diagramNode addChildNode:box]; |
box = [box clone]; |
box.name = @"child2"; |
box.position = SCNVector3Make(5.405, -2, 0); |
[diagramNode addChildNode:box]; |
box = [box clone]; |
box.name = @"child3"; |
box.position = SCNVector3Make(8.405, -2, 0); |
[diagramNode addChildNode:box]; |
// "Light" |
NSColor *purple = [NSColor colorWithDeviceRed:190.0/255 green:56.0/255 blue:243.0/255 alpha:1]; |
box = [SCNNode asc_boxNodeWithTitle:@"Light" frame:NSMakeRect(-40, -20, 80, 40) color:purple cornerRadius:10 centered:YES]; |
box.name = @"light"; |
box.scale = SCNVector3Make(0.03, 0.03, 0.03); |
box.position = SCNVector3Make(2.405, -4.8, 0); |
[diagramNode addChildNode:box]; |
// Arrow to "Light" |
arrowNode = [SCNNode node]; |
arrowNode.name = @"lightArrow"; |
arrowNode.geometry = [SCNShape shapeWithPath:[NSBezierPath asc_arrowBezierPathWithBaseSize:NSMakeSize(2.0,0.15) tipSize:NSMakeSize(0.5, 0.7) hollow:0.2 twoSides:NO] extrusionDepth:0]; |
arrowNode.position = SCNVector3Make(-5, 60, 8); |
arrowNode.scale = SCNVector3Make(20, 20, 1); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -M_PI_2); |
arrowNode.geometry.firstMaterial.diffuse.contents = purple; |
[box addChildNode:arrowNode]; |
// "Camera" |
box = [SCNNode asc_boxNodeWithTitle:@"Camera" frame:NSMakeRect(-45, -20, 90, 40) color:purple cornerRadius:10 centered:YES]; |
box.name = @"camera"; |
box.scale = SCNVector3Make(0.03, 0.03, 0.03); |
box.position = SCNVector3Make(5.25, -4.8, 0); |
[diagramNode addChildNode:box]; |
// Arrow to "Camera" |
arrowNode = [arrowNode clone]; |
arrowNode.name = @"cameraArrow"; |
arrowNode.position = SCNVector3Make(0, 60, 8); |
[box addChildNode:arrowNode]; |
// "Geometry" |
box = [SCNNode asc_boxNodeWithTitle:@"Geometry" frame:NSMakeRect(-55, -20, 110, 40) color:purple cornerRadius:10 centered:YES]; |
box.name = @"geometry"; |
box.scale = SCNVector3Make(0.03, 0.03, 0.03); |
box.position = SCNVector3Make(8.6, -4.8, 0); |
[diagramNode addChildNode:box]; |
// Arrows to "Geometry" |
arrowNode = [arrowNode clone]; |
arrowNode.name = @"geometryArrow"; |
arrowNode.position = SCNVector3Make(-10, 60, 8); |
[box addChildNode:arrowNode]; |
arrowNode = [arrowNode clone]; |
arrowNode.name = @"geometryArrow2"; |
arrowNode.geometry = [SCNShape shapeWithPath:[NSBezierPath asc_arrowBezierPathWithBaseSize:NSMakeSize(5.0,0.15) tipSize:NSMakeSize(0.5, 0.7) hollow:0.2 twoSides:NO] extrusionDepth:0]; |
arrowNode.geometry.firstMaterial.diffuse.contents = purple; |
arrowNode.position = SCNVector3Make(-105, 53, 8); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -M_PI / 8); |
[box addChildNode:arrowNode]; |
// Multiple "Material" |
NSColor *redColor = [NSColor colorWithDeviceRed:168.0/255 green:21.0/255 blue:0.0/255 alpha:1]; |
SCNNode *materialsBox = [SCNNode asc_boxNodeWithTitle:nil frame:NSMakeRect(-151, -25, 302, 50) color:[NSColor lightGrayColor] cornerRadius:2 centered:YES]; |
materialsBox.scale = SCNVector3Make(0.03, 0.03, 0.03); |
materialsBox.name = @"materials"; |
materialsBox.position = SCNVector3Make(8.7, -7.1, -0.2); |
[diagramNode addChildNode:materialsBox]; |
box = [SCNNode asc_boxNodeWithTitle:@"Material" frame:NSMakeRect(-45, -20, 90, 40) color:redColor cornerRadius:0 centered:YES]; |
box.position = SCNVector3Make(-100, 0, 0.2); |
[materialsBox addChildNode:box]; |
box = [box clone]; |
box.position = SCNVector3Make(100, 0, 0.2); |
[materialsBox addChildNode:box]; |
box = [box clone]; |
box.position = SCNVector3Make(0, 0, 0.2); |
[materialsBox addChildNode:box]; |
// Arrow from "Geometry" to the materials |
arrowNode = [SCNNode node]; |
arrowNode.geometry = [SCNShape shapeWithPath:[NSBezierPath asc_arrowBezierPathWithBaseSize:NSMakeSize(2.0,0.15) tipSize:NSMakeSize(0.5, 0.7) hollow:0.2 twoSides:NO] extrusionDepth:0]; |
arrowNode.position = SCNVector3Make(-6, 65, 8); |
arrowNode.scale = SCNVector3Make(20, 20, 1); |
arrowNode.rotation = SCNVector4Make(0, 0, 1, -M_PI_2); |
arrowNode.geometry.firstMaterial.diffuse.contents = redColor; |
[box addChildNode:arrowNode]; |
[materialsBox.parentNode replaceChildNode:materialsBox with:[materialsBox flattenedClone]]; |
} |
return diagramNode; |
} |
+ (void)highlightNodesNamed:(NSArray *)names inNodeTree:(SCNNode *)node { |
for (SCNNode *child in node.childNodes) { |
if ([names containsObject:child.name]) { |
child.opacity = 1; |
[self highlightNodesNamed:names inNodeTree:child]; |
} |
else { |
if (child.opacity == 1.0) |
child.opacity = 0.3; |
} |
} |
} |
+ (void)showNodesNamed:(NSArray *)names { |
SCNNode *diagramNode = [self sharedScenegraphDiagramNode]; |
[SCNTransaction begin]; |
[SCNTransaction setAnimationDuration:1.0]; |
{ |
for (NSString *nodeName in names) { |
SCNNode *node = [diagramNode childNodeWithName:nodeName recursively:YES]; |
node.opacity = 1.0; |
if (node.rotation.z == 0.0) |
node.rotation = SCNVector4Make(0, 1, 0, 0); |
} |
} |
[SCNTransaction commit]; |
} |
+ (void)scenegraphDiagramGoToStep:(NSUInteger)step { |
SCNNode *diagramNode = [[self class] sharedScenegraphDiagramNode]; |
switch (step) { |
case 0: |
// Restore the initial state (hidden and rotated) |
[diagramNode childNodesPassingTest:^BOOL(SCNNode *child, BOOL *stop) { |
child.opacity = 0.0; |
if (child.rotation.z == 0) // don't touch nodes that already have a rotation set |
child.rotation = SCNVector4Make(0, 1, 0, M_PI_2); |
return NO; |
}]; |
break; |
case 1: |
[self showNodesNamed:@[@"sceneArrow", @"rootNode"]]; |
break; |
case 2: |
[self showNodesNamed:@[@"child1", @"child2", @"child3", @"nodeArrow1", @"nodeArrow2", @"nodeArrow3"]]; |
break; |
case 3: |
[self showNodesNamed:@[@"light", @"camera", @"geometry", @"lightArrow", @"cameraArrow", @"geometryArrow", @"geometryArrow2"]]; |
break; |
case 4: |
[self showNodesNamed:@[@"scene", @"sceneArrow", @"rootNode", @"light", @"camera", @"cameraArrow", @"child1", @"child2", @"child3", @"nodeArrow1", @"nodeArrow2", @"nodeArrow3", @"geometry", @"lightArrow", @"geometryArrow", @"geometryArrow2"]]; |
[self highlightNodesNamed:@[@"scene", @"sceneArrow", @"rootNode", @"light", @"camera", @"cameraArrow", @"child1", @"child2", @"child3", @"nodeArrow1", @"nodeArrow2", @"nodeArrow3", @"geometry", @"lightArrow", @"geometryArrow", @"geometryArrow2"] inNodeTree:diagramNode]; |
break; |
case 5: |
[self showNodesNamed:@[@"scene", @"sceneArrow", @"rootNode", @"light", @"camera", @"cameraArrow", @"child1", @"child2", @"child3", @"nodeArrow1", @"nodeArrow2", @"nodeArrow3", @"geometry", @"lightArrow", @"geometryArrow", @"geometryArrow2", @"materials"]]; |
[self highlightNodesNamed:@[@"scene", @"sceneArrow", @"rootNode", @"child2", @"child3", @"nodeArrow2", @"nodeArrow3", @"geometry", @"geometryArrow", @"geometryArrow2", @"materials"] inNodeTree:diagramNode]; |
break; |
case 6: |
[self highlightNodesNamed:@[@"child3", @"geometryArrow", @"geometry"] inNodeTree:diagramNode]; |
break; |
case 7: |
[self showNodesNamed:@[@"scene", @"sceneArrow", @"rootNode", @"light", @"camera", @"cameraArrow", @"child1", @"child2", @"child3", @"nodeArrow1", @"nodeArrow2", @"nodeArrow3", @"geometry", @"lightArrow", @"geometryArrow", @"geometryArrow2", @"materials"]]; |
break; |
} |
} |
@end |
Copyright © 2014 Apple Inc. All Rights Reserved. Terms of Use | Privacy Policy | Updated: 2014-01-07